From 6fcd15c929efdca82331afe1f450eba8cf015646 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte
 <61604367+GabrielMarquezMatte@users.noreply.github.com>
Date: Wed, 7 Oct 2026 13:41:16 +0000
Subject: [PATCH 001/115] chore: promote public API for v6.0.0

---
 .../PublicAPI/PublicAPI.Shipped.txt           |   2 +-
 .../PublicAPI/PublicAPI.Unshipped.txt         |   2 -
 .../PublicAPI/PublicAPI.Shipped.txt           | 290 ++++++++++--------
 .../PublicAPI/PublicAPI.Unshipped.txt         | 290 ------------------
 4 files changed, 158 insertions(+), 426 deletions(-)

diff --git a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
index 6a1803ef..297b0d9a 100644
--- a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
@@ -1,7 +1,7 @@
 #nullable enable
 ExcelReader.Arrow.ArrowConversionExtensions
 ExcelReader.Arrow.ArrowWriteExtensions
-static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelRowReader! reader, ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]? schema = null, int headerRow = 1) -> Apache.Arrow.RecordBatch!
+static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]? schema = null, int headerRow = 1) -> Apache.Arrow.RecordBatch!
 static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Csv.CsvWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, bool writeHeader = true) -> void
 static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xls.XlsWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true) -> void
 static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true) -> void
diff --git a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
index 38a178ff..7dc5c581 100644
--- a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
@@ -1,3 +1 @@
 #nullable enable
-static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]? schema = null, int headerRow = 1) -> Apache.Arrow.RecordBatch!
-*REMOVED*static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelRowReader! reader, ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]? schema = null, int headerRow = 1) -> Apache.Arrow.RecordBatch!
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index dcc56664..514d6008 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -3,9 +3,9 @@ ExcelReader.Core.ExcelSheetVisibility
 ExcelReader.Core.ExcelSheetVisibility.Hidden = 1 -> ExcelReader.Core.ExcelSheetVisibility
 ExcelReader.Core.ExcelSheetVisibility.VeryHidden = 2 -> ExcelReader.Core.ExcelSheetVisibility
 ExcelReader.Core.ExcelSheetVisibility.Visible = 0 -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.Current.get -> T
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
+ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>
+ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.Current.get -> T
+ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
 ExcelReader.Core.Parser.CsvEnumerable<T>
 ExcelReader.Core.Parser.CsvEnumerable<T>.AsyncEnumerator
 ExcelReader.Core.Parser.CsvEnumerable<T>.Enumerator
@@ -19,9 +19,9 @@ ExcelReader.Core.Parser.ExcelColumnAttribute.Name.get -> string!
 ExcelReader.Core.Parser.ExcelConverterAttribute
 ExcelReader.Core.Parser.ExcelConverterAttribute.ConverterType.get -> System.Type!
 ExcelReader.Core.Parser.ExcelConverterAttribute.ExcelConverterAttribute(System.Type! converterType) -> void
-ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>
-ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.AsyncEnumerator
-ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.Enumerator
+ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>
+ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator
+ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator
 ExcelReader.Core.Parser.ExcelEnumerable<T>
 ExcelReader.Core.Parser.ExcelIgnoreAttribute
 ExcelReader.Core.Parser.ExcelIgnoreAttribute.ExcelIgnoreAttribute() -> void
@@ -37,11 +37,11 @@ ExcelReader.Core.Parser.ExcelParseException.RawValue.get -> string!
 ExcelReader.Core.Parser.ExcelParseException.Row.get -> int
 ExcelReader.Core.Parser.ExcelParser
 ExcelReader.Core.Parser.ExcelParser<T>
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Csv.CsvReader! reader) -> ExcelReader.Core.Parser.CsvEnumerable<T>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.IExcelRowReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.IExcelRowReader!, ExcelReader.Core.Reader.IExcelRowEnumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xls.XlsReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xls.XlsReader!, ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsb.XlsbReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xlsb.XlsbReader!, ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsx.XlsxReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T>!
+ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Csv.CsvSheet sheet) -> ExcelReader.Core.Parser.CsvEnumerable<T>!
+ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.IExcelSheet! sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.IExcelSheet!, ExcelReader.Core.Reader.IExcelRowEnumerator!>!
+ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xls.XlsSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xls.XlsSheet, ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!>!
+ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsb.XlsbSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xlsb.XlsbSheet, ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!>!
+ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsx.XlsxSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T>!
 ExcelReader.Core.Parser.ExcelParserConfig
 ExcelReader.Core.Parser.ExcelParserConfig.ColumnNameComparer.get -> System.StringComparer!
 ExcelReader.Core.Parser.ExcelParserConfig.ColumnNameComparer.init -> void
@@ -144,16 +144,11 @@ ExcelReader.Core.Reader.Csv.CsvReader.Enumerator
 ExcelReader.Core.Reader.Csv.CsvReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
 ExcelReader.Core.Reader.Csv.CsvReader.Enumerator.MoveNext() -> bool
 ExcelReader.Core.Reader.Csv.CsvReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Csv.CsvReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
-ExcelReader.Core.Reader.Csv.CsvReader.GetEnumerator() -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
+ExcelReader.Core.Reader.Csv.CsvReader.FirstSheet.get -> ExcelReader.Core.Reader.Csv.CsvSheet
 ExcelReader.Core.Reader.Csv.CsvReader.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Csv.CsvReader.MoveToSheet(int index) -> void
 ExcelReader.Core.Reader.Csv.CsvReader.SheetCount.get -> int
-ExcelReader.Core.Reader.Csv.CsvReader.SheetName.get -> string!
-ExcelReader.Core.Reader.Csv.CsvReader.SheetNameAt(int index) -> string!
-ExcelReader.Core.Reader.Csv.CsvReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Csv.CsvReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Csv.CsvReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
+ExcelReader.Core.Reader.Csv.CsvReader.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Csv.CsvSheet>!
+ExcelReader.Core.Reader.Csv.CsvReader.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Csv.CsvSheet sheet) -> bool
 ExcelReader.Core.Reader.Csv.CsvReaderOptions
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.<Clone>$() -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.CsvReaderOptions() -> void
@@ -174,6 +169,15 @@ ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect.get -> bool
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.WithDialect(ExcelReader.Core.Reader.Csv.CsvDialect dialect) -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
 ExcelReader.Core.Reader.Csv.CsvRowAction<TState>
+ExcelReader.Core.Reader.Csv.CsvSheet
+ExcelReader.Core.Reader.Csv.CsvSheet.CsvSheet() -> void
+ExcelReader.Core.Reader.Csv.CsvSheet.Equals(ExcelReader.Core.Reader.Csv.CsvSheet other) -> bool
+ExcelReader.Core.Reader.Csv.CsvSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
+ExcelReader.Core.Reader.Csv.CsvSheet.GetEnumerator() -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
+ExcelReader.Core.Reader.Csv.CsvSheet.Index.get -> int
+ExcelReader.Core.Reader.Csv.CsvSheet.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Csv.CsvSheet.Name.get -> string!
+ExcelReader.Core.Reader.Csv.CsvSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
 ExcelReader.Core.Reader.Csv.CsvSniffer
 ExcelReader.Core.Reader.Csv.CsvSnifferOptions
 ExcelReader.Core.Reader.Csv.CsvSnifferOptions.<Clone>$() -> ExcelReader.Core.Reader.Csv.CsvSnifferOptions!
@@ -195,7 +199,7 @@ ExcelReader.Core.Reader.ExcelDataReader
 ExcelReader.Core.Reader.ExcelDataReader.Close() -> void
 ExcelReader.Core.Reader.ExcelDataReader.Depth.get -> int
 ExcelReader.Core.Reader.ExcelDataReader.Dispose() -> void
-ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow = 1) -> void
+ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1) -> void
 ExcelReader.Core.Reader.ExcelDataReader.FieldCount.get -> int
 ExcelReader.Core.Reader.ExcelDataReader.GetBoolean(int i) -> bool
 ExcelReader.Core.Reader.ExcelDataReader.GetByte(int i) -> byte
@@ -281,34 +285,28 @@ ExcelReader.Core.Reader.ExcelReaderOptions.PrefetchDecompression.get -> bool
 ExcelReader.Core.Reader.ExcelReaderOptions.PrefetchDecompression.init -> void
 ExcelReader.Core.Reader.ExcelReaderOptions.VerifyEncryptedIntegrity.get -> bool
 ExcelReader.Core.Reader.ExcelReaderOptions.VerifyEncryptedIntegrity.init -> void
-ExcelReader.Core.Reader.ExcelRowReaderExtensions
-ExcelReader.Core.Reader.ExcelSheet
-ExcelReader.Core.Reader.ExcelSheet.Deconstruct(out int Index, out string! Name) -> void
-ExcelReader.Core.Reader.ExcelSheet.Equals(ExcelReader.Core.Reader.ExcelSheet other) -> bool
-ExcelReader.Core.Reader.ExcelSheet.ExcelSheet() -> void
-ExcelReader.Core.Reader.ExcelSheet.ExcelSheet(int Index, string! Name) -> void
-ExcelReader.Core.Reader.ExcelSheet.Index.get -> int
-ExcelReader.Core.Reader.ExcelSheet.Index.init -> void
-ExcelReader.Core.Reader.ExcelSheet.Name.get -> string!
-ExcelReader.Core.Reader.ExcelSheet.Name.init -> void
-ExcelReader.Core.Reader.ExcelSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.ExcelSheet.Visibility.init -> void
+ExcelReader.Core.Reader.ExcelSheetList<TSheet>
+ExcelReader.Core.Reader.ExcelSheetList<TSheet>.Count.get -> int
+ExcelReader.Core.Reader.ExcelSheetList<TSheet>.GetEnumerator() -> System.ArraySegment<TSheet>.Enumerator
+ExcelReader.Core.Reader.ExcelSheetList<TSheet>.this[int index].get -> TSheet
 ExcelReader.Core.Reader.IExcelRowEnumerator
 ExcelReader.Core.Reader.IExcelRowEnumerator.Current.get -> ExcelReader.Core.Reader.Row
 ExcelReader.Core.Reader.IExcelRowEnumerator.MoveNext() -> bool
 ExcelReader.Core.Reader.IExcelRowEnumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.IExcelRowReader
-ExcelReader.Core.Reader.IExcelRowReader.MoveToSheet(int index) -> void
-ExcelReader.Core.Reader.IExcelRowReader.SheetCount.get -> int
-ExcelReader.Core.Reader.IExcelRowReader.SheetName.get -> string!
-ExcelReader.Core.Reader.IExcelRowReader.SheetNameAt(int index) -> string!
-ExcelReader.Core.Reader.IExcelRowReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.IExcelRowReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.IExcelRowReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>
-ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> TEnumerator
-ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.GetEnumerator() -> TEnumerator
-ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.IsDate1904.get -> bool
+ExcelReader.Core.Reader.IExcelSheet
+ExcelReader.Core.Reader.IExcelSheet.Index.get -> int
+ExcelReader.Core.Reader.IExcelSheet.Name.get -> string!
+ExcelReader.Core.Reader.IExcelSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
+ExcelReader.Core.Reader.IExcelSheet<TEnumerator>
+ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> TEnumerator
+ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.GetEnumerator() -> TEnumerator
+ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.IsDate1904.get -> bool
+ExcelReader.Core.Reader.IExcelWorkbook
+ExcelReader.Core.Reader.IExcelWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.IExcelSheet!
+ExcelReader.Core.Reader.IExcelWorkbook.IsDate1904.get -> bool
+ExcelReader.Core.Reader.IExcelWorkbook.SheetAt(int index) -> ExcelReader.Core.Reader.IExcelSheet!
+ExcelReader.Core.Reader.IExcelWorkbook.SheetCount.get -> int
+ExcelReader.Core.Reader.IExcelWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.IExcelSheet! sheet) -> bool
 ExcelReader.Core.Reader.PooledStreamRowEnumerator
 ExcelReader.Core.Reader.PooledStreamRowEnumerator.Dispose() -> void
 ExcelReader.Core.Reader.PooledStreamRowEnumerator.DisposeAsync() -> System.Threading.Tasks.ValueTask
@@ -346,59 +344,71 @@ ExcelReader.Core.Reader.Schema.ExcelColumnType.Int64Column = 1 -> ExcelReader.Co
 ExcelReader.Core.Reader.Schema.ExcelColumnType.StringColumn = 0 -> ExcelReader.Core.Reader.Schema.ExcelColumnType
 ExcelReader.Core.Reader.Schema.ExcelColumnType.TimeColumn = 5 -> ExcelReader.Core.Reader.Schema.ExcelColumnType
 ExcelReader.Core.Reader.Schema.ExcelColumnType.TimestampColumn = 6 -> ExcelReader.Core.Reader.Schema.ExcelColumnType
-ExcelReader.Core.Reader.Xls.XlsReader
-ExcelReader.Core.Reader.Xls.XlsReader.Dispose() -> void
-ExcelReader.Core.Reader.Xls.XlsReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.Dispose() -> void
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xls.XlsReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!
-ExcelReader.Core.Reader.Xls.XlsReader.GetEnumerator() -> ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!
-ExcelReader.Core.Reader.Xls.XlsReader.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xls.XlsReader.MoveToSheet(int index) -> void
-ExcelReader.Core.Reader.Xls.XlsReader.SheetCount.get -> int
-ExcelReader.Core.Reader.Xls.XlsReader.SheetName.get -> string!
-ExcelReader.Core.Reader.Xls.XlsReader.SheetNameAt(int index) -> string!
-ExcelReader.Core.Reader.Xls.XlsReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xls.XlsReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xls.XlsReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbReader
-ExcelReader.Core.Reader.Xlsb.XlsbReader.Dispose() -> void
-ExcelReader.Core.Reader.Xlsb.XlsbReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator
-ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xlsb.XlsbReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!
-ExcelReader.Core.Reader.Xlsb.XlsbReader.GetEnumerator() -> ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!
-ExcelReader.Core.Reader.Xlsb.XlsbReader.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbReader.MoveToSheet(int index) -> void
-ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetCount.get -> int
-ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetName.get -> string!
-ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetNameAt(int index) -> string!
-ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsb.XlsbReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxReader
-ExcelReader.Core.Reader.Xlsx.XlsxReader.Dispose() -> void
-ExcelReader.Core.Reader.Xlsx.XlsxReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator
-ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xlsx.XlsxReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator!
-ExcelReader.Core.Reader.Xlsx.XlsxReader.GetEnumerator() -> ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator!
-ExcelReader.Core.Reader.Xlsx.XlsxReader.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxReader.MoveToSheet(int index) -> void
-ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetCount.get -> int
-ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetName.get -> string!
-ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetNameAt(int index) -> string!
-ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsx.XlsxReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
+ExcelReader.Core.Reader.Xls.XlsSheet
+ExcelReader.Core.Reader.Xls.XlsSheet.Equals(ExcelReader.Core.Reader.Xls.XlsSheet other) -> bool
+ExcelReader.Core.Reader.Xls.XlsSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xls.XlsSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xls.XlsSheet.Index.get -> int
+ExcelReader.Core.Reader.Xls.XlsSheet.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xls.XlsSheet.Name.get -> string!
+ExcelReader.Core.Reader.Xls.XlsSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
+ExcelReader.Core.Reader.Xls.XlsSheet.XlsSheet() -> void
+ExcelReader.Core.Reader.Xls.XlsWorkbook
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Dispose() -> void
+ExcelReader.Core.Reader.Xls.XlsWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.Dispose() -> void
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.DisposeAsync() -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.MoveNext() -> bool
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
+ExcelReader.Core.Reader.Xls.XlsWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xls.XlsSheet
+ExcelReader.Core.Reader.Xls.XlsWorkbook.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xls.XlsWorkbook.SheetCount.get -> int
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xls.XlsSheet>!
+ExcelReader.Core.Reader.Xls.XlsWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xls.XlsSheet sheet) -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbSheet
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.Equals(ExcelReader.Core.Reader.Xlsb.XlsbSheet other) -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.Index.get -> int
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.Name.get -> string!
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
+ExcelReader.Core.Reader.Xlsb.XlsbSheet.XlsbSheet() -> void
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Dispose() -> void
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.MoveNext() -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xlsb.XlsbSheet
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.SheetCount.get -> int
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xlsb.XlsbSheet>!
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xlsb.XlsbSheet sheet) -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxSheet
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.Equals(ExcelReader.Core.Reader.Xlsx.XlsxSheet other) -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator!
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.Index.get -> int
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.Name.get -> string!
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
+ExcelReader.Core.Reader.Xlsx.XlsxSheet.XlsxSheet() -> void
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Dispose() -> void
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.MoveNext() -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xlsx.XlsxSheet
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.IsDate1904.get -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.SheetCount.get -> int
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xlsx.XlsxSheet>!
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xlsx.XlsxSheet sheet) -> bool
 ExcelReader.Core.Writer.CellStyle
 ExcelReader.Core.Writer.CellStyle.Bold.get -> bool
 ExcelReader.Core.Writer.CellStyle.Bold.init -> void
@@ -647,6 +657,7 @@ override ExcelReader.Core.Reader.Csv.CsvDialect.GetHashCode() -> int
 override ExcelReader.Core.Reader.Csv.CsvReaderOptions.Equals(object? obj) -> bool
 override ExcelReader.Core.Reader.Csv.CsvReaderOptions.GetHashCode() -> int
 override ExcelReader.Core.Reader.Csv.CsvReaderOptions.ToString() -> string!
+override ExcelReader.Core.Reader.Csv.CsvSheet.GetHashCode() -> int
 override ExcelReader.Core.Reader.Csv.CsvSnifferOptions.Equals(object? obj) -> bool
 override ExcelReader.Core.Reader.Csv.CsvSnifferOptions.GetHashCode() -> int
 override ExcelReader.Core.Reader.Csv.CsvSnifferOptions.ToString() -> string!
@@ -654,8 +665,10 @@ override ExcelReader.Core.Reader.ExcelPassword.ToString() -> string!
 override ExcelReader.Core.Reader.ExcelReaderOptions.Equals(object? obj) -> bool
 override ExcelReader.Core.Reader.ExcelReaderOptions.GetHashCode() -> int
 override ExcelReader.Core.Reader.ExcelReaderOptions.ToString() -> string!
-override ExcelReader.Core.Reader.ExcelSheet.GetHashCode() -> int
 override ExcelReader.Core.Reader.Schema.ExcelColumnSchema.GetHashCode() -> int
+override ExcelReader.Core.Reader.Xls.XlsSheet.GetHashCode() -> int
+override ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetHashCode() -> int
+override ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetHashCode() -> int
 override ExcelReader.Core.Writer.CellStyle.GetHashCode() -> int
 override ExcelReader.Core.Writer.Csv.CsvWriterOptions.Equals(object? obj) -> bool
 override ExcelReader.Core.Writer.Csv.CsvWriterOptions.GetHashCode() -> int
@@ -702,6 +715,8 @@ static ExcelReader.Core.Reader.Csv.CsvParallelOptions.Default.get -> ExcelReader
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.Default.get -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.operator !=(ExcelReader.Core.Reader.Csv.CsvReaderOptions? left, ExcelReader.Core.Reader.Csv.CsvReaderOptions? right) -> bool
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.operator ==(ExcelReader.Core.Reader.Csv.CsvReaderOptions? left, ExcelReader.Core.Reader.Csv.CsvReaderOptions? right) -> bool
+static ExcelReader.Core.Reader.Csv.CsvSheet.operator !=(ExcelReader.Core.Reader.Csv.CsvSheet left, ExcelReader.Core.Reader.Csv.CsvSheet right) -> bool
+static ExcelReader.Core.Reader.Csv.CsvSheet.operator ==(ExcelReader.Core.Reader.Csv.CsvSheet left, ExcelReader.Core.Reader.Csv.CsvSheet right) -> bool
 static ExcelReader.Core.Reader.Csv.CsvSniffer.Detect(System.IO.Stream! stream, ExcelReader.Core.Reader.Csv.CsvSnifferOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvDialect
 static ExcelReader.Core.Reader.Csv.CsvSniffer.Detect(System.ReadOnlySpan<byte> sample, ExcelReader.Core.Reader.Csv.CsvSnifferOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvDialect
 static ExcelReader.Core.Reader.Csv.CsvSniffer.DetectAsync(System.IO.Stream! stream, ExcelReader.Core.Reader.Csv.CsvSnifferOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvDialect>
@@ -722,43 +737,46 @@ static ExcelReader.Core.Reader.Excel.FromCsv(System.ReadOnlyMemory<byte> data, E
 static ExcelReader.Core.Reader.Excel.FromCsvAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
 static ExcelReader.Core.Reader.Excel.FromCsvFile(string! path, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
 static ExcelReader.Core.Reader.Excel.FromCsvFileAsync(string! path, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
-static ExcelReader.Core.Reader.Excel.FromXls(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-static ExcelReader.Core.Reader.Excel.FromXls(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-static ExcelReader.Core.Reader.Excel.FromXlsAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsReader!>
-static ExcelReader.Core.Reader.Excel.FromXlsFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-static ExcelReader.Core.Reader.Excel.FromXlsFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsReader!>
-static ExcelReader.Core.Reader.Excel.FromXlsb(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-static ExcelReader.Core.Reader.Excel.FromXlsb(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-static ExcelReader.Core.Reader.Excel.FromXlsbAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbReader!>
-static ExcelReader.Core.Reader.Excel.FromXlsbFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-static ExcelReader.Core.Reader.Excel.FromXlsbFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbReader!>
-static ExcelReader.Core.Reader.Excel.FromXlsx(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-static ExcelReader.Core.Reader.Excel.FromXlsx(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-static ExcelReader.Core.Reader.Excel.FromXlsxAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxReader!>
-static ExcelReader.Core.Reader.Excel.FromXlsxFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-static ExcelReader.Core.Reader.Excel.FromXlsxFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxReader!>
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow = 1, int sampleSize = 100, bool parseText = false) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow, int sampleSize) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
+static ExcelReader.Core.Reader.Excel.FromXls(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXls(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsWorkbook!>
+static ExcelReader.Core.Reader.Excel.FromXlsFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsWorkbook!>
+static ExcelReader.Core.Reader.Excel.FromXlsb(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsb(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsbAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!>
+static ExcelReader.Core.Reader.Excel.FromXlsbFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsbFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!>
+static ExcelReader.Core.Reader.Excel.FromXlsx(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsx(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsxAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
+static ExcelReader.Core.Reader.Excel.FromXlsxFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
+static ExcelReader.Core.Reader.Excel.FromXlsxFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
+static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1, int sampleSize = 100, bool parseText = false) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
+static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow, int sampleSize) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
+static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
+static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
+static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
+static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
+static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
 static ExcelReader.Core.Reader.ExcelPassword.FromString(string! password) -> ExcelReader.Core.Reader.ExcelPassword!
 static ExcelReader.Core.Reader.ExcelPassword.implicit operator ExcelReader.Core.Reader.ExcelPassword!(string! password) -> ExcelReader.Core.Reader.ExcelPassword!
 static ExcelReader.Core.Reader.ExcelReaderOptions.Default.get -> ExcelReader.Core.Reader.ExcelReaderOptions!
 static ExcelReader.Core.Reader.ExcelReaderOptions.operator !=(ExcelReader.Core.Reader.ExcelReaderOptions? left, ExcelReader.Core.Reader.ExcelReaderOptions? right) -> bool
 static ExcelReader.Core.Reader.ExcelReaderOptions.operator ==(ExcelReader.Core.Reader.ExcelReaderOptions? left, ExcelReader.Core.Reader.ExcelReaderOptions? right) -> bool
-static ExcelReader.Core.Reader.ExcelRowReaderExtensions.Sheets(this ExcelReader.Core.Reader.IExcelRowReader! reader) -> System.Collections.Generic.IEnumerable<ExcelReader.Core.Reader.ExcelSheet>!
-static ExcelReader.Core.Reader.ExcelSheet.operator !=(ExcelReader.Core.Reader.ExcelSheet left, ExcelReader.Core.Reader.ExcelSheet right) -> bool
-static ExcelReader.Core.Reader.ExcelSheet.operator ==(ExcelReader.Core.Reader.ExcelSheet left, ExcelReader.Core.Reader.ExcelSheet right) -> bool
 static ExcelReader.Core.Reader.Schema.ExcelColumnSchema.operator !=(ExcelReader.Core.Reader.Schema.ExcelColumnSchema left, ExcelReader.Core.Reader.Schema.ExcelColumnSchema right) -> bool
 static ExcelReader.Core.Reader.Schema.ExcelColumnSchema.operator ==(ExcelReader.Core.Reader.Schema.ExcelColumnSchema left, ExcelReader.Core.Reader.Schema.ExcelColumnSchema right) -> bool
+static ExcelReader.Core.Reader.Xls.XlsSheet.operator !=(ExcelReader.Core.Reader.Xls.XlsSheet left, ExcelReader.Core.Reader.Xls.XlsSheet right) -> bool
+static ExcelReader.Core.Reader.Xls.XlsSheet.operator ==(ExcelReader.Core.Reader.Xls.XlsSheet left, ExcelReader.Core.Reader.Xls.XlsSheet right) -> bool
+static ExcelReader.Core.Reader.Xlsb.XlsbSheet.operator !=(ExcelReader.Core.Reader.Xlsb.XlsbSheet left, ExcelReader.Core.Reader.Xlsb.XlsbSheet right) -> bool
+static ExcelReader.Core.Reader.Xlsb.XlsbSheet.operator ==(ExcelReader.Core.Reader.Xlsb.XlsbSheet left, ExcelReader.Core.Reader.Xlsb.XlsbSheet right) -> bool
+static ExcelReader.Core.Reader.Xlsx.XlsxSheet.operator !=(ExcelReader.Core.Reader.Xlsx.XlsxSheet left, ExcelReader.Core.Reader.Xlsx.XlsxSheet right) -> bool
+static ExcelReader.Core.Reader.Xlsx.XlsxSheet.operator ==(ExcelReader.Core.Reader.Xlsx.XlsxSheet left, ExcelReader.Core.Reader.Xlsx.XlsxSheet right) -> bool
 static ExcelReader.Core.Writer.CellStyle.operator !=(ExcelReader.Core.Writer.CellStyle left, ExcelReader.Core.Writer.CellStyle right) -> bool
 static ExcelReader.Core.Writer.CellStyle.operator ==(ExcelReader.Core.Writer.CellStyle left, ExcelReader.Core.Writer.CellStyle right) -> bool
 static ExcelReader.Core.Writer.Csv.CsvWorkbookWriter.Create(System.IO.Stream! stream, bool leaveOpen = false, ExcelReader.Core.Writer.Csv.CsvWriterOptions? options = null) -> ExcelReader.Core.Writer.Csv.CsvWorkbookWriter!
@@ -812,21 +830,27 @@ static readonly ExcelReader.Core.Parser.ExcelCellReaders.String -> ExcelReader.C
 static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlyAuto -> ExcelReader.Core.Parser.ExcelCellReader<System.TimeOnly>!
 static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlySerial -> ExcelReader.Core.Parser.ExcelCellReader<System.TimeOnly>!
 static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlyText -> ExcelReader.Core.Parser.ExcelCellReader<System.TimeOnly>!
-virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.DisposeAsync() -> System.Threading.Tasks.ValueTask
+virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.DisposeAsync() -> System.Threading.Tasks.ValueTask
 virtual ExcelReader.Core.Parser.ExcelCellReader<TValue>.Invoke(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TValue value) -> bool
 virtual ExcelReader.Core.Parser.ExcelPropertySetter<TModel, TValue>.Invoke(ref TModel model, TValue value) -> void
 virtual ExcelReader.Core.Parser.ExcelRowParser<TModel>.Invoke(ref TModel model, in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider) -> bool
 virtual ExcelReader.Core.Reader.Csv.CsvRowAction<TState>.Invoke(ref TState state, ExcelReader.Core.Reader.Row row) -> void
-~ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.AsyncEnumerator!
-~ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.Enumerator!
+~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator!
+~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator!
 ~override ExcelReader.Core.Parser.ExcelRowContext.Equals(object obj) -> bool
 ~override ExcelReader.Core.Parser.ExcelRowContext.ToString() -> string
 ~override ExcelReader.Core.Reader.Csv.CsvDialect.Equals(object obj) -> bool
 ~override ExcelReader.Core.Reader.Csv.CsvDialect.ToString() -> string
-~override ExcelReader.Core.Reader.ExcelSheet.Equals(object obj) -> bool
-~override ExcelReader.Core.Reader.ExcelSheet.ToString() -> string
+~override ExcelReader.Core.Reader.Csv.CsvSheet.Equals(object obj) -> bool
+~override ExcelReader.Core.Reader.Csv.CsvSheet.ToString() -> string
 ~override ExcelReader.Core.Reader.Schema.ExcelColumnSchema.Equals(object obj) -> bool
 ~override ExcelReader.Core.Reader.Schema.ExcelColumnSchema.ToString() -> string
+~override ExcelReader.Core.Reader.Xls.XlsSheet.Equals(object obj) -> bool
+~override ExcelReader.Core.Reader.Xls.XlsSheet.ToString() -> string
+~override ExcelReader.Core.Reader.Xlsb.XlsbSheet.Equals(object obj) -> bool
+~override ExcelReader.Core.Reader.Xlsb.XlsbSheet.ToString() -> string
+~override ExcelReader.Core.Reader.Xlsx.XlsxSheet.Equals(object obj) -> bool
+~override ExcelReader.Core.Reader.Xlsx.XlsxSheet.ToString() -> string
 ~override ExcelReader.Core.Writer.CellStyle.Equals(object obj) -> bool
 ~override ExcelReader.Core.Writer.CellStyle.ToString() -> string
 ~override ExcelReader.Core.Writer.Xlsb.XlsbCell.Equals(object obj) -> bool
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 9f1f112d..7dc5c581 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -1,291 +1 @@
 #nullable enable
-*REMOVED*ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>
-*REMOVED*ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.Current.get -> T
-*REMOVED*ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-*REMOVED*ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>
-*REMOVED*ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.AsyncEnumerator
-*REMOVED*ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.Enumerator
-*REMOVED*ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Csv.CsvReader! reader) -> ExcelReader.Core.Parser.CsvEnumerable<T>!
-*REMOVED*ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.IExcelRowReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.IExcelRowReader!, ExcelReader.Core.Reader.IExcelRowEnumerator!>!
-*REMOVED*ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xls.XlsReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xls.XlsReader!, ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!>!
-*REMOVED*ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsb.XlsbReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xlsb.XlsbReader!, ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!>!
-*REMOVED*ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsx.XlsxReader! reader) -> ExcelReader.Core.Parser.ExcelEnumerable<T>!
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.GetEnumerator() -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.MoveToSheet(int index) -> void
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.SheetName.get -> string!
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.SheetNameAt(int index) -> string!
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Csv.CsvReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-*REMOVED*ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow = 1) -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelRowReaderExtensions
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Deconstruct(out int Index, out string! Name) -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Equals(ExcelReader.Core.Reader.ExcelSheet other) -> bool
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.ExcelSheet() -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.ExcelSheet(int Index, string! Name) -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Index.get -> int
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Index.init -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Name.get -> string!
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Name.init -> void
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.ExcelSheet.Visibility.init -> void
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.MoveToSheet(int index) -> void
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.SheetCount.get -> int
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.SheetName.get -> string!
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.SheetNameAt(int index) -> string!
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> TEnumerator
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.GetEnumerator() -> TEnumerator
-*REMOVED*ExcelReader.Core.Reader.IExcelRowReader<TEnumerator>.IsDate1904.get -> bool
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Dispose() -> void
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.Dispose() -> void
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.DisposeAsync() -> System.Threading.Tasks.ValueTask
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.MoveNext() -> bool
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.GetEnumerator() -> ExcelReader.Core.Reader.Xls.XlsReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.IsDate1904.get -> bool
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.MoveToSheet(int index) -> void
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.SheetCount.get -> int
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.SheetName.get -> string!
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.SheetNameAt(int index) -> string!
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xls.XlsReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.Dispose() -> void
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.MoveNext() -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.GetEnumerator() -> ExcelReader.Core.Reader.Xlsb.XlsbReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.IsDate1904.get -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.MoveToSheet(int index) -> void
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetCount.get -> int
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetName.get -> string!
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetNameAt(int index) -> string!
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xlsb.XlsbReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.Dispose() -> void
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.MoveNext() -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.GetEnumerator() -> ExcelReader.Core.Reader.Xlsx.XlsxReader.Enumerator!
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.IsDate1904.get -> bool
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.MoveToSheet(int index) -> void
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetCount.get -> int
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetName.get -> string!
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetNameAt(int index) -> string!
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetVisibility.get -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.SheetVisibilityAt(int index) -> ExcelReader.Core.ExcelSheetVisibility
-*REMOVED*ExcelReader.Core.Reader.Xlsx.XlsxReader.TryMoveToSheet(System.ReadOnlySpan<char> name) -> bool
-*REMOVED*override ExcelReader.Core.Reader.ExcelSheet.GetHashCode() -> int
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXls(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXls(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsb(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsb(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsbAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsbFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsbFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsx(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsx(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsxAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsxFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.FromXlsxFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow = 1, int sampleSize = 100, bool parseText = false) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-*REMOVED*static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelRowReader! reader, int headerRow, int sampleSize) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelRowReader!
-*REMOVED*static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-*REMOVED*static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelRowReader!>
-*REMOVED*static ExcelReader.Core.Reader.ExcelRowReaderExtensions.Sheets(this ExcelReader.Core.Reader.IExcelRowReader! reader) -> System.Collections.Generic.IEnumerable<ExcelReader.Core.Reader.ExcelSheet>!
-*REMOVED*static ExcelReader.Core.Reader.ExcelSheet.operator !=(ExcelReader.Core.Reader.ExcelSheet left, ExcelReader.Core.Reader.ExcelSheet right) -> bool
-*REMOVED*static ExcelReader.Core.Reader.ExcelSheet.operator ==(ExcelReader.Core.Reader.ExcelSheet left, ExcelReader.Core.Reader.ExcelSheet right) -> bool
-*REMOVED*virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TReader, TRows>.DisposeAsync() -> System.Threading.Tasks.ValueTask
-*REMOVED*~ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.AsyncEnumerator!
-*REMOVED*~ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TReader, TEnumerator>.Enumerator!
-*REMOVED*~override ExcelReader.Core.Reader.ExcelSheet.Equals(object obj) -> bool
-*REMOVED*~override ExcelReader.Core.Reader.ExcelSheet.ToString() -> string
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.Current.get -> T
-ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>
-ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator
-ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Csv.CsvSheet sheet) -> ExcelReader.Core.Parser.CsvEnumerable<T>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.IExcelSheet! sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.IExcelSheet!, ExcelReader.Core.Reader.IExcelRowEnumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xls.XlsSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xls.XlsSheet, ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsb.XlsbSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xlsb.XlsbSheet, ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!>!
-ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsx.XlsxSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T>!
-ExcelReader.Core.Reader.Csv.CsvReader.FirstSheet.get -> ExcelReader.Core.Reader.Csv.CsvSheet
-ExcelReader.Core.Reader.Csv.CsvReader.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Csv.CsvSheet>!
-ExcelReader.Core.Reader.Csv.CsvReader.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Csv.CsvSheet sheet) -> bool
-ExcelReader.Core.Reader.Csv.CsvSheet
-ExcelReader.Core.Reader.Csv.CsvSheet.CsvSheet() -> void
-ExcelReader.Core.Reader.Csv.CsvSheet.Equals(ExcelReader.Core.Reader.Csv.CsvSheet other) -> bool
-ExcelReader.Core.Reader.Csv.CsvSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
-ExcelReader.Core.Reader.Csv.CsvSheet.GetEnumerator() -> ExcelReader.Core.Reader.Csv.CsvReader.Enumerator!
-ExcelReader.Core.Reader.Csv.CsvSheet.Index.get -> int
-ExcelReader.Core.Reader.Csv.CsvSheet.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Csv.CsvSheet.Name.get -> string!
-ExcelReader.Core.Reader.Csv.CsvSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1) -> void
-ExcelReader.Core.Reader.ExcelSheetList<TSheet>
-ExcelReader.Core.Reader.ExcelSheetList<TSheet>.Count.get -> int
-ExcelReader.Core.Reader.ExcelSheetList<TSheet>.GetEnumerator() -> System.ArraySegment<TSheet>.Enumerator
-ExcelReader.Core.Reader.ExcelSheetList<TSheet>.this[int index].get -> TSheet
-ExcelReader.Core.Reader.IExcelSheet
-ExcelReader.Core.Reader.IExcelSheet.Index.get -> int
-ExcelReader.Core.Reader.IExcelSheet.Name.get -> string!
-ExcelReader.Core.Reader.IExcelSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.IExcelSheet<TEnumerator>
-ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> TEnumerator
-ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.GetEnumerator() -> TEnumerator
-ExcelReader.Core.Reader.IExcelSheet<TEnumerator>.IsDate1904.get -> bool
-ExcelReader.Core.Reader.IExcelWorkbook
-ExcelReader.Core.Reader.IExcelWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.IExcelSheet!
-ExcelReader.Core.Reader.IExcelWorkbook.IsDate1904.get -> bool
-ExcelReader.Core.Reader.IExcelWorkbook.SheetAt(int index) -> ExcelReader.Core.Reader.IExcelSheet!
-ExcelReader.Core.Reader.IExcelWorkbook.SheetCount.get -> int
-ExcelReader.Core.Reader.IExcelWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.IExcelSheet! sheet) -> bool
-ExcelReader.Core.Reader.Xls.XlsSheet
-ExcelReader.Core.Reader.Xls.XlsSheet.Equals(ExcelReader.Core.Reader.Xls.XlsSheet other) -> bool
-ExcelReader.Core.Reader.Xls.XlsSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xls.XlsSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xls.XlsSheet.Index.get -> int
-ExcelReader.Core.Reader.Xls.XlsSheet.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xls.XlsSheet.Name.get -> string!
-ExcelReader.Core.Reader.Xls.XlsSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xls.XlsSheet.XlsSheet() -> void
-ExcelReader.Core.Reader.Xls.XlsWorkbook
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Dispose() -> void
-ExcelReader.Core.Reader.Xls.XlsWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.Dispose() -> void
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xls.XlsWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xls.XlsSheet
-ExcelReader.Core.Reader.Xls.XlsWorkbook.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xls.XlsWorkbook.SheetCount.get -> int
-ExcelReader.Core.Reader.Xls.XlsWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xls.XlsSheet>!
-ExcelReader.Core.Reader.Xls.XlsWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xls.XlsSheet sheet) -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbSheet
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.Equals(ExcelReader.Core.Reader.Xlsb.XlsbSheet other) -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.Index.get -> int
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.Name.get -> string!
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsb.XlsbSheet.XlsbSheet() -> void
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Dispose() -> void
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xlsb.XlsbSheet
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.SheetCount.get -> int
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xlsb.XlsbSheet>!
-ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xlsb.XlsbSheet sheet) -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxSheet
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.Equals(ExcelReader.Core.Reader.Xlsx.XlsxSheet other) -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetAsyncEnumerator(System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetEnumerator() -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator!
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.Index.get -> int
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.Name.get -> string!
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.Visibility.get -> ExcelReader.Core.ExcelSheetVisibility
-ExcelReader.Core.Reader.Xlsx.XlsxSheet.XlsxSheet() -> void
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Dispose() -> void
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.DisposeAsync() -> System.Threading.Tasks.ValueTask
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.Current.get -> ExcelReader.Core.Reader.Row
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.MoveNext() -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator.MoveNextAsync() -> System.Threading.Tasks.ValueTask<bool>
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.FirstSheet.get -> ExcelReader.Core.Reader.Xlsx.XlsxSheet
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.IsDate1904.get -> bool
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.SheetCount.get -> int
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Sheets.get -> ExcelReader.Core.Reader.ExcelSheetList<ExcelReader.Core.Reader.Xlsx.XlsxSheet>!
-ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.TryGetSheet(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.Xlsx.XlsxSheet sheet) -> bool
-override ExcelReader.Core.Reader.Csv.CsvSheet.GetHashCode() -> int
-override ExcelReader.Core.Reader.Xls.XlsSheet.GetHashCode() -> int
-override ExcelReader.Core.Reader.Xlsb.XlsbSheet.GetHashCode() -> int
-override ExcelReader.Core.Reader.Xlsx.XlsxSheet.GetHashCode() -> int
-static ExcelReader.Core.Reader.Csv.CsvSheet.operator !=(ExcelReader.Core.Reader.Csv.CsvSheet left, ExcelReader.Core.Reader.Csv.CsvSheet right) -> bool
-static ExcelReader.Core.Reader.Csv.CsvSheet.operator ==(ExcelReader.Core.Reader.Csv.CsvSheet left, ExcelReader.Core.Reader.Csv.CsvSheet right) -> bool
-static ExcelReader.Core.Reader.Excel.FromXls(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXls(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsWorkbook!>
-static ExcelReader.Core.Reader.Excel.FromXlsFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsWorkbook!>
-static ExcelReader.Core.Reader.Excel.FromXlsb(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsb(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsbAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!>
-static ExcelReader.Core.Reader.Excel.FromXlsbFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsbFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsb.XlsbWorkbook!>
-static ExcelReader.Core.Reader.Excel.FromXlsx(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsx(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsxAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
-static ExcelReader.Core.Reader.Excel.FromXlsxFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
-static ExcelReader.Core.Reader.Excel.FromXlsxFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1, int sampleSize = 100, bool parseText = false) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow, int sampleSize) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.Open(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
-static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
-static ExcelReader.Core.Reader.Excel.OpenAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.IExcelWorkbook!>
-static ExcelReader.Core.Reader.Xls.XlsSheet.operator !=(ExcelReader.Core.Reader.Xls.XlsSheet left, ExcelReader.Core.Reader.Xls.XlsSheet right) -> bool
-static ExcelReader.Core.Reader.Xls.XlsSheet.operator ==(ExcelReader.Core.Reader.Xls.XlsSheet left, ExcelReader.Core.Reader.Xls.XlsSheet right) -> bool
-static ExcelReader.Core.Reader.Xlsb.XlsbSheet.operator !=(ExcelReader.Core.Reader.Xlsb.XlsbSheet left, ExcelReader.Core.Reader.Xlsb.XlsbSheet right) -> bool
-static ExcelReader.Core.Reader.Xlsb.XlsbSheet.operator ==(ExcelReader.Core.Reader.Xlsb.XlsbSheet left, ExcelReader.Core.Reader.Xlsb.XlsbSheet right) -> bool
-static ExcelReader.Core.Reader.Xlsx.XlsxSheet.operator !=(ExcelReader.Core.Reader.Xlsx.XlsxSheet left, ExcelReader.Core.Reader.Xlsx.XlsxSheet right) -> bool
-static ExcelReader.Core.Reader.Xlsx.XlsxSheet.operator ==(ExcelReader.Core.Reader.Xlsx.XlsxSheet left, ExcelReader.Core.Reader.Xlsx.XlsxSheet right) -> bool
-virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.DisposeAsync() -> System.Threading.Tasks.ValueTask
-~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator!
-~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator!
-~override ExcelReader.Core.Reader.Csv.CsvSheet.Equals(object obj) -> bool
-~override ExcelReader.Core.Reader.Csv.CsvSheet.ToString() -> string
-~override ExcelReader.Core.Reader.Xls.XlsSheet.Equals(object obj) -> bool
-~override ExcelReader.Core.Reader.Xls.XlsSheet.ToString() -> string
-~override ExcelReader.Core.Reader.Xlsb.XlsbSheet.Equals(object obj) -> bool
-~override ExcelReader.Core.Reader.Xlsb.XlsbSheet.ToString() -> string
-~override ExcelReader.Core.Reader.Xlsx.XlsxSheet.Equals(object obj) -> bool
-~override ExcelReader.Core.Reader.Xlsx.XlsxSheet.ToString() -> string

From d86e4afb91d9960a5399cd3e6647124e22ad0e2a Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 11:27:56 -0300
Subject: [PATCH 002/115] feat(python): enhance Arrow stream handling with GIL
 management and threading support

---
 python/src/excelreader/arrow_stream.py | 80 ++++++++++++++++++++++++--
 python/tests/test_reader.py            | 46 +++++++++++++++
 2 files changed, 120 insertions(+), 6 deletions(-)

diff --git a/python/src/excelreader/arrow_stream.py b/python/src/excelreader/arrow_stream.py
index bd3c0399..71396b0b 100644
--- a/python/src/excelreader/arrow_stream.py
+++ b/python/src/excelreader/arrow_stream.py
@@ -17,7 +17,62 @@
 _capsule_pointer.argtypes = [ctypes.c_void_p, ctypes.c_char_p]
 _capsule_pointer.restype = ctypes.c_void_p
 
-_live: dict[int, _native.ArrowArrayStream] = {}
+_ReadFn = ctypes.CFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_void_p)
+_ErrorFn = ctypes.CFUNCTYPE(ctypes.c_void_p, ctypes.c_void_p)
+_ReleaseFn = ctypes.CFUNCTYPE(None, ctypes.c_void_p)
+
+
+class _Target:
+    """The native stream behind a proxy, with its callbacks re-typed so ctypes releases the GIL."""
+
+    def __init__(self, stream: _native.ArrowArrayStream) -> None:
+        self.stream = stream
+        self.address = ctypes.addressof(stream)
+        self.get_schema = _ReadFn(_address_of(stream.get_schema))
+        self.get_next = _ReadFn(_address_of(stream.get_next))
+        self.get_last_error = _ErrorFn(_address_of(stream.get_last_error))
+
+
+def _address_of(function: object) -> int:
+    return ctypes.cast(function, ctypes.c_void_p).value
+
+
+# A consumer may move the proxy out of the capsule, so callbacks find the native stream through
+# private_data, which travels with the move, never through the address they are called with.
+_streams: dict[int, _Target] = {}
+_proxies: dict[int, _native.ArrowArrayStream] = {}
+
+
+def _target(stream: int) -> _Target:
+    return _streams[_native.ArrowArrayStream.from_address(stream).private_data]
+
+
+@_ReadFn
+def _get_schema(stream: int, out: int) -> int:
+    target = _target(stream)
+    return target.get_schema(target.address, out)
+
+
+@_ReadFn
+def _get_next(stream: int, out: int) -> int:
+    target = _target(stream)
+    return target.get_next(target.address, out)
+
+
+@_ErrorFn
+def _get_last_error(stream: int) -> int | None:
+    target = _target(stream)
+    return target.get_last_error(target.address)
+
+
+def _close(proxy: _native.ArrowArrayStream) -> None:
+    _release(_streams.pop(proxy.private_data).stream)
+    proxy.release = _native._ArrowStreamRelease()
+
+
+@_ReleaseFn
+def _release_proxy(stream: int) -> None:
+    _close(_native.ArrowArrayStream.from_address(stream))
 
 
 def _release(stream: _native.ArrowArrayStream) -> None:
@@ -25,10 +80,22 @@ def _release(stream: _native.ArrowArrayStream) -> None:
         stream.release(ctypes.byref(stream))
 
 
+def _proxy(stream: _native.ArrowArrayStream) -> _native.ArrowArrayStream:
+    target = _Target(stream)
+    _streams[id(target)] = target
+    proxy = _native.ArrowArrayStream()
+    proxy.get_schema = ctypes.cast(_get_schema, _native._ArrowStreamGetSchema)
+    proxy.get_next = ctypes.cast(_get_next, _native._ArrowStreamGetNext)
+    proxy.get_last_error = ctypes.cast(_get_last_error, _native._ArrowStreamGetLastError)
+    proxy.release = ctypes.cast(_release_proxy, _native._ArrowStreamRelease)
+    proxy.private_data = id(target)
+    return proxy
+
+
 def _destroy_capsule(capsule: int) -> None:
-    address = _capsule_pointer(capsule, _CAPSULE_NAME)
-    stream = _live.pop(address)
-    _release(stream)
+    proxy = _proxies.pop(_capsule_pointer(capsule, _CAPSULE_NAME))
+    if proxy.release:
+        _close(proxy)
 
 
 _destroy_capsule_callback = ctypes.CFUNCTYPE(None, ctypes.c_void_p)(_destroy_capsule)
@@ -49,8 +116,9 @@ def __arrow_c_stream__(self, requested_schema: object = None) -> object:
         if self._stream is None:
             raise ExcelReaderError("this Arrow stream was already consumed")
         stream, self._stream = self._stream, None
-        address = ctypes.addressof(stream)
-        _live[address] = stream
+        proxy = _proxy(stream)
+        address = ctypes.addressof(proxy)
+        _proxies[address] = proxy
         return _capsule_new(address, _CAPSULE_NAME, _destroy_capsule_callback)
 
     def __del__(self) -> None:
diff --git a/python/tests/test_reader.py b/python/tests/test_reader.py
index ad3a6476..d08c554c 100644
--- a/python/tests/test_reader.py
+++ b/python/tests/test_reader.py
@@ -1,5 +1,8 @@
+import ctypes
 import gc
 import shutil
+import threading
+import time
 from pathlib import Path
 
 import pytest
@@ -16,6 +19,7 @@
     open_bytes,
     open_workbook,
 )
+from excelreader import _native
 from excelreader import arrow_stream as arrow_stream_module
 from excelreader import reader as reader_module
 
@@ -649,6 +653,48 @@ def test_a_dropped_capsule_releases_the_read(batched_csv, monkeypatch):
         assert released == [True]
 
 
+def test_a_consumer_holding_the_gil_does_not_block_other_threads_while_a_batch_parses(tmp_path):
+    path = tmp_path / "large.csv"
+    rows = 1_000_000
+    path.write_text("name,qty\n" + "".join(f"row{i},{i}\n" for i in range(rows)), encoding="utf-8")
+    ticks = []
+    stop = threading.Event()
+
+    def tick():
+        while not stop.is_set():
+            ticks.append(time.perf_counter())
+
+    with open_workbook(path) as workbook:
+        capsule = workbook.sheets[0].to_arrow_stream(_BATCH_SCHEMA, batch_size=rows).__arrow_c_stream__()
+        capsule_pointer = ctypes.PYFUNCTYPE(ctypes.c_void_p, ctypes.py_object, ctypes.c_char_p)(
+            ("PyCapsule_GetPointer", ctypes.pythonapi)
+        )
+        address = capsule_pointer(capsule, b"arrow_array_stream")
+        stream = _native.ArrowArrayStream.from_address(address)
+        holding_gil = ctypes.PYFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_void_p)
+        get_next = holding_gil(ctypes.cast(stream.get_next, ctypes.c_void_p).value)
+        batch = _native.ArrowArray()
+        ticker = threading.Thread(target=tick)
+        ticker.start()
+        try:
+            start = time.perf_counter()
+            status = get_next(address, ctypes.addressof(batch))
+            end = time.perf_counter()
+        finally:
+            stop.set()
+            ticker.join()
+        release_batch = ctypes.CFUNCTYPE(None, ctypes.c_void_p)(batch.release)
+        release_batch(ctypes.addressof(batch))
+        del capsule
+
+    assert status == 0
+    assert batch.length == rows
+    inside = [start] + [t for t in ticks if start < t < end] + [end]
+    longest_gap = max(b - a for a, b in zip(inside, inside[1:]))
+    assert end - start > 0.05, "the batch must parse long enough for the gap to mean something"
+    assert longest_gap < (end - start) / 2
+
+
 def test_arrow_stream_rejects_a_negative_batch_size(batched_csv):
     with open_workbook(batched_csv) as workbook:
         with pytest.raises(ExcelReaderError):

From 57dc08c87595fe8566b3424899ac85ad7f0aebe7 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:15:51 -0300
Subject: [PATCH 003/115] feat(core): open a workbook from any byte source
 through a seekable view

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Reader/Sources/ByteSource.cs              |   4 +
 .../Reader/Sources/SourceStream.cs            |  99 +++++++++++++
 .../Reader/Sources/CountingSource.cs          |  45 ++++++
 .../Reader/Sources/SourceStreamTests.cs       | 136 ++++++++++++++++++
 4 files changed, 284 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/Sources/SourceStream.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Sources/CountingSource.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Sources/SourceStreamTests.cs

diff --git a/src/ExcelReader.Core/Reader/Sources/ByteSource.cs b/src/ExcelReader.Core/Reader/Sources/ByteSource.cs
index 1801ead6..b92b1e3f 100644
--- a/src/ExcelReader.Core/Reader/Sources/ByteSource.cs
+++ b/src/ExcelReader.Core/Reader/Sources/ByteSource.cs
@@ -114,6 +114,10 @@ internal static async ValueTask<ByteSource> FromStreamAsync(Stream stream, bool
 
         private static bool TryWrapSeekable(Stream stream, bool leaveOpen, [System.Diagnostics.CodeAnalysis.NotNullWhen(true)] out ByteSource? source)
         {
+            if (!leaveOpen && stream is SourceStream view && view.TryTakeSource(out source))
+            {
+                return true;
+            }
             IDisposable? owner = leaveOpen ? null : stream;
             if (stream.GetType() == typeof(MemoryStream) && ((MemoryStream)stream).TryGetBuffer(out ArraySegment<byte> segment))
             {
diff --git a/src/ExcelReader.Core/Reader/Sources/SourceStream.cs b/src/ExcelReader.Core/Reader/Sources/SourceStream.cs
new file mode 100644
index 00000000..99dfb19f
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Sources/SourceStream.cs
@@ -0,0 +1,99 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace ExcelReader.Core.Reader.Sources
+{
+    /// <summary>
+    /// A seekable stream over a whole <see cref="ByteSource"/>. <see cref="ByteSource.FromStream"/> takes the
+    /// source back out, so the paths that open a workbook from a stream read the source positionally.
+    /// </summary>
+    [SuppressMessage("Usage", "CA2213", Justification = "The source is disposed through Interlocked.Exchange so a taken source is not.")]
+    internal sealed class SourceStream(ByteSource source) : Stream
+    {
+        private readonly ByteSource _source = source;
+        private ByteSource? _owned = source;
+        private long _position;
+
+        public override bool CanRead => true;
+
+        public override bool CanSeek => true;
+
+        public override bool CanWrite => false;
+
+        public override long Length => _source.Length;
+
+        public override long Position
+        {
+            get => _position;
+            set
+            {
+                ArgumentOutOfRangeException.ThrowIfNegative(value);
+                _position = value;
+            }
+        }
+
+        internal bool TryTakeSource([NotNullWhen(true)] out ByteSource? taken)
+        {
+            taken = Interlocked.Exchange(ref _owned, null);
+            return taken is not null;
+        }
+
+        public override int Read(Span<byte> buffer)
+        {
+            int read = _source.Read(_position, buffer);
+            _position += read;
+            return read;
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return Read(buffer.AsSpan(offset, count));
+        }
+
+        public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+        {
+            int read = await _source.ReadAsync(_position, buffer, cancellationToken).ConfigureAwait(false);
+            _position += read;
+            return read;
+        }
+
+        public override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+        {
+            return ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            Position = origin switch
+            {
+                SeekOrigin.Begin => offset,
+                SeekOrigin.Current => _position + offset,
+                SeekOrigin.End => _source.Length + offset,
+                _ => throw new ArgumentOutOfRangeException(nameof(origin)),
+            };
+            return _position;
+        }
+
+        public override void Flush()
+        {
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            throw new NotSupportedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing)
+            {
+                Interlocked.Exchange(ref _owned, null)?.Dispose();
+            }
+            base.Dispose(disposing);
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Sources/CountingSource.cs b/tests/ExcelReader.Tests/Reader/Sources/CountingSource.cs
new file mode 100644
index 00000000..920e0dc5
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Sources/CountingSource.cs
@@ -0,0 +1,45 @@
+using ExcelReader.Core.Reader.Sources;
+
+namespace ExcelReader.Tests.Reader.Sources
+{
+    internal sealed class CountingSource(byte[] bytes) : ByteSource
+    {
+        internal int Reads;
+        internal int Disposals;
+        internal int FailReads;
+        internal TimeSpan Delay { get; init; }
+
+        internal override long Length => bytes.Length;
+
+        internal override int Read(long offset, Span<byte> destination)
+        {
+            ArgumentOutOfRangeException.ThrowIfNegative(offset);
+            Interlocked.Increment(ref Reads);
+            if (Delay > TimeSpan.Zero)
+            {
+                Thread.Sleep(Delay);
+            }
+            if (Interlocked.Decrement(ref FailReads) >= 0)
+            {
+                throw new IOException("transient");
+            }
+            if (offset >= bytes.Length)
+            {
+                return 0;
+            }
+            int count = (int)Math.Min(destination.Length, bytes.Length - offset);
+            bytes.AsSpan((int)offset, count).CopyTo(destination);
+            return count;
+        }
+
+        internal override ValueTask<int> ReadAsync(long offset, Memory<byte> destination, CancellationToken ct)
+        {
+            return new ValueTask<int>(Read(offset, destination.Span));
+        }
+
+        public override void Dispose()
+        {
+            Interlocked.Increment(ref Disposals);
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Sources/SourceStreamTests.cs b/tests/ExcelReader.Tests/Reader/Sources/SourceStreamTests.cs
new file mode 100644
index 00000000..0c381951
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Sources/SourceStreamTests.cs
@@ -0,0 +1,136 @@
+using System.Text;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Sources;
+using ExcelReader.Tests.Crypto;
+
+namespace ExcelReader.Tests.Reader.Sources
+{
+    public sealed class SourceStreamTests
+    {
+        public static TheoryData<ConcurrentSheetTests.Format, ExcelFileFormat> Formats => new()
+        {
+            { ConcurrentSheetTests.Format.Xlsx, ExcelFileFormat.Xlsx },
+            { ConcurrentSheetTests.Format.Xlsb, ExcelFileFormat.Xlsb },
+            { ConcurrentSheetTests.Format.Xls, ExcelFileFormat.Xls },
+            { ConcurrentSheetTests.Format.Xlsx, ExcelFileFormat.Unknown },
+            { ConcurrentSheetTests.Format.Xls, ExcelFileFormat.Unknown },
+        };
+
+        public static TheoryData<string> EncryptedNames => new(EncryptedFixtures.All);
+
+        private static List<string> Drain(IExcelSheet sheet)
+        {
+            List<string> lines = [];
+            using IExcelRowEnumerator e = sheet.GetEnumerator();
+            while (e.MoveNext())
+            {
+                StringBuilder line = new();
+                foreach (RowCell cell in e.Current.Cells)
+                {
+                    line.Append(cell.Value.GetString()).Append('|');
+                }
+                lines.Add(line.ToString());
+            }
+            return lines;
+        }
+
+        [Fact]
+        public void FromStream_Unwraps_A_SourceStream_That_Owns_Its_Source()
+        {
+            CountingSource source = new(new byte[100]);
+            using ByteSource unwrapped = ByteSource.FromStream(new SourceStream(source), leaveOpen: false);
+            Assert.Same(source, unwrapped);
+        }
+
+        [Fact]
+        public void FromStream_Does_Not_Unwrap_A_Stream_The_Caller_Keeps()
+        {
+            using SourceStream stream = new(new CountingSource(new byte[100]));
+            using ByteSource wrapped = ByteSource.FromStream(stream, leaveOpen: true);
+            Assert.IsType<StreamByteSource>(wrapped);
+        }
+
+        [Fact]
+        public void A_Taken_Source_Belongs_To_Its_New_Owner()
+        {
+            CountingSource source = new(new byte[100]);
+            SourceStream stream = new(source);
+            ByteSource unwrapped = ByteSource.FromStream(stream, leaveOpen: false);
+            stream.Dispose();
+            Assert.Equal(0, source.Disposals);
+            unwrapped.Dispose();
+            Assert.Equal(1, source.Disposals);
+        }
+
+        [Fact]
+        public void Disposing_A_Stream_Whose_Source_Was_Not_Taken_Disposes_The_Source()
+        {
+            CountingSource source = new(new byte[100]);
+            new SourceStream(source).Dispose();
+            Assert.Equal(1, source.Disposals);
+        }
+
+        [Fact]
+        public void Seek_And_Read_Follow_The_Source()
+        {
+            byte[] bytes = [.. Enumerable.Range(0, 256).Select(i => (byte)i)];
+            using SourceStream stream = new(new CountingSource(bytes));
+            Assert.True(stream.CanSeek);
+            Assert.Equal(256, stream.Length);
+            stream.Seek(-6, SeekOrigin.End);
+            byte[] tail = new byte[10];
+            Assert.Equal(6, stream.Read(tail));
+            Assert.Equal(bytes[250..], tail[..6]);
+            Assert.Equal(256, stream.Position);
+        }
+
+        [Theory]
+        [MemberData(nameof(Formats))]
+        public void Sheets_Opened_Over_A_SourceStream_Read_In_Parallel_What_Memory_Reads(
+            ConcurrentSheetTests.Format format, ExcelFileFormat requested)
+        {
+            byte[] bytes = ConcurrentSheetTests.Build(format);
+            List<string>[] expected;
+            using (IExcelWorkbook reference = Excel.Open(bytes))
+            {
+                expected = [.. Enumerable.Range(0, reference.SheetCount).Select(s => Drain(reference.SheetAt(s)))];
+            }
+
+            CountingSource source = new(bytes);
+            using (IExcelWorkbook workbook = Excel.Open(new SourceStream(source), requested, leaveOpen: false))
+            {
+                List<string>[] parallel = new List<string>[expected.Length * 2];
+                Parallel.For(0, parallel.Length, i => parallel[i] = Drain(workbook.SheetAt(i % expected.Length)));
+                for (int i = 0; i < parallel.Length; i++)
+                {
+                    Assert.Equal(expected[i % expected.Length], parallel[i]);
+                }
+            }
+            Assert.Equal(1, source.Disposals);
+        }
+
+        [Fact]
+        public void A_Csv_Over_A_SourceStream_Reads_More_Than_Once()
+        {
+            byte[] bytes = Encoding.UTF8.GetBytes("a,b,c\n1,2,3\n4,5,6\n");
+            using IExcelWorkbook csv = Excel.Open(new SourceStream(new CountingSource(bytes)), ExcelFileFormat.Csv, leaveOpen: false);
+            Assert.Equal(["a|b|c|", "1|2|3|", "4|5|6|"], Drain(csv.FirstSheet));
+            Assert.Equal(Drain(csv.FirstSheet), Drain(csv.FirstSheet));
+        }
+
+        [Theory]
+        [MemberData(nameof(EncryptedNames))]
+        public void An_Encrypted_Package_Over_A_SourceStream_Opens_With_Its_Password(string name)
+        {
+            ExcelReaderOptions options = new() { Password = EncryptedFixtures.PasswordFor(name) };
+            List<string> expected;
+            using (IExcelWorkbook plain = Excel.Open(EncryptedFixtures.PlainBytes(name)))
+            {
+                expected = Drain(plain.FirstSheet);
+            }
+            using IExcelWorkbook workbook = Excel.Open(
+                new SourceStream(new CountingSource(EncryptedFixtures.Bytes(name))), ExcelFileFormat.Unknown, leaveOpen: false, options);
+            Assert.Equal(expected, Drain(workbook.FirstSheet));
+        }
+    }
+}

From fcb2605b045d7f0fffe6e1a7e18e71d636dfd219 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:21:32 -0300
Subject: [PATCH 004/115] feat(core): cache a byte source in blocks fetched
 once

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Reader/Sources/CachedByteSource.cs        | 115 ++++++++++++++++++
 .../Reader/Sources/CachedByteSourceTests.cs   |  89 ++++++++++++++
 2 files changed, 204 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/Sources/CachedByteSource.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Sources/CachedByteSourceTests.cs

diff --git a/src/ExcelReader.Core/Reader/Sources/CachedByteSource.cs b/src/ExcelReader.Core/Reader/Sources/CachedByteSource.cs
new file mode 100644
index 00000000..a9daa8f9
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Sources/CachedByteSource.cs
@@ -0,0 +1,115 @@
+namespace ExcelReader.Core.Reader.Sources
+{
+    /// <summary>
+    /// Serves reads from blocks of <c>blockSize</c> bytes fetched once from an inner source, keeping the
+    /// most recently used blocks up to <c>capacityBytes</c>.
+    /// </summary>
+    internal sealed class CachedByteSource(ByteSource inner, int blockSize, long capacityBytes) : ByteSource
+    {
+        private readonly int _maxBlocks = (int)Math.Clamp(capacityBytes / blockSize, 1, int.MaxValue);
+        private readonly Dictionary<long, Entry> _blocks = [];
+        private readonly Lock _gate = new();
+        private long _clock;
+        private int _disposed;
+
+        internal override long Length => inner.Length;
+
+        internal override int Read(long offset, Span<byte> destination)
+        {
+            ArgumentOutOfRangeException.ThrowIfNegative(offset);
+            if (offset >= Length || destination.IsEmpty)
+            {
+                return 0;
+            }
+            long index = offset / blockSize;
+            byte[] block = Block(index);
+            int start = (int)(offset - (index * blockSize));
+            int count = Math.Min(destination.Length, block.Length - start);
+            block.AsSpan(start, count).CopyTo(destination);
+            return count;
+        }
+
+        internal override ValueTask<int> ReadAsync(long offset, Memory<byte> destination, CancellationToken ct)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new ValueTask<int>(Read(offset, destination.Span));
+        }
+
+        public override void Dispose()
+        {
+            if (Interlocked.Exchange(ref _disposed, 1) != 0)
+            {
+                return;
+            }
+            lock (_gate)
+            {
+                _blocks.Clear();
+            }
+            inner.Dispose();
+        }
+
+        private byte[] Block(long index)
+        {
+            Entry entry;
+            lock (_gate)
+            {
+                if (!_blocks.TryGetValue(index, out entry!))
+                {
+                    entry = new Entry(new Lazy<byte[]>(() => Fetch(index), LazyThreadSafetyMode.ExecutionAndPublication));
+                    _blocks[index] = entry;
+                    EvictBeyondCapacity(index);
+                }
+                entry.LastUse = ++_clock;
+            }
+            try
+            {
+                return entry.Data.Value;
+            }
+            catch
+            {
+                lock (_gate)
+                {
+                    if (_blocks.TryGetValue(index, out Entry? current) && ReferenceEquals(current, entry))
+                    {
+                        _blocks.Remove(index);
+                    }
+                }
+                throw;
+            }
+        }
+
+        private byte[] Fetch(long index)
+        {
+            long start = index * blockSize;
+            byte[] data = new byte[(int)Math.Min(blockSize, Length - start)];
+            inner.ReadExactly(start, data);
+            return data;
+        }
+
+        // ponytail: linear scan for the oldest block; fine for the default 16 blocks, a linked list if capacities grow.
+        private void EvictBeyondCapacity(long keep)
+        {
+            while (_blocks.Count > _maxBlocks)
+            {
+                long oldest = -1;
+                long oldestUse = long.MaxValue;
+                foreach ((long key, Entry candidate) in _blocks)
+                {
+                    if (key != keep && candidate.LastUse < oldestUse)
+                    {
+                        oldest = key;
+                        oldestUse = candidate.LastUse;
+                    }
+                }
+                _blocks.Remove(oldest);
+            }
+        }
+
+        private sealed class Entry(Lazy<byte[]> data)
+        {
+            internal Lazy<byte[]> Data { get; } = data;
+
+            internal long LastUse;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Sources/CachedByteSourceTests.cs b/tests/ExcelReader.Tests/Reader/Sources/CachedByteSourceTests.cs
new file mode 100644
index 00000000..e8d81494
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Sources/CachedByteSourceTests.cs
@@ -0,0 +1,89 @@
+using ExcelReader.Core.Reader.Sources;
+
+namespace ExcelReader.Tests.Reader.Sources
+{
+    public sealed class CachedByteSourceTests
+    {
+        private static readonly byte[] Payload = [.. Enumerable.Range(0, 10_000).Select(i => (byte)(i * 7))];
+
+        [Fact]
+        public void ReadExactly_Across_Blocks_Returns_The_Inner_Bytes()
+        {
+            using CachedByteSource cache = new(new CountingSource(Payload), blockSize: 1024, capacityBytes: 1 << 20);
+            byte[] read = new byte[3000];
+            cache.ReadExactly(500, read);
+            Assert.Equal(Payload[500..3500], read);
+        }
+
+        [Fact]
+        public void Each_Block_Is_Fetched_Once_While_It_Fits()
+        {
+            CountingSource inner = new(Payload);
+            using CachedByteSource cache = new(inner, blockSize: 1024, capacityBytes: 1 << 20);
+            byte[] chunk = new byte[100];
+            for (int pass = 0; pass < 2; pass++)
+            {
+                for (int offset = 0; offset < Payload.Length; offset += chunk.Length)
+                {
+                    cache.ReadExactly(offset, chunk);
+                }
+            }
+            Assert.Equal(10, inner.Reads);
+        }
+
+        [Fact]
+        public void Concurrent_Readers_Of_One_Block_Fetch_It_Once()
+        {
+            CountingSource inner = new(Payload) { Delay = TimeSpan.FromMilliseconds(50) };
+            using CachedByteSource cache = new(inner, blockSize: 4096, capacityBytes: 1 << 20);
+            Parallel.For(0, 16, _ =>
+            {
+                byte[] read = new byte[64];
+                cache.ReadExactly(0, read);
+            });
+            Assert.Equal(1, inner.Reads);
+        }
+
+        [Fact]
+        public void The_Least_Recently_Used_Block_Is_Evicted_Past_Capacity()
+        {
+            CountingSource inner = new(Payload);
+            using CachedByteSource cache = new(inner, blockSize: 1024, capacityBytes: 2048);
+            byte[] one = new byte[1];
+            foreach (long offset in new long[] { 0, 1024, 2048, 1024, 0 })
+            {
+                cache.ReadExactly(offset, one);
+            }
+            Assert.Equal(4, inner.Reads);
+        }
+
+        [Fact]
+        public void A_Read_At_Or_Past_The_End_Returns_Zero()
+        {
+            using CachedByteSource cache = new(new CountingSource(Payload), blockSize: 1024, capacityBytes: 1 << 20);
+            Assert.Equal(0, cache.Read(Payload.Length, new byte[10]));
+            Assert.Equal(0, cache.Read(Payload.Length + 5, new byte[10]));
+        }
+
+        [Fact]
+        public void A_Failed_Fetch_Is_Tried_Again()
+        {
+            CountingSource inner = new(Payload) { FailReads = 1 };
+            using CachedByteSource cache = new(inner, blockSize: 1024, capacityBytes: 1 << 20);
+            byte[] read = new byte[10];
+            Assert.Throws<IOException>(() => cache.ReadExactly(0, read));
+            cache.ReadExactly(0, read);
+            Assert.Equal(Payload[..10], read);
+        }
+
+        [Fact]
+        public void Dispose_Disposes_The_Inner_Source_Once()
+        {
+            CountingSource inner = new(Payload);
+            CachedByteSource cache = new(inner, blockSize: 1024, capacityBytes: 1 << 20);
+            cache.Dispose();
+            cache.Dispose();
+            Assert.Equal(1, inner.Disposals);
+        }
+    }
+}

From 5574daa78bb9f26eba541fc2f099caa035166ad0 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:27:09 -0300
Subject: [PATCH 005/115] feat(native): add source and buffering options and
 keep accepting the 6.0 options layout

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Native/Exports.Reading.cs     | 10 +--
 src/ExcelReader.Native/NativeOpenOptions.cs   | 35 +++++++-
 src/ExcelReader.Native/include/excelreader.h  | 12 ++-
 .../Native/OpenOptionsLayoutTests.cs          | 90 +++++++++++++++++++
 4 files changed, 139 insertions(+), 8 deletions(-)
 create mode 100644 tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs

diff --git a/src/ExcelReader.Native/Exports.Reading.cs b/src/ExcelReader.Native/Exports.Reading.cs
index 4bb34f11..c8715c42 100644
--- a/src/ExcelReader.Native/Exports.Reading.cs
+++ b/src/ExcelReader.Native/Exports.Reading.cs
@@ -295,19 +295,17 @@ private static bool IsValidOpenRequest(byte* source, int sourceLength, nint* out
 
         private static bool TryReadOpenOptions(NativeOpenOptionsRaw* options, out NativeOpenOptionsRaw? rawOptions)
         {
+            rawOptions = null;
             if (options is null)
             {
-                rawOptions = null;
                 return true;
             }
-            int expectedSize = sizeof(NativeOpenOptionsRaw);
-            if (options->StructSize != expectedSize)
+            if (!NativeOpenOptionsRaw.TryRead(options, out NativeOpenOptionsRaw raw, out string? error))
             {
-                NativeApi.SetLastError($"xl_open_options.struct_size is {options->StructSize}, but this library expects {expectedSize}.");
-                rawOptions = null;
+                NativeApi.SetLastError(error);
                 return false;
             }
-            rawOptions = *options;
+            rawOptions = raw;
             return true;
         }
 
diff --git a/src/ExcelReader.Native/NativeOpenOptions.cs b/src/ExcelReader.Native/NativeOpenOptions.cs
index d15582a8..3dd7b97e 100644
--- a/src/ExcelReader.Native/NativeOpenOptions.cs
+++ b/src/ExcelReader.Native/NativeOpenOptions.cs
@@ -1,3 +1,4 @@
+using System.Diagnostics.CodeAnalysis;
 using System.Numerics;
 using System.Runtime.InteropServices;
 using ExcelReader.Core.Reader;
@@ -69,6 +70,29 @@ internal struct NativeOpenOptionsRaw
 
         public IntPtr Password;
         public int PasswordLen;
+
+        public long SourceCacheBytes;
+        public long MaxBufferedBytes;
+        public int SourceBlockSize;
+
+        internal static readonly int V6Size = (int)Marshal.OffsetOf<NativeOpenOptionsRaw>(nameof(SourceCacheBytes));
+
+        internal static unsafe bool TryRead(NativeOpenOptionsRaw* options, out NativeOpenOptionsRaw raw, [NotNullWhen(false)] out string? error)
+        {
+            raw = default;
+            int size = options->StructSize;
+            if (size != sizeof(NativeOpenOptionsRaw) && size != V6Size)
+            {
+                error = $"xl_open_options.struct_size is {size}, but this library expects {sizeof(NativeOpenOptionsRaw)} (or {V6Size} for the 6.0 layout).";
+                return false;
+            }
+            NativeOpenOptionsRaw copy = default;
+            Buffer.MemoryCopy(options, &copy, sizeof(NativeOpenOptionsRaw), size);
+            copy.StructSize = sizeof(NativeOpenOptionsRaw);
+            raw = copy;
+            error = null;
+            return true;
+        }
     }
 
     internal readonly struct NativeOpenOptions
@@ -93,6 +117,10 @@ internal readonly struct NativeOpenOptions
 
         internal string? Password { get; init; }
 
+        internal int? SourceBlockSize { get; init; }
+        internal long? SourceCacheBytes { get; init; }
+        internal long? MaxBufferedBytes { get; init; }
+
         internal CsvReaderOptions ToCsvReaderOptions()
         {
             CsvReaderOptions options = CsvSniffDialect ? CsvReaderOptions.Default with { SniffDialect = true } : CsvReaderOptions.Default;
@@ -170,7 +198,9 @@ internal static bool TryDecode(NativeOpenOptionsRaw raw, out NativeOpenOptions o
                 || !TryDecodeNonNegative(raw.MaxCellBytes, "max_cell_bytes", out int? maxCellBytes, out error)
                 || !TryDecodeNonNegative(raw.MaxZipEntries, "max_zip_entries", out int? maxZipEntries, out error)
                 || !TryDecodeNonNegative(raw.MaxTotalDecompressedBytes, "max_total_decompressed_bytes", out long? maxTotal, out error)
-                || !TryDecodeNonNegative(raw.MaxSharedStringBytes, "max_shared_string_bytes", out long? maxSharedStrings, out error))
+                || !TryDecodeNonNegative(raw.MaxSharedStringBytes, "max_shared_string_bytes", out long? maxSharedStrings, out error)
+                || !TryDecodeNonNegative(raw.SourceCacheBytes, "source_cache_bytes", out long? sourceCacheBytes, out error)
+                || !TryDecodeNonNegative(raw.MaxBufferedBytes, "max_buffered_bytes", out long? maxBufferedBytes, out error))
             {
                 return false;
             }
@@ -218,6 +248,9 @@ internal static bool TryDecode(NativeOpenOptionsRaw raw, out NativeOpenOptions o
                 PrefetchDecompression = prefetch,
                 InternStrings = internStrings,
                 Password = password,
+                SourceBlockSize = raw.SourceBlockSize == 0 ? null : raw.SourceBlockSize,
+                SourceCacheBytes = sourceCacheBytes,
+                MaxBufferedBytes = maxBufferedBytes,
             };
             return true;
         }
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 2c857eee..81b02098 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -79,10 +79,20 @@ typedef struct xl_open_options {
 
     const uint8_t* password;
     int32_t password_len;
+
+    /* xl_open_source only: bytes of blocks kept in memory. 0 is the default, 64 MiB. */
+    int64_t source_cache_bytes;
+    /* xl_open_stream with XLSX, XLSB or XLS only: the most bytes the stream may hold. 0 is the
+       default, the .NET array limit (about 2 GB). */
+    int64_t max_buffered_bytes;
+    /* xl_open_source only: bytes fetched per read_at call. 0 is the default, 4 MiB; negative turns
+       the cache off, so every read the library makes reaches read_at. */
+    int32_t source_block_size;
 } xl_open_options;
 
 /* options may be NULL for the defaults. When it is not NULL, set options->struct_size to
-   sizeof(xl_open_options) first. xl_open_memory copies data, so the buffer may be released as soon
+   sizeof(xl_open_options) first. The 6.0 layout, which ends at password_len, is still accepted.
+   xl_open_memory copies data, so the buffer may be released as soon
    as the call returns. */
 int32_t xl_open_file(const uint8_t* path, int32_t path_len, int32_t format,
                      const xl_open_options* options, xl_workbook** out_handle);
diff --git a/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs b/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs
new file mode 100644
index 00000000..bcd37ae9
--- /dev/null
+++ b/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs
@@ -0,0 +1,90 @@
+using ExcelReader.Native;
+
+namespace ExcelReader.Tests.Native
+{
+    public sealed unsafe class OpenOptionsLayoutTests
+    {
+        [Fact]
+        public void The_6_0_Layout_Ends_Where_The_New_Fields_Begin()
+        {
+            Assert.Equal(88, NativeOpenOptionsRaw.V6Size);
+            Assert.Equal(112, sizeof(NativeOpenOptionsRaw));
+        }
+
+        [Fact]
+        public void A_6_0_Sized_Struct_Is_Read_As_A_Prefix()
+        {
+            NativeOpenOptionsRaw caller = new()
+            {
+                StructSize = NativeOpenOptionsRaw.V6Size,
+                MaxCellBytes = 1234,
+                SourceCacheBytes = -99,
+                MaxBufferedBytes = -99,
+                SourceBlockSize = -99,
+            };
+            Assert.True(NativeOpenOptionsRaw.TryRead(&caller, out NativeOpenOptionsRaw raw, out string? error), error);
+            Assert.Equal(1234, raw.MaxCellBytes);
+            Assert.Equal(0, raw.SourceCacheBytes);
+            Assert.Equal(0, raw.MaxBufferedBytes);
+            Assert.Equal(0, raw.SourceBlockSize);
+            Assert.Equal(sizeof(NativeOpenOptionsRaw), raw.StructSize);
+        }
+
+        [Fact]
+        public void A_Full_Sized_Struct_Is_Read_Whole()
+        {
+            NativeOpenOptionsRaw caller = new()
+            {
+                StructSize = sizeof(NativeOpenOptionsRaw),
+                SourceCacheBytes = 1 << 20,
+                MaxBufferedBytes = 4096,
+                SourceBlockSize = -1,
+            };
+            Assert.True(NativeOpenOptionsRaw.TryRead(&caller, out NativeOpenOptionsRaw raw, out _));
+            Assert.Equal(1 << 20, raw.SourceCacheBytes);
+            Assert.Equal(4096, raw.MaxBufferedBytes);
+            Assert.Equal(-1, raw.SourceBlockSize);
+        }
+
+        [Theory]
+        [InlineData(0)]
+        [InlineData(1)]
+        [InlineData(87)]
+        [InlineData(113)]
+        public void Any_Other_Size_Is_Rejected(int size)
+        {
+            NativeOpenOptionsRaw caller = new() { StructSize = size };
+            Assert.False(NativeOpenOptionsRaw.TryRead(&caller, out _, out string? error));
+            Assert.Contains("struct_size", error, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void Decoding_Keeps_A_Negative_Block_Size_And_Rejects_Negative_Byte_Counts()
+        {
+            NativeOpenOptionsRaw raw = new()
+            {
+                StructSize = sizeof(NativeOpenOptionsRaw),
+                SourceBlockSize = -1,
+                SourceCacheBytes = 1 << 20,
+                MaxBufferedBytes = 10,
+            };
+            Assert.True(NativeOpenOptions.TryDecode(raw, out NativeOpenOptions options, out string? error), error);
+            Assert.Equal(-1, options.SourceBlockSize);
+            Assert.Equal(1 << 20, options.SourceCacheBytes);
+            Assert.Equal(10, options.MaxBufferedBytes);
+
+            Assert.False(NativeOpenOptions.TryDecode(raw with { SourceCacheBytes = -1 }, out _, out _));
+            Assert.False(NativeOpenOptions.TryDecode(raw with { MaxBufferedBytes = -1 }, out _, out _));
+        }
+
+        [Fact]
+        public void Zero_Leaves_Every_New_Field_At_Its_Default()
+        {
+            NativeOpenOptionsRaw raw = new() { StructSize = sizeof(NativeOpenOptionsRaw) };
+            Assert.True(NativeOpenOptions.TryDecode(raw, out NativeOpenOptions options, out _));
+            Assert.Null(options.SourceBlockSize);
+            Assert.Null(options.SourceCacheBytes);
+            Assert.Null(options.MaxBufferedBytes);
+        }
+    }
+}

From d46ec618602003e8781d11b64862b4ece34865ba Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:30:26 -0300
Subject: [PATCH 006/115] fix(native): make the 6.0 options size a constant and
 document it

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Native/NativeOpenOptions.cs              | 2 +-
 src/ExcelReader.Native/README.md                         | 5 +++--
 tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs | 1 +
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/ExcelReader.Native/NativeOpenOptions.cs b/src/ExcelReader.Native/NativeOpenOptions.cs
index 3dd7b97e..bf7e0d8c 100644
--- a/src/ExcelReader.Native/NativeOpenOptions.cs
+++ b/src/ExcelReader.Native/NativeOpenOptions.cs
@@ -75,7 +75,7 @@ internal struct NativeOpenOptionsRaw
         public long MaxBufferedBytes;
         public int SourceBlockSize;
 
-        internal static readonly int V6Size = (int)Marshal.OffsetOf<NativeOpenOptionsRaw>(nameof(SourceCacheBytes));
+        internal const int V6Size = 88;
 
         internal static unsafe bool TryRead(NativeOpenOptionsRaw* options, out NativeOpenOptionsRaw raw, [NotNullWhen(false)] out string? error)
         {
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index e9cfa05c..fb8a4b7d 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -133,8 +133,9 @@ if (status == XL_STATUS_PASSWORD_REQUIRED || status == XL_STATUS_PASSWORD_INCORR
 
 This is why `XL_ABI_VERSION` moved from 3 to 4: `password`/`password_len` are new fields at the end
 of `xl_open_options`, so a caller built against the old, smaller struct passes the old, smaller
-`sizeof(xl_open_options)` as `struct_size` — the mismatch is rejected outright with
-`XL_INVALID_ARGUMENT` instead of the library reading two garbage fields past the end of the caller's
+`sizeof(xl_open_options)` as `struct_size` — any size other than the current one is rejected outright with
+`XL_INVALID_ARGUMENT` (the 6.0 size, 88 bytes, is the one exception: it is also accepted, read as a prefix
+with the newer fields defaulted) instead of the library reading two garbage fields past the end of the caller's
 allocation. Check `xl_abi_version()` against `XL_ABI_VERSION` (see above) and rebuild against the
 current header rather than only relying on the `struct_size` check to catch it.
 
diff --git a/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs b/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs
index bcd37ae9..e3e690fd 100644
--- a/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs
+++ b/tests/ExcelReader.Tests/Native/OpenOptionsLayoutTests.cs
@@ -8,6 +8,7 @@ public sealed unsafe class OpenOptionsLayoutTests
         public void The_6_0_Layout_Ends_Where_The_New_Fields_Begin()
         {
             Assert.Equal(88, NativeOpenOptionsRaw.V6Size);
+            Assert.Equal(NativeOpenOptionsRaw.V6Size, (int)System.Runtime.InteropServices.Marshal.OffsetOf<NativeOpenOptionsRaw>(nameof(NativeOpenOptionsRaw.SourceCacheBytes)));
             Assert.Equal(112, sizeof(NativeOpenOptionsRaw));
         }
 

From 6bc46a04703075dcd21c414f0333f600eb24b229 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:39:51 -0300
Subject: [PATCH 007/115] feat(native): open a workbook over a source the
 caller serves

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 rust/excelreader/excelreader.def              |   2 +
 src/ExcelReader.Native/Exports.Reading.cs     |  29 ++
 .../Reading/CallbackByteSource.cs             |  77 +++++
 .../Reading/NativeSourceRaw.cs                |  23 ++
 .../Reading/ReadApi.Sources.cs                |  55 ++++
 .../Reading/SourceErrors.cs                   |  28 ++
 .../include/excelreader.def                   |   2 +
 src/ExcelReader.Native/include/excelreader.h  |  25 ++
 .../Native/CallbackSourceTests.cs             | 301 ++++++++++++++++++
 9 files changed, 542 insertions(+)
 create mode 100644 src/ExcelReader.Native/Reading/CallbackByteSource.cs
 create mode 100644 src/ExcelReader.Native/Reading/NativeSourceRaw.cs
 create mode 100644 src/ExcelReader.Native/Reading/ReadApi.Sources.cs
 create mode 100644 src/ExcelReader.Native/Reading/SourceErrors.cs
 create mode 100644 tests/ExcelReader.Tests/Native/CallbackSourceTests.cs

diff --git a/rust/excelreader/excelreader.def b/rust/excelreader/excelreader.def
index 29729e2d..7b2dccdf 100644
--- a/rust/excelreader/excelreader.def
+++ b/rust/excelreader/excelreader.def
@@ -2,6 +2,8 @@ EXPORTS
     xl_abi_version
     xl_open_file
     xl_open_memory
+    xl_open_source
+    xl_set_source_error
     xl_close
     xl_sheet_count
     xl_sheet_name_at
diff --git a/src/ExcelReader.Native/Exports.Reading.cs b/src/ExcelReader.Native/Exports.Reading.cs
index c8715c42..09690c20 100644
--- a/src/ExcelReader.Native/Exports.Reading.cs
+++ b/src/ExcelReader.Native/Exports.Reading.cs
@@ -1,4 +1,5 @@
 using System.Runtime.InteropServices;
+using System.Text;
 using ExcelReader.Native.Reading;
 
 namespace ExcelReader.Native
@@ -49,6 +50,34 @@ public static int OpenMemory(byte* data, int dataLength, int format, NativeOpenO
             return RegisterOpened(status, handle, outHandle);
         }
 
+        [UnmanagedCallersOnly(EntryPoint = "xl_open_source")]
+        public static int OpenSource(NativeSourceRaw* source, int format, NativeOpenOptionsRaw* options, nint* outHandle)
+        {
+            NativeApi.ClearLastError();
+            if (outHandle is not null)
+            {
+                *outHandle = 0;
+            }
+            if (!CallbackByteSource.TryCreate(source, outHandle is not null, out CallbackByteSource? callback, out string? error))
+            {
+                NativeApi.SetLastError(error);
+                return NativeStatus.InvalidArgument;
+            }
+            if (!TryReadOpenOptions(options, out NativeOpenOptionsRaw? rawOptions))
+            {
+                callback.Dispose();
+                return NativeStatus.InvalidArgument;
+            }
+            int status = ReadApi.OpenSource(callback, format, rawOptions, out NativeHandle? handle);
+            return RegisterOpened(status, handle, outHandle);
+        }
+
+        [UnmanagedCallersOnly(EntryPoint = "xl_set_source_error")]
+        public static void SetSourceError(byte* message, int length)
+        {
+            SourceErrors.Set(message is null || length <= 0 ? null : Encoding.UTF8.GetString(message, length));
+        }
+
         [UnmanagedCallersOnly(EntryPoint = "xl_close")]
         public static int Close(nint handle)
         {
diff --git a/src/ExcelReader.Native/Reading/CallbackByteSource.cs b/src/ExcelReader.Native/Reading/CallbackByteSource.cs
new file mode 100644
index 00000000..2ddc3382
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/CallbackByteSource.cs
@@ -0,0 +1,77 @@
+using System.Diagnostics.CodeAnalysis;
+using ExcelReader.Core.Reader.Sources;
+
+namespace ExcelReader.Native.Reading
+{
+    internal sealed unsafe class CallbackByteSource : ByteSource
+    {
+        private readonly delegate* unmanaged<void*, long, byte*, long, long> _readAt;
+        private readonly delegate* unmanaged<void*, void> _release;
+        private readonly void* _userData;
+        private int _released;
+
+        private CallbackByteSource(in NativeSourceRaw raw)
+        {
+            _readAt = raw.ReadAt;
+            _release = raw.Release;
+            _userData = raw.UserData;
+            Length = raw.Length;
+        }
+
+        internal override long Length { get; }
+
+        internal static bool TryCreate(
+            NativeSourceRaw* raw, bool hasOutHandle, [NotNullWhen(true)] out CallbackByteSource? source, [NotNullWhen(false)] out string? error)
+        {
+            source = null;
+            if (raw is null || !hasOutHandle || raw->StructSize != sizeof(NativeSourceRaw) || raw->ReadAt is null || raw->Length < 0)
+            {
+                error = "xl_open_source needs a non-NULL source whose struct_size is sizeof(xl_source), whose read_at is set and whose length is 0 or more, and a non-NULL out_handle.";
+                return false;
+            }
+            error = null;
+            source = new CallbackByteSource(*raw);
+            return true;
+        }
+
+        internal override int Read(long offset, Span<byte> destination)
+        {
+            ArgumentOutOfRangeException.ThrowIfNegative(offset);
+            ObjectDisposedException.ThrowIf(Volatile.Read(ref _released) != 0, this);
+            if (offset >= Length || destination.IsEmpty)
+            {
+                return 0;
+            }
+            int requested = (int)Math.Min(destination.Length, Length - offset);
+            SourceErrors.Clear();
+            long got;
+            fixed (byte* buffer = destination)
+            {
+                got = _readAt(_userData, offset, buffer, requested);
+            }
+            if (got < 0 || got > requested)
+            {
+                throw SourceErrors.Failed($"xl_source.read_at at offset {offset}", got, requested);
+            }
+            if (got == 0)
+            {
+                throw new IOException($"The source ended at offset {offset}, before its declared length of {Length} bytes.");
+            }
+            return (int)got;
+        }
+
+        internal override ValueTask<int> ReadAsync(long offset, Memory<byte> destination, CancellationToken ct)
+        {
+            ct.ThrowIfCancellationRequested();
+            return new ValueTask<int>(Read(offset, destination.Span));
+        }
+
+        public override void Dispose()
+        {
+            if (Interlocked.Exchange(ref _released, 1) == 0 && _release is not null)
+            {
+                _release(_userData);
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/Reading/NativeSourceRaw.cs b/src/ExcelReader.Native/Reading/NativeSourceRaw.cs
new file mode 100644
index 00000000..42cd707e
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/NativeSourceRaw.cs
@@ -0,0 +1,23 @@
+using System.Runtime.InteropServices;
+
+namespace ExcelReader.Native.Reading
+{
+    [StructLayout(LayoutKind.Sequential)]
+    internal unsafe struct NativeSourceRaw
+    {
+        public int StructSize;
+        public void* UserData;
+        public long Length;
+        public delegate* unmanaged<void*, long, byte*, long, long> ReadAt;
+        public delegate* unmanaged<void*, void> Release;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    internal unsafe struct NativeStreamRaw
+    {
+        public int StructSize;
+        public void* UserData;
+        public delegate* unmanaged<void*, byte*, long, long> Read;
+        public delegate* unmanaged<void*, void> Release;
+    }
+}
diff --git a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
new file mode 100644
index 00000000..3b65e277
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
@@ -0,0 +1,55 @@
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Sources;
+
+namespace ExcelReader.Native.Reading
+{
+    internal static partial class ReadApi
+    {
+        private const int DefaultSourceBlockSize = 4 * 1024 * 1024;
+        private const long DefaultSourceCacheBytes = 64L * 1024 * 1024;
+
+        internal static int OpenSource(ByteSource callback, int format, NativeOpenOptionsRaw? rawOptions, out NativeHandle? handle)
+        {
+            handle = null;
+            bool opened = false;
+            try
+            {
+                if (!TryDecodeOpenOptions(rawOptions, out NativeOpenOptions? decoded, out string? error))
+                {
+                    NativeApi.SetLastError(error!);
+                    return NativeStatus.InvalidArgument;
+                }
+                if (!IsKnownFormat(format))
+                {
+                    NativeApi.SetLastError($"format must be one of the XL_FORMAT_* values; got {format}.");
+                    return NativeStatus.InvalidArgument;
+                }
+                NativeOpenOptions options = decoded ?? default;
+                int blockSize = options.SourceBlockSize ?? DefaultSourceBlockSize;
+                ByteSource source = blockSize < 0
+                    ? callback
+                    : new CachedByteSource(callback, blockSize, options.SourceCacheBytes ?? DefaultSourceCacheBytes);
+                IExcelWorkbook workbook = Excel.Open(new SourceStream(source), MapFormat(format), leaveOpen: false, options.ToExcelReaderOptions());
+                handle = new NativeHandle(workbook);
+                opened = true;
+                return NativeStatus.Ok;
+            }
+            catch (ExcelEncryptionException ex)
+            {
+                return MapEncryptionException(ex);
+            }
+            catch (Exception exception)
+            {
+                NativeApi.SetLastError(exception.Message);
+                return NativeStatus.Error;
+            }
+            finally
+            {
+                if (!opened)
+                {
+                    callback.Dispose();
+                }
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/Reading/SourceErrors.cs b/src/ExcelReader.Native/Reading/SourceErrors.cs
new file mode 100644
index 00000000..65d75ae7
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/SourceErrors.cs
@@ -0,0 +1,28 @@
+namespace ExcelReader.Native.Reading
+{
+    /// <summary>The message a source callback leaves through xl_set_source_error before returning -1.</summary>
+    internal static class SourceErrors
+    {
+        [ThreadStatic]
+        private static string? _pending;
+
+        internal static void Set(string? message)
+        {
+            _pending = string.IsNullOrEmpty(message) ? null : message;
+        }
+
+        internal static void Clear()
+        {
+            _pending = null;
+        }
+
+        internal static IOException Failed(string where, long got, long requested)
+        {
+            string? message = _pending;
+            _pending = null;
+            return got == -1
+                ? new IOException(message ?? $"{where} failed.")
+                : new IOException($"{where} returned {got} for a request of {requested} bytes; expected 0 to {requested}, or -1 on failure.");
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/include/excelreader.def b/src/ExcelReader.Native/include/excelreader.def
index 29729e2d..7b2dccdf 100644
--- a/src/ExcelReader.Native/include/excelreader.def
+++ b/src/ExcelReader.Native/include/excelreader.def
@@ -2,6 +2,8 @@ EXPORTS
     xl_abi_version
     xl_open_file
     xl_open_memory
+    xl_open_source
+    xl_set_source_error
     xl_close
     xl_sheet_count
     xl_sheet_name_at
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 81b02098..895fa8a2 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -100,6 +100,31 @@ int32_t xl_open_file(const uint8_t* path, int32_t path_len, int32_t format,
 int32_t xl_open_memory(const uint8_t* data, int32_t data_len, int32_t format,
                        const xl_open_options* options, xl_workbook** out_handle);
 
+/* Random-access bytes for xl_open_source. */
+typedef struct xl_source {
+    int32_t struct_size;     /* sizeof(xl_source) */
+    void* user_data;
+    int64_t length;          /* total size in bytes */
+    /* Copy up to len bytes starting at offset into buf. Return the bytes copied, or -1 on failure
+       after calling xl_set_source_error. Returning 0 before length is a failure ("the source ended
+       early"). Called from any thread, concurrently. */
+    int64_t (*read_at)(void* user_data, int64_t offset, uint8_t* buf, int64_t len);
+    /* May be NULL. Called exactly once, when nothing opened from the workbook needs the source. */
+    void (*release)(void* user_data);
+} xl_source;
+
+/* Opens a workbook over a source the caller serves. Every sheet can be read in parallel. A valid
+   source is released exactly once, whether the open succeeds or fails; a NULL source, a wrong
+   struct_size, a NULL read_at, a negative length or a NULL out_handle returns XL_INVALID_ARGUMENT
+   and the source is not released. With the default options, reads reach read_at in 4 MiB blocks
+   kept in a 64 MiB cache. */
+int32_t xl_open_source(const xl_source* source, int32_t format,
+                       const xl_open_options* options, xl_workbook** out_handle);
+
+/* Callable only from inside read_at or read: the message xl_last_error reports when the callback
+   then returns -1. Inside a callback, no other xl_ function may be called. */
+void xl_set_source_error(const uint8_t* message, int32_t len);
+
 /* Cursors, typed readers and Arrow streams opened from this handle keep working after xl_close; the
    workbook's resources are released when the last of them is closed. Any later call that takes this
    handle returns XL_INVALID_HANDLE. */
diff --git a/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs b/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs
new file mode 100644
index 00000000..01b84fa2
--- /dev/null
+++ b/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs
@@ -0,0 +1,301 @@
+using System.Globalization;
+using System.Runtime.InteropServices;
+using System.Text;
+using ExcelReader.Core.Writer.Xlsx;
+using ExcelReader.Native;
+using ExcelReader.Native.Reading;
+using ExcelReader.Tests.Reader;
+
+namespace ExcelReader.Tests.Native
+{
+    public sealed unsafe class CallbackSourceTests
+    {
+        internal sealed class TestSource(byte[] bytes)
+        {
+            internal readonly byte[] Bytes = bytes;
+            internal int Reads;
+            internal int Releases;
+            internal string? Error;
+            internal long ShortAt = -1;
+            internal int FailOffThread;
+        }
+
+        private sealed class Pinned(TestSource source) : IDisposable
+        {
+            private GCHandle _handle = GCHandle.Alloc(source);
+
+            internal NativeSourceRaw Raw(long? length = null) => new()
+            {
+                StructSize = sizeof(NativeSourceRaw),
+                UserData = (void*)GCHandle.ToIntPtr(_handle),
+                Length = length ?? source.Bytes.Length,
+                ReadAt = &ReadAt,
+                Release = &Release,
+            };
+
+            public void Dispose()
+            {
+                _handle.Free();
+            }
+        }
+
+        [UnmanagedCallersOnly]
+        private static long ReadAt(void* userData, long offset, byte* buffer, long length)
+        {
+            TestSource source = (TestSource)GCHandle.FromIntPtr((nint)userData).Target!;
+            Interlocked.Increment(ref source.Reads);
+            if (source.Error is string message && Environment.CurrentManagedThreadId != source.FailOffThread)
+            {
+                SourceErrors.Set(message);
+                return -1;
+            }
+            if (source.ShortAt >= 0 && offset >= source.ShortAt)
+            {
+                return 0;
+            }
+            long count = Math.Min(length, source.Bytes.Length - offset);
+            source.Bytes.AsSpan((int)offset, (int)count).CopyTo(new Span<byte>(buffer, (int)count));
+            return count;
+        }
+
+        [UnmanagedCallersOnly]
+        private static void Release(void* userData)
+        {
+            TestSource source = (TestSource)GCHandle.FromIntPtr((nint)userData).Target!;
+            Interlocked.Increment(ref source.Releases);
+        }
+
+        private static int Open(Pinned pinned, int format, out NativeHandle? handle, NativeOpenOptionsRaw? options = null, long? length = null)
+        {
+            NativeSourceRaw raw = pinned.Raw(length);
+            Assert.True(CallbackByteSource.TryCreate(&raw, hasOutHandle: true, out CallbackByteSource? source, out string? error), error);
+            return ReadApi.OpenSource(source!, format, options, out handle);
+        }
+
+        private static NativeOpenOptionsRaw Options() => new() { StructSize = sizeof(NativeOpenOptionsRaw) };
+
+        // Prefetch only engages on sheets of 256 KiB or more uncompressed; the ConcurrentSheetTests sheets are smaller.
+        private static byte[] BuildPrefetchedXlsx()
+        {
+            using MemoryStream buffer = new();
+            using (XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(buffer, leaveOpen: true))
+            {
+                XlsxSheetWriter sheet = workbook.AddSheet("big");
+                for (int r = 0; r < 20_000; r++)
+                {
+                    using XlsxRowWriter row = sheet.StartRow();
+                    row.Write("row-" + r.ToString(CultureInfo.InvariantCulture));
+                    row.Write(r);
+                }
+                sheet.End();
+                sheet.Dispose();
+                workbook.End();
+            }
+            return buffer.ToArray();
+        }
+
+        private static List<string> ReadSheet(NativeHandle handle, int sheet)
+        {
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenRows(handle, sheet, out NativeRowCursor? opened));
+            using NativeRowCursor cursor = opened!;
+            List<string> lines = [];
+            while (true)
+            {
+                int status = ReadApi.NextRowView(cursor, out NativeRow row);
+                if (status == NativeStatus.Eof)
+                {
+                    return lines;
+                }
+                Assert.Equal(NativeStatus.Ok, status);
+                StringBuilder line = new();
+                int cellSize = Marshal.SizeOf<NativeRowCell>();
+                for (int i = 0; i < row.CellCount; i++)
+                {
+                    NativeRowCell cell = Marshal.PtrToStructure<NativeRowCell>(IntPtr.Add(row.Cells, i * cellSize));
+                    line.Append(Marshal.PtrToStringUTF8(cell.Value, cell.ValueLength)).Append('|');
+                }
+                lines.Add(line.ToString());
+            }
+        }
+
+        [Theory]
+        [InlineData(ConcurrentSheetTests.Format.Xlsx, NativeFormat.Xlsx)]
+        [InlineData(ConcurrentSheetTests.Format.Xlsb, NativeFormat.Xlsb)]
+        [InlineData(ConcurrentSheetTests.Format.Xls, NativeFormat.Xls)]
+        [InlineData(ConcurrentSheetTests.Format.Xlsx, NativeFormat.Auto)]
+        public void Every_Sheet_Read_In_Parallel_Matches_The_Memory_Read(ConcurrentSheetTests.Format format, int nativeFormat)
+        {
+            byte[] bytes = ConcurrentSheetTests.Build(format);
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenMemory(bytes, nativeFormat, out NativeHandle? memory));
+            List<string>[] expected;
+            using (memory)
+            {
+                expected = [.. Enumerable.Range(0, ConcurrentSheetTests.Sheets).Select(s => ReadSheet(memory!, s))];
+            }
+
+            TestSource test = new(bytes);
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, nativeFormat, out NativeHandle? handle));
+            using (NativeHandle live = handle!)
+            {
+                List<string>[] parallel = new List<string>[expected.Length * 2];
+                Parallel.For(0, parallel.Length, i => parallel[i] = ReadSheet(live, i % expected.Length));
+                for (int i = 0; i < parallel.Length; i++)
+                {
+                    Assert.Equal(expected[i % expected.Length], parallel[i]);
+                }
+            }
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void A_Csv_Is_Read_Through_The_Source()
+        {
+            TestSource test = new(Encoding.UTF8.GetBytes("a,b\n1,2\n"));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Csv, out NativeHandle? handle));
+            using (handle)
+            {
+                Assert.Equal(["a|b|", "1|2|"], ReadSheet(handle!, 0));
+            }
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void The_Source_Is_Released_Only_When_The_Last_Cursor_Closes_After_The_Workbook()
+        {
+            TestSource test = new(ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Xlsx, out NativeHandle? handle));
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenRows(handle, 0, out NativeRowCursor? cursor));
+            Assert.Equal(NativeStatus.Ok, ReadApi.Close(handle));
+            Assert.Equal(0, test.Releases);
+            cursor!.Dispose();
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void A_Failed_Open_Releases_The_Source_Once()
+        {
+            TestSource test = new(Encoding.UTF8.GetBytes("not a workbook at all"));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Auto, out NativeHandle? handle));
+            Assert.Null(handle);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void An_Empty_Source_Fails_With_The_Format_Message_And_Is_Released()
+        {
+            TestSource test = new([]);
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Auto, out _));
+            Assert.Contains("Unrecognized file format", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void Invalid_Options_Release_The_Source_Once()
+        {
+            TestSource test = new(ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx));
+            using Pinned pinned = new(test);
+            NativeOpenOptionsRaw options = Options() with { MaxBufferedBytes = -1 };
+            Assert.Equal(NativeStatus.InvalidArgument, Open(pinned, NativeFormat.Xlsx, out _, options));
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void The_Callback_Message_Reaches_The_Caller()
+        {
+            TestSource test = new(ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx)) { Error = "disk on fire" };
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Xlsx, out _));
+            Assert.Contains("disk on fire", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void The_Callback_Message_Reaches_The_Caller_When_Prefetch_Reads_On_Another_Thread()
+        {
+            byte[] bytes = BuildPrefetchedXlsx();
+            TestSource test = new(bytes);
+            using Pinned pinned = new(test);
+            NativeOpenOptionsRaw options = Options() with { PrefetchDecompression = 2, SourceBlockSize = -1 };
+            Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Xlsx, out NativeHandle? handle, options));
+            using (handle)
+            {
+                test.FailOffThread = Environment.CurrentManagedThreadId;
+                test.Error = "disk on fire";
+                Assert.Equal(NativeStatus.Ok, ReadApi.OpenRows(handle, 0, out NativeRowCursor? opened));
+                using NativeRowCursor cursor = opened!;
+                int status;
+                do
+                {
+                    status = ReadApi.NextRowView(cursor, out _);
+                }
+                while (status == NativeStatus.Ok);
+                Assert.Equal(NativeStatus.Error, status);
+                Assert.Contains("disk on fire", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            }
+        }
+
+        [Fact]
+        public void A_Source_That_Ends_Early_Fails_Instead_Of_Looping()
+        {
+            byte[] bytes = ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx);
+            TestSource test = new(bytes) { ShortAt = bytes.Length / 2 };
+            using Pinned pinned = new(test);
+            NativeOpenOptionsRaw options = Options() with { SourceBlockSize = -1 };
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Xlsx, out _, options));
+            Assert.Contains("ended at offset", NativeApi.LastErrorText(), StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void The_Default_Cache_Fetches_Each_Block_Once()
+        {
+            byte[] bytes = ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx);
+            long blocks = (bytes.Length + (4L * 1024 * 1024) - 1) / (4L * 1024 * 1024);
+
+            TestSource cached = new(bytes);
+            using (Pinned pinned = new(cached))
+            {
+                Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Xlsx, out NativeHandle? handle));
+                using (handle)
+                {
+                    ReadSheet(handle!, 0);
+                }
+            }
+            Assert.True(cached.Reads <= blocks, $"{cached.Reads} reads for {blocks} blocks");
+
+            TestSource uncached = new(bytes);
+            using (Pinned pinned = new(uncached))
+            {
+                Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Xlsx, out NativeHandle? handle, Options() with { SourceBlockSize = -1 }));
+                using (handle)
+                {
+                    ReadSheet(handle!, 0);
+                }
+            }
+            Assert.True(uncached.Reads > blocks, $"{uncached.Reads} reads without the cache");
+        }
+
+        [Fact]
+        public void Invalid_Source_Structs_Are_Rejected_Without_Taking_Ownership()
+        {
+            TestSource test = new([1, 2, 3]);
+            using Pinned pinned = new(test);
+            NativeSourceRaw good = pinned.Raw();
+            NativeSourceRaw wrongSize = good with { StructSize = 8 };
+            NativeSourceRaw noRead = good with { ReadAt = null };
+            NativeSourceRaw negative = good with { Length = -1 };
+
+            Assert.False(CallbackByteSource.TryCreate(null, true, out _, out _));
+            Assert.False(CallbackByteSource.TryCreate(&good, false, out _, out _));
+            Assert.False(CallbackByteSource.TryCreate(&wrongSize, true, out _, out _));
+            Assert.False(CallbackByteSource.TryCreate(&noRead, true, out _, out _));
+            Assert.False(CallbackByteSource.TryCreate(&negative, true, out _, out string? error));
+            Assert.Contains("xl_open_source", error, StringComparison.Ordinal);
+            Assert.Equal(0, test.Releases);
+        }
+    }
+}

From 0e20232cde1eeb9121cf35c8026c8aa79973f928 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:46:13 -0300
Subject: [PATCH 008/115] feat(native): open a workbook over a stream that
 cannot seek

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 rust/excelreader/excelreader.def              |   1 +
 src/ExcelReader.Native/Exports.Reading.cs     |  22 +++
 .../Reading/CallbackReadStream.cs             | 100 +++++++++++
 .../Reading/ReadApi.Sources.cs                |  51 ++++++
 .../Reading/StreamBuffer.cs                   |  32 ++++
 .../include/excelreader.def                   |   1 +
 src/ExcelReader.Native/include/excelreader.h  |  19 ++
 .../Native/CallbackStreamTests.cs             | 162 ++++++++++++++++++
 8 files changed, 388 insertions(+)
 create mode 100644 src/ExcelReader.Native/Reading/CallbackReadStream.cs
 create mode 100644 src/ExcelReader.Native/Reading/StreamBuffer.cs
 create mode 100644 tests/ExcelReader.Tests/Native/CallbackStreamTests.cs

diff --git a/rust/excelreader/excelreader.def b/rust/excelreader/excelreader.def
index 7b2dccdf..6bd570d3 100644
--- a/rust/excelreader/excelreader.def
+++ b/rust/excelreader/excelreader.def
@@ -3,6 +3,7 @@ EXPORTS
     xl_open_file
     xl_open_memory
     xl_open_source
+    xl_open_stream
     xl_set_source_error
     xl_close
     xl_sheet_count
diff --git a/src/ExcelReader.Native/Exports.Reading.cs b/src/ExcelReader.Native/Exports.Reading.cs
index 09690c20..0373f9c7 100644
--- a/src/ExcelReader.Native/Exports.Reading.cs
+++ b/src/ExcelReader.Native/Exports.Reading.cs
@@ -72,6 +72,28 @@ public static int OpenSource(NativeSourceRaw* source, int format, NativeOpenOpti
             return RegisterOpened(status, handle, outHandle);
         }
 
+        [UnmanagedCallersOnly(EntryPoint = "xl_open_stream")]
+        public static int OpenStream(NativeStreamRaw* stream, int format, NativeOpenOptionsRaw* options, nint* outHandle)
+        {
+            NativeApi.ClearLastError();
+            if (outHandle is not null)
+            {
+                *outHandle = 0;
+            }
+            if (!CallbackReadStream.TryCreate(stream, outHandle is not null, out CallbackReadStream? callback, out string? error))
+            {
+                NativeApi.SetLastError(error);
+                return NativeStatus.InvalidArgument;
+            }
+            if (!TryReadOpenOptions(options, out NativeOpenOptionsRaw? rawOptions))
+            {
+                callback.Dispose();
+                return NativeStatus.InvalidArgument;
+            }
+            int status = ReadApi.OpenStream(callback, format, rawOptions, out NativeHandle? handle);
+            return RegisterOpened(status, handle, outHandle);
+        }
+
         [UnmanagedCallersOnly(EntryPoint = "xl_set_source_error")]
         public static void SetSourceError(byte* message, int length)
         {
diff --git a/src/ExcelReader.Native/Reading/CallbackReadStream.cs b/src/ExcelReader.Native/Reading/CallbackReadStream.cs
new file mode 100644
index 00000000..10f3d6d4
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/CallbackReadStream.cs
@@ -0,0 +1,100 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace ExcelReader.Native.Reading
+{
+    internal sealed unsafe class CallbackReadStream : Stream
+    {
+        private readonly delegate* unmanaged<void*, byte*, long, long> _read;
+        private readonly delegate* unmanaged<void*, void> _release;
+        private readonly void* _userData;
+        private int _released;
+
+        private CallbackReadStream(in NativeStreamRaw raw)
+        {
+            _read = raw.Read;
+            _release = raw.Release;
+            _userData = raw.UserData;
+        }
+
+        internal static bool TryCreate(
+            NativeStreamRaw* raw, bool hasOutHandle, [NotNullWhen(true)] out CallbackReadStream? stream, [NotNullWhen(false)] out string? error)
+        {
+            stream = null;
+            if (raw is null || !hasOutHandle || raw->StructSize != sizeof(NativeStreamRaw) || raw->Read is null)
+            {
+                error = "xl_open_stream needs a non-NULL stream whose struct_size is sizeof(xl_stream) and whose read is set, and a non-NULL out_handle.";
+                return false;
+            }
+            error = null;
+            stream = new CallbackReadStream(*raw);
+            return true;
+        }
+
+        public override bool CanRead => true;
+
+        public override bool CanSeek => false;
+
+        public override bool CanWrite => false;
+
+        public override long Length => throw new NotSupportedException();
+
+        public override long Position
+        {
+            get => throw new NotSupportedException();
+            set => throw new NotSupportedException();
+        }
+
+        public override int Read(Span<byte> buffer)
+        {
+            ObjectDisposedException.ThrowIf(Volatile.Read(ref _released) != 0, this);
+            if (buffer.IsEmpty)
+            {
+                return 0;
+            }
+            SourceErrors.Clear();
+            long got;
+            fixed (byte* destination = buffer)
+            {
+                got = _read(_userData, destination, buffer.Length);
+            }
+            if (got < 0 || got > buffer.Length)
+            {
+                throw SourceErrors.Failed("xl_stream.read", got, buffer.Length);
+            }
+            return (int)got;
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return Read(buffer.AsSpan(offset, count));
+        }
+
+        public override void Flush()
+        {
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            throw new NotSupportedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (Interlocked.Exchange(ref _released, 1) == 0 && _release is not null)
+            {
+                _release(_userData);
+            }
+            base.Dispose(disposing);
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
index 3b65e277..555ba5c2 100644
--- a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
+++ b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
@@ -51,5 +51,56 @@ internal static int OpenSource(ByteSource callback, int format, NativeOpenOption
                 }
             }
         }
+
+        internal static int OpenStream(CallbackReadStream stream, int format, NativeOpenOptionsRaw? rawOptions, out NativeHandle? handle)
+        {
+            handle = null;
+            bool opened = false;
+            try
+            {
+                if (!TryDecodeOpenOptions(rawOptions, out NativeOpenOptions? decoded, out string? error))
+                {
+                    NativeApi.SetLastError(error!);
+                    return NativeStatus.InvalidArgument;
+                }
+                if (!IsKnownFormat(format))
+                {
+                    NativeApi.SetLastError($"format must be one of the XL_FORMAT_* values; got {format}.");
+                    return NativeStatus.InvalidArgument;
+                }
+                NativeOpenOptions options = decoded ?? default;
+                ExcelReaderOptions readerOptions = options.ToExcelReaderOptions();
+                IExcelWorkbook workbook;
+                if (format == NativeFormat.Csv)
+                {
+                    workbook = Excel.FromCsv(stream, leaveOpen: false, readerOptions.Csv);
+                }
+                else
+                {
+                    ReadOnlyMemory<byte> data = StreamBuffer.ReadAll(stream, options.MaxBufferedBytes ?? Array.MaxLength);
+                    stream.Dispose();
+                    workbook = Excel.Open(data, MapFormat(format), readerOptions);
+                }
+                handle = new NativeHandle(workbook);
+                opened = true;
+                return NativeStatus.Ok;
+            }
+            catch (ExcelEncryptionException ex)
+            {
+                return MapEncryptionException(ex);
+            }
+            catch (Exception exception)
+            {
+                NativeApi.SetLastError(exception.Message);
+                return NativeStatus.Error;
+            }
+            finally
+            {
+                if (!opened)
+                {
+                    stream.Dispose();
+                }
+            }
+        }
     }
 }
diff --git a/src/ExcelReader.Native/Reading/StreamBuffer.cs b/src/ExcelReader.Native/Reading/StreamBuffer.cs
new file mode 100644
index 00000000..e2570f03
--- /dev/null
+++ b/src/ExcelReader.Native/Reading/StreamBuffer.cs
@@ -0,0 +1,32 @@
+using System.Buffers;
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Native.Reading
+{
+    internal static class StreamBuffer
+    {
+        internal static ReadOnlyMemory<byte> ReadAll(Stream stream, long limit)
+        {
+            MemoryStream buffer = new();
+            byte[] chunk = ArrayPool<byte>.Shared.Rent(81_920);
+            try
+            {
+                int read;
+                while ((read = stream.Read(chunk)) > 0)
+                {
+                    long total = buffer.Length + read;
+                    if (total > limit)
+                    {
+                        throw new ExcelLimitExceededException("MaxBufferedBytes", limit, total);
+                    }
+                    buffer.Write(chunk, 0, read);
+                }
+            }
+            finally
+            {
+                ArrayPool<byte>.Shared.Return(chunk);
+            }
+            return buffer.GetBuffer().AsMemory(0, (int)buffer.Length);
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/include/excelreader.def b/src/ExcelReader.Native/include/excelreader.def
index 7b2dccdf..6bd570d3 100644
--- a/src/ExcelReader.Native/include/excelreader.def
+++ b/src/ExcelReader.Native/include/excelreader.def
@@ -3,6 +3,7 @@ EXPORTS
     xl_open_file
     xl_open_memory
     xl_open_source
+    xl_open_stream
     xl_set_source_error
     xl_close
     xl_sheet_count
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 895fa8a2..5deb8192 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -121,6 +121,25 @@ typedef struct xl_source {
 int32_t xl_open_source(const xl_source* source, int32_t format,
                        const xl_open_options* options, xl_workbook** out_handle);
 
+/* Sequential bytes for xl_open_stream. */
+typedef struct xl_stream {
+    int32_t struct_size;     /* sizeof(xl_stream) */
+    void* user_data;
+    /* Copy up to len bytes into buf. Return the bytes copied (0 at the end), or -1 on failure after
+       calling xl_set_source_error. Never called concurrently. */
+    int64_t (*read)(void* user_data, uint8_t* buf, int64_t len);
+    /* May be NULL. Called exactly once. */
+    void (*release)(void* user_data);
+} xl_stream;
+
+/* Opens a workbook over a stream that cannot seek. A CSV is read as it arrives, by one cursor:
+   a second cursor, typed reader or Arrow stream on it fails with XL_ERROR, csv_sniff_dialect is
+   refused, and the stream is released when the workbook and its cursor are closed. An XLSX, XLSB
+   or XLS needs random access, so the stream is read whole (up to max_buffered_bytes) and released
+   before this returns. Ownership rules are those of xl_open_source. */
+int32_t xl_open_stream(const xl_stream* stream, int32_t format,
+                       const xl_open_options* options, xl_workbook** out_handle);
+
 /* Callable only from inside read_at or read: the message xl_last_error reports when the callback
    then returns -1. Inside a callback, no other xl_ function may be called. */
 void xl_set_source_error(const uint8_t* message, int32_t len);
diff --git a/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
new file mode 100644
index 00000000..a2e2c168
--- /dev/null
+++ b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
@@ -0,0 +1,162 @@
+using System.Runtime.InteropServices;
+using System.Text;
+using ExcelReader.Native;
+using ExcelReader.Native.Reading;
+using ExcelReader.Tests.Reader;
+
+namespace ExcelReader.Tests.Native
+{
+    public sealed unsafe class CallbackStreamTests
+    {
+        internal sealed class TestStream(byte[] bytes)
+        {
+            internal readonly byte[] Bytes = bytes;
+            internal int Position;
+            internal int Releases;
+            internal string? Error;
+        }
+
+        private sealed class Pinned(TestStream stream) : IDisposable
+        {
+            private GCHandle _handle = GCHandle.Alloc(stream);
+
+            internal NativeStreamRaw Raw()
+            {
+                return new()
+                {
+                    StructSize = sizeof(NativeStreamRaw),
+                    UserData = (void*)GCHandle.ToIntPtr(_handle),
+                    Read = &Read,
+                    Release = &Release,
+                };
+            }
+
+            public void Dispose()
+            {
+                _handle.Free();
+            }
+        }
+
+        [UnmanagedCallersOnly]
+        private static long Read(void* userData, byte* buffer, long length)
+        {
+            TestStream stream = (TestStream)GCHandle.FromIntPtr((nint)userData).Target!;
+            if (stream.Error is string message)
+            {
+                SourceErrors.Set(message);
+                return -1;
+            }
+            int count = (int)Math.Min(Math.Min(length, 7), stream.Bytes.Length - stream.Position);
+            stream.Bytes.AsSpan(stream.Position, count).CopyTo(new Span<byte>(buffer, count));
+            stream.Position += count;
+            return count;
+        }
+
+        [UnmanagedCallersOnly]
+        private static void Release(void* userData)
+        {
+            TestStream stream = (TestStream)GCHandle.FromIntPtr((nint)userData).Target!;
+            Interlocked.Increment(ref stream.Releases);
+        }
+
+        private static int Open(Pinned pinned, int format, out NativeHandle? handle, NativeOpenOptionsRaw? options = null)
+        {
+            NativeStreamRaw raw = pinned.Raw();
+            Assert.True(CallbackReadStream.TryCreate(&raw, hasOutHandle: true, out CallbackReadStream? stream, out string? error), error);
+            return ReadApi.OpenStream(stream!, format, options, out handle);
+        }
+
+        private static NativeOpenOptionsRaw Options() => new() { StructSize = sizeof(NativeOpenOptionsRaw) };
+
+        private static int CountRows(NativeHandle handle, int sheet)
+        {
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenRows(handle, sheet, out NativeRowCursor? opened));
+            using NativeRowCursor cursor = opened!;
+            int rows = 0;
+            while (ReadApi.NextRowView(cursor, out _) == NativeStatus.Ok)
+            {
+                rows++;
+            }
+            return rows;
+        }
+
+        [Fact]
+        public void A_Csv_Streams_Once_And_Is_Released_When_Its_Cursor_Closes()
+        {
+            TestStream test = new(Encoding.UTF8.GetBytes("a,b\n1,2\n3,4\n"));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Csv, out NativeHandle? handle));
+            Assert.Equal(3, CountRows(handle!, 0));
+
+            Assert.Equal(NativeStatus.Error, ReadApi.OpenRows(handle, 0, out _));
+            Assert.Contains("only be enumerated once", NativeApi.LastErrorText(), StringComparison.Ordinal);
+
+            Assert.Equal(0, test.Releases);
+            Assert.Equal(NativeStatus.Ok, ReadApi.Close(handle));
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Theory]
+        [InlineData(ConcurrentSheetTests.Format.Xlsx, NativeFormat.Xlsx)]
+        [InlineData(ConcurrentSheetTests.Format.Xls, NativeFormat.Auto)]
+        public void An_Excel_Workbook_Is_Buffered_And_The_Stream_Released_Before_The_Open_Returns(
+            ConcurrentSheetTests.Format format, int nativeFormat)
+        {
+            TestStream test = new(ConcurrentSheetTests.Build(format));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, nativeFormat, out NativeHandle? handle));
+            Assert.Equal(1, test.Releases);
+            using (handle)
+            {
+                Assert.Equal(ConcurrentSheetTests.Rows, CountRows(handle!, 5));
+            }
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void A_Stream_Past_The_Buffer_Limit_Fails_And_Is_Released_Once()
+        {
+            TestStream test = new(ConcurrentSheetTests.Build(ConcurrentSheetTests.Format.Xlsx));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Xlsx, out _, Options() with { MaxBufferedBytes = 1000 }));
+            Assert.Contains("MaxBufferedBytes", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void Sniffing_A_Csv_Stream_Fails_With_A_Message_And_Is_Released_Once()
+        {
+            TestStream test = new(Encoding.UTF8.GetBytes("a;b\n1;2\n"));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Csv, out _, Options() with { CsvSniffDialect = 2 }));
+            Assert.Contains("seekable", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void The_Callback_Message_Reaches_The_Caller()
+        {
+            TestStream test = new([1, 2, 3]) { Error = "pipe broke" };
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Error, Open(pinned, NativeFormat.Xlsx, out _));
+            Assert.Contains("pipe broke", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(1, test.Releases);
+        }
+
+        [Fact]
+        public void Invalid_Stream_Structs_Are_Rejected_Without_Taking_Ownership()
+        {
+            TestStream test = new([]);
+            using Pinned pinned = new(test);
+            NativeStreamRaw good = pinned.Raw();
+            NativeStreamRaw noRead = good with { Read = null };
+            NativeStreamRaw wrongSize = good with { StructSize = 4 };
+            Assert.False(CallbackReadStream.TryCreate(null, true, out _, out _));
+            Assert.False(CallbackReadStream.TryCreate(&good, false, out _, out _));
+            Assert.False(CallbackReadStream.TryCreate(&noRead, true, out _, out _));
+            Assert.False(CallbackReadStream.TryCreate(&wrongSize, true, out _, out string? error));
+            Assert.Contains("xl_open_stream", error, StringComparison.Ordinal);
+            Assert.Equal(0, test.Releases);
+        }
+    }
+}

From 4714b45d731396a9cfba13d9102cf32c72738f54 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 14:52:12 -0300
Subject: [PATCH 009/115] test(native): open a workbook through xl_open_source
 from C

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 tests/ExcelReader.NativeSmoke/smoke.c | 75 +++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/tests/ExcelReader.NativeSmoke/smoke.c b/tests/ExcelReader.NativeSmoke/smoke.c
index 0720f16d..7536fbdb 100644
--- a/tests/ExcelReader.NativeSmoke/smoke.c
+++ b/tests/ExcelReader.NativeSmoke/smoke.c
@@ -99,6 +99,22 @@ XL_STATIC_ASSERT(sizeof(xl_csv_aggregation) == 48, csv_agg_size);
 XL_STATIC_ASSERT(offsetof(xl_csv_parallel_options, max_cell_bytes) == 24, csv_opt_max_cell_bytes);
 XL_STATIC_ASSERT(sizeof(xl_csv_parallel_options) == 28, csv_opt_size);
 
+XL_STATIC_ASSERT(offsetof(xl_open_options, source_cache_bytes) == 88, open_options_source_cache_bytes);
+XL_STATIC_ASSERT(offsetof(xl_open_options, max_buffered_bytes) == 96, open_options_max_buffered_bytes);
+XL_STATIC_ASSERT(offsetof(xl_open_options, source_block_size) == 104, open_options_source_block_size);
+XL_STATIC_ASSERT(sizeof(xl_open_options) == 112, open_options_size);
+
+XL_STATIC_ASSERT(offsetof(xl_source, user_data) == 8, source_user_data);
+XL_STATIC_ASSERT(offsetof(xl_source, length) == 16, source_length);
+XL_STATIC_ASSERT(offsetof(xl_source, read_at) == 24, source_read_at);
+XL_STATIC_ASSERT(offsetof(xl_source, release) == 32, source_release);
+XL_STATIC_ASSERT(sizeof(xl_source) == 40, source_size);
+
+XL_STATIC_ASSERT(offsetof(xl_stream, user_data) == 8, stream_user_data);
+XL_STATIC_ASSERT(offsetof(xl_stream, read) == 16, stream_read);
+XL_STATIC_ASSERT(offsetof(xl_stream, release) == 24, stream_release);
+XL_STATIC_ASSERT(sizeof(xl_stream) == 32, stream_size);
+
 
 static xl_lib_handle load_library(const char* path)
 {
@@ -1268,6 +1284,64 @@ static int test_csv_aggregate_quoted_records(xl_lib_handle lib)
     return status;
 }
 
+typedef int32_t (*xl_open_source_fn)(const xl_source*, int32_t, const xl_open_options*, xl_workbook**);
+
+typedef struct smoke_buffer {
+    uint8_t* data;
+    int64_t length;
+    int releases;
+} smoke_buffer;
+
+static int64_t smoke_read_at(void* user_data, int64_t offset, uint8_t* buf, int64_t len)
+{
+    smoke_buffer* source = (smoke_buffer*)user_data;
+    if (offset >= source->length)
+    {
+        return 0;
+    }
+    int64_t count = source->length - offset < len ? source->length - offset : len;
+    memcpy(buf, source->data + offset, (size_t)count);
+    return count;
+}
+
+static void smoke_release(void* user_data)
+{
+    ((smoke_buffer*)user_data)->releases++;
+}
+
+static int test_open_source(xl_lib_handle lib, const api_t* api, const char* fixture)
+{
+    xl_open_source_fn open_source = (xl_open_source_fn)load_symbol(lib, "xl_open_source");
+    CHECK(open_source != NULL, "xl_open_source must be exported");
+
+    FILE* file = fopen(fixture, "rb");
+    CHECK(file != NULL, "the fixture must open");
+    fseek(file, 0, SEEK_END);
+    smoke_buffer buffer = { NULL, ftell(file), 0 };
+    fseek(file, 0, SEEK_SET);
+    buffer.data = (uint8_t*)malloc((size_t)buffer.length);
+    CHECK(buffer.data != NULL && fread(buffer.data, 1, (size_t)buffer.length, file) == (size_t)buffer.length, "the fixture must read");
+    fclose(file);
+
+    xl_source source;
+    memset(&source, 0, sizeof(source));
+    source.struct_size = (int32_t)sizeof(xl_source);
+    source.user_data = &buffer;
+    source.length = buffer.length;
+    source.read_at = smoke_read_at;
+    source.release = smoke_release;
+
+    xl_workbook* handle = NULL;
+    CHECK(open_source(&source, XL_FORMAT_XLSB, NULL, &handle) == XL_OK && handle != NULL, "xl_open_source must open the fixture");
+    int32_t count = 0;
+    CHECK(api->sheet_count(handle, &count) == XL_OK && count == 1, "the fixture has one sheet");
+    CHECK(api->close_(handle) == XL_OK, "xl_close must succeed");
+    CHECK(buffer.releases == 1, "release must run exactly once");
+
+    free(buffer.data);
+    return 0;
+}
+
 int main(int argc, char** argv)
 {
     const char* library_path = argc > 1 ? argv[1] : EXCELREADER_LIB_PATH_DEFAULT;
@@ -1308,6 +1382,7 @@ int main(int argc, char** argv)
     failures += test_write_typed(&api);
     failures += test_csv_aggregate_file(lib);
     failures += test_csv_aggregate_quoted_records(lib);
+    failures += test_open_source(lib, &api, fixture_path);
 
     if (failures == 0)
     {

From c933af83449572745cd560dba66b136d0cc1def2 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:00:09 -0300
Subject: [PATCH 010/115] feat(rust): open a workbook from a Source or any Read

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 rust/excelreader/src/lib.rs      |  38 +++++++
 rust/excelreader/src/options.rs  |  18 ++++
 rust/excelreader/src/source.rs   |  95 +++++++++++++++++
 rust/excelreader/src/workbook.rs |   4 +
 rust/excelreader/tests/source.rs | 177 +++++++++++++++++++++++++++++++
 5 files changed, 332 insertions(+)
 create mode 100644 rust/excelreader/src/source.rs
 create mode 100644 rust/excelreader/tests/source.rs

diff --git a/rust/excelreader/src/lib.rs b/rust/excelreader/src/lib.rs
index 9a4970d0..53550150 100644
--- a/rust/excelreader/src/lib.rs
+++ b/rust/excelreader/src/lib.rs
@@ -10,6 +10,7 @@ pub mod workbook;
 pub mod writer;
 pub mod writer_handle;
 pub mod rows;
+pub mod source;
 
 #[cfg(feature = "arrow")]
 pub mod arrow;
@@ -17,6 +18,7 @@ pub mod arrow;
 pub use aggregate::{aggregate_csv_file, aggregate_csv_memory, CsvAccumulator, CsvParallelOptions};
 pub use error::Error;
 pub use rows::{AllRows, CellIter, CellRef, CellType, DecodedRows, RowCursor, RowRef};
+pub use source::Source;
 pub use options::{OpenOptions, OpenOptionsRaw, WriteOptions};
 pub use temporal::{Date, Time, Timestamp};
 
@@ -118,6 +120,26 @@ pub struct XlOpenOptions {
     /// remain valid for the duration of the call - see [`OpenOptionsRaw`](crate::options::OpenOptionsRaw).
     pub password: *const u8,
     pub password_len: i32,
+    pub source_cache_bytes: i64,
+    pub max_buffered_bytes: i64,
+    pub source_block_size: i32,
+}
+
+#[repr(C)]
+pub struct XlSource {
+    pub struct_size: i32,
+    pub user_data: *mut c_void,
+    pub length: i64,
+    pub read_at: Option<unsafe extern "C" fn(*mut c_void, i64, *mut u8, i64) -> i64>,
+    pub release: Option<unsafe extern "C" fn(*mut c_void)>,
+}
+
+#[repr(C)]
+pub struct XlStream {
+    pub struct_size: i32,
+    pub user_data: *mut c_void,
+    pub read: Option<unsafe extern "C" fn(*mut c_void, *mut u8, i64) -> i64>,
+    pub release: Option<unsafe extern "C" fn(*mut c_void)>,
 }
 
 /// Mirrors `xl_write_options`. Field ORDER is the C struct's, not a tidied-up version of it: with
@@ -257,6 +279,22 @@ extern "C" {
         out_handle: *mut *mut XlWorkbook,
     ) -> c_int;
 
+    pub fn xl_open_source(
+        source: *const XlSource,
+        format: i32,
+        options: *const XlOpenOptions,
+        out_handle: *mut *mut XlWorkbook,
+    ) -> c_int;
+
+    pub fn xl_open_stream(
+        stream: *const XlStream,
+        format: i32,
+        options: *const XlOpenOptions,
+        out_handle: *mut *mut XlWorkbook,
+    ) -> c_int;
+
+    pub fn xl_set_source_error(message: *const u8, len: i32);
+
     pub fn xl_close(handle: *mut XlWorkbook) -> c_int;
 
     pub fn xl_sheet_count(handle: *mut XlWorkbook, out_count: *mut i32) -> c_int;
diff --git a/rust/excelreader/src/options.rs b/rust/excelreader/src/options.rs
index 4684b2d9..6d5f39c4 100644
--- a/rust/excelreader/src/options.rs
+++ b/rust/excelreader/src/options.rs
@@ -38,6 +38,14 @@ pub struct OpenOptions {
     pub prefetch_decompression: Option<bool>,
     pub intern_strings: Option<bool>,
 
+    /// `open_source` only: bytes fetched per `read_at` call. `None` is 4 MiB; a negative value turns
+    /// the cache off.
+    pub source_block_size: Option<i32>,
+    /// `open_source` only: bytes of blocks kept in memory. `None` is 64 MiB.
+    pub source_cache_bytes: Option<i64>,
+    /// `open_reader` with XLSX, XLSB or XLS only: the most bytes the reader may hold.
+    pub max_buffered_bytes: Option<i64>,
+
     /// Password for an encrypted OOXML workbook. `None` means "not encrypted, or fail with
     /// `Error::PasswordRequired`".
     pub password: Option<String>,
@@ -90,6 +98,13 @@ impl OpenOptions {
         prefetch_decompression: bool,
         /// XLS/XLSX/XLSB only. Library default is `false`.
         intern_strings: bool,
+        /// `open_source` only: bytes fetched per `read_at` call. Library default is 4 MiB; a negative
+        /// value turns the cache off.
+        source_block_size: i32,
+        /// `open_source` only: bytes of blocks kept in memory. Library default is 64 MiB.
+        source_cache_bytes: i64,
+        /// `open_reader` with XLSX, XLSB or XLS only: the most bytes the reader may hold.
+        max_buffered_bytes: i64,
     }
 
     /// Password for an encrypted OOXML workbook. Stored owned, since the C ABI receives a pointer
@@ -130,6 +145,9 @@ impl OpenOptions {
             intern_strings: opt_state(self.intern_strings),
             password: std::ptr::null(),
             password_len: 0,
+            source_cache_bytes: opt_number(self.source_cache_bytes),
+            max_buffered_bytes: opt_number(self.max_buffered_bytes),
+            source_block_size: opt_number(self.source_block_size),
         };
         if let Some(bytes) = password {
             raw.password = bytes.as_ptr();
diff --git a/rust/excelreader/src/source.rs b/rust/excelreader/src/source.rs
new file mode 100644
index 00000000..b35a4105
--- /dev/null
+++ b/rust/excelreader/src/source.rs
@@ -0,0 +1,95 @@
+//! Workbooks opened from bytes the caller serves: a positional [`Source`] or any [`Read`].
+
+use crate::workbook::{check, check_abi_version, Workbook};
+use crate::{Error, OpenOptions, XlSource, XlStream, XlWorkbook, XL_INVALID_ARGUMENT};
+use std::any::Any;
+use std::ffi::c_void;
+use std::io::{self, Read};
+use std::panic::{catch_unwind, AssertUnwindSafe};
+
+/// Random-access bytes for [`Workbook::open_source`]. The library calls `read_at` from several
+/// threads at once, which is why the trait requires `Send + Sync`.
+pub trait Source: Send + Sync + 'static {
+    /// Total size in bytes. Called once, while the workbook opens.
+    fn size(&self) -> io::Result<u64>;
+
+    /// Fills `buf` with the bytes starting at `offset` and returns how many it wrote. Returning 0
+    /// before the end is a failure.
+    fn read_at(&self, offset: u64, buf: &mut [u8]) -> io::Result<usize>;
+}
+
+impl Workbook {
+    /// Opens a workbook over `source`, which the library owns from here on and drops once nothing
+    /// opened from the workbook needs it. Every sheet can be read in parallel.
+    pub fn open_source<S: Source>(source: S, format: i32, options: Option<&OpenOptions>) -> Result<Workbook, Error> {
+        check_abi_version()?;
+        let size = source.size().map_err(|error| Error::from_status(XL_INVALID_ARGUMENT, error.to_string()))?;
+        let length = i64::try_from(size)
+            .map_err(|_| Error::from_status(XL_INVALID_ARGUMENT, "the source size does not fit in an i64".to_string()))?;
+        let raw = XlSource {
+            struct_size: std::mem::size_of::<XlSource>() as i32,
+            user_data: Box::into_raw(Box::new(source)).cast(),
+            length,
+            read_at: Some(read_at::<S>),
+            release: Some(release::<S>),
+        };
+        let options = options.map(OpenOptions::to_raw);
+        let options_ptr = options
+            .as_ref()
+            .map_or(std::ptr::null(), crate::options::OpenOptionsRaw::as_ptr);
+        let mut handle: *mut XlWorkbook = std::ptr::null_mut();
+        check(unsafe { crate::xl_open_source(&raw, format, options_ptr, &mut handle) })?;
+        Ok(Workbook::from_handle(handle))
+    }
+
+    /// Opens a workbook over `reader`, which cannot seek. A CSV is read as it arrives, once; an
+    /// XLSX, XLSB or XLS is read whole first. The library owns `reader` from here on.
+    pub fn open_reader<R: Read + Send + 'static>(reader: R, format: i32, options: Option<&OpenOptions>) -> Result<Workbook, Error> {
+        check_abi_version()?;
+        let raw = XlStream {
+            struct_size: std::mem::size_of::<XlStream>() as i32,
+            user_data: Box::into_raw(Box::new(reader)).cast(),
+            read: Some(read::<R>),
+            release: Some(release::<R>),
+        };
+        let options = options.map(OpenOptions::to_raw);
+        let options_ptr = options
+            .as_ref()
+            .map_or(std::ptr::null(), crate::options::OpenOptionsRaw::as_ptr);
+        let mut handle: *mut XlWorkbook = std::ptr::null_mut();
+        check(unsafe { crate::xl_open_stream(&raw, format, options_ptr, &mut handle) })?;
+        Ok(Workbook::from_handle(handle))
+    }
+}
+
+unsafe extern "C" fn read_at<S: Source>(user_data: *mut c_void, offset: i64, buf: *mut u8, len: i64) -> i64 {
+    let source = &*user_data.cast::<S>();
+    let buf = std::slice::from_raw_parts_mut(buf, len as usize);
+    report(catch_unwind(AssertUnwindSafe(|| source.read_at(offset as u64, buf))))
+}
+
+// The ABI never calls read concurrently, so the reader can be borrowed mutably.
+unsafe extern "C" fn read<R: Read>(user_data: *mut c_void, buf: *mut u8, len: i64) -> i64 {
+    let reader = &mut *user_data.cast::<R>();
+    let buf = std::slice::from_raw_parts_mut(buf, len as usize);
+    report(catch_unwind(AssertUnwindSafe(|| loop {
+        match reader.read(buf) {
+            Err(error) if error.kind() == io::ErrorKind::Interrupted => continue,
+            other => return other,
+        }
+    })))
+}
+
+unsafe extern "C" fn release<T>(user_data: *mut c_void) {
+    let _ = catch_unwind(AssertUnwindSafe(|| drop(Box::from_raw(user_data.cast::<T>()))));
+}
+
+fn report(outcome: Result<io::Result<usize>, Box<dyn Any + Send>>) -> i64 {
+    let message = match outcome {
+        Ok(Ok(count)) => return count as i64,
+        Ok(Err(error)) => error.to_string(),
+        Err(_) => "source panicked".to_string(),
+    };
+    unsafe { crate::xl_set_source_error(message.as_ptr(), message.len() as i32) };
+    -1
+}
diff --git a/rust/excelreader/src/workbook.rs b/rust/excelreader/src/workbook.rs
index 863fd498..dc75b791 100644
--- a/rust/excelreader/src/workbook.rs
+++ b/rust/excelreader/src/workbook.rs
@@ -140,6 +140,10 @@ unsafe impl Send for Workbook {}
 unsafe impl Sync for Workbook {}
 
 impl Workbook {
+    pub(crate) fn from_handle(handle: *mut XlWorkbook) -> Workbook {
+        Workbook { handle }
+    }
+
     /// Opens `path`, sniffing the format and using every library default.
     ///
     /// Sniffing does NOT detect CSV - open one with [`open_with`](Self::open_with) and
diff --git a/rust/excelreader/tests/source.rs b/rust/excelreader/tests/source.rs
new file mode 100644
index 00000000..1c396145
--- /dev/null
+++ b/rust/excelreader/tests/source.rs
@@ -0,0 +1,177 @@
+use excelreader::workbook::Workbook;
+use excelreader::writer_handle::WriterHandle;
+use excelreader::{OpenOptions, RowCursor, Source, XL_FORMAT_AUTO, XL_FORMAT_CSV, XL_FORMAT_XLSX};
+use std::io::{self, Read};
+use std::sync::atomic::{AtomicUsize, Ordering};
+use std::sync::Arc;
+
+const SHEETS: usize = 4;
+const ROWS: usize = 300;
+
+fn workbook_bytes() -> Vec<u8> {
+    let mut writer = WriterHandle::open_memory(XL_FORMAT_XLSX, None).expect("open writer");
+    for sheet in 0..SHEETS {
+        writer.start_sheet(&format!("sheet{sheet}")).expect("start sheet");
+        for row in 0..ROWS {
+            writer.start_row().expect("start row");
+            writer.write_str(Some(&format!("s{sheet}-r{row}"))).expect("write");
+            writer.end_row().expect("end row");
+        }
+        writer.end_sheet().expect("end sheet");
+    }
+    writer.bytes().expect("bytes").to_vec()
+}
+
+fn first_column(cursor: &mut RowCursor<'_>) -> Vec<String> {
+    let mut values = Vec::new();
+    while let Some(row) = cursor.next_row() {
+        let row = row.expect("a row");
+        values.push(row.get(0).expect("a cell").as_str().expect("utf-8").to_string());
+    }
+    values
+}
+
+#[derive(Default, Clone)]
+struct Counters {
+    reads: Arc<AtomicUsize>,
+    drops: Arc<AtomicUsize>,
+}
+
+struct MemorySource {
+    bytes: Vec<u8>,
+    counters: Counters,
+}
+
+impl Source for MemorySource {
+    fn size(&self) -> io::Result<u64> {
+        Ok(self.bytes.len() as u64)
+    }
+
+    fn read_at(&self, offset: u64, buf: &mut [u8]) -> io::Result<usize> {
+        self.counters.reads.fetch_add(1, Ordering::SeqCst);
+        let start = (offset as usize).min(self.bytes.len());
+        let count = buf.len().min(self.bytes.len() - start);
+        buf[..count].copy_from_slice(&self.bytes[start..start + count]);
+        Ok(count)
+    }
+}
+
+impl Drop for MemorySource {
+    fn drop(&mut self) {
+        self.counters.drops.fetch_add(1, Ordering::SeqCst);
+    }
+}
+
+struct FailingSource;
+
+impl Source for FailingSource {
+    fn size(&self) -> io::Result<u64> {
+        Ok(1024)
+    }
+
+    fn read_at(&self, _offset: u64, _buf: &mut [u8]) -> io::Result<usize> {
+        Err(io::Error::other("disk on fire"))
+    }
+}
+
+struct PanickingSource;
+
+impl Source for PanickingSource {
+    fn size(&self) -> io::Result<u64> {
+        Ok(1024)
+    }
+
+    fn read_at(&self, _offset: u64, _buf: &mut [u8]) -> io::Result<usize> {
+        panic!("boom");
+    }
+}
+
+struct OnlyRead(io::Cursor<Vec<u8>>);
+
+impl Read for OnlyRead {
+    fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
+        let limit = buf.len().min(7);
+        self.0.read(&mut buf[..limit])
+    }
+}
+
+#[test]
+fn every_sheet_of_a_source_reads_in_parallel_like_memory() {
+    let bytes = workbook_bytes();
+    let memory = Workbook::open_memory(&bytes, XL_FORMAT_AUTO, None).expect("open memory");
+    let expected: Vec<Vec<String>> = memory
+        .sheets()
+        .expect("sheets")
+        .iter()
+        .map(|sheet| first_column(&mut sheet.rows().expect("cursor")))
+        .collect();
+
+    let counters = Counters::default();
+    let workbook = Workbook::open_source(MemorySource { bytes, counters: counters.clone() }, XL_FORMAT_AUTO, None)
+        .expect("open source");
+    let sheets = workbook.sheets().expect("sheets");
+    let parallel: Vec<Vec<String>> = std::thread::scope(|scope| {
+        let handles: Vec<_> = sheets
+            .iter()
+            .chain(sheets.iter())
+            .map(|sheet| {
+                let sheet = *sheet;
+                scope.spawn(move || first_column(&mut sheet.rows().expect("cursor")))
+            })
+            .collect();
+        handles.into_iter().map(|handle| handle.join().expect("no panic")).collect()
+    });
+    for (index, rows) in parallel.iter().enumerate() {
+        assert_eq!(rows, &expected[index % SHEETS]);
+    }
+
+    drop(workbook);
+    assert_eq!(counters.drops.load(Ordering::SeqCst), 1);
+}
+
+#[test]
+fn an_io_error_reaches_the_caller_with_its_message() {
+    let error = Workbook::open_source(FailingSource, XL_FORMAT_XLSX, None).expect_err("must fail");
+    assert!(error.message().contains("disk on fire"), "{}", error.message());
+}
+
+#[test]
+fn a_panicking_source_becomes_an_error() {
+    let error = Workbook::open_source(PanickingSource, XL_FORMAT_XLSX, None).expect_err("must fail");
+    assert!(error.message().contains("source panicked"), "{}", error.message());
+}
+
+#[test]
+fn the_default_cache_fetches_a_small_workbook_once() {
+    let bytes = workbook_bytes();
+    let cached = Counters::default();
+    {
+        let workbook = Workbook::open_source(MemorySource { bytes: bytes.clone(), counters: cached.clone() }, XL_FORMAT_XLSX, None)
+            .expect("open");
+        first_column(&mut workbook.sheet(0).expect("sheet").rows().expect("cursor"));
+    }
+    assert_eq!(cached.reads.load(Ordering::SeqCst), 1);
+
+    let uncached = Counters::default();
+    let options = OpenOptions::new().source_block_size(-1);
+    {
+        let workbook = Workbook::open_source(MemorySource { bytes, counters: uncached.clone() }, XL_FORMAT_XLSX, Some(&options))
+            .expect("open");
+        first_column(&mut workbook.sheet(0).expect("sheet").rows().expect("cursor"));
+    }
+    assert!(uncached.reads.load(Ordering::SeqCst) > 1);
+}
+
+#[test]
+fn a_reader_serves_a_csv_and_an_xlsx() {
+    let csv = OnlyRead(io::Cursor::new(b"name,qty\nwidget,7\ngadget,9\n".to_vec()));
+    let workbook = Workbook::open_reader(csv, XL_FORMAT_CSV, None).expect("open csv");
+    let names = first_column(&mut workbook.sheet(0).expect("sheet").rows().expect("cursor"));
+    assert_eq!(names, vec!["name", "widget", "gadget"]);
+
+    let xlsx = OnlyRead(io::Cursor::new(workbook_bytes()));
+    let workbook = Workbook::open_reader(xlsx, XL_FORMAT_AUTO, None).expect("open xlsx");
+    let rows = first_column(&mut workbook.sheet(3).expect("sheet").rows().expect("cursor"));
+    assert_eq!(rows.len(), ROWS);
+    assert_eq!(rows[0], "s3-r0");
+}

From 962e8720006c98d15285b233bb53ad7df1731e69 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:02:29 -0300
Subject: [PATCH 011/115] test(rust): pin source release counts and the new ABI
 layouts

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 rust/excelreader/src/options.rs  | 11 +++++++
 rust/excelreader/tests/source.rs | 51 +++++++++++++++++++++++++++-----
 2 files changed, 55 insertions(+), 7 deletions(-)

diff --git a/rust/excelreader/src/options.rs b/rust/excelreader/src/options.rs
index 6d5f39c4..a14c58ae 100644
--- a/rust/excelreader/src/options.rs
+++ b/rust/excelreader/src/options.rs
@@ -385,4 +385,15 @@ mod tests {
     fn write_options_match_the_c_struct_size() {
         assert_eq!(std::mem::size_of::<crate::XlWriteOptions>(), 32);
     }
+
+    #[test]
+    fn source_layouts_match_the_c_structs() {
+        use crate::{XlOpenOptions, XlSource, XlStream};
+        assert_eq!(std::mem::size_of::<XlOpenOptions>(), 112);
+        assert_eq!(std::mem::offset_of!(XlOpenOptions, source_cache_bytes), 88);
+        assert_eq!(std::mem::offset_of!(XlOpenOptions, max_buffered_bytes), 96);
+        assert_eq!(std::mem::offset_of!(XlOpenOptions, source_block_size), 104);
+        assert_eq!(std::mem::size_of::<XlSource>(), 40);
+        assert_eq!(std::mem::size_of::<XlStream>(), 32);
+    }
 }
diff --git a/rust/excelreader/tests/source.rs b/rust/excelreader/tests/source.rs
index 1c396145..9167fb42 100644
--- a/rust/excelreader/tests/source.rs
+++ b/rust/excelreader/tests/source.rs
@@ -62,7 +62,13 @@ impl Drop for MemorySource {
     }
 }
 
-struct FailingSource;
+struct FailingSource(Counters);
+
+impl Drop for FailingSource {
+    fn drop(&mut self) {
+        self.0.drops.fetch_add(1, Ordering::SeqCst);
+    }
+}
 
 impl Source for FailingSource {
     fn size(&self) -> io::Result<u64> {
@@ -74,7 +80,13 @@ impl Source for FailingSource {
     }
 }
 
-struct PanickingSource;
+struct PanickingSource(Counters);
+
+impl Drop for PanickingSource {
+    fn drop(&mut self) {
+        self.0.drops.fetch_add(1, Ordering::SeqCst);
+    }
+}
 
 impl Source for PanickingSource {
     fn size(&self) -> io::Result<u64> {
@@ -86,7 +98,19 @@ impl Source for PanickingSource {
     }
 }
 
-struct OnlyRead(io::Cursor<Vec<u8>>);
+struct OnlyRead(io::Cursor<Vec<u8>>, Counters);
+
+impl OnlyRead {
+    fn new(bytes: Vec<u8>, counters: &Counters) -> Self {
+        OnlyRead(io::Cursor::new(bytes), counters.clone())
+    }
+}
+
+impl Drop for OnlyRead {
+    fn drop(&mut self) {
+        self.1.drops.fetch_add(1, Ordering::SeqCst);
+    }
+}
 
 impl Read for OnlyRead {
     fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
@@ -131,14 +155,18 @@ fn every_sheet_of_a_source_reads_in_parallel_like_memory() {
 
 #[test]
 fn an_io_error_reaches_the_caller_with_its_message() {
-    let error = Workbook::open_source(FailingSource, XL_FORMAT_XLSX, None).expect_err("must fail");
+    let counters = Counters::default();
+    let error = Workbook::open_source(FailingSource(counters.clone()), XL_FORMAT_XLSX, None).expect_err("must fail");
     assert!(error.message().contains("disk on fire"), "{}", error.message());
+    assert_eq!(counters.drops.load(Ordering::SeqCst), 1);
 }
 
 #[test]
 fn a_panicking_source_becomes_an_error() {
-    let error = Workbook::open_source(PanickingSource, XL_FORMAT_XLSX, None).expect_err("must fail");
+    let counters = Counters::default();
+    let error = Workbook::open_source(PanickingSource(counters.clone()), XL_FORMAT_XLSX, None).expect_err("must fail");
     assert!(error.message().contains("source panicked"), "{}", error.message());
+    assert_eq!(counters.drops.load(Ordering::SeqCst), 1);
 }
 
 #[test]
@@ -164,13 +192,22 @@ fn the_default_cache_fetches_a_small_workbook_once() {
 
 #[test]
 fn a_reader_serves_a_csv_and_an_xlsx() {
-    let csv = OnlyRead(io::Cursor::new(b"name,qty\nwidget,7\ngadget,9\n".to_vec()));
+    let csv_counters = Counters::default();
+    let csv = OnlyRead::new(b"name,qty
+widget,7
+gadget,9
+".to_vec(), &csv_counters);
     let workbook = Workbook::open_reader(csv, XL_FORMAT_CSV, None).expect("open csv");
     let names = first_column(&mut workbook.sheet(0).expect("sheet").rows().expect("cursor"));
     assert_eq!(names, vec!["name", "widget", "gadget"]);
+    assert_eq!(csv_counters.drops.load(Ordering::SeqCst), 0, "the CSV is read as it arrives");
+    drop(workbook);
+    assert_eq!(csv_counters.drops.load(Ordering::SeqCst), 1);
 
-    let xlsx = OnlyRead(io::Cursor::new(workbook_bytes()));
+    let xlsx_counters = Counters::default();
+    let xlsx = OnlyRead::new(workbook_bytes(), &xlsx_counters);
     let workbook = Workbook::open_reader(xlsx, XL_FORMAT_AUTO, None).expect("open xlsx");
+    assert_eq!(xlsx_counters.drops.load(Ordering::SeqCst), 1, "an XLSX is read whole before open returns");
     let rows = first_column(&mut workbook.sheet(3).expect("sheet").rows().expect("cursor"));
     assert_eq!(rows.len(), ROWS);
     assert_eq!(rows[0], "s3-r0");

From 4db2192bdcecc612861c409ea25d679a1205eefb Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:06:22 -0300
Subject: [PATCH 012/115] feat(cpp): open a workbook from an xl::Source or an
 xl::InputStream

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 cpp/tests/CMakeLists.txt                      |   8 +
 cpp/tests/sources.cpp                         | 170 ++++++++++++++++++
 .../include/excelreader.hpp                   | 130 ++++++++++++++
 3 files changed, 308 insertions(+)
 create mode 100644 cpp/tests/sources.cpp

diff --git a/cpp/tests/CMakeLists.txt b/cpp/tests/CMakeLists.txt
index 3e166f8a..67467e16 100644
--- a/cpp/tests/CMakeLists.txt
+++ b/cpp/tests/CMakeLists.txt
@@ -38,6 +38,14 @@ target_compile_definitions(excelreader_cpp_rows PRIVATE
 add_test(NAME excelreader_cpp_rows COMMAND excelreader_cpp_rows)
 excelreader_copy_native_library(excelreader_cpp_rows)
 
+add_executable(excelreader_cpp_sources sources.cpp)
+target_link_libraries(excelreader_cpp_sources PRIVATE xl::excelreader)
+target_compile_definitions(excelreader_cpp_sources PRIVATE
+    EXCELREADER_XLSX_FIXTURE_PATH="${EXCELREADER_XLSX_FIXTURE_PATH}")
+
+add_test(NAME excelreader_cpp_sources COMMAND excelreader_cpp_sources)
+excelreader_copy_native_library(excelreader_cpp_sources)
+
 add_executable(excelreader_cpp_sheets sheets.cpp)
 find_package(Threads REQUIRED)
 target_link_libraries(excelreader_cpp_sheets PRIVATE xl::excelreader Threads::Threads)
diff --git a/cpp/tests/sources.cpp b/cpp/tests/sources.cpp
new file mode 100644
index 00000000..1bcc958f
--- /dev/null
+++ b/cpp/tests/sources.cpp
@@ -0,0 +1,170 @@
+#include <xl/excelreader.hpp>
+
+#include <algorithm>
+#include <atomic>
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <fstream>
+#include <iterator>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <vector>
+
+namespace
+{
+    int failures = 0;
+
+    void check(bool condition, const char *what)
+    {
+        if (!condition)
+        {
+            std::fprintf(stderr, "FAILED: %s\n", what);
+            ++failures;
+        }
+    }
+
+    std::vector<std::byte> read_file(const char *path)
+    {
+        std::ifstream in(path, std::ios::binary);
+        std::vector<char> chars((std::istreambuf_iterator<char>(in)), std::istreambuf_iterator<char>());
+        std::vector<std::byte> bytes(chars.size());
+        std::memcpy(bytes.data(), chars.data(), chars.size());
+        return bytes;
+    }
+
+    struct Counters
+    {
+        std::atomic<int> reads{0};
+        std::atomic<int> destroyed{0};
+    };
+
+    class MemorySource final : public xl::Source
+    {
+    public:
+        MemorySource(std::vector<std::byte> bytes, Counters &counters) : bytes_(std::move(bytes)), counters_(counters) {}
+        ~MemorySource() override { counters_.destroyed.fetch_add(1); }
+
+        std::uint64_t size() const override { return bytes_.size(); }
+
+        std::expected<std::size_t, std::string> read_at(std::uint64_t offset, std::span<std::byte> buffer) const override
+        {
+            counters_.reads.fetch_add(1);
+            if (offset >= bytes_.size())
+            {
+                return std::size_t{0};
+            }
+            const std::size_t count = std::min<std::size_t>(buffer.size(), bytes_.size() - offset);
+            std::memcpy(buffer.data(), bytes_.data() + offset, count);
+            return count;
+        }
+
+    private:
+        std::vector<std::byte> bytes_;
+        Counters &counters_;
+    };
+
+    class FailingSource final : public xl::Source
+    {
+    public:
+        std::uint64_t size() const override { return 1024; }
+        std::expected<std::size_t, std::string> read_at(std::uint64_t, std::span<std::byte>) const override
+        {
+            return std::unexpected(std::string("disk on fire"));
+        }
+    };
+
+    class ThrowingSource final : public xl::Source
+    {
+    public:
+        std::uint64_t size() const override { return 1024; }
+        std::expected<std::size_t, std::string> read_at(std::uint64_t, std::span<std::byte>) const override
+        {
+            throw std::runtime_error("boom");
+        }
+    };
+
+    class ChunkStream final : public xl::InputStream
+    {
+    public:
+        explicit ChunkStream(std::vector<std::byte> bytes) : bytes_(std::move(bytes)) {}
+
+        std::expected<std::size_t, std::string> read(std::span<std::byte> buffer) override
+        {
+            const std::size_t count = std::min<std::size_t>({buffer.size(), std::size_t{7}, bytes_.size() - position_});
+            std::memcpy(buffer.data(), bytes_.data() + position_, count);
+            position_ += count;
+            return count;
+        }
+
+    private:
+        std::vector<std::byte> bytes_;
+        std::size_t position_ = 0;
+    };
+
+    std::size_t row_count(const xl::Workbook &workbook)
+    {
+        auto decoded = workbook.sheet(0).read_all_decoded();
+        return decoded.has_value() ? decoded->size() : 0;
+    }
+}
+
+int main()
+{
+    const std::vector<std::byte> bytes = read_file(EXCELREADER_XLSX_FIXTURE_PATH);
+    auto reference = xl::Workbook::open(EXCELREADER_XLSX_FIXTURE_PATH);
+    check(reference.has_value(), "open the fixture by path");
+    const std::size_t expected_rows = reference.has_value() ? row_count(*reference) : 0;
+    check(expected_rows > 1, "the fixture has rows");
+
+    Counters counters;
+    {
+        auto workbook = xl::Workbook::open_source(std::make_unique<MemorySource>(bytes, counters));
+        check(workbook.has_value(), "open_source opens the fixture");
+        check(workbook.has_value() && row_count(*workbook) == expected_rows, "open_source reads every row");
+    }
+    check(counters.destroyed.load() == 1, "the source is destroyed exactly once");
+
+    const int blocks = static_cast<int>((bytes.size() + (4u << 20) - 1) / (4u << 20));
+    check(counters.reads.load() <= blocks, "the default cache fetches each block once");
+
+    Counters uncached;
+    {
+        xl::OpenOptions options;
+        options.source_block_size = -1;
+        auto workbook = xl::Workbook::open_source(std::make_unique<MemorySource>(bytes, uncached), XL_FORMAT_XLSX, &options);
+        check(workbook.has_value() && row_count(*workbook) == expected_rows, "open_source without the cache reads every row");
+    }
+    check(uncached.reads.load() > blocks, "without the cache every read reaches read_at");
+
+    {
+        auto workbook = xl::Workbook::open_source(std::make_unique<FailingSource>(), XL_FORMAT_XLSX);
+        check(!workbook.has_value() && workbook.error().message.find("disk on fire") != std::string::npos,
+              "the source's error message reaches the caller");
+    }
+    {
+        auto workbook = xl::Workbook::open_source(std::make_unique<ThrowingSource>(), XL_FORMAT_XLSX);
+        check(!workbook.has_value() && workbook.error().message.find("boom") != std::string::npos,
+              "an exception from the source becomes an error");
+    }
+    {
+        const std::string csv = "name,qty\nwidget,7\n";
+        std::vector<std::byte> csv_bytes(csv.size());
+        std::memcpy(csv_bytes.data(), csv.data(), csv.size());
+        auto workbook = xl::Workbook::open_stream(std::make_unique<ChunkStream>(csv_bytes), XL_FORMAT_CSV);
+        check(workbook.has_value() && row_count(*workbook) == 2, "open_stream reads a CSV");
+    }
+    {
+        auto workbook = xl::Workbook::open_stream(std::make_unique<ChunkStream>(bytes));
+        check(workbook.has_value() && row_count(*workbook) == expected_rows, "open_stream reads an XLSX");
+    }
+
+    if (failures != 0)
+    {
+        std::fprintf(stderr, "%d check(s) failed\n", failures);
+        return EXIT_FAILURE;
+    }
+    std::puts("sources: OK");
+    return EXIT_SUCCESS;
+}
diff --git a/src/ExcelReader.Native/include/excelreader.hpp b/src/ExcelReader.Native/include/excelreader.hpp
index f3e39eb9..45d59dec 100644
--- a/src/ExcelReader.Native/include/excelreader.hpp
+++ b/src/ExcelReader.Native/include/excelreader.hpp
@@ -144,6 +144,9 @@ namespace xl
         int32_t max_zip_entries = 0;
         int32_t prefetch_decompression = XL_OPT_DEFAULT;
         int32_t intern_strings = XL_OPT_DEFAULT;
+        int64_t source_cache_bytes = 0;
+        int64_t max_buffered_bytes = 0;
+        int32_t source_block_size = 0;
 
         std::string password_{};
 
@@ -169,6 +172,9 @@ namespace xl
             opts.max_zip_entries = max_zip_entries;
             opts.prefetch_decompression = prefetch_decompression;
             opts.intern_strings = intern_strings;
+            opts.source_cache_bytes = source_cache_bytes;
+            opts.max_buffered_bytes = max_buffered_bytes;
+            opts.source_block_size = source_block_size;
             opts.password = password_.empty() ? nullptr : reinterpret_cast<const uint8_t *>(password_.data());
             opts.password_len = static_cast<int32_t>(password_.size());
             return opts;
@@ -800,6 +806,75 @@ namespace xl
         int32_t index_ = 0;
     };
 
+    /// Random-access bytes for Workbook::open_source. read_at is called from several threads at once.
+    class Source
+    {
+    public:
+        virtual ~Source() = default;
+        virtual std::uint64_t size() const = 0;
+        virtual std::expected<std::size_t, std::string> read_at(std::uint64_t offset, std::span<std::byte> buffer) const = 0;
+    };
+
+    /// Sequential bytes for Workbook::open_stream. read is never called concurrently.
+    class InputStream
+    {
+    public:
+        virtual ~InputStream() = default;
+        virtual std::expected<std::size_t, std::string> read(std::span<std::byte> buffer) = 0;
+    };
+
+    namespace detail
+    {
+        inline int64_t report_source_error(std::string_view message) noexcept
+        {
+            xl_set_source_error(reinterpret_cast<const uint8_t *>(message.data()), static_cast<int32_t>(message.size()));
+            return -1;
+        }
+
+        template <typename Call>
+        inline int64_t guarded_read(Call &&call) noexcept
+        {
+            try
+            {
+                auto result = call();
+                return result.has_value() ? static_cast<int64_t>(*result) : report_source_error(result.error());
+            }
+            catch (const std::exception &e)
+            {
+                return report_source_error(e.what());
+            }
+            catch (...)
+            {
+                return report_source_error("the source threw an exception");
+            }
+        }
+
+        inline int64_t source_read_at(void *user_data, int64_t offset, uint8_t *buffer, int64_t length) noexcept
+        {
+            return guarded_read([&]
+                                { return static_cast<const Source *>(user_data)->read_at(
+                                      static_cast<std::uint64_t>(offset),
+                                      std::span<std::byte>(reinterpret_cast<std::byte *>(buffer), static_cast<std::size_t>(length))); });
+        }
+
+        inline int64_t stream_read(void *user_data, uint8_t *buffer, int64_t length) noexcept
+        {
+            return guarded_read([&]
+                                { return static_cast<InputStream *>(user_data)->read(
+                                      std::span<std::byte>(reinterpret_cast<std::byte *>(buffer), static_cast<std::size_t>(length))); });
+        }
+
+        inline void source_release(void *user_data) noexcept
+        {
+            delete static_cast<Source *>(user_data);
+        }
+
+        inline void stream_release(void *user_data) noexcept
+        {
+            delete static_cast<InputStream *>(user_data);
+        }
+    }
+
     /// An open workbook. Safe to use from several threads at once: every read goes through a Sheet and opens its own cursor.
     class Workbook
     {
@@ -859,6 +934,61 @@ namespace xl
             return Workbook(handle);
         }
 
+        /// Opens a workbook over a source the library owns from here on; every sheet can be read in parallel.
+        static std::expected<Workbook, Error> open_source(std::unique_ptr<Source> source, int32_t format = XL_FORMAT_AUTO,
+                                                          const OpenOptions *options = nullptr)
+        {
+            if (const auto &abi = detail::check_abi_version(); !abi.has_value())
+            {
+                return std::unexpected(abi.error());
+            }
+            if (source == nullptr)
+            {
+                return std::unexpected(Error{XL_INVALID_ARGUMENT, "source is null"});
+            }
+            xl_source raw{};
+            raw.struct_size = sizeof(xl_source);
+            raw.length = static_cast<int64_t>(source->size());
+            raw.read_at = &detail::source_read_at;
+            raw.release = &detail::source_release;
+            raw.user_data = source.release();
+            xl_workbook *handle = nullptr;
+            xl_open_options c_options{};
+            int32_t status = xl_open_source(&raw, format, detail::lower_options(options, c_options), &handle);
+            if (status != XL_OK)
+            {
+                return std::unexpected(detail::make_error(status));
+            }
+            return Workbook(handle);
+        }
+
+        /// Opens a workbook over a stream that cannot seek: a CSV is read as it arrives, once; an XLSX, XLSB or XLS is read whole first.
+        static std::expected<Workbook, Error> open_stream(std::unique_ptr<InputStream> stream, int32_t format = XL_FORMAT_AUTO,
+                                                          const OpenOptions *options = nullptr)
+        {
+            if (const auto &abi = detail::check_abi_version(); !abi.has_value())
+            {
+                return std::unexpected(abi.error());
+            }
+            if (stream == nullptr)
+            {
+                return std::unexpected(Error{XL_INVALID_ARGUMENT, "stream is null"});
+            }
+            xl_stream raw{};
+            raw.struct_size = sizeof(xl_stream);
+            raw.read = &detail::stream_read;
+            raw.release = &detail::stream_release;
+            raw.user_data = stream.release();
+            xl_workbook *handle = nullptr;
+            xl_open_options c_options{};
+            int32_t status = xl_open_stream(&raw, format, detail::lower_options(options, c_options), &handle);
+            if (status != XL_OK)
+            {
+                return std::unexpected(detail::make_error(status));
+            }
+            return Workbook(handle);
+        }
+
 
         std::expected<int32_t, Error> sheet_count() const
         {

From 2b1b3ad968919f9562c221332b5dd601e106564f Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:10:04 -0300
Subject: [PATCH 013/115] feat(python): open a workbook from a Source or a
 readable stream

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 python/src/excelreader/__init__.py |   4 +
 python/src/excelreader/_native.py  |  40 +++++++++
 python/src/excelreader/sources.py  | 106 ++++++++++++++++++++++
 python/src/excelreader/types.py    |   7 ++
 python/tests/test_native.py        |   3 +
 python/tests/test_sources.py       | 140 +++++++++++++++++++++++++++++
 6 files changed, 300 insertions(+)
 create mode 100644 python/src/excelreader/sources.py
 create mode 100644 python/tests/test_sources.py

diff --git a/python/src/excelreader/__init__.py b/python/src/excelreader/__init__.py
index b5cf6ba4..6b8457d1 100644
--- a/python/src/excelreader/__init__.py
+++ b/python/src/excelreader/__init__.py
@@ -2,6 +2,7 @@
 
 from excelreader.arrow_stream import ArrowStream
 from excelreader.reader import Sheet, Sheets, Workbook, decode_cell, open_bytes, open_workbook
+from excelreader.sources import Source, open_source, open_stream
 from excelreader.types import (
     Cell,
     CellType,
@@ -46,6 +47,7 @@
     "SheetVisibility",
     "SheetWriter",
     "Sheets",
+    "Source",
     "StringColumn",
     "TypedTable",
     "Workbook",
@@ -54,6 +56,8 @@
     "encrypt_package",
     "encrypt_package_bytes",
     "open_bytes",
+    "open_source",
+    "open_stream",
     "open_workbook",
     "open_writer",
     "open_writer_to_memory",
diff --git a/python/src/excelreader/_native.py b/python/src/excelreader/_native.py
index a619aacb..d6b25317 100644
--- a/python/src/excelreader/_native.py
+++ b/python/src/excelreader/_native.py
@@ -263,6 +263,37 @@ class NativeOpenOptions(ctypes.Structure):
         ("intern_strings", ctypes.c_int32),
         ("password", ctypes.POINTER(ctypes.c_uint8)),
         ("password_len", ctypes.c_int32),
+        ("source_cache_bytes", ctypes.c_int64),
+        ("max_buffered_bytes", ctypes.c_int64),
+        ("source_block_size", ctypes.c_int32),
+    ]
+
+
+SourceReadAt = ctypes.CFUNCTYPE(ctypes.c_int64, ctypes.c_void_p, ctypes.c_int64, ctypes.c_void_p, ctypes.c_int64)
+StreamRead = ctypes.CFUNCTYPE(ctypes.c_int64, ctypes.c_void_p, ctypes.c_void_p, ctypes.c_int64)
+SourceRelease = ctypes.CFUNCTYPE(None, ctypes.c_void_p)
+
+
+class NativeSource(ctypes.Structure):
+    """Mirrors xl_source."""
+
+    _fields_ = [
+        ("struct_size", ctypes.c_int32),
+        ("user_data", ctypes.c_void_p),
+        ("length", ctypes.c_int64),
+        ("read_at", SourceReadAt),
+        ("release", SourceRelease),
+    ]
+
+
+class NativeStream(ctypes.Structure):
+    """Mirrors xl_stream."""
+
+    _fields_ = [
+        ("struct_size", ctypes.c_int32),
+        ("user_data", ctypes.c_void_p),
+        ("read", StreamRead),
+        ("release", SourceRelease),
     ]
 
 
@@ -310,6 +341,9 @@ def to_native_open_options(options: OpenOptions) -> NativeOpenOptions:
     raw.max_cell_bytes = _opt_number(options.max_cell_bytes)
     raw.max_shared_string_bytes = _opt_number(options.max_shared_string_bytes)
     raw.max_zip_entries = _opt_number(options.max_zip_entries)
+    raw.source_cache_bytes = _opt_number(options.source_cache_bytes)
+    raw.max_buffered_bytes = _opt_number(options.max_buffered_bytes)
+    raw.source_block_size = _opt_number(options.source_block_size)
     return raw
 
 
@@ -445,6 +479,12 @@ def _bind(lib: ctypes.CDLL) -> ctypes.CDLL:
     lib.xl_open_file.restype = c_int
     lib.xl_open_memory.argtypes = [p_bytes, c_int, c_int, p_open_options, pp_void]
     lib.xl_open_memory.restype = c_int
+    lib.xl_open_source.argtypes = [ctypes.POINTER(NativeSource), c_int, p_open_options, pp_void]
+    lib.xl_open_source.restype = c_int
+    lib.xl_open_stream.argtypes = [ctypes.POINTER(NativeStream), c_int, p_open_options, pp_void]
+    lib.xl_open_stream.restype = c_int
+    lib.xl_set_source_error.argtypes = [p_bytes, c_int]
+    lib.xl_set_source_error.restype = None
     lib.xl_sheet_visibility_at.argtypes = [p_void, c_int, p_int]
     lib.xl_sheet_visibility_at.restype = c_int
     lib.xl_sheet_index.argtypes = [p_void, p_bytes, c_int, p_int]
diff --git a/python/src/excelreader/sources.py b/python/src/excelreader/sources.py
new file mode 100644
index 00000000..f6a8931a
--- /dev/null
+++ b/python/src/excelreader/sources.py
@@ -0,0 +1,106 @@
+"""Open a workbook from bytes the caller serves: a positional `Source`, or a readable stream."""
+
+from __future__ import annotations
+
+import ctypes
+import itertools
+from typing import Protocol
+
+from excelreader import _native
+from excelreader.reader import Workbook, _check, _raw_options, _resolve_format
+from excelreader.types import OpenOptions
+
+
+class Source(Protocol):
+    """Random-access bytes for `open_source()`. `read_at` is called from several threads at once."""
+
+    size: int
+
+    def read_at(self, offset: int, buffer: memoryview) -> int:
+        """Fills `buffer` with the bytes starting at `offset` and returns how many it wrote."""
+        ...
+
+
+_keys = itertools.count(1)
+_live: dict[int, object] = {}
+
+
+def _fail(error: Exception) -> int:
+    message = (str(error) or type(error).__name__).encode("utf-8", errors="replace")
+    _native.load_library().xl_set_source_error(message, len(message))
+    return -1
+
+
+def _view(address: int, length: int) -> memoryview:
+    return memoryview((ctypes.c_ubyte * length).from_address(address)).cast("B")
+
+
+@_native.SourceReadAt
+def _read_at(key: int, offset: int, buffer: int, length: int) -> int:
+    try:
+        return _live[key].read_at(offset, _view(buffer, length))
+    except Exception as error:  # noqa: BLE001
+        return _fail(error)
+
+
+@_native.StreamRead
+def _read(key: int, buffer: int, length: int) -> int:
+    try:
+        stream = _live[key]
+        readinto = getattr(stream, "readinto", None)
+        if readinto is None:
+            data = stream.read(length)
+            ctypes.memmove(buffer, data, len(data))
+            return len(data)
+        count = readinto(_view(buffer, length))
+        if count is None:
+            raise OSError("the stream has no data ready; open_stream() needs a blocking stream")
+        return count
+    except Exception as error:  # noqa: BLE001
+        return _fail(error)
+
+
+@_native.SourceRelease
+def _release(key: int) -> None:
+    _live.pop(key, None)
+
+
+def open_source(
+    source: Source, format: str | None = None, *, options: OpenOptions | None = None, password: str | None = None
+) -> Workbook:
+    """Opens a workbook over bytes `source` serves; every sheet can be read on its own thread.
+
+    The library keeps a reference to `source` until the workbook and everything read from it are
+    closed. `read_at` runs with the GIL held, so a local file is better opened with `open_workbook()`.
+    """
+    size = source.size
+    lib = _native.load_library()
+    resolved = _resolve_format(format, None)
+    key = next(_keys)
+    _live[key] = source
+    raw = _native.NativeSource(ctypes.sizeof(_native.NativeSource), key, size, _read_at, _release)
+    raw_options, _raw, _password_buffer = _raw_options(options, password)
+    handle = ctypes.c_void_p()
+    _check(lib.xl_open_source(ctypes.byref(raw), resolved, raw_options, ctypes.byref(handle)))
+    return Workbook(handle)
+
+
+def open_stream(
+    stream: object, format: str | None = None, *, options: OpenOptions | None = None, password: str | None = None
+) -> Workbook:
+    """Opens a workbook over a stream that cannot seek, such as `sys.stdin.buffer` or a socket.
+
+    A CSV (`format="csv"`) is read as it arrives and only once; an XLSX, XLSB or XLS is read whole
+    before the workbook opens. `stream` needs `readinto` or `read`; the library never closes it.
+    """
+    if not (hasattr(stream, "readinto") or hasattr(stream, "read")):
+        raise TypeError("open_stream() needs an object with readinto() or read()")
+    lib = _native.load_library()
+    resolved = _resolve_format(format, None)
+    key = next(_keys)
+    _live[key] = stream
+    raw = _native.NativeStream(ctypes.sizeof(_native.NativeStream), key, _read, _release)
+    raw_options, _raw, _password_buffer = _raw_options(options, password)
+    handle = ctypes.c_void_p()
+    _check(lib.xl_open_stream(ctypes.byref(raw), resolved, raw_options, ctypes.byref(handle)))
+    return Workbook(handle)
diff --git a/python/src/excelreader/types.py b/python/src/excelreader/types.py
index 8693c8c5..c562a61a 100644
--- a/python/src/excelreader/types.py
+++ b/python/src/excelreader/types.py
@@ -117,6 +117,10 @@ class OpenOptions(NamedTuple):
 
     `csv_delimiter` and `csv_quote` are byte values, not strings: pass `ord(';')`, not `';'`.
 
+    `source_block_size` and `source_cache_bytes` tune the block cache of `open_source()` (4 MiB blocks
+    in 64 MiB by default; a negative block size turns the cache off). `max_buffered_bytes` caps how
+    much `open_stream()` reads before an XLSX, XLSB or XLS opens.
+
     Validation happens on the native side, which owns the real limits; an out-of-range value raises
     `ExcelReaderError` with the reason. Fields mirror xl_open_options in
     src/ExcelReader.Native/include/excelreader.h.
@@ -134,6 +138,9 @@ class OpenOptions(NamedTuple):
     max_zip_entries: int | None = None
     prefetch_decompression: bool | None = None
     intern_strings: bool | None = None
+    source_block_size: int | None = None
+    source_cache_bytes: int | None = None
+    max_buffered_bytes: int | None = None
 
 
 class WriteOptions(NamedTuple):
diff --git a/python/tests/test_native.py b/python/tests/test_native.py
index 735934f1..291186b6 100644
--- a/python/tests/test_native.py
+++ b/python/tests/test_native.py
@@ -22,6 +22,9 @@ def test_exported_functions_are_present():
     for name in (
         "xl_open_file",
         "xl_open_memory",
+        "xl_open_source",
+        "xl_open_stream",
+        "xl_set_source_error",
         "xl_close",
         "xl_sheet_count",
         "xl_sheet_name_at",
diff --git a/python/tests/test_sources.py b/python/tests/test_sources.py
new file mode 100644
index 00000000..eceae2a1
--- /dev/null
+++ b/python/tests/test_sources.py
@@ -0,0 +1,140 @@
+import gc
+import io
+import os
+import threading
+import weakref
+from concurrent.futures import ThreadPoolExecutor
+
+import pytest
+from excelreader import ExcelReaderError, OpenOptions, open_bytes, open_source, open_stream, open_writer_to_memory
+from excelreader import sources as sources_module
+
+SHEETS = 4
+ROWS = 300
+
+
+def _workbook_bytes() -> bytes:
+    with open_writer_to_memory("xlsx") as writer:
+        for sheet in range(SHEETS):
+            writer.start_sheet(f"sheet{sheet}")
+            for row in range(ROWS):
+                writer.write_row([f"s{sheet}-r{row}"])
+            writer.end_sheet()
+        return writer.bytes()
+
+
+def _first_column(sheet) -> list[str]:
+    return [row[0].value for row in sheet.rows()]
+
+
+class BytesSource:
+    def __init__(self, data: bytes) -> None:
+        self.data = data
+        self.size = len(data)
+        self.reads = 0
+        self._lock = threading.Lock()
+
+    def read_at(self, offset: int, buffer: memoryview) -> int:
+        with self._lock:
+            self.reads += 1
+        chunk = self.data[offset : offset + len(buffer)]
+        buffer[: len(chunk)] = chunk
+        return len(chunk)
+
+
+class FailingSource:
+    size = 1024
+
+    def read_at(self, offset: int, buffer: memoryview) -> int:
+        raise OSError("disk on fire")
+
+
+class OnlyRead:
+    def __init__(self, data: bytes) -> None:
+        self._inner = io.BytesIO(data)
+
+    def read(self, size: int) -> bytes:
+        return self._inner.read(min(size, 7))
+
+
+def test_every_sheet_of_a_source_reads_in_parallel_like_memory():
+    data = _workbook_bytes()
+    with open_bytes(data) as reference:
+        expected = [_first_column(sheet) for sheet in reference.sheets]
+
+    with open_source(BytesSource(data)) as workbook, ThreadPoolExecutor(max_workers=SHEETS * 2) as pool:
+        sheets = list(workbook.sheets)
+        parallel = list(pool.map(_first_column, sheets + sheets))
+
+    for position, rows in enumerate(parallel):
+        assert rows == expected[position % SHEETS]
+
+
+def test_the_source_is_dropped_after_the_workbook_closes():
+    source = BytesSource(_workbook_bytes())
+    finalized = weakref.finalize(source, lambda: None)
+    workbook = open_source(source, "xlsx")
+    del source
+    _first_column(workbook.sheets[0])
+    workbook.close()
+    gc.collect()
+    assert not finalized.alive
+    assert sources_module._live == {}
+
+
+def test_a_source_error_reaches_the_caller_with_its_message():
+    with pytest.raises(ExcelReaderError, match="disk on fire"):
+        open_source(FailingSource(), "xlsx")
+
+
+def test_the_default_cache_fetches_a_small_workbook_once():
+    data = _workbook_bytes()
+    cached = BytesSource(data)
+    with open_source(cached, "xlsx") as workbook:
+        _first_column(workbook.sheets[0])
+    assert cached.reads == 1
+
+    uncached = BytesSource(data)
+    with open_source(uncached, "xlsx", options=OpenOptions(source_block_size=-1)) as workbook:
+        _first_column(workbook.sheets[0])
+    assert uncached.reads > 1
+
+
+def test_one_source_object_opened_twice_at_once_serves_both():
+    source = BytesSource(_workbook_bytes())
+    first = open_source(source, "xlsx")
+    second = open_source(source, "xlsx")
+    first.close()
+    assert _first_column(second.sheets[2])[0] == "s2-r0"
+    second.close()
+
+
+def test_open_stream_reads_a_csv_from_a_pipe():
+    read_fd, write_fd = os.pipe()
+
+    def produce() -> None:
+        with os.fdopen(write_fd, "wb") as out:
+            out.write(b"name,qty\n")
+            for i in range(1000):
+                out.write(f"row{i},{i}\n".encode())
+
+    producer = threading.Thread(target=produce)
+    producer.start()
+    with os.fdopen(read_fd, "rb") as pipe, open_stream(pipe, "csv") as workbook:
+        names = _first_column(workbook.sheets[0])
+    producer.join()
+    assert names[0] == "name"
+    assert len(names) == 1001
+    assert names[-1] == "row999"
+
+
+def test_open_stream_reads_an_xlsx_from_an_object_with_only_read():
+    with open_stream(OnlyRead(_workbook_bytes())) as workbook:
+        rows = _first_column(workbook.sheets[3])
+    assert rows[0] == "s3-r0"
+    assert len(rows) == ROWS
+
+
+def test_open_stream_rejects_an_object_that_cannot_be_read():
+    with pytest.raises(TypeError):
+        open_stream(object())

From 995dec97b63fdc55936a16e93fc4bf825f78c40b Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:14:05 -0300
Subject: [PATCH 014/115] fix(python): register a source only after every
 fallible step, and guard stream reads

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 python/src/excelreader/sources.py | 22 +++++++++-----
 python/tests/test_sources.py      | 49 ++++++++++++++++++++++++++++++-
 2 files changed, 63 insertions(+), 8 deletions(-)

diff --git a/python/src/excelreader/sources.py b/python/src/excelreader/sources.py
index f6a8931a..5c9a75af 100644
--- a/python/src/excelreader/sources.py
+++ b/python/src/excelreader/sources.py
@@ -4,6 +4,7 @@
 
 import ctypes
 import itertools
+import operator
 from typing import Protocol
 
 from excelreader import _native
@@ -38,7 +39,7 @@ def _view(address: int, length: int) -> memoryview:
 @_native.SourceReadAt
 def _read_at(key: int, offset: int, buffer: int, length: int) -> int:
     try:
-        return _live[key].read_at(offset, _view(buffer, length))
+        return operator.index(_live[key].read_at(offset, _view(buffer, length)))
     except Exception as error:  # noqa: BLE001
         return _fail(error)
 
@@ -49,12 +50,17 @@ def _read(key: int, buffer: int, length: int) -> int:
         stream = _live[key]
         readinto = getattr(stream, "readinto", None)
         if readinto is None:
-            data = stream.read(length)
+            data = bytes(stream.read(length))
+            if len(data) > length:
+                raise OSError("the stream returned more bytes than requested")
             ctypes.memmove(buffer, data, len(data))
             return len(data)
         count = readinto(_view(buffer, length))
         if count is None:
             raise OSError("the stream has no data ready; open_stream() needs a blocking stream")
+        count = operator.index(count)
+        if count > length:
+            raise OSError("the stream returned more bytes than requested")
         return count
     except Exception as error:  # noqa: BLE001
         return _fail(error)
@@ -73,14 +79,16 @@ def open_source(
     The library keeps a reference to `source` until the workbook and everything read from it are
     closed. `read_at` runs with the GIL held, so a local file is better opened with `open_workbook()`.
     """
-    size = source.size
+    size = operator.index(source.size)
+    if size < 0:
+        raise ValueError("source.size must not be negative")
     lib = _native.load_library()
     resolved = _resolve_format(format, None)
+    raw_options, _raw, _password_buffer = _raw_options(options, password)
     key = next(_keys)
-    _live[key] = source
     raw = _native.NativeSource(ctypes.sizeof(_native.NativeSource), key, size, _read_at, _release)
-    raw_options, _raw, _password_buffer = _raw_options(options, password)
     handle = ctypes.c_void_p()
+    _live[key] = source
     _check(lib.xl_open_source(ctypes.byref(raw), resolved, raw_options, ctypes.byref(handle)))
     return Workbook(handle)
 
@@ -97,10 +105,10 @@ def open_stream(
         raise TypeError("open_stream() needs an object with readinto() or read()")
     lib = _native.load_library()
     resolved = _resolve_format(format, None)
+    raw_options, _raw, _password_buffer = _raw_options(options, password)
     key = next(_keys)
-    _live[key] = stream
     raw = _native.NativeStream(ctypes.sizeof(_native.NativeStream), key, _read, _release)
-    raw_options, _raw, _password_buffer = _raw_options(options, password)
     handle = ctypes.c_void_p()
+    _live[key] = stream
     _check(lib.xl_open_stream(ctypes.byref(raw), resolved, raw_options, ctypes.byref(handle)))
     return Workbook(handle)
diff --git a/python/tests/test_sources.py b/python/tests/test_sources.py
index eceae2a1..97f4acf1 100644
--- a/python/tests/test_sources.py
+++ b/python/tests/test_sources.py
@@ -73,13 +73,15 @@ def test_every_sheet_of_a_source_reads_in_parallel_like_memory():
 def test_the_source_is_dropped_after_the_workbook_closes():
     source = BytesSource(_workbook_bytes())
     finalized = weakref.finalize(source, lambda: None)
+    before = set(sources_module._live)
     workbook = open_source(source, "xlsx")
+    assert len(sources_module._live) == len(before) + 1
     del source
     _first_column(workbook.sheets[0])
     workbook.close()
     gc.collect()
     assert not finalized.alive
-    assert sources_module._live == {}
+    assert set(sources_module._live) == before
 
 
 def test_a_source_error_reaches_the_caller_with_its_message():
@@ -138,3 +140,48 @@ def test_open_stream_reads_an_xlsx_from_an_object_with_only_read():
 def test_open_stream_rejects_an_object_that_cannot_be_read():
     with pytest.raises(TypeError):
         open_stream(object())
+
+
+def test_a_failed_open_leaves_nothing_registered():
+    before = set(sources_module._live)
+    source = BytesSource(_workbook_bytes())
+    with pytest.raises(ValueError):
+        open_source(source, "nope")
+    with pytest.raises(ValueError):
+        open_source(source, "xlsx", password="\ud800")
+    negative = BytesSource(b"")
+    negative.size = -1
+    with pytest.raises(ValueError):
+        open_source(negative, "xlsx")
+    with pytest.raises(ValueError):
+        open_stream(io.BytesIO(), "nope")
+    assert set(sources_module._live) == before
+
+
+def test_open_stream_fails_on_a_text_stream_and_releases_it():
+    before = set(sources_module._live)
+    with pytest.raises(ExcelReaderError), open_stream(io.StringIO("a,b\n1,2\n"), "csv") as workbook:
+        _first_column(workbook.sheets[0])
+    assert set(sources_module._live) == before
+
+
+def test_open_stream_fails_when_read_returns_more_than_asked():
+    class Greedy:
+        def read(self, size: int) -> bytes:
+            return b"x" * (size + 1)
+
+    before = set(sources_module._live)
+    with pytest.raises(ExcelReaderError, match="more bytes than requested"), open_stream(Greedy(), "csv") as workbook:
+        _first_column(workbook.sheets[0])
+    assert set(sources_module._live) == before
+
+
+def test_a_read_at_that_returns_none_reaches_the_caller_as_an_error():
+    class Bad:
+        size = 1024
+
+        def read_at(self, offset: int, buffer: memoryview):
+            return None
+
+    with pytest.raises(ExcelReaderError):
+        open_source(Bad(), "xlsx")

From fe9a3b6611af526dafcb5cbdc0782d1680c370a7 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:17:46 -0300
Subject: [PATCH 015/115] docs: read workbooks from your own sources and
 streams

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 cpp/README.md                    | 27 +++++++++++++++++++++++
 python/README.md                 | 36 +++++++++++++++++++++++++++++++
 rust/excelreader/README.md       | 37 ++++++++++++++++++++++++++++++++
 src/ExcelReader.Native/README.md | 35 +++++++++++++++++++++++++++++-
 4 files changed, 134 insertions(+), 1 deletion(-)

diff --git a/cpp/README.md b/cpp/README.md
index d21e5162..e8c0d794 100644
--- a/cpp/README.md
+++ b/cpp/README.md
@@ -245,6 +245,33 @@ if (!encrypted) { /* encrypted.error().message */ }
 Encryption parameters are fixed at Excel's own defaults — there are no options — and only XLSX/XLSB
 packages can be encrypted, matching what `Workbook::open`/`open_memory` can decrypt.
 
+### Reading from your own bytes
+
+Derive from `xl::Source` to read from anything you can read at an offset; `read_at` is called from
+several threads, in cached 4 MiB blocks. Derive from `xl::InputStream` for a stream that cannot
+seek: a CSV is read as it arrives, an XLSX, XLSB or XLS is read whole first.
+
+```cpp
+class StdinStream final : public xl::InputStream
+{
+public:
+    std::expected<std::size_t, std::string> read(std::span<std::byte> buffer) override
+    {
+        std::cin.read(reinterpret_cast<char *>(buffer.data()), static_cast<std::streamsize>(buffer.size()));
+        if (std::cin.bad())
+        {
+            return std::unexpected(std::string("reading stdin failed"));
+        }
+        return static_cast<std::size_t>(std::cin.gcount());
+    }
+};
+
+auto workbook = xl::Workbook::open_stream(std::make_unique<StdinStream>(), XL_FORMAT_CSV);
+```
+
+The workbook owns the object you pass and deletes it once nothing needs it. A returned error
+string or a thrown exception becomes the `xl::Error` of the call that needed the bytes.
+
 ### Arrow export
 
 `<xl/excelreader_arrow.hpp>` is a separate header — including `<xl/excelreader.hpp>` never pulls the
diff --git a/python/README.md b/python/README.md
index 74160f1e..8322f20e 100644
--- a/python/README.md
+++ b/python/README.md
@@ -380,6 +380,42 @@ with open_bytes(payload) as workbook:
     ...
 ```
 
+### From your own bytes
+
+`open_source()` takes any object with a `size` and a `read_at(offset, buffer)` that fills `buffer`
+and returns the count. The library asks for 4 MiB blocks and caches them, and every sheet can still
+be read on its own thread.
+
+```python
+import urllib.request
+
+class HttpSource:
+    def __init__(self, url):
+        self.url = url
+        with urllib.request.urlopen(urllib.request.Request(url, method="HEAD")) as response:
+            self.size = int(response.headers["Content-Length"])
+
+    def read_at(self, offset, buffer):
+        request = urllib.request.Request(self.url, headers={"Range": f"bytes={offset}-{offset + len(buffer) - 1}"})
+        with urllib.request.urlopen(request) as response:
+            data = response.read()
+        buffer[: len(data)] = data
+        return len(data)
+
+with open_source(HttpSource("https://example.com/book.xlsx")) as workbook:
+    ...
+```
+
+`open_stream()` reads anything with `readinto()` or `read()`, such as `sys.stdin.buffer`. A CSV is
+read as it arrives; an XLSX, XLSB or XLS is read whole first.
+
+```python
+with open_stream(sys.stdin.buffer, "csv") as workbook:
+    ...
+```
+
+Both callbacks run with the GIL held. For a file on disk, `open_workbook()` is faster.
+
 ### Reader options
 
 `open_workbook()`/`open_bytes()` take an optional `OpenOptions` for CSV dialect settings and reader
diff --git a/rust/excelreader/README.md b/rust/excelreader/README.md
index 7727bbef..80db3161 100644
--- a/rust/excelreader/README.md
+++ b/rust/excelreader/README.md
@@ -147,6 +147,43 @@ encrypt_package("plain.xlsx", "secret.xlsx", "hunter2")?;
 Encryption parameters are fixed at Excel's own defaults - there are no options - and only XLSX/XLSB
 packages can be encrypted, matching what `Workbook::open_with`/`open_memory` can decrypt.
 
+### Reading from your own bytes
+
+Implement [`Source`] to read from anything you can read at an offset. The library calls `read_at`
+from several threads, fetching 4 MiB blocks it caches; every sheet can still be read in parallel.
+
+```rust
+struct HttpSource { client: reqwest::blocking::Client, url: String, size: u64 }
+
+impl excelreader::Source for HttpSource {
+    fn size(&self) -> std::io::Result<u64> {
+        Ok(self.size)
+    }
+
+    fn read_at(&self, offset: u64, buf: &mut [u8]) -> std::io::Result<usize> {
+        let range = format!("bytes={}-{}", offset, offset + buf.len() as u64 - 1);
+        let bytes = self.client.get(&self.url).header("Range", range).send()
+            .and_then(|r| r.error_for_status())
+            .and_then(|r| r.bytes())
+            .map_err(std::io::Error::other)?;
+        buf[..bytes.len()].copy_from_slice(&bytes);
+        Ok(bytes.len())
+    }
+}
+
+let workbook = Workbook::open_source(source, XL_FORMAT_AUTO, None)?;
+```
+
+Anything that implements `Read` works through `open_reader`. A CSV is read as it arrives; an XLSX,
+XLSB or XLS is read whole first.
+
+```rust
+let workbook = Workbook::open_reader(std::io::stdin(), XL_FORMAT_CSV, None)?;
+```
+
+An `io::Error` from your source, or a panic in it, comes back as the `Error` of the call that
+needed the bytes.
+
 ### Arrow export (`arrow` feature)
 
 ```toml
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index fb8a4b7d..302f6a94 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -52,7 +52,8 @@ may get worse, not only better.
 | `Reading/RowViewBuffer.cs` | Cursor-owned native row behind `xl_rows_next_view`. |
 | `include/excelreader.h` | Hand-written C header; keep in sync with `Exports*.cs`. |
 
-Reading exports: `xl_open_file`, `xl_open_memory`, `xl_close`, `xl_sheet_count`, `xl_sheet_name_at`,
+Reading exports: `xl_open_file`, `xl_open_memory`, `xl_open_source`, `xl_open_stream`,
+`xl_set_source_error`, `xl_close`, `xl_sheet_count`, `xl_sheet_name_at`,
 `xl_sheet_visibility_at`, `xl_sheet_index`, `xl_is_date1904`, `xl_rows_open`, `xl_rows_next`,
 `xl_rows_next_view`, `xl_rows_read_all_blob`, `xl_rows_read_all_decoded`, `xl_rows_close`,
 `xl_free_rows`, `xl_parse_typed`, `xl_free_table`, `xl_typed_reader_open`, `xl_typed_reader_next`,
@@ -143,3 +144,35 @@ To produce one, `xl_encrypt_package` wraps a finished XLSX/XLSB file in the encr
 `xl_encrypt_package_to_memory` does the same over bytes, so a package written with
 `xl_write_typed_to_memory` is encrypted without its plaintext ever reaching disk. Release the result
 with `xl_free_buffer`.
+
+## Opening from your own bytes
+
+`xl_open_source` reads through a callback that copies bytes at an offset, from any thread. Use it
+for S3, HTTP range requests or any store you can read at an offset; every sheet can still be read
+in parallel. By default the library asks for 4 MiB blocks and keeps 64 MiB of them
+(`source_block_size`, `source_cache_bytes` in `xl_open_options`).
+
+`xl_open_stream` reads through a callback that copies the next bytes. A CSV is read as it arrives,
+by one cursor; an XLSX, XLSB or XLS is read whole first (`max_buffered_bytes` caps it), because
+those formats need random access.
+
+Both take ownership: `release` runs exactly once, when nothing needs the bytes any more. A failing
+callback calls `xl_set_source_error` and returns -1; that message is what `xl_last_error` reports.
+Inside a callback, no other `xl_` function may be called.
+
+```c
+static int64_t read_at(void* user_data, int64_t offset, uint8_t* buf, int64_t len)
+{
+    my_blob* blob = user_data;
+    int64_t got = my_blob_read(blob, offset, buf, len);   /* your store */
+    if (got < 0) {
+        const char* message = my_blob_error(blob);
+        xl_set_source_error((const uint8_t*)message, (int32_t)strlen(message));
+    }
+    return got;
+}
+
+xl_source source = { sizeof(xl_source), blob, my_blob_size(blob), read_at, my_blob_free };
+xl_workbook* workbook = NULL;
+int32_t status = xl_open_source(&source, XL_FORMAT_AUTO, NULL, &workbook);
+```

From 79f6201322ae437a1e2ba657f21ed0c967d9fbe0 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 15:33:32 -0300
Subject: [PATCH 016/115] fix: final-review fixes for callback sources

Python callbacks now catch BaseException so Ctrl-C fails the read instead of
truncating a CSV stream. C++ open_source rejects a size above INT64_MAX before
releasing the source, and the C++ tests cover destruction on failure, parallel
reads and stream errors. The smoke test pins the 88-byte 6.0 options struct.
Source error wording no longer claims 0 is valid, StreamBuffer clamps its limit
to Array.MaxLength, and the header, docstring and READMEs are tightened.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 cpp/tests/CMakeLists.txt                      |   3 +-
 cpp/tests/sources.cpp                         | 111 +++++++++++++++++-
 python/README.md                              |   6 +
 python/src/excelreader/sources.py             |  11 +-
 python/tests/test_sources.py                  |  11 ++
 src/ExcelReader.Native/README.md              |   8 +-
 .../Reading/SourceErrors.cs                   |   2 +-
 .../Reading/StreamBuffer.cs                   |   1 +
 src/ExcelReader.Native/include/excelreader.h  |   6 +-
 .../include/excelreader.hpp                   |   8 +-
 tests/ExcelReader.NativeSmoke/smoke.c         |   8 ++
 11 files changed, 160 insertions(+), 15 deletions(-)

diff --git a/cpp/tests/CMakeLists.txt b/cpp/tests/CMakeLists.txt
index 67467e16..a91732ae 100644
--- a/cpp/tests/CMakeLists.txt
+++ b/cpp/tests/CMakeLists.txt
@@ -39,7 +39,8 @@ add_test(NAME excelreader_cpp_rows COMMAND excelreader_cpp_rows)
 excelreader_copy_native_library(excelreader_cpp_rows)
 
 add_executable(excelreader_cpp_sources sources.cpp)
-target_link_libraries(excelreader_cpp_sources PRIVATE xl::excelreader)
+find_package(Threads REQUIRED)
+target_link_libraries(excelreader_cpp_sources PRIVATE xl::excelreader Threads::Threads)
 target_compile_definitions(excelreader_cpp_sources PRIVATE
     EXCELREADER_XLSX_FIXTURE_PATH="${EXCELREADER_XLSX_FIXTURE_PATH}")
 
diff --git a/cpp/tests/sources.cpp b/cpp/tests/sources.cpp
index 1bcc958f..a84afe35 100644
--- a/cpp/tests/sources.cpp
+++ b/cpp/tests/sources.cpp
@@ -10,6 +10,7 @@
 #include <memory>
 #include <stdexcept>
 #include <string>
+#include <thread>
 #include <vector>
 
 namespace
@@ -68,21 +69,42 @@ namespace
     class FailingSource final : public xl::Source
     {
     public:
+        explicit FailingSource(Counters &counters) : counters_(counters) {}
+        ~FailingSource() override { counters_.destroyed.fetch_add(1); }
+
         std::uint64_t size() const override { return 1024; }
         std::expected<std::size_t, std::string> read_at(std::uint64_t, std::span<std::byte>) const override
         {
             return std::unexpected(std::string("disk on fire"));
         }
+
+    private:
+        Counters &counters_;
     };
 
     class ThrowingSource final : public xl::Source
     {
     public:
+        explicit ThrowingSource(Counters &counters) : counters_(counters) {}
+        ~ThrowingSource() override { counters_.destroyed.fetch_add(1); }
+
         std::uint64_t size() const override { return 1024; }
         std::expected<std::size_t, std::string> read_at(std::uint64_t, std::span<std::byte>) const override
         {
             throw std::runtime_error("boom");
         }
+
+    private:
+        Counters &counters_;
+    };
+
+    class ErrorStream final : public xl::InputStream
+    {
+    public:
+        std::expected<std::size_t, std::string> read(std::span<std::byte>) override
+        {
+            return std::unexpected(std::string("pipe broke"));
+        }
     };
 
     class ChunkStream final : public xl::InputStream
@@ -103,6 +125,50 @@ namespace
         std::size_t position_ = 0;
     };
 
+    std::vector<std::byte> build_sheets(int sheet_count, int row_count)
+    {
+        auto writer = xl::WriterHandle::open_memory(XL_FORMAT_XLSX);
+        std::vector<std::byte> bytes;
+        if (!writer.has_value())
+        {
+            return bytes;
+        }
+        for (int s = 0; s < sheet_count; ++s)
+        {
+            (void)writer->start_sheet("sheet" + std::to_string(s));
+            for (int r = 0; r < row_count; ++r)
+            {
+                (void)writer->start_row();
+                (void)writer->write("s" + std::to_string(s) + "-r" + std::to_string(r));
+                (void)writer->end_row();
+            }
+            (void)writer->end_sheet();
+        }
+        auto written = writer->bytes();
+        if (written.has_value())
+        {
+            bytes.resize(written->size());
+            std::memcpy(bytes.data(), written->data(), written->size());
+        }
+        return bytes;
+    }
+
+    std::vector<std::string> first_column(const xl::Workbook &workbook, int32_t sheet)
+    {
+        std::vector<std::string> values;
+        auto cursor = workbook.sheet(sheet).rows();
+        while (cursor.has_value())
+        {
+            auto row = cursor->next_row();
+            if (!row.has_value())
+            {
+                break;
+            }
+            values.emplace_back((*row)[0].value);
+        }
+        return values;
+    }
+
     std::size_t row_count(const xl::Workbook &workbook)
     {
         auto decoded = workbook.sheet(0).read_all_decoded();
@@ -139,14 +205,55 @@ int main()
     check(uncached.reads.load() > blocks, "without the cache every read reaches read_at");
 
     {
-        auto workbook = xl::Workbook::open_source(std::make_unique<FailingSource>(), XL_FORMAT_XLSX);
+        Counters failing;
+        auto workbook = xl::Workbook::open_source(std::make_unique<FailingSource>(failing), XL_FORMAT_XLSX);
         check(!workbook.has_value() && workbook.error().message.find("disk on fire") != std::string::npos,
               "the source's error message reaches the caller");
+        check(failing.destroyed.load() == 1, "a source whose read failed is destroyed exactly once");
     }
     {
-        auto workbook = xl::Workbook::open_source(std::make_unique<ThrowingSource>(), XL_FORMAT_XLSX);
+        Counters throwing;
+        auto workbook = xl::Workbook::open_source(std::make_unique<ThrowingSource>(throwing), XL_FORMAT_XLSX);
         check(!workbook.has_value() && workbook.error().message.find("boom") != std::string::npos,
               "an exception from the source becomes an error");
+        check(throwing.destroyed.load() == 1, "a source that threw is destroyed exactly once");
+    }
+    {
+        auto workbook = xl::Workbook::open_stream(std::make_unique<ErrorStream>(), XL_FORMAT_XLSX);
+        check(!workbook.has_value() && workbook.error().message.find("pipe broke") != std::string::npos,
+              "the stream's error message reaches the caller");
+    }
+    {
+        constexpr int sheet_count = 4;
+        const std::vector<std::byte> many = build_sheets(sheet_count, 300);
+        check(!many.empty(), "build the multi-sheet workbook");
+        Counters parallel_counters;
+        auto reference_many = xl::Workbook::open_memory(std::span<const uint8_t>(reinterpret_cast<const uint8_t *>(many.data()), many.size()));
+        auto workbook = xl::Workbook::open_source(std::make_unique<MemorySource>(many, parallel_counters), XL_FORMAT_XLSX);
+        check(reference_many.has_value() && workbook.has_value(), "open the multi-sheet workbook both ways");
+        if (reference_many.has_value() && workbook.has_value())
+        {
+            std::vector<std::vector<std::string>> parallel(sheet_count * 2);
+            {
+                std::vector<std::thread> threads;
+                for (std::size_t i = 0; i < parallel.size(); ++i)
+                {
+                    threads.emplace_back([&parallel, &workbook, i]
+                                         { parallel[i] = first_column(*workbook, static_cast<int32_t>(i % sheet_count)); });
+                }
+                for (std::thread &thread : threads)
+                {
+                    thread.join();
+                }
+            }
+            bool same = true;
+            for (std::size_t i = 0; i < parallel.size(); ++i)
+            {
+                const auto expected = first_column(*reference_many, static_cast<int32_t>(i % sheet_count));
+                same = same && expected.size() == 300 && parallel[i] == expected;
+            }
+            check(same, "every sheet of a source read on its own thread matches the in-memory read");
+        }
     }
     {
         const std::string csv = "name,qty\nwidget,7\n";
diff --git a/python/README.md b/python/README.md
index 8322f20e..a7ffba44 100644
--- a/python/README.md
+++ b/python/README.md
@@ -389,6 +389,8 @@ be read on its own thread.
 ```python
 import urllib.request
 
+from excelreader import open_source
+
 class HttpSource:
     def __init__(self, url):
         self.url = url
@@ -410,6 +412,10 @@ with open_source(HttpSource("https://example.com/book.xlsx")) as workbook:
 read as it arrives; an XLSX, XLSB or XLS is read whole first.
 
 ```python
+import sys
+
+from excelreader import open_stream
+
 with open_stream(sys.stdin.buffer, "csv") as workbook:
     ...
 ```
diff --git a/python/src/excelreader/sources.py b/python/src/excelreader/sources.py
index 5c9a75af..3cf52826 100644
--- a/python/src/excelreader/sources.py
+++ b/python/src/excelreader/sources.py
@@ -18,7 +18,10 @@ class Source(Protocol):
     size: int
 
     def read_at(self, offset: int, buffer: memoryview) -> int:
-        """Fills `buffer` with the bytes starting at `offset` and returns how many it wrote."""
+        """Fills `buffer` with the bytes starting at `offset` and returns how many it wrote.
+
+        `buffer` is valid only during the call; do not retain it.
+        """
         ...
 
 
@@ -26,7 +29,7 @@ def read_at(self, offset: int, buffer: memoryview) -> int:
 _live: dict[int, object] = {}
 
 
-def _fail(error: Exception) -> int:
+def _fail(error: BaseException) -> int:
     message = (str(error) or type(error).__name__).encode("utf-8", errors="replace")
     _native.load_library().xl_set_source_error(message, len(message))
     return -1
@@ -40,7 +43,7 @@ def _view(address: int, length: int) -> memoryview:
 def _read_at(key: int, offset: int, buffer: int, length: int) -> int:
     try:
         return operator.index(_live[key].read_at(offset, _view(buffer, length)))
-    except Exception as error:  # noqa: BLE001
+    except BaseException as error:  # noqa: BLE001
         return _fail(error)
 
 
@@ -62,7 +65,7 @@ def _read(key: int, buffer: int, length: int) -> int:
         if count > length:
             raise OSError("the stream returned more bytes than requested")
         return count
-    except Exception as error:  # noqa: BLE001
+    except BaseException as error:  # noqa: BLE001
         return _fail(error)
 
 
diff --git a/python/tests/test_sources.py b/python/tests/test_sources.py
index 97f4acf1..ea5a8a88 100644
--- a/python/tests/test_sources.py
+++ b/python/tests/test_sources.py
@@ -176,6 +176,17 @@ def read(self, size: int) -> bytes:
     assert set(sources_module._live) == before
 
 
+def test_open_stream_fails_when_read_raises_keyboard_interrupt_and_releases_it():
+    class Interrupted:
+        def read(self, size: int) -> bytes:
+            raise KeyboardInterrupt
+
+    before = set(sources_module._live)
+    with pytest.raises(ExcelReaderError), open_stream(Interrupted(), "csv") as workbook:
+        _first_column(workbook.sheets[0])
+    assert set(sources_module._live) == before
+
+
 def test_a_read_at_that_returns_none_reaches_the_caller_as_an_error():
     class Bad:
         size = 1024
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index 302f6a94..0c779c3d 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -134,10 +134,10 @@ if (status == XL_STATUS_PASSWORD_REQUIRED || status == XL_STATUS_PASSWORD_INCORR
 
 This is why `XL_ABI_VERSION` moved from 3 to 4: `password`/`password_len` are new fields at the end
 of `xl_open_options`, so a caller built against the old, smaller struct passes the old, smaller
-`sizeof(xl_open_options)` as `struct_size` — any size other than the current one is rejected outright with
-`XL_INVALID_ARGUMENT` (the 6.0 size, 88 bytes, is the one exception: it is also accepted, read as a prefix
-with the newer fields defaulted) instead of the library reading two garbage fields past the end of the caller's
-allocation. Check `xl_abi_version()` against `XL_ABI_VERSION` (see above) and rebuild against the
+`sizeof(xl_open_options)` as `struct_size`. Any size other than the current one is rejected outright with
+`XL_INVALID_ARGUMENT` instead of the library reading two garbage fields past the end of the caller's
+allocation, except the 6.0 size of 88 bytes, which is also accepted and read as a prefix with the newer
+fields defaulted. Check `xl_abi_version()` against `XL_ABI_VERSION` (see above) and rebuild against the
 current header rather than only relying on the `struct_size` check to catch it.
 
 To produce one, `xl_encrypt_package` wraps a finished XLSX/XLSB file in the encrypted container, and
diff --git a/src/ExcelReader.Native/Reading/SourceErrors.cs b/src/ExcelReader.Native/Reading/SourceErrors.cs
index 65d75ae7..811e317f 100644
--- a/src/ExcelReader.Native/Reading/SourceErrors.cs
+++ b/src/ExcelReader.Native/Reading/SourceErrors.cs
@@ -22,7 +22,7 @@ internal static IOException Failed(string where, long got, long requested)
             _pending = null;
             return got == -1
                 ? new IOException(message ?? $"{where} failed.")
-                : new IOException($"{where} returned {got} for a request of {requested} bytes; expected 0 to {requested}, or -1 on failure.");
+                : new IOException($"{where} returned {got} for a request of {requested} bytes, which is not a valid result.");
         }
     }
 }
diff --git a/src/ExcelReader.Native/Reading/StreamBuffer.cs b/src/ExcelReader.Native/Reading/StreamBuffer.cs
index e2570f03..0cfd1391 100644
--- a/src/ExcelReader.Native/Reading/StreamBuffer.cs
+++ b/src/ExcelReader.Native/Reading/StreamBuffer.cs
@@ -7,6 +7,7 @@ internal static class StreamBuffer
     {
         internal static ReadOnlyMemory<byte> ReadAll(Stream stream, long limit)
         {
+            limit = Math.Min(limit, Array.MaxLength);
             MemoryStream buffer = new();
             byte[] chunk = ArrayPool<byte>.Shared.Rent(81_920);
             try
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 5deb8192..c0cbfda5 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -107,7 +107,8 @@ typedef struct xl_source {
     int64_t length;          /* total size in bytes */
     /* Copy up to len bytes starting at offset into buf. Return the bytes copied, or -1 on failure
        after calling xl_set_source_error. Returning 0 before length is a failure ("the source ended
-       early"). Called from any thread, concurrently. */
+       early"). Returning more than len, or a negative other than -1, is a failure. Called from any
+       thread, concurrently. */
     int64_t (*read_at)(void* user_data, int64_t offset, uint8_t* buf, int64_t len);
     /* May be NULL. Called exactly once, when nothing opened from the workbook needs the source. */
     void (*release)(void* user_data);
@@ -126,7 +127,8 @@ typedef struct xl_stream {
     int32_t struct_size;     /* sizeof(xl_stream) */
     void* user_data;
     /* Copy up to len bytes into buf. Return the bytes copied (0 at the end), or -1 on failure after
-       calling xl_set_source_error. Never called concurrently. */
+       calling xl_set_source_error. Returning more than len, or a negative other than -1, is a failure.
+       Never called concurrently. */
     int64_t (*read)(void* user_data, uint8_t* buf, int64_t len);
     /* May be NULL. Called exactly once. */
     void (*release)(void* user_data);
diff --git a/src/ExcelReader.Native/include/excelreader.hpp b/src/ExcelReader.Native/include/excelreader.hpp
index 45d59dec..c17ae596 100644
--- a/src/ExcelReader.Native/include/excelreader.hpp
+++ b/src/ExcelReader.Native/include/excelreader.hpp
@@ -8,6 +8,7 @@
 #include <concepts>
 #include <cstdint>
 #include <cstring>
+#include <exception>
 #include <expected>
 #include <iterator>
 #include <limits>
@@ -946,9 +947,14 @@ namespace xl
             {
                 return std::unexpected(Error{XL_INVALID_ARGUMENT, "source is null"});
             }
+            const std::uint64_t size = source->size();
+            if (size > static_cast<std::uint64_t>(std::numeric_limits<int64_t>::max()))
+            {
+                return std::unexpected(Error{XL_INVALID_ARGUMENT, "source size exceeds INT64_MAX"});
+            }
             xl_source raw{};
             raw.struct_size = sizeof(xl_source);
-            raw.length = static_cast<int64_t>(source->size());
+            raw.length = static_cast<int64_t>(size);
             raw.read_at = &detail::source_read_at;
             raw.release = &detail::source_release;
             raw.user_data = source.release();
diff --git a/tests/ExcelReader.NativeSmoke/smoke.c b/tests/ExcelReader.NativeSmoke/smoke.c
index 7536fbdb..3e5a9639 100644
--- a/tests/ExcelReader.NativeSmoke/smoke.c
+++ b/tests/ExcelReader.NativeSmoke/smoke.c
@@ -522,6 +522,14 @@ static int test_open_file_options(const api_t* api, const char* fixture)
     int32_t status = api->open_file((const uint8_t*)fixture, (int32_t)path_len, XL_FORMAT_XLSB, &bad_options, &handle);
     CHECK(status == XL_INVALID_ARGUMENT, "a wrong xl_open_options.struct_size must be XL_INVALID_ARGUMENT");
     CHECK(handle == NULL, "a rejected xl_open_file must not hand back a handle");
+
+    xl_open_options v6_options;
+    memset(&v6_options, 0, sizeof(v6_options));
+    v6_options.struct_size = 88;
+    handle = NULL;
+    status = api->open_file((const uint8_t*)fixture, (int32_t)path_len, XL_FORMAT_XLSB, &v6_options, &handle);
+    CHECK(status == XL_OK, "the 88-byte 6.0 xl_open_options must still be accepted");
+    CHECK(api->close_(handle) == XL_OK, "xl_close must succeed");
     return 0;
 }
 

From e269dc61cece60a4b15ac56d183d16d55a960347 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 16:38:14 -0300
Subject: [PATCH 017/115] feat: enhance CSV stream handling to support schema
 inference and replay functionality

---
 python/README.md                              |   3 +-
 python/scripts/build_native.py                |  13 ++
 python/src/excelreader/sources.py             |   3 +-
 python/tests/test_sources.py                  |  11 ++
 rust/excelreader/src/source.rs                |   4 +-
 src/ExcelReader.Core/Reader/Csv/CsvReader.cs  |  35 ++--
 .../Reader/Csv/ReplayStream.cs                | 137 +++++++++++++++
 src/ExcelReader.Native/README.md              |   3 +-
 src/ExcelReader.Native/include/excelreader.h  |   8 +-
 .../include/excelreader.hpp                   |   3 +-
 .../Native/CallbackStreamTests.cs             |  14 +-
 .../Reader/Csv/CsvReaderTests.cs              |   4 +-
 .../Reader/Csv/CsvReplayTests.cs              | 159 ++++++++++++++++++
 13 files changed, 367 insertions(+), 30 deletions(-)
 create mode 100644 src/ExcelReader.Core/Reader/Csv/ReplayStream.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs

diff --git a/python/README.md b/python/README.md
index a7ffba44..a2bf19ce 100644
--- a/python/README.md
+++ b/python/README.md
@@ -409,7 +409,8 @@ with open_source(HttpSource("https://example.com/book.xlsx")) as workbook:
 ```
 
 `open_stream()` reads anything with `readinto()` or `read()`, such as `sys.stdin.buffer`. A CSV is
-read as it arrives; an XLSX, XLSB or XLS is read whole first.
+read as it arrives, and its first 16 MiB are kept so that `infer_schema()` followed by a read works;
+an XLSX, XLSB or XLS is read whole first.
 
 ```python
 import sys
diff --git a/python/scripts/build_native.py b/python/scripts/build_native.py
index adaa3fe4..c85cf58d 100644
--- a/python/scripts/build_native.py
+++ b/python/scripts/build_native.py
@@ -4,6 +4,7 @@
 """
 
 import argparse
+import os
 import platform
 import shutil
 import subprocess
@@ -32,6 +33,17 @@ def default_rid() -> str:
     return f"linux-{arch}"
 
 
+def publish_environment() -> dict[str, str]:
+    """The NativeAOT linker step finds MSVC through vswhere, which the installer keeps off PATH."""
+    environment = dict(os.environ)
+    if platform.system() == "Windows" and shutil.which("vswhere") is None:
+        program_files = environment.get("ProgramFiles(x86)", r"C:\Program Files (x86)")
+        installer = Path(program_files) / "Microsoft Visual Studio" / "Installer"
+        if (installer / "vswhere.exe").exists():
+            environment["PATH"] = environment.get("PATH", "") + os.pathsep + str(installer)
+    return environment
+
+
 def main() -> int:
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument("--rid", default=default_rid(), help="dotnet runtime identifier")
@@ -41,6 +53,7 @@ def main() -> int:
     subprocess.run(
         ["dotnet", "publish", str(CSPROJ), "-c", "Release", "-f", args.framework, "-r", args.rid],
         check=True,
+        env=publish_environment(),
     )
 
     publish_dir = CSPROJ.parent / "bin" / "Release" / args.framework / args.rid / "publish"
diff --git a/python/src/excelreader/sources.py b/python/src/excelreader/sources.py
index 3cf52826..ba6aab91 100644
--- a/python/src/excelreader/sources.py
+++ b/python/src/excelreader/sources.py
@@ -101,7 +101,8 @@ def open_stream(
 ) -> Workbook:
     """Opens a workbook over a stream that cannot seek, such as `sys.stdin.buffer` or a socket.
 
-    A CSV (`format="csv"`) is read as it arrives and only once; an XLSX, XLSB or XLS is read whole
+    A CSV (`format="csv"`) is read as it arrives, and can be read again from the start
+    (`infer_schema()`, then a read) until 16 MiB of it were read; an XLSX, XLSB or XLS is read whole
     before the workbook opens. `stream` needs `readinto` or `read`; the library never closes it.
     """
     if not (hasattr(stream, "readinto") or hasattr(stream, "read")):
diff --git a/python/tests/test_sources.py b/python/tests/test_sources.py
index ea5a8a88..a8353732 100644
--- a/python/tests/test_sources.py
+++ b/python/tests/test_sources.py
@@ -130,6 +130,17 @@ def produce() -> None:
     assert names[-1] == "row999"
 
 
+def test_a_csv_stream_serves_a_schema_inference_and_then_every_row():
+    data = b"name,qty\n" + b"".join(f"row{i},{i}\n".encode() for i in range(5000))
+    with open_stream(OnlyRead(data), "csv") as workbook:
+        sheet = workbook.sheets[0]
+        schema = sheet.infer_schema(parse_text=True)
+        names = _first_column(sheet)
+    assert len(schema) == 2
+    assert len(names) == 5001
+    assert names[-1] == "row4999"
+
+
 def test_open_stream_reads_an_xlsx_from_an_object_with_only_read():
     with open_stream(OnlyRead(_workbook_bytes())) as workbook:
         rows = _first_column(workbook.sheets[3])
diff --git a/rust/excelreader/src/source.rs b/rust/excelreader/src/source.rs
index b35a4105..12ea90bf 100644
--- a/rust/excelreader/src/source.rs
+++ b/rust/excelreader/src/source.rs
@@ -42,8 +42,8 @@ impl Workbook {
         Ok(Workbook::from_handle(handle))
     }
 
-    /// Opens a workbook over `reader`, which cannot seek. A CSV is read as it arrives, once; an
-    /// XLSX, XLSB or XLS is read whole first. The library owns `reader` from here on.
+    /// Opens a workbook over `reader`, which cannot seek. A CSV is read as it arrives, and
+    /// again from the start until 16 MiB of it were read; an XLSX, XLSB or XLS is read whole first. The library owns `reader` from here on.
     pub fn open_reader<R: Read + Send + 'static>(reader: R, format: i32, options: Option<&OpenOptions>) -> Result<Workbook, Error> {
         check_abi_version()?;
         let raw = XlStream {
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
index 5ef80d2e..fde2ae72 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
@@ -18,14 +18,14 @@ public sealed partial class CsvReader : IExcelWorkbook
         [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed", Justification = "An alias of the stream the ByteSource owns; ReleaseResources disposes the source.")]
         private readonly FileStream? _file;
         [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed", Justification = "Disposed by ReleaseResources, which the lifetime runs after the last enumerator.")]
-        private readonly Stream? _stream;
-        private readonly bool _leaveOpen;
+        private readonly ReplayStream? _stream;
         private readonly CsvReaderOptions _options;
         private readonly ReadOnlyMemory<byte> _memory;
         private readonly ExcelSheetList<CsvSheet> _sheetList;
-        private int _enumeratedOnce;
         private SafeFileHandle? _chunkHandle;
 
+        internal const int ReplayLimit = 16 * 1024 * 1024;
+
         internal ReaderLifetime Lifetime { get; }
 
         internal CsvReader(Stream stream, bool leaveOpen, CsvReaderOptions? options = null)
@@ -39,17 +39,15 @@ internal CsvReader(Stream stream, bool leaveOpen, CsvReaderOptions? options = nu
                 _sourceStart = stream.Position;
                 _file = stream as FileStream;
                 _source = ByteSource.FromStream(stream, leaveOpen);
-                _leaveOpen = true;
             }
             else if (NeedsTranscoding(_options.Encoding))
             {
-                _stream = Encoding.CreateTranscodingStream(stream, _options.Encoding!, Encoding.UTF8, leaveOpen);
-                _leaveOpen = false;
+                Stream transcoding = Encoding.CreateTranscodingStream(stream, _options.Encoding!, Encoding.UTF8, leaveOpen);
+                _stream = new ReplayStream(transcoding, leaveOpen: false, ReplayLimit);
             }
             else
             {
-                _stream = stream;
-                _leaveOpen = leaveOpen;
+                _stream = new ReplayStream(stream, leaveOpen, ReplayLimit);
             }
             _sheetList = new ExcelSheetList<CsvSheet>([new CsvSheet(this)]);
         }
@@ -65,7 +63,6 @@ internal CsvReader(ReadOnlyMemory<byte> data, CsvReaderOptions? options = null)
             ValidateOptions(_options);
             Lifetime = new ReaderLifetime(ReleaseResources);
             _stream = null;
-            _leaveOpen = true;
             _memory = Transcode(data, _options.Encoding);
             _sheetList = new ExcelSheetList<CsvSheet>([new CsvSheet(this)]);
         }
@@ -223,12 +220,21 @@ internal Enumerator OpenSheet(CancellationToken ct = default)
                 {
                     return new Enumerator(_memory, _options, Lifetime, ct);
                 }
-                if (Interlocked.Exchange(ref _enumeratedOnce, 1) != 0)
+                if (!_stream.TryBeginPass())
                 {
                     throw new InvalidOperationException(
-                        "This CsvReader is over a non-seekable stream and can only be enumerated once.");
+                        "This CsvReader is over a non-seekable stream and cannot be enumerated again: "
+                        + $"an enumeration is still open, or one has read past the first {ReplayLimit} bytes.");
+                }
+                try
+                {
+                    return new Enumerator(_stream, _options, ownsSource: true, Lifetime, ct);
+                }
+                catch
+                {
+                    _stream.Dispose();
+                    throw;
                 }
-                return new Enumerator(_stream, _options, ownsSource: false, Lifetime, ct);
             }
             catch
             {
@@ -263,10 +269,7 @@ private void ReleaseResources()
         {
             _chunkHandle?.Dispose();
             _source?.Dispose();
-            if (!_leaveOpen)
-            {
-                _stream?.Dispose();
-            }
+            _stream?.Release();
         }
     }
 }
diff --git a/src/ExcelReader.Core/Reader/Csv/ReplayStream.cs b/src/ExcelReader.Core/Reader/Csv/ReplayStream.cs
new file mode 100644
index 00000000..ffaee20e
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Csv/ReplayStream.cs
@@ -0,0 +1,137 @@
+namespace ExcelReader.Core.Reader.Csv
+{
+    /// <summary>
+    /// Serves a forward-only stream to one pass at a time, and lets a later pass start over for as long
+    /// as everything read so far still fits in <c>limit</c> bytes. Disposing ends a pass;
+    /// <see cref="Release"/> closes the stream underneath.
+    /// </summary>
+    internal sealed class ReplayStream(Stream inner, bool leaveOpen, int limit) : Stream
+    {
+        private MemoryStream? _recorded = new();
+        private int _position;
+        private int _busy;
+
+        public override bool CanRead => true;
+
+        public override bool CanSeek => false;
+
+        public override bool CanWrite => false;
+
+        public override long Length => throw new NotSupportedException();
+
+        public override long Position
+        {
+            get => throw new NotSupportedException();
+            set => throw new NotSupportedException();
+        }
+
+        internal bool TryBeginPass()
+        {
+            if (Interlocked.CompareExchange(ref _busy, 1, 0) != 0)
+            {
+                return false;
+            }
+            if (_recorded is null)
+            {
+                Volatile.Write(ref _busy, 0);
+                return false;
+            }
+            _position = 0;
+            return true;
+        }
+
+        internal void Release()
+        {
+            _recorded = null;
+            if (!leaveOpen)
+            {
+                inner.Dispose();
+            }
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return Read(buffer.AsSpan(offset, count));
+        }
+
+        public override int Read(Span<byte> buffer)
+        {
+            if (TryReplay(buffer, out int replayed))
+            {
+                return replayed;
+            }
+            int read = inner.Read(buffer);
+            Record(buffer[..read]);
+            return read;
+        }
+
+        public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+        {
+            if (TryReplay(buffer.Span, out int replayed))
+            {
+                return replayed;
+            }
+            int read = await inner.ReadAsync(buffer, cancellationToken).ConfigureAwait(false);
+            Record(buffer.Span[..read]);
+            return read;
+        }
+
+        public override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+        {
+            return ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();
+        }
+
+        private bool TryReplay(Span<byte> buffer, out int count)
+        {
+            count = 0;
+            if (_recorded is not { } recorded || _position >= recorded.Length || buffer.IsEmpty)
+            {
+                return false;
+            }
+            count = Math.Min(buffer.Length, (int)recorded.Length - _position);
+            recorded.GetBuffer().AsSpan(_position, count).CopyTo(buffer);
+            _position += count;
+            return true;
+        }
+
+        private void Record(ReadOnlySpan<byte> data)
+        {
+            if (_recorded is not { } recorded)
+            {
+                return;
+            }
+            if (recorded.Length + data.Length > limit)
+            {
+                _recorded = null;
+                return;
+            }
+            recorded.Write(data);
+            _position += data.Length;
+        }
+
+        public override void Flush()
+        {
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            throw new NotSupportedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            Volatile.Write(ref _busy, 0);
+            base.Dispose(disposing);
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index 0c779c3d..27699d4c 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -153,7 +153,8 @@ in parallel. By default the library asks for 4 MiB blocks and keeps 64 MiB of th
 (`source_block_size`, `source_cache_bytes` in `xl_open_options`).
 
 `xl_open_stream` reads through a callback that copies the next bytes. A CSV is read as it arrives,
-by one cursor; an XLSX, XLSB or XLS is read whole first (`max_buffered_bytes` caps it), because
+by one cursor at a time, and its first 16 MiB are kept so that `xl_infer_schema` followed by a read
+works; an XLSX, XLSB or XLS is read whole first (`max_buffered_bytes` caps it), because
 those formats need random access.
 
 Both take ownership: `release` runs exactly once, when nothing needs the bytes any more. A failing
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index c0cbfda5..7631490a 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -134,9 +134,11 @@ typedef struct xl_stream {
     void (*release)(void* user_data);
 } xl_stream;
 
-/* Opens a workbook over a stream that cannot seek. A CSV is read as it arrives, by one cursor:
-   a second cursor, typed reader or Arrow stream on it fails with XL_ERROR, csv_sniff_dialect is
-   refused, and the stream is released when the workbook and its cursor are closed. An XLSX, XLSB
+/* Opens a workbook over a stream that cannot seek. A CSV is read as it arrives, by one cursor
+   at a time. Its first 16 MiB are kept, so a later cursor, typed reader or Arrow stream starts over
+   (xl_infer_schema, then a read) until one has read past them; after that, or while one is still
+   open, another fails with XL_ERROR. csv_sniff_dialect is refused, and the stream is released when
+   the workbook and its cursors are closed. An XLSX, XLSB
    or XLS needs random access, so the stream is read whole (up to max_buffered_bytes) and released
    before this returns. Ownership rules are those of xl_open_source. */
 int32_t xl_open_stream(const xl_stream* stream, int32_t format,
diff --git a/src/ExcelReader.Native/include/excelreader.hpp b/src/ExcelReader.Native/include/excelreader.hpp
index c17ae596..2717ab82 100644
--- a/src/ExcelReader.Native/include/excelreader.hpp
+++ b/src/ExcelReader.Native/include/excelreader.hpp
@@ -968,7 +968,8 @@ namespace xl
             return Workbook(handle);
         }
 
-        /// Opens a workbook over a stream that cannot seek: a CSV is read as it arrives, once; an XLSX, XLSB or XLS is read whole first.
+        /// Opens a workbook over a stream that cannot seek: a CSV is read as it arrives, and again from the start
+        /// until 16 MiB of it were read; an XLSX, XLSB or XLS is read whole first.
         static std::expected<Workbook, Error> open_stream(std::unique_ptr<InputStream> stream, int32_t format = XL_FORMAT_AUTO,
                                                           const OpenOptions *options = nullptr)
         {
diff --git a/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
index a2e2c168..30a694a4 100644
--- a/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
+++ b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
@@ -81,15 +81,23 @@ private static int CountRows(NativeHandle handle, int sheet)
         }
 
         [Fact]
-        public void A_Csv_Streams_Once_And_Is_Released_When_Its_Cursor_Closes()
+        public void A_Csv_Streams_Through_One_Cursor_At_A_Time_And_Is_Released_On_Close()
         {
             TestStream test = new(Encoding.UTF8.GetBytes("a,b\n1,2\n3,4\n"));
             using Pinned pinned = new(test);
             Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Csv, out NativeHandle? handle));
+
+            Assert.Equal(NativeStatus.Ok, ReadApi.InferSchema(handle, 0, headerRow: 1, sampleSize: 100, flags: 0, out NativeInferredSchema schema));
+            Assert.Equal(2, schema.ColumnCount);
+            ReadApi.FreeSchema(ref schema);
             Assert.Equal(3, CountRows(handle!, 0));
 
-            Assert.Equal(NativeStatus.Error, ReadApi.OpenRows(handle, 0, out _));
-            Assert.Contains("only be enumerated once", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenRows(handle, 0, out NativeRowCursor? open));
+            using (open)
+            {
+                Assert.Equal(NativeStatus.Error, ReadApi.OpenRows(handle, 0, out _));
+                Assert.Contains("cannot be enumerated again", NativeApi.LastErrorText(), StringComparison.Ordinal);
+            }
 
             Assert.Equal(0, test.Releases);
             Assert.Equal(NativeStatus.Ok, ReadApi.Close(handle));
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
index a0aac49c..74739c0b 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
@@ -392,7 +392,7 @@ public void SeekableStreamCanBeEnumeratedMoreThanOnce()
         }
 
         [Fact]
-        public void NonSeekableStreamThrowsOnSecondEnumeration()
+        public void NonSeekableStreamIsReplayedOnSecondEnumeration()
         {
             byte[] bytes = Encoding.UTF8.GetBytes("a,b\n1,2\n");
             using NonSeekableStream stream = new(bytes);
@@ -401,7 +401,7 @@ public void NonSeekableStreamThrowsOnSecondEnumeration()
             var first = ReadAll(reader);
             Assert.Equal(2, first.Count);
 
-            Assert.Throws<InvalidOperationException>(reader.FirstSheet.GetEnumerator);
+            Assert.Equal(first, ReadAll(reader));
         }
 
 
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
new file mode 100644
index 00000000..2d8332f9
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
@@ -0,0 +1,159 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Schema;
+
+namespace ExcelReader.Tests.Reader.Csv
+{
+    public sealed class CsvReplayTests
+    {
+        private static byte[] BuildCsv(int rows, Encoding? encoding = null)
+        {
+            StringBuilder text = new("name,value\n");
+            for (int r = 0; r < rows; r++)
+            {
+                text.Append("name-").Append(r.ToString(CultureInfo.InvariantCulture))
+                    .Append(',').Append((r * 7).ToString(CultureInfo.InvariantCulture)).Append('\n');
+            }
+            return (encoding ?? Encoding.UTF8).GetBytes(text.ToString());
+        }
+
+        private static List<string> Drain(CsvReader reader)
+        {
+            List<string> lines = [];
+            using CsvReader.Enumerator e = reader.FirstSheet.GetEnumerator();
+            while (e.MoveNext())
+            {
+                Row row = e.Current;
+                lines.Add(row[0].GetString() + "|" + row[1].GetString());
+            }
+            return lines;
+        }
+
+        private static List<string> Expected(int rows)
+        {
+            using CsvReader reference = Excel.FromCsv(BuildCsv(rows));
+            return Drain(reference);
+        }
+
+        [Fact]
+        public void A_Schema_Inferred_From_A_NonSeekable_Stream_Leaves_Every_Row_To_Read()
+        {
+            const int rows = 20_000;
+            using NonSeekableStream stream = new(BuildCsv(rows));
+            using CsvReader reader = Excel.FromCsv(stream);
+
+            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, headerRow: 1, sampleSize: 100, parseText: true);
+
+            Assert.Equal(["name", "value"], schema.Select(c => c.Name), StringComparer.Ordinal);
+            Assert.Equal(ExcelColumnType.Int64Column, schema[1].Type);
+            Assert.Equal(Expected(rows), Drain(reader), StringComparer.Ordinal);
+        }
+
+        [Fact]
+        public void A_Small_NonSeekable_Stream_Can_Be_Read_Any_Number_Of_Times()
+        {
+            const int rows = 500;
+            List<string> expected = Expected(rows);
+            using NonSeekableStream stream = new(BuildCsv(rows));
+            using CsvReader reader = Excel.FromCsv(stream);
+
+            Assert.Equal(expected, Drain(reader), StringComparer.Ordinal);
+            Assert.Equal(expected, Drain(reader), StringComparer.Ordinal);
+            Assert.Equal(expected, Drain(reader), StringComparer.Ordinal);
+        }
+
+        [Fact]
+        public void A_Transcoded_NonSeekable_Stream_Is_Replayed_Too()
+        {
+            const int rows = 20_000;
+            using NonSeekableStream stream = new(BuildCsv(rows, Encoding.Unicode));
+            using CsvReader reader = Excel.FromCsv(
+                stream, leaveOpen: false,
+                new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false });
+
+            Excel.InferSchema(reader.FirstSheet);
+
+            Assert.Equal(Expected(rows), Drain(reader), StringComparer.Ordinal);
+        }
+
+        [Fact]
+        public void A_Second_Enumeration_Is_Refused_While_The_First_Is_Open()
+        {
+            using NonSeekableStream stream = new(BuildCsv(10));
+            using CsvReader reader = Excel.FromCsv(stream);
+            using CsvReader.Enumerator first = reader.FirstSheet.GetEnumerator();
+
+            Assert.Throws<InvalidOperationException>(reader.FirstSheet.GetEnumerator);
+        }
+
+        [Fact]
+        public void A_Stream_Read_Past_The_Replay_Limit_Cannot_Be_Read_Again()
+        {
+            byte[] line = Encoding.UTF8.GetBytes(new string('x', 1021) + ",1\n");
+            byte[] bytes = new byte[CsvReader.ReplayLimit + (line.Length * 4)];
+            for (int offset = 0; offset < bytes.Length; offset += line.Length)
+            {
+                line.CopyTo(bytes, offset);
+            }
+            using NonSeekableStream stream = new(bytes);
+            using CsvReader reader = Excel.FromCsv(stream);
+
+            Assert.Equal(bytes.Length / line.Length, Drain(reader).Count);
+
+            InvalidOperationException error = Assert.Throws<InvalidOperationException>(reader.FirstSheet.GetEnumerator);
+            Assert.Contains("cannot be enumerated again", error.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void A_Pass_Replays_What_Was_Read_And_Then_Continues()
+        {
+            byte[] bytes = Enumerable.Range(0, 100).Select(i => (byte)i).ToArray();
+            using NonSeekableStream inner = new(bytes);
+            using ReplayStream replay = new(inner, leaveOpen: true, limit: 64);
+
+            Assert.True(replay.TryBeginPass());
+            byte[] head = new byte[40];
+            replay.ReadExactly(head);
+            replay.Dispose();
+
+            Assert.True(replay.TryBeginPass());
+            byte[] all = new byte[100];
+            replay.ReadExactly(all);
+            Assert.Equal(bytes, all);
+            Assert.Equal(0, replay.Read(new byte[1]));
+            replay.Dispose();
+
+            Assert.False(replay.TryBeginPass());
+        }
+
+        [Fact]
+        public void Releasing_Closes_The_Inner_Stream_Only_When_It_Is_Owned()
+        {
+            using TrackingStream owned = new();
+            using TrackingStream borrowed = new();
+            ReplayStream a = new(owned, leaveOpen: false, limit: 8);
+            ReplayStream b = new(borrowed, leaveOpen: true, limit: 8);
+
+            a.Dispose();
+            Assert.False(owned.Disposed);
+            a.Release();
+            b.Release();
+
+            Assert.True(owned.Disposed);
+            Assert.False(borrowed.Disposed);
+        }
+
+        private sealed class TrackingStream : MemoryStream
+        {
+            internal bool Disposed { get; private set; }
+
+            protected override void Dispose(bool disposing)
+            {
+                Disposed = true;
+                base.Dispose(disposing);
+            }
+        }
+    }
+}

From d5da1e13bf73e4f448d826ff4027975889abf9d3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 7 Oct 2026 20:07:24 +0000
Subject: [PATCH 018/115] Bump the analyzers group with 1 update

Bumps Meziantou.Analyzer from 3.0.290 to 3.0.294

---
updated-dependencies:
- dependency-name: Meziantou.Analyzer
  dependency-version: 3.0.294
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: analyzers
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 Directory.Build.props | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index f9b76a42..8782a287 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -27,7 +27,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>
     </PackageReference>
-    <PackageReference Include="Meziantou.Analyzer" Version="3.0.290">
+    <PackageReference Include="Meziantou.Analyzer" Version="3.0.294">
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>
     </PackageReference>

From d185665193e02453022d494f09b86a3b5e155d72 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 7 Oct 2026 20:08:47 +0000
Subject: [PATCH 019/115] Bump the test group with 2 updates

Bumps Microsoft.Testing.Extensions.CodeCoverage from 18.11.2 to 18.12.0
Bumps Microsoft.Testing.Extensions.TrxReport from 2.4.1 to 2.5.1

---
updated-dependencies:
- dependency-name: Microsoft.Testing.Extensions.CodeCoverage
  dependency-version: 18.12.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: test
- dependency-name: Microsoft.Testing.Extensions.TrxReport
  dependency-version: 2.5.1
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: test
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 tests/ExcelReader.Tests/ExcelReader.Tests.csproj | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/ExcelReader.Tests/ExcelReader.Tests.csproj b/tests/ExcelReader.Tests/ExcelReader.Tests.csproj
index ab2b1d8a..478b1ae3 100644
--- a/tests/ExcelReader.Tests/ExcelReader.Tests.csproj
+++ b/tests/ExcelReader.Tests/ExcelReader.Tests.csproj
@@ -33,8 +33,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Testing.Extensions.TrxReport" Version="2.4.1" />
-    <PackageReference Include="Microsoft.Testing.Extensions.CodeCoverage" Version="18.11.2" />
+    <PackageReference Include="Microsoft.Testing.Extensions.TrxReport" Version="2.5.1" />
+    <PackageReference Include="Microsoft.Testing.Extensions.CodeCoverage" Version="18.12.0" />
     <PackageReference Include="xunit.runner.visualstudio" Version="4.0.0">
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>

From 77f97b68e913159c2e7340f823435387c1b65220 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Wed, 7 Oct 2026 17:42:37 -0300
Subject: [PATCH 020/115] Removing unnecessary comments

---
 .github/workflows/release.yml                 |  2 -
 cpp/benchmarks/benchmark_csv_compare.cpp      |  6 --
 python/src/excelreader/_native.py             |  2 -
 python/src/excelreader/arrow_stream.py        |  2 -
 rust/excelreader/src/rows.rs                  |  2 -
 rust/excelreader/src/source.rs                |  1 -
 rust/excelreader/src/workbook.rs              |  3 -
 .../Parser/Internal/RowProjector.cs           |  1 -
 src/ExcelReader.Core/Reader/Csv/CsvReader.cs  |  2 -
 .../Reader/Internal/FastDouble.cs             |  8 --
 .../Reader/Schema/SchemaInference.cs          |  4 -
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |  2 -
 src/ExcelReader.Core/Writer/Csv/CsvWriter.cs  |  2 -
 .../Writer/Internal/BiffBuffer.cs             |  2 -
 .../Writer/Xlsb/XlsbSheetWriter.cs            |  3 -
 .../Writer/Xlsx/XlsxSheetWriter.cs            |  2 -
 .../ExcelRowMapGenerator.cs                   |  1 -
 .../Reading/RowViewBuffer.cs                  |  2 -
 src/ExcelReader.Native/Typed/TypedApi.cs      |  3 -
 src/ExcelReader.Native/include/excelreader.h  | 80 +------------------
 .../include/excelreader.hpp                   |  3 -
 .../include/excelreader_arrow.h               |  2 -
 .../Read/XlsxSharedStringHotPathBenchmark.cs  |  2 -
 .../Native/CallbackSourceTests.cs             |  1 -
 .../Native/NativeApiTests.ParallelTyped.cs    |  1 -
 .../Parser/HeaderCollisionTests.cs            |  1 -
 .../ParallelCsv/CsvReaderChunkSourceTests.cs  |  1 -
 tests/ExcelReader.Tests/TestUtils.cs          |  1 -
 28 files changed, 3 insertions(+), 139 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index e7559e70..91fff678 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -312,8 +312,6 @@ jobs:
             grep -q 'already exists' <<<"$out" || exit 1
           fi
 
-      # The workspace config points EXCELREADER_NATIVE_LIB_DIR at a local build that this job never makes;
-      # without it the package verification downloads the native library from the release, as users do.
       - name: Publish excelreader to crates.io
         working-directory: rust/excelreader
         env:
diff --git a/cpp/benchmarks/benchmark_csv_compare.cpp b/cpp/benchmarks/benchmark_csv_compare.cpp
index cb0eb531..211faf13 100644
--- a/cpp/benchmarks/benchmark_csv_compare.cpp
+++ b/cpp/benchmarks/benchmark_csv_compare.cpp
@@ -1,8 +1,6 @@
 #include <xl/excelreader.hpp>
 
 #include <benchmark/benchmark.h>
-// zsv's headers are plain C99: no extern "C" guard, and `restrict`, which GCC and Clang spell
-// `__restrict` in C++.
 #define restrict __restrict
 extern "C"
 {
@@ -135,8 +133,6 @@ namespace
         return {reinterpret_cast<const char *>(cell.str), cell.len};
     }
 
-    // The same conversions parse_sheet<FullRow> makes: text into owned std::string, ISO dates, integers
-    // and doubles, one FullRow per data row, header skipped.
     void zsv_typed_row(void *context)
     {
         auto *run = static_cast<ZsvRun *>(context);
@@ -146,8 +142,6 @@ namespace
             return;
         }
         const size_t count = zsv_cell_count(run->parser);
-        // zsv reports the empty line after the file's final CRLF as a one-cell row; ExcelReader skips
-        // blank lines.
         if (count == 1 && zsv_get_cell(run->parser, 0).len == 0)
         {
             return;
diff --git a/python/src/excelreader/_native.py b/python/src/excelreader/_native.py
index d6b25317..c67def55 100644
--- a/python/src/excelreader/_native.py
+++ b/python/src/excelreader/_native.py
@@ -437,8 +437,6 @@ def load_library() -> ctypes.CDLL:
 
 
 def _warm_up(lib: ctypes.CDLL) -> None:
-    # Threads whose first native call lands together can crash the NativeAOT runtime's start-up
-    # (see commit b5f8c5f); one small read here finishes it on a single thread. Failures are ignored.
     data = b"a,b\n1,2\n3,4\n"
     workbook = ctypes.c_void_p()
     if lib.xl_open_memory(data, len(data), XL_FORMAT_CSV, None, ctypes.byref(workbook)) != XL_OK:
diff --git a/python/src/excelreader/arrow_stream.py b/python/src/excelreader/arrow_stream.py
index 71396b0b..3292e25e 100644
--- a/python/src/excelreader/arrow_stream.py
+++ b/python/src/excelreader/arrow_stream.py
@@ -37,8 +37,6 @@ def _address_of(function: object) -> int:
     return ctypes.cast(function, ctypes.c_void_p).value
 
 
-# A consumer may move the proxy out of the capsule, so callbacks find the native stream through
-# private_data, which travels with the move, never through the address they are called with.
 _streams: dict[int, _Target] = {}
 _proxies: dict[int, _native.ArrowArrayStream] = {}
 
diff --git a/rust/excelreader/src/rows.rs b/rust/excelreader/src/rows.rs
index 58a50217..c516de9a 100644
--- a/rust/excelreader/src/rows.rs
+++ b/rust/excelreader/src/rows.rs
@@ -229,7 +229,6 @@ pub struct RowCursor<'w> {
 }
 
 // SAFETY: the cursor owns its native enumerator and ABI v6 lets one thread at a time use it;
-// every method that touches it takes `&mut self`.
 unsafe impl Send for RowCursor<'_> {}
 
 impl<'w> RowCursor<'w> {
@@ -337,7 +336,6 @@ impl Drop for DecodedRows {
 }
 
 // SAFETY: plain native allocations, read only through &self, released by xl_free_rows, which any
-// thread may call.
 unsafe impl Send for DecodedRows {}
 unsafe impl Sync for DecodedRows {}
 
diff --git a/rust/excelreader/src/source.rs b/rust/excelreader/src/source.rs
index 12ea90bf..cee8f842 100644
--- a/rust/excelreader/src/source.rs
+++ b/rust/excelreader/src/source.rs
@@ -68,7 +68,6 @@ unsafe extern "C" fn read_at<S: Source>(user_data: *mut c_void, offset: i64, buf
     report(catch_unwind(AssertUnwindSafe(|| source.read_at(offset as u64, buf))))
 }
 
-// The ABI never calls read concurrently, so the reader can be borrowed mutably.
 unsafe extern "C" fn read<R: Read>(user_data: *mut c_void, buf: *mut u8, len: i64) -> i64 {
     let reader = &mut *user_data.cast::<R>();
     let buf = std::slice::from_raw_parts_mut(buf, len as usize);
diff --git a/rust/excelreader/src/workbook.rs b/rust/excelreader/src/workbook.rs
index dc75b791..14934735 100644
--- a/rust/excelreader/src/workbook.rs
+++ b/rust/excelreader/src/workbook.rs
@@ -135,7 +135,6 @@ pub struct Workbook {
 }
 
 // SAFETY: ABI v6 documents the workbook handle as usable from several threads at once. The only
-// state behind it is immutable after open; each read owns its enumerator.
 unsafe impl Send for Workbook {}
 unsafe impl Sync for Workbook {}
 
@@ -699,7 +698,6 @@ impl<T: ExcelMapper> Drop for TableView<T> {
 }
 
 // SAFETY: plain native allocations, read only through &self, released by xl_free_table, which any
-// thread may call. T appears only as fn pointers, never as a stored value.
 unsafe impl<T: ExcelMapper> Send for TableView<T> {}
 unsafe impl<T: ExcelMapper> Sync for TableView<T> {}
 
@@ -723,7 +721,6 @@ pub struct TypedChunks<'a, T: ExcelMapper> {
 }
 
 // SAFETY: a typed reader owns its native enumerator; ABI v6 lets it be used from any one thread
-// at a time, which `&mut self` on `next` already guarantees.
 unsafe impl<T: ExcelMapper> Send for TypedChunks<'_, T> {}
 
 impl<T: ExcelMapper> Iterator for TypedChunks<'_, T> {
diff --git a/src/ExcelReader.Core/Parser/Internal/RowProjector.cs b/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
index f38606ac..fc2a7380 100644
--- a/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
+++ b/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
@@ -51,7 +51,6 @@ internal ProjectionStep Classify(in Row row)
             return ProjectionStep.Skip;
         }
 
-        // Kept out of line so the caller's foreach tier-1 compile can't inline the whole projection and spill its hot loop.
         [MethodImpl(MethodImplOptions.NoInlining)]
         internal readonly T Project(Row row)
         {
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
index fde2ae72..59899d3a 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
@@ -92,9 +92,7 @@ internal bool TryGetChunkSource(out CsvChunkSource source)
             return false;
         }
 
-        // A synchronous Windows handle serializes every read on its file object; parallel chunks need an overlapped one.
         // ponytail: reopens by path, safe because Excel's file opens deny write/delete sharing; switch to
-        // ReOpenFile if a caller-supplied FileStream that allows delete ever reaches this.
         private SafeFileHandle ChunkHandle(FileStream file)
         {
             if (!OperatingSystem.IsWindows())
diff --git a/src/ExcelReader.Core/Reader/Internal/FastDouble.cs b/src/ExcelReader.Core/Reader/Internal/FastDouble.cs
index b73631e8..1051fb16 100644
--- a/src/ExcelReader.Core/Reader/Internal/FastDouble.cs
+++ b/src/ExcelReader.Core/Reader/Internal/FastDouble.cs
@@ -14,8 +14,6 @@ internal static class FastDouble
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static bool TryParse(ReadOnlySpan<byte> s, out double value) => TryParse(s, MaxMantissaDigits, out value);
 
-        // Rejects text with more significant digits than a double round-trips, so a caller that keeps
-        // the double in place of the text never loses digits a decimal or long parse of the text would see.
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         public static bool TryParseLossless(ReadOnlySpan<byte> s, out double value) => TryParse(s, MaxLosslessDigits, out value);
 
@@ -34,8 +32,6 @@ private static bool TryParse(ReadOnlySpan<byte> s, int maxDigits, out double val
                 i = 1;
             }
 
-            // Integer digits, then fraction digits, each in its own tight loop: one loop over both paid a
-            // mispredicted branch at the dot and on every digit's dot/leading-zero checks.
             ulong mantissa = 0;
             int integerStart = i;
             for (; i < s.Length; i++)
@@ -93,8 +89,6 @@ private static bool TryParse(ReadOnlySpan<byte> s, int maxDigits, out double val
             return true;
         }
 
-        // Eisel-Lemire as ported from fast_float's compute_float for binary64. Returns false for
-        // subnormals, overflow and powers outside the table so the caller's double.TryParse decides.
         [MethodImpl(MethodImplOptions.NoInlining)]
         private static bool EiselLemire(ulong w, int q, bool neg, out double value)
         {
@@ -155,7 +149,6 @@ private static bool EiselLemire(ulong w, int q, bool neg, out double value)
             return true;
         }
 
-        // Leading zeros add nothing to the mantissa, so they neither overflow it nor count toward the limit.
         [MethodImpl(MethodImplOptions.NoInlining)]
         private static int SignificantDigits(ReadOnlySpan<byte> number)
         {
@@ -214,7 +207,6 @@ private static double Pow10(int scale)
         ];
 
         // ponytail: fast_float's 128-bit truncated 5^q table cut to q in [-64, 64]; widen to its full
-        // [-342, 308] if inputs outside that range ever show up often enough to matter.
         private static ReadOnlySpan<ulong> PowersOfFive =>
         [
             0xA87FEA27A539E9A5, 0x3F2398D747B36224, 0xD29FE4B18E88640E, 0x8EEC7F0D19A03AAD,
diff --git a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
index 9c9c607b..fd54b2d7 100644
--- a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
+++ b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
@@ -169,15 +169,12 @@ internal void Observe(in Cell cell, bool isDate1904, bool parseText)
                 }
             }
 
-            // Stricter than the typed converters on purpose: their fallbacks (DateTime.TryParse,
-            // long.TryParse with whitespace) would type ID and ratio columns as dates or numbers.
             private bool ObserveText(in Cell cell, bool isDate1904)
             {
                 ReadOnlySpan<byte> text = cell.Value;
                 bool canonical = HasCanonicalIntegerPart(text, out bool allDigits);
                 if (canonical && allDigits)
                 {
-                    // An integer past long stays text: as a double it would silently lose digits.
                     if (!ExcelCellReaders.Parsable<long>(in cell, isDate1904, CultureInfo.InvariantCulture, out _))
                     {
                         return false;
@@ -186,7 +183,6 @@ private bool ObserveText(in Cell cell, bool isDate1904)
                     SawNonBinaryNumber |= !IsBinaryDigit(text);
                     return true;
                 }
-                // Scientific notation stays text: part codes like 12E4 would silently become 120000.
                 if (canonical && !text.ContainsAny((byte)'e', (byte)'E') && FastDouble.TryParse(text, out _))
                 {
                     SawNumber = true;
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 2c2ad493..000a579e 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -562,8 +562,6 @@ private bool MissingRowOpenTag()
                 return true;
             }
 
-            // Accepts only ` r="A1"`, ` s="12"`, ` t="s"` (any order, one space, double quotes); anything else goes generic.
-            // Inlined so col/style/kind/gt stay in registers instead of five out-params through the stack per cell.
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
             private static bool TryScanCanonicalCellTag(byte[] buf, int len, int i, out int gt, out int col, out int style, out Kind kind)
             {
diff --git a/src/ExcelReader.Core/Writer/Csv/CsvWriter.cs b/src/ExcelReader.Core/Writer/Csv/CsvWriter.cs
index b231193e..0bf1928a 100644
--- a/src/ExcelReader.Core/Writer/Csv/CsvWriter.cs
+++ b/src/ExcelReader.Core/Writer/Csv/CsvWriter.cs
@@ -212,8 +212,6 @@ private void FlushCore()
             }
         }
 
-        // A failed write leaves an unknown prefix of the buffer in the stream, so writing it again could
-        // silently corrupt the output: the writer becomes terminal and only Dispose remains meaningful.
         private void Fault()
         {
             if (_faulted)
diff --git a/src/ExcelReader.Core/Writer/Internal/BiffBuffer.cs b/src/ExcelReader.Core/Writer/Internal/BiffBuffer.cs
index 3f012f6e..346d0c79 100644
--- a/src/ExcelReader.Core/Writer/Internal/BiffBuffer.cs
+++ b/src/ExcelReader.Core/Writer/Internal/BiffBuffer.cs
@@ -15,7 +15,6 @@ internal sealed class BiffBuffer : IDisposable
 
         private static ArrayPool<byte> Pool => PoolOverride.Value ?? DefaultPool;
 
-        // Test seam: lets a test count every rent/return made on its own async flow.
         internal static void OverridePool(ArrayPool<byte>? pool)
         {
             PoolOverride.Value = pool;
@@ -169,7 +168,6 @@ private void Ensure(int extra)
             }
         }
 
-        // Kept out of line so the inlined Ensure on every Write stays a single compare.
         [MethodImpl(MethodImplOptions.NoInlining)]
         private void Grow(int needed)
         {
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
index fa9bdbf6..e4b6c591 100644
--- a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
@@ -265,8 +265,6 @@ public async ValueTask EndAsync(CancellationToken ct = default)
             Release(faulted: false);
         }
 
-        // Ended is only ever set by Release, after cleanup, so an already-ended sheet has nothing left
-        // to release: a fault raised inside a nested step (flush) is handled exactly once.
         private void Fault()
         {
             if (_state == WriterState.Ended)
@@ -653,7 +651,6 @@ private static bool TryEncodeRk(double value, out uint rk)
             {
                 return false;
             }
-            // Excel writes an integer as the float form whenever it is exact; calamine ignores a date style on the int form.
             ulong bits = BitConverter.DoubleToUInt64Bits(value);
             rk = (bits & 0x3_FFFF_FFFFUL) == 0 ? (uint)(bits >> 32) : ((uint)(int)value << 2) | 0x02;
             return true;
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
index 5f4bc430..0f7ddd0b 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
@@ -265,8 +265,6 @@ public void End()
             Release(faulted: false);
         }
 
-        // Ended is only ever set by Release, after cleanup, so an already-ended sheet has nothing left
-        // to release: a fault raised inside a nested step (start, flush) is handled exactly once.
         private void Fault()
         {
             if (_state == WriterState.Ended)
diff --git a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
index 3cbbf77e..80e68cfe 100644
--- a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
+++ b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
@@ -366,7 +366,6 @@ private static (string Assign, string? InitAccessorDecl) PlanAssignment(IPropert
             {
                 return ($"m.{member} = v", null);
             }
-            // Init accessors can't be called outside an object initializer; UnsafeAccessor binds the same setter reflection's GetSetMethod() does.
             string accessor = $"__ExcelInit_{property.Name}";
             string byRef = init.ContainingType.IsValueType ? "ref " : "";
             string target = init.ContainingType.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat);
diff --git a/src/ExcelReader.Native/Reading/RowViewBuffer.cs b/src/ExcelReader.Native/Reading/RowViewBuffer.cs
index 8431a902..70cff1e8 100644
--- a/src/ExcelReader.Native/Reading/RowViewBuffer.cs
+++ b/src/ExcelReader.Native/Reading/RowViewBuffer.cs
@@ -65,7 +65,6 @@ private void Add(ref int count, int column, int type, int valueOffset, int lengt
             {
                 GrowCells();
             }
-            // Offsets until the row is complete: growing _values moves it, so pointers are fixed up in Finish.
             _cells[count++] = new NativeRowCell { Column = column, Type = type, ValueLength = length, Value = valueOffset };
         }
 
@@ -86,7 +85,6 @@ private void EnsureValues(int required)
             }
         }
 
-        // Out of line: without PGO the JIT/ILC inlines the Realloc P/Invoke and pays its frame setup on every row.
         [MethodImpl(MethodImplOptions.NoInlining)]
         private void GrowValues(int required)
         {
diff --git a/src/ExcelReader.Native/Typed/TypedApi.cs b/src/ExcelReader.Native/Typed/TypedApi.cs
index 928d40f9..e6eae494 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.cs
@@ -98,7 +98,6 @@ private static void FreeColumn(in NativeColumn column)
             FreeBlock(column.Data);
         }
 
-        // AsyncLocal, not ThreadStatic: a test's hooks must follow a parallel build onto pool threads.
         private static readonly AsyncLocal<Func<int, IntPtr>?> AllocOverrideLocal = new();
         private static readonly AsyncLocal<Action<IntPtr>?> FreeOverrideLocal = new();
 
@@ -419,8 +418,6 @@ private bool AppendString(in Cell cell)
                 return true;
             }
 
-            // Each numeric type gets its own method so AppendFrom stays a small dispatcher: with the
-            // inlined double parser in it, every cell of every type paid its prologue.
             [MethodImpl(MethodImplOptions.NoInlining)]
             private bool AppendInt64(in Cell cell, bool isDate1904)
             {
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 7631490a..4b53d87f 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -80,114 +80,60 @@ typedef struct xl_open_options {
     const uint8_t* password;
     int32_t password_len;
 
-    /* xl_open_source only: bytes of blocks kept in memory. 0 is the default, 64 MiB. */
     int64_t source_cache_bytes;
-    /* xl_open_stream with XLSX, XLSB or XLS only: the most bytes the stream may hold. 0 is the
-       default, the .NET array limit (about 2 GB). */
     int64_t max_buffered_bytes;
-    /* xl_open_source only: bytes fetched per read_at call. 0 is the default, 4 MiB; negative turns
-       the cache off, so every read the library makes reaches read_at. */
     int32_t source_block_size;
 } xl_open_options;
 
-/* options may be NULL for the defaults. When it is not NULL, set options->struct_size to
-   sizeof(xl_open_options) first. The 6.0 layout, which ends at password_len, is still accepted.
-   xl_open_memory copies data, so the buffer may be released as soon
-   as the call returns. */
 int32_t xl_open_file(const uint8_t* path, int32_t path_len, int32_t format,
                      const xl_open_options* options, xl_workbook** out_handle);
 
 int32_t xl_open_memory(const uint8_t* data, int32_t data_len, int32_t format,
                        const xl_open_options* options, xl_workbook** out_handle);
 
-/* Random-access bytes for xl_open_source. */
 typedef struct xl_source {
-    int32_t struct_size;     /* sizeof(xl_source) */
+    int32_t struct_size;     
     void* user_data;
-    int64_t length;          /* total size in bytes */
-    /* Copy up to len bytes starting at offset into buf. Return the bytes copied, or -1 on failure
-       after calling xl_set_source_error. Returning 0 before length is a failure ("the source ended
-       early"). Returning more than len, or a negative other than -1, is a failure. Called from any
-       thread, concurrently. */
+    int64_t length;          
     int64_t (*read_at)(void* user_data, int64_t offset, uint8_t* buf, int64_t len);
-    /* May be NULL. Called exactly once, when nothing opened from the workbook needs the source. */
     void (*release)(void* user_data);
 } xl_source;
 
-/* Opens a workbook over a source the caller serves. Every sheet can be read in parallel. A valid
-   source is released exactly once, whether the open succeeds or fails; a NULL source, a wrong
-   struct_size, a NULL read_at, a negative length or a NULL out_handle returns XL_INVALID_ARGUMENT
-   and the source is not released. With the default options, reads reach read_at in 4 MiB blocks
-   kept in a 64 MiB cache. */
 int32_t xl_open_source(const xl_source* source, int32_t format,
                        const xl_open_options* options, xl_workbook** out_handle);
 
-/* Sequential bytes for xl_open_stream. */
 typedef struct xl_stream {
-    int32_t struct_size;     /* sizeof(xl_stream) */
+    int32_t struct_size;     
     void* user_data;
-    /* Copy up to len bytes into buf. Return the bytes copied (0 at the end), or -1 on failure after
-       calling xl_set_source_error. Returning more than len, or a negative other than -1, is a failure.
-       Never called concurrently. */
     int64_t (*read)(void* user_data, uint8_t* buf, int64_t len);
-    /* May be NULL. Called exactly once. */
     void (*release)(void* user_data);
 } xl_stream;
 
-/* Opens a workbook over a stream that cannot seek. A CSV is read as it arrives, by one cursor
-   at a time. Its first 16 MiB are kept, so a later cursor, typed reader or Arrow stream starts over
-   (xl_infer_schema, then a read) until one has read past them; after that, or while one is still
-   open, another fails with XL_ERROR. csv_sniff_dialect is refused, and the stream is released when
-   the workbook and its cursors are closed. An XLSX, XLSB
-   or XLS needs random access, so the stream is read whole (up to max_buffered_bytes) and released
-   before this returns. Ownership rules are those of xl_open_source. */
 int32_t xl_open_stream(const xl_stream* stream, int32_t format,
                        const xl_open_options* options, xl_workbook** out_handle);
 
-/* Callable only from inside read_at or read: the message xl_last_error reports when the callback
-   then returns -1. Inside a callback, no other xl_ function may be called. */
 void xl_set_source_error(const uint8_t* message, int32_t len);
 
-/* Cursors, typed readers and Arrow streams opened from this handle keep working after xl_close; the
-   workbook's resources are released when the last of them is closed. Any later call that takes this
-   handle returns XL_INVALID_HANDLE. */
 int32_t xl_close(xl_workbook* handle);
 
-/* A workbook handle may be used from several threads at once. index and sheet are zero-based:
-   negative is XL_INVALID_ARGUMENT, at or past xl_sheet_count is XL_ERROR. */
 int32_t xl_sheet_count(xl_workbook* handle, int32_t* out_count);
 
 int32_t xl_sheet_name_at(xl_workbook* handle, int32_t index, uint8_t* buffer, int32_t capacity, int32_t* out_len);
 
-/* Writes XL_SHEET_VISIBLE, XL_SHEET_HIDDEN or XL_SHEET_VERY_HIDDEN. */
 int32_t xl_sheet_visibility_at(xl_workbook* handle, int32_t index, int32_t* out_visibility);
 
-/* Finds a sheet by name, ignoring case. A name that matches no sheet is not an error: the function
-   returns XL_OK and writes -1. */
 int32_t xl_sheet_index(xl_workbook* handle, const uint8_t* name, int32_t name_len, int32_t* out_index);
 
 int32_t xl_is_date1904(xl_workbook* handle, int32_t* out_flag);
 
-/* Opens a cursor over one sheet. A cursor reads its sheet once, front to back; open another to read
-   it again. Any number of cursors may be open on one workbook, on the same sheet or on different
-   ones, and each may run on its own thread. Use one cursor from one thread at a time. A cursor keeps
-   working after xl_close on its workbook. Release it with xl_rows_close. */
 int32_t xl_rows_open(xl_workbook* handle, int32_t sheet, xl_rows** out_rows);
 
-/* A NULL or unknown cursor is XL_INVALID_HANDLE and nothing is released. */
 int32_t xl_rows_close(xl_rows* rows);
 
-/* XL_BUFFER_TOO_SMALL writes the needed size to out_written; call xl_rows_next again with a larger
-   buffer before any other read on that cursor, and the same row is returned. */
 int32_t xl_rows_next(xl_rows* rows, uint8_t* buffer, int32_t capacity, int32_t* out_written);
 
-/* out_row points into memory the cursor owns: overwritten by the next xl_rows_next_view on that
-   cursor, released by xl_rows_close. Values are NUL-terminated. Do not pass it to xl_free_rows. */
 int32_t xl_rows_next_view(xl_rows* rows, xl_row* out_row);
 
-/* Reads the rows the cursor has not yet returned. XL_BUFFER_TOO_SMALL writes the needed size to
-   out_written; call xl_rows_read_all_blob again with a larger buffer before any other read on that
-   cursor. */
 int32_t xl_rows_read_all_blob(xl_rows* rows, uint8_t* buffer, int32_t capacity, int32_t* out_written);
 
 typedef struct xl_rows_decoded {
@@ -195,7 +141,6 @@ typedef struct xl_rows_decoded {
     xl_row* rows;
 } xl_rows_decoded;
 
-/* Reads the rows the cursor has not yet returned. Release out_rows with xl_free_rows. */
 int32_t xl_rows_read_all_decoded(xl_rows* rows, xl_rows_decoded* out_rows);
 
 void xl_free_rows(xl_rows_decoded* rows);
@@ -232,24 +177,16 @@ typedef struct xl_table {
     xl_column* columns;
 } xl_table;
 
-/* sheet is a zero-based index: negative is XL_INVALID_ARGUMENT, at or past xl_sheet_count is XL_ERROR.
-   degree_of_parallelism: 0 = processor count, 1 = sequential, n = up to n threads; negative is
-   XL_INVALID_ARGUMENT. Only a CSV handle is read in parallel. Any other format, a CSV too small to
-   split, or a CSV opened with a non-UTF-8 encoding is read sequentially; the table is the same either
-   way. Calls on one handle may run on several threads at once. */
 int32_t xl_parse_typed(xl_workbook* handle, int32_t sheet, const xl_column_spec* specs, int32_t spec_count,
                        int32_t header_row, int32_t degree_of_parallelism, xl_table* out_table);
 
 void xl_free_table(xl_table* table);
 
-/* The reader owns its position in the sheet. It keeps working after xl_close on its workbook, and any
-   number of readers may be open on one workbook. Use one reader from one thread at a time. */
 int32_t xl_typed_reader_open(xl_workbook* handle, int32_t sheet, const xl_column_spec* specs, int32_t spec_count,
                              int32_t header_row, int64_t max_rows, xl_typed_reader** out_reader);
 
 int32_t xl_typed_reader_next(xl_typed_reader* reader, xl_table* out_table);
 
-/* A NULL or unknown reader is ignored. */
 void xl_typed_reader_close(xl_typed_reader* reader);
 
 
@@ -289,8 +226,6 @@ int32_t xl_encrypt_package(const uint8_t* package_path, int32_t package_path_len
                            const uint8_t* destination_path, int32_t destination_path_len,
                            const uint8_t* password, int32_t password_len);
 
-/* xl_encrypt_package over bytes: the plaintext package never touches disk. Release out_buffer with
-   xl_free_buffer. */
 int32_t xl_encrypt_package_to_memory(const uint8_t* package, int32_t package_len,
                                      const uint8_t* password, int32_t password_len,
                                      xl_buffer* out_buffer);
@@ -302,10 +237,6 @@ typedef struct xl_inferred_schema {
 
 #define XL_INFER_PARSE_TEXT 1
 
-/* flags: 0, or XL_INFER_PARSE_TEXT to also type cells that hold text (a CSV's fields, numbers stored
-   as text): integers, decimals, true/false and ISO dates or date-times, when the text has exactly that
-   shape. Leading-zero codes such as 00123 and scientific notation such as 12E4 stay text. Any unknown
-   bit is XL_INVALID_ARGUMENT. Free the result with xl_free_schema. */
 int32_t xl_infer_schema(xl_workbook* handle, int32_t sheet, int32_t header_row, int32_t sample_size,
                         int32_t flags, xl_inferred_schema* out_schema);
 
@@ -372,11 +303,6 @@ int32_t xl_csv_aggregate_memory(const uint8_t* data, int32_t data_len,
                                 const xl_csv_parallel_options* options,
                                 void** out_state);
 
-/* The message for the calling thread's most recent failure. After any non-OK status from a
-   function that opens, reads or inspects a workbook (xl_open_*, xl_close, xl_sheet_*, xl_is_date1904,
-   xl_rows_*, xl_parse_*, xl_typed_reader_*, xl_infer_schema), it is that call's message, or empty
-   when the status alone says it all (a NULL out-pointer, an unknown handle): never a message left by
-   an earlier call. The writer, CSV-aggregation and encryption functions set it on XL_ERROR. */
 int32_t xl_last_error(uint8_t* buffer, int32_t capacity, int32_t* out_len);
 
 const uint8_t* xl_last_error_ptr(int32_t* out_len);
diff --git a/src/ExcelReader.Native/include/excelreader.hpp b/src/ExcelReader.Native/include/excelreader.hpp
index 2717ab82..4094de50 100644
--- a/src/ExcelReader.Native/include/excelreader.hpp
+++ b/src/ExcelReader.Native/include/excelreader.hpp
@@ -76,8 +76,6 @@ namespace xl
     namespace detail
     {
 
-        // The first calls into the runtime from several threads at once can crash it; finish its
-        // start-up on this thread first (see commit b5f8c5f). Failures are ignored.
         inline void warm_up() noexcept
         {
             static constexpr char csv[] = "a,b\n1,2\n3,4\n";
@@ -528,7 +526,6 @@ namespace xl
                     current_ = (*row_)[index_];
                     return;
                 }
-                // Blob cell: int32 column, int32 type, int32 length, then the value bytes.
                 const uint8_t *end = row_->payload_.data() + row_->payload_.size();
                 int32_t header[3];
                 if (static_cast<size_t>(end - next_) < sizeof(header))
diff --git a/src/ExcelReader.Native/include/excelreader_arrow.h b/src/ExcelReader.Native/include/excelreader_arrow.h
index 761c387f..a12cebee 100644
--- a/src/ExcelReader.Native/include/excelreader_arrow.h
+++ b/src/ExcelReader.Native/include/excelreader_arrow.h
@@ -62,12 +62,10 @@ struct ArrowArrayStream {
 
 #endif /* ARROW_C_STREAM_INTERFACE */
 
-/* Same sheet and degree_of_parallelism contract as xl_parse_typed. */
 int32_t xl_parse_arrow(xl_workbook* handle, int32_t sheet, const xl_column_spec* specs, int32_t spec_count,
                        int32_t header_row, int32_t degree_of_parallelism,
                        struct ArrowArray* out_array, struct ArrowSchema* out_schema);
 
-/* The stream owns its position in the sheet and keeps working after xl_close on its workbook. */
 int32_t xl_parse_arrow_stream(xl_workbook* handle, int32_t sheet, const xl_column_spec* specs, int32_t spec_count,
                               int32_t header_row, int64_t max_rows,
                               struct ArrowArrayStream* out_stream);
diff --git a/tests/ExcelReader.Benchmarks/Read/XlsxSharedStringHotPathBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/XlsxSharedStringHotPathBenchmark.cs
index 36782f49..e7354893 100644
--- a/tests/ExcelReader.Benchmarks/Read/XlsxSharedStringHotPathBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Read/XlsxSharedStringHotPathBenchmark.cs
@@ -8,8 +8,6 @@
 
 namespace ExcelReader.Benchmarks
 {
-    // Sheet stage = full read minus the shared-string prologue; the Stored_* pair repeats both with
-    // the sheet re-zipped uncompressed, so their difference is sheet parse with no inflate floor.
     [MemoryDiagnoser]
     public partial class XlsxSharedStringHotPathBenchmark
     {
diff --git a/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs b/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs
index 01b84fa2..29cc16c6 100644
--- a/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs
+++ b/tests/ExcelReader.Tests/Native/CallbackSourceTests.cs
@@ -74,7 +74,6 @@ private static int Open(Pinned pinned, int format, out NativeHandle? handle, Nat
 
         private static NativeOpenOptionsRaw Options() => new() { StructSize = sizeof(NativeOpenOptionsRaw) };
 
-        // Prefetch only engages on sheets of 256 KiB or more uncompressed; the ConcurrentSheetTests sheets are smaller.
         private static byte[] BuildPrefetchedXlsx()
         {
             using MemoryStream buffer = new();
diff --git a/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTyped.cs b/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTyped.cs
index e124be77..4cf1577f 100644
--- a/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTyped.cs
+++ b/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTyped.cs
@@ -182,7 +182,6 @@ public void ParseTypedTable_Should_Free_Every_Block_Exactly_Once_When_A_Parallel
             Assert.True(TypedApi.LastParseRanInParallel);
             Assert.Equal(NativeStatus.Error, status);
             Assert.Equal(IntPtr.Zero, table.Columns);
-            // Columns build concurrently, so another column can still allocate after the injected failure.
             Assert.True(tracker.Allocations >= failAt);
             Assert.Equal(tracker.Allocations - 1, tracker.Frees);
             Assert.Equal(0, tracker.Live);
diff --git a/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs b/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
index 54b1c486..11ac642a 100644
--- a/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
+++ b/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
@@ -6,7 +6,6 @@ namespace ExcelReader.Tests.Parser
 {
     public partial class HeaderCollisionTests
     {
-        // EXR006 fires for these two, so their Generated path is covered by GeneratorTests' in-memory compilation instead.
         private sealed class CaseModel
         {
             [ExcelColumn("Name")]
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
index fffe6e20..5e924f0c 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
@@ -60,7 +60,6 @@ public void TryGetChunkSource_Should_Read_A_File_Through_Its_Own_Overlapped_Hand
                     Assert.True(reader.TryGetChunkSource(out source));
                     Assert.Equal(OperatingSystem.IsWindows(), source.Handle!.IsAsync);
                 }
-                // Windows closes the reader's own overlapped handle; elsewhere it is the stream's, closed with the stream.
                 Assert.True(source.Handle.IsClosed);
             }
             finally
diff --git a/tests/ExcelReader.Tests/TestUtils.cs b/tests/ExcelReader.Tests/TestUtils.cs
index 7e6653b8..a930bef7 100644
--- a/tests/ExcelReader.Tests/TestUtils.cs
+++ b/tests/ExcelReader.Tests/TestUtils.cs
@@ -257,7 +257,6 @@ internal static Action FailOnce(Exception failure)
             };
         }
 
-        // Every span/async write on a derived MemoryStream funnels into this overload.
         public override void Write(byte[] buffer, int offset, int count)
         {
             OnWrite?.Invoke();

From 1514726f56a9c04948170c5051d9ceb9e2070816 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:43:05 -0300
Subject: [PATCH 021/115] feat: add Huffman decode-table builder for the
 managed inflate decoder

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 THIRD-PARTY-NOTICES.md                        |  34 ++-
 src/ExcelReader.Core/ExcelReader.Core.csproj  |   1 +
 .../Reader/Zip/Inflate/HuffmanTableBuilder.cs | 194 ++++++++++++++++++
 .../Reader/Zip/Inflate/InflateFormat.cs       |  71 +++++++
 .../Reader/Zip/HuffmanTableBuilderTests.cs    | 161 +++++++++++++++
 5 files changed, 460 insertions(+), 1 deletion(-)
 create mode 100644 src/ExcelReader.Core/Reader/Zip/Inflate/HuffmanTableBuilder.cs
 create mode 100644 src/ExcelReader.Core/Reader/Zip/Inflate/InflateFormat.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Zip/HuffmanTableBuilderTests.cs

diff --git a/THIRD-PARTY-NOTICES.md b/THIRD-PARTY-NOTICES.md
index e9fc20f2..c67d0e57 100644
--- a/THIRD-PARTY-NOTICES.md
+++ b/THIRD-PARTY-NOTICES.md
@@ -1,7 +1,7 @@
 # Third-Party Notices
 
 This project (ExcelReader.NET) is licensed under the MIT License (see `LICENSE`). It vendors one
-piece of third-party test data, noted below.
+piece of third-party test data and ports one piece of third-party code, both noted below.
 
 ## tests/ExcelReader.Tests/data/encrypted/standard-aes128-sha1.xlsx
 
@@ -14,3 +14,35 @@ It is used solely as a third-party oracle fixture to verify ECMA-376 standard-en
 against a file this codebase did not produce. It is test-project content only: it ships in the
 `ExcelReader.Tests` test project, never in the `ExcelReader.Core` NuGet package
 (`PackageLicenseExpression=MIT`), and is not distributed in any published package.
+
+## src/ExcelReader.Core/Reader/Zip/Inflate/
+
+The inflate decoder in this folder is a C# port of the decompressor design in libdeflate: its
+decode-table layout, table-building algorithm and fast-loop structure.
+
+- Project: libdeflate — https://github.com/ebiggers/libdeflate
+- License: MIT
+
+This code ships in the `ExcelReader.NET` NuGet package, so the notice below ships with it.
+
+    Copyright 2016 Eric Biggers
+
+    Permission is hereby granted, free of charge, to any person
+    obtaining a copy of this software and associated documentation files
+    (the "Software"), to deal in the Software without restriction,
+    including without limitation the rights to use, copy, modify, merge,
+    publish, distribute, sublicense, and/or sell copies of the Software,
+    and to permit persons to whom the Software is furnished to do so,
+    subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+    BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+    ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+    CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE.
diff --git a/src/ExcelReader.Core/ExcelReader.Core.csproj b/src/ExcelReader.Core/ExcelReader.Core.csproj
index 216104fc..61872636 100644
--- a/src/ExcelReader.Core/ExcelReader.Core.csproj
+++ b/src/ExcelReader.Core/ExcelReader.Core.csproj
@@ -36,6 +36,7 @@
 
   <ItemGroup>
     <None Include="..\..\README.md" Pack="true" PackagePath="\" />
+    <None Include="..\..\THIRD-PARTY-NOTICES.md" Pack="true" PackagePath="\" />
   </ItemGroup>
 
   <!-- Binary parsers (BIFF12 framing, etc.) are internal but warrant isolated unit tests. -->
diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/HuffmanTableBuilder.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/HuffmanTableBuilder.cs
new file mode 100644
index 00000000..e9fccbd3
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/HuffmanTableBuilder.cs
@@ -0,0 +1,194 @@
+// Ported from libdeflate's decompressor (MIT, Eric Biggers); the notice is in THIRD-PARTY-NOTICES.md.
+using System.Numerics;
+
+namespace ExcelReader.Core.Reader.Zip.Inflate
+{
+    internal static class HuffmanTableBuilder
+    {
+        internal static bool TryBuild(
+            Span<uint> table, ReadOnlySpan<byte> lens, ReadOnlySpan<uint> results, int tableBits, int maxLen,
+            Span<ushort> sorted, bool shrink, out int tableBitsUsed)
+        {
+            Span<int> lenCounts = stackalloc int[InflateFormat.MaxCodewordLength + 2];
+            lenCounts.Clear();
+            foreach (byte len in lens)
+            {
+                lenCounts[len]++;
+            }
+            while (maxLen > 1 && lenCounts[maxLen] == 0)
+            {
+                maxLen--;
+            }
+            if (shrink)
+            {
+                tableBits = Math.Min(tableBits, maxLen);
+            }
+            tableBitsUsed = tableBits;
+
+            uint codespaceUsed = SortSymbols(lens, lenCounts, maxLen, sorted);
+            ReadOnlySpan<ushort> used = sorted[lenCounts[0]..lens.Length];
+            uint codespace = 1U << maxLen;
+            if (codespaceUsed > codespace)
+            {
+                return false;
+            }
+            if (codespaceUsed < codespace)
+            {
+                return TryFillIncomplete(table[..(1 << tableBits)], results, used, codespaceUsed, codespace, lenCounts[1]);
+            }
+            FillComplete(table, results, used, lenCounts, tableBits);
+            return true;
+        }
+
+        private static uint SortSymbols(ReadOnlySpan<byte> lens, ReadOnlySpan<int> lenCounts, int maxLen, Span<ushort> sorted)
+        {
+            Span<int> offsets = stackalloc int[InflateFormat.MaxCodewordLength + 2];
+            offsets[0] = 0;
+            offsets[1] = lenCounts[0];
+            uint codespaceUsed = 0;
+            for (int len = 1; len < maxLen; len++)
+            {
+                offsets[len + 1] = offsets[len] + lenCounts[len];
+                codespaceUsed = (codespaceUsed << 1) + (uint)lenCounts[len];
+            }
+            codespaceUsed = (codespaceUsed << 1) + (uint)lenCounts[maxLen];
+            for (int symbol = 0; symbol < lens.Length; symbol++)
+            {
+                sorted[offsets[lens[symbol]]++] = (ushort)symbol;
+            }
+            return codespaceUsed;
+        }
+
+        // Deflate allows two incomplete codes: no codewords at all, and a single one-bit codeword.
+        private static bool TryFillIncomplete(
+            Span<uint> mainTable, ReadOnlySpan<uint> results, ReadOnlySpan<ushort> used, uint codespaceUsed, uint codespace, int oneBitCodewords)
+        {
+            int symbol = 0;
+            if (codespaceUsed != 0)
+            {
+                if (codespaceUsed != codespace >> 1 || oneBitCodewords != 1)
+                {
+                    return false;
+                }
+                symbol = used[0];
+            }
+            mainTable.Fill(Entry(results[symbol], 1));
+            return true;
+        }
+
+        private static void FillComplete(Span<uint> table, ReadOnlySpan<uint> results, ReadOnlySpan<ushort> used, ReadOnlySpan<int> lenCounts, int tableBits)
+        {
+            int next = 0;
+            uint codeword = 0;
+            int len = 1;
+            while (lenCounts[len] == 0)
+            {
+                len++;
+            }
+            int count = lenCounts[len];
+            int tableEnd = 1 << len;
+            while (len <= tableBits)
+            {
+                do
+                {
+                    table[(int)codeword] = Entry(results[used[next++]], len);
+                    if (codeword == (uint)tableEnd - 1)
+                    {
+                        Replicate(table, tableEnd, 1 << tableBits);
+                        return;
+                    }
+                    codeword = NextCodeword(codeword, (uint)tableEnd - 1);
+                }
+                while (--count != 0);
+
+                do
+                {
+                    len++;
+                    if (len <= tableBits)
+                    {
+                        Replicate(table, tableEnd, tableEnd << 1);
+                        tableEnd <<= 1;
+                    }
+                    count = lenCounts[len];
+                }
+                while (count == 0);
+            }
+            FillSubtables(table, results, used[next..], lenCounts, tableBits, codeword, len, count);
+        }
+
+        private static void FillSubtables(
+            Span<uint> table, ReadOnlySpan<uint> results, ReadOnlySpan<ushort> used, ReadOnlySpan<int> lenCounts,
+            int tableBits, uint codeword, int len, int count)
+        {
+            uint tableEnd = 1U << tableBits;
+            uint mainMask = tableEnd - 1;
+            uint prefix = uint.MaxValue;
+            uint start = 0;
+            int next = 0;
+            while (true)
+            {
+                if ((codeword & mainMask) != prefix)
+                {
+                    prefix = codeword & mainMask;
+                    start = tableEnd;
+                    int subtableBits = SubtableBits(lenCounts, tableBits, len, count);
+                    tableEnd = start + (1U << subtableBits);
+                    table[(int)prefix] = (start << 16) | InflateFormat.Exceptional | InflateFormat.SubtablePointer
+                        | ((uint)subtableBits << 8) | (uint)tableBits;
+                }
+
+                int subLen = len - tableBits;
+                uint entry = Entry(results[used[next++]], subLen);
+                for (uint i = start + (codeword >> tableBits); i < tableEnd; i += 1U << subLen)
+                {
+                    table[(int)i] = entry;
+                }
+
+                uint allOnes = (1U << len) - 1;
+                if (codeword == allOnes)
+                {
+                    return;
+                }
+                codeword = NextCodeword(codeword, allOnes);
+                count--;
+                while (count == 0)
+                {
+                    count = lenCounts[++len];
+                }
+            }
+        }
+
+        private static int SubtableBits(ReadOnlySpan<int> lenCounts, int tableBits, int len, int count)
+        {
+            int bits = len - tableBits;
+            uint codespaceUsed = (uint)count;
+            while (codespaceUsed < 1U << bits)
+            {
+                bits++;
+                codespaceUsed = (codespaceUsed << 1) + (uint)lenCounts[tableBits + bits];
+            }
+            return bits;
+        }
+
+        private static void Replicate(Span<uint> table, int filled, int target)
+        {
+            while (filled < target)
+            {
+                table[..filled].CopyTo(table[filled..]);
+                filled <<= 1;
+            }
+        }
+
+        // Codewords are stored bit-reversed, so the next one in canonical order is a reversed increment.
+        private static uint NextCodeword(uint codeword, uint allOnes)
+        {
+            uint bit = 1U << BitOperations.Log2(codeword ^ allOnes);
+            return (codeword & (bit - 1)) | bit;
+        }
+
+        private static uint Entry(uint result, int len)
+        {
+            return result + ((uint)len << 8) + (uint)len;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateFormat.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateFormat.cs
new file mode 100644
index 00000000..cb11b31e
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateFormat.cs
@@ -0,0 +1,71 @@
+namespace ExcelReader.Core.Reader.Zip.Inflate
+{
+    internal static class InflateFormat
+    {
+        internal const int LitlenTableBits = 11;
+        internal const int OffsetTableBits = 8;
+        internal const int PrecodeTableBits = 7;
+
+        // Worst-case table sizes for these table widths, from zlib's `enough` tool as used by libdeflate.
+        internal const int LitlenTableSize = 2342;
+        internal const int OffsetTableSize = 402;
+        internal const int PrecodeTableSize = 128;
+
+        internal const int MaxLitlenSymbols = 288;
+        internal const int MaxOffsetSymbols = 32;
+        internal const int PrecodeSymbols = 19;
+        internal const int MaxCodewordLength = 15;
+        internal const int MaxPrecodeLength = 7;
+        internal const int MaxRepeat = 138;
+
+        internal const uint Literal = 0x8000_0000;
+        internal const uint Exceptional = 0x8000;
+        internal const uint SubtablePointer = 0x4000;
+        internal const uint EndOfBlock = 0x2000;
+
+        internal static readonly uint[] LitlenResults = BuildLitlenResults();
+        internal static readonly uint[] OffsetResults = BuildOffsetResults();
+        internal static readonly uint[] PrecodeResults = BuildPrecodeResults();
+
+        internal static ReadOnlySpan<byte> PrecodeOrder => [16, 17, 18, 0, 8, 7, 9, 6, 10, 5, 11, 4, 12, 3, 13, 2, 14, 1, 15];
+
+        private static uint[] BuildLitlenResults()
+        {
+            ReadOnlySpan<ushort> bases = [3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 15, 17, 19, 23, 27, 31, 35, 43, 51, 59, 67, 83, 99, 115, 131, 163, 195, 227, 258, 258, 258];
+            ReadOnlySpan<byte> extraBits = [0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5, 0, 0, 0];
+            uint[] results = new uint[MaxLitlenSymbols];
+            for (uint literal = 0; literal < 256; literal++)
+            {
+                results[literal] = Literal | (literal << 16);
+            }
+            results[256] = Exceptional | EndOfBlock;
+            for (int i = 0; i < bases.Length; i++)
+            {
+                results[257 + i] = ((uint)bases[i] << 16) | extraBits[i];
+            }
+            return results;
+        }
+
+        private static uint[] BuildOffsetResults()
+        {
+            ReadOnlySpan<ushort> bases = [1, 2, 3, 4, 5, 7, 9, 13, 17, 25, 33, 49, 65, 97, 129, 193, 257, 385, 513, 769, 1025, 1537, 2049, 3073, 4097, 6145, 8193, 12289, 16385, 24577, 24577, 24577];
+            ReadOnlySpan<byte> extraBits = [0, 0, 0, 0, 1, 1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 13, 13, 13, 13];
+            uint[] results = new uint[MaxOffsetSymbols];
+            for (int i = 0; i < results.Length; i++)
+            {
+                results[i] = ((uint)bases[i] << 16) | extraBits[i];
+            }
+            return results;
+        }
+
+        private static uint[] BuildPrecodeResults()
+        {
+            uint[] results = new uint[PrecodeSymbols];
+            for (uint i = 0; i < results.Length; i++)
+            {
+                results[i] = i << 16;
+            }
+            return results;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Zip/HuffmanTableBuilderTests.cs b/tests/ExcelReader.Tests/Reader/Zip/HuffmanTableBuilderTests.cs
new file mode 100644
index 00000000..27365b70
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Zip/HuffmanTableBuilderTests.cs
@@ -0,0 +1,161 @@
+using ExcelReader.Core.Reader.Zip.Inflate;
+
+namespace ExcelReader.Tests.Reader.Zip
+{
+    public class HuffmanTableBuilderTests
+    {
+        private static readonly uint[] _symbolResults = [.. Enumerable.Range(0, InflateFormat.MaxLitlenSymbols).Select(static i => (uint)i << 16)];
+
+        public static TheoryData<byte[], int> CompleteCodes()
+        {
+            byte[] fixedLitlen = new byte[288];
+            fixedLitlen.AsSpan(0, 144).Fill(8);
+            fixedLitlen.AsSpan(144, 112).Fill(9);
+            fixedLitlen.AsSpan(256, 24).Fill(7);
+            fixedLitlen.AsSpan(280, 8).Fill(8);
+            return new TheoryData<byte[], int>
+            {
+                { [3, 3, 3, 3, 3, 2, 4, 4], 11 },
+                { [3, 3, 3, 3, 3, 2, 4, 4], 3 },
+                { fixedLitlen, 11 },
+                { fixedLitlen, 8 },
+                { [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 15], 11 },
+                { [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 15], 8 },
+                { [0, 2, 0, 2, 2, 0, 0, 2], 8 },
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(CompleteCodes))]
+        public void EveryCanonicalCodewordDecodesToItsSymbol(byte[] lens, int tableBits)
+        {
+            uint[] table = new uint[InflateFormat.LitlenTableSize];
+            ushort[] sorted = new ushort[lens.Length];
+
+            Assert.True(HuffmanTableBuilder.TryBuild(table, lens, _symbolResults, tableBits, 15, sorted, shrink: false, out int used));
+            Assert.Equal(tableBits, used);
+
+            uint[] codewords = CanonicalCodewords(lens);
+            int checkedSymbols = 0;
+            for (int symbol = 0; symbol < lens.Length; symbol++)
+            {
+                if (lens[symbol] == 0)
+                {
+                    continue;
+                }
+                uint reversed = Reverse(codewords[symbol], lens[symbol]);
+                foreach (uint padding in (uint[])[0, uint.MaxValue])
+                {
+                    uint bits = reversed | (padding << lens[symbol]);
+                    (int decoded, int length) = Lookup(table, bits, tableBits);
+                    Assert.Equal(symbol, decoded);
+                    Assert.Equal(lens[symbol], length);
+                }
+                checkedSymbols++;
+            }
+            Assert.Equal(lens.Count(static len => len != 0), checkedSymbols);
+        }
+
+        [Fact]
+        public void ShrinkNarrowsTheTableToTheLongestCodeword()
+        {
+            uint[] table = new uint[InflateFormat.LitlenTableSize];
+            ushort[] sorted = new ushort[8];
+
+            Assert.True(HuffmanTableBuilder.TryBuild(table, [3, 3, 3, 3, 3, 2, 4, 4], _symbolResults, 11, 15, sorted, shrink: true, out int used));
+
+            Assert.Equal(4, used);
+        }
+
+        [Theory]
+        [InlineData(new byte[] { 1, 1, 1 })]
+        [InlineData(new byte[] { 2, 2, 2, 2, 2 })]
+        [InlineData(new byte[] { 1, 2, 2, 15 })]
+        public void OverSubscribedCodeIsRejected(byte[] lens)
+        {
+            Assert.False(HuffmanTableBuilder.TryBuild(
+                new uint[InflateFormat.LitlenTableSize], lens, _symbolResults, 11, 15, new ushort[lens.Length], shrink: false, out _));
+        }
+
+        [Theory]
+        [InlineData(new byte[] { 2, 2, 2 })]
+        [InlineData(new byte[] { 2 })]
+        [InlineData(new byte[] { 1, 0, 2 })]
+        [InlineData(new byte[] { 1, 15 })]
+        public void IncompleteCodeIsRejected(byte[] lens)
+        {
+            Assert.False(HuffmanTableBuilder.TryBuild(
+                new uint[InflateFormat.LitlenTableSize], lens, _symbolResults, 11, 15, new ushort[lens.Length], shrink: false, out _));
+        }
+
+        [Fact]
+        public void SingleOneBitCodewordFillsTheTableWithItsSymbol()
+        {
+            uint[] table = new uint[256];
+
+            Assert.True(HuffmanTableBuilder.TryBuild(table, [0, 0, 1, 0], _symbolResults, 8, 15, new ushort[4], shrink: false, out _));
+
+            Assert.All(table, static entry => Assert.Equal((2U << 16) | (1U << 8) | 1U, entry));
+        }
+
+        [Fact]
+        public void EmptyCodeFillsTheTableWithSymbolZero()
+        {
+            uint[] table = new uint[256];
+            Array.Fill(table, uint.MaxValue);
+
+            Assert.True(HuffmanTableBuilder.TryBuild(table, [0, 0, 0, 0], _symbolResults, 8, 15, new ushort[4], shrink: false, out _));
+
+            Assert.All(table, static entry => Assert.Equal((1U << 8) | 1U, entry));
+        }
+
+        private static (int Symbol, int Length) Lookup(uint[] table, uint bits, int tableBits)
+        {
+            uint entry = table[bits & ((1U << tableBits) - 1)];
+            if ((entry & InflateFormat.SubtablePointer) == 0)
+            {
+                return ((int)(entry >> 16), (int)(entry & 0xFF));
+            }
+            int subtableBits = (int)((entry >> 8) & 0x3F);
+            uint subEntry = table[(entry >> 16) + ((bits >> tableBits) & ((1U << subtableBits) - 1))];
+            return ((int)(subEntry >> 16), tableBits + (int)(subEntry & 0xFF));
+        }
+
+        // RFC 1951 section 3.2.2.
+        private static uint[] CanonicalCodewords(byte[] lens)
+        {
+            int[] counts = new int[16];
+            foreach (byte len in lens)
+            {
+                counts[len]++;
+            }
+            counts[0] = 0;
+            uint[] next = new uint[16];
+            uint code = 0;
+            for (int bits = 1; bits <= 15; bits++)
+            {
+                code = (code + (uint)counts[bits - 1]) << 1;
+                next[bits] = code;
+            }
+            uint[] codewords = new uint[lens.Length];
+            for (int symbol = 0; symbol < lens.Length; symbol++)
+            {
+                if (lens[symbol] != 0)
+                {
+                    codewords[symbol] = next[lens[symbol]]++;
+                }
+            }
+            return codewords;
+        }
+
+        private static uint Reverse(uint codeword, int length)
+        {
+            uint reversed = 0;
+            for (int i = 0; i < length; i++)
+            {
+                reversed = (reversed << 1) | ((codeword >> i) & 1);
+            }
+            return reversed;
+        }
+    }
+}

From d7f155979d00e333d8fc33fd7c4fc5ff34c12ba4 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:45:37 -0300
Subject: [PATCH 022/115] feat: add a managed streaming inflate decoder

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Zip/Inflate/InflateDecoder.FastLoop.cs    | 241 +++++++++++++
 .../Reader/Zip/Inflate/InflateDecoder.cs      | 336 ++++++++++++++++++
 .../Reader/Zip/Inflate/InflateStream.cs       | 211 +++++++++++
 .../Reader/Zip/InflateDifferentialTests.cs    |  87 +++++
 .../Reader/Zip/InflateStreamTests.cs          | 245 +++++++++++++
 .../Reader/Zip/InflateTestSupport.cs          | 202 +++++++++++
 6 files changed, 1322 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
 create mode 100644 src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
 create mode 100644 src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Zip/InflateDifferentialTests.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Zip/InflateTestSupport.cs

diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
new file mode 100644
index 00000000..fcf7f008
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
@@ -0,0 +1,241 @@
+// Ported from libdeflate's decompressor (MIT, Eric Biggers); the notice is in THIRD-PARTY-NOTICES.md.
+using System.Buffers.Binary;
+using System.Diagnostics.CodeAnalysis;
+using System.Runtime.CompilerServices;
+using System.Runtime.Intrinsics.X86;
+
+namespace ExcelReader.Core.Reader.Zip.Inflate
+{
+    internal sealed partial class InflateDecoder
+    {
+        private enum LoopStatus
+        {
+            BlockDone,
+            Limit,
+            BadOffset,
+        }
+
+        private unsafe LoopStatus RunFastLoop(byte[] input, ref int inPos, int inLimit, byte[] window, ref int outPos, int outLimit)
+        {
+            fixed (byte* inBase = input)
+            fixed (byte* outBase = window)
+            fixed (uint* litlen = _litlen)
+            fixed (uint* offsets = _offset)
+            {
+                byte* inNext = inBase + inPos;
+                byte* outNext = outBase + outPos;
+                LoopStatus status = FastLoop(ref inNext, inBase + inLimit, outBase, ref outNext, outBase + outLimit, litlen, offsets);
+                inPos = (int)(inNext - inBase);
+                outPos = (int)(outNext - outBase);
+                return status;
+            }
+        }
+
+        // Entry layout, shared with HuffmanTableBuilder: bits 0-7 hold the bits to consume (codeword
+        // plus extra bits), bits 8-11 the codeword length alone, bits 16 and up the literal, the
+        // base length or offset, or the subtable start.
+        //
+        // Bit budget: a refill leaves at least 56 bits. Three literals from the main table take at
+        // most 33; a length takes at most 20 and an offset at most 28, hence the refill between them.
+        [SuppressMessage("Design", "MA0051:Method is too long",
+            Justification = "The decode loop is deliberately one call-free method: every live value has to stay in a register across it, and a call inside the loop spills them.")]
+        private unsafe LoopStatus FastLoop(
+            ref byte* inPosition, byte* inLimit, byte* window, ref byte* outPosition, byte* outLimit, uint* litlen, uint* offsets)
+        {
+            ulong bitbuf = _bitbuf;
+            int bitsleft = _bitsleft;
+            byte* inNext = inPosition;
+            byte* outNext = outPosition;
+            ulong mask = _litlenMask;
+            LoopStatus status;
+
+            bitbuf |= LoadWord(inNext) << bitsleft;
+            inNext += (63 - bitsleft) >> 3;
+            bitsleft |= 56;
+            uint entry = litlen[bitbuf & mask];
+
+            while (true)
+            {
+                if (inNext >= inLimit || outNext >= outLimit)
+                {
+                    status = LoopStatus.Limit;
+                    break;
+                }
+
+                ulong saved = bitbuf;
+                bitbuf >>= (int)entry;
+                bitsleft -= (int)(entry & 0xFF);
+
+                if ((int)entry < 0)
+                {
+                    uint literal = entry >> 16;
+                    entry = litlen[bitbuf & mask];
+                    saved = bitbuf;
+                    bitbuf >>= (int)entry;
+                    bitsleft -= (int)(entry & 0xFF);
+                    *outNext++ = (byte)literal;
+                    if ((int)entry < 0)
+                    {
+                        literal = entry >> 16;
+                        entry = litlen[bitbuf & mask];
+                        saved = bitbuf;
+                        bitbuf >>= (int)entry;
+                        bitsleft -= (int)(entry & 0xFF);
+                        *outNext++ = (byte)literal;
+                    }
+                    if ((int)entry < 0)
+                    {
+                        *outNext++ = (byte)(entry >> 16);
+                        entry = litlen[bitbuf & mask];
+                        bitbuf |= LoadWord(inNext) << bitsleft;
+                        inNext += (63 - bitsleft) >> 3;
+                        bitsleft |= 56;
+                        continue;
+                    }
+                }
+
+                if ((entry & InflateFormat.Exceptional) != 0)
+                {
+                    if ((entry & InflateFormat.EndOfBlock) != 0)
+                    {
+                        status = LoopStatus.BlockDone;
+                        break;
+                    }
+                    entry = litlen[(entry >> 16) + (uint)LowBits(bitbuf, (entry >> 8) & 0x3F)];
+                    saved = bitbuf;
+                    bitbuf >>= (int)entry;
+                    bitsleft -= (int)(entry & 0xFF);
+                    if ((int)entry < 0)
+                    {
+                        *outNext++ = (byte)(entry >> 16);
+                        entry = litlen[bitbuf & mask];
+                        bitbuf |= LoadWord(inNext) << bitsleft;
+                        inNext += (63 - bitsleft) >> 3;
+                        bitsleft |= 56;
+                        continue;
+                    }
+                    if ((entry & InflateFormat.EndOfBlock) != 0)
+                    {
+                        status = LoopStatus.BlockDone;
+                        break;
+                    }
+                }
+
+                uint length = (entry >> 16) + (uint)(LowBits(saved, entry & 0xFF) >> (int)((entry >> 8) & 0xF));
+
+                if (bitsleft < 30)
+                {
+                    bitbuf |= LoadWord(inNext) << bitsleft;
+                    inNext += (63 - bitsleft) >> 3;
+                    bitsleft |= 56;
+                }
+                uint offsetEntry = offsets[bitbuf & ((1 << InflateFormat.OffsetTableBits) - 1)];
+                if ((offsetEntry & InflateFormat.Exceptional) != 0)
+                {
+                    bitbuf >>= InflateFormat.OffsetTableBits;
+                    bitsleft -= InflateFormat.OffsetTableBits;
+                    offsetEntry = offsets[(offsetEntry >> 16) + (uint)LowBits(bitbuf, (offsetEntry >> 8) & 0x3F)];
+                }
+                saved = bitbuf;
+                bitbuf >>= (int)offsetEntry;
+                bitsleft -= (int)(offsetEntry & 0xFF);
+                uint offset = (offsetEntry >> 16) + (uint)(LowBits(saved, offsetEntry & 0xFF) >> (int)((offsetEntry >> 8) & 0xF));
+
+                if (offset > (nuint)(outNext - window))
+                {
+                    status = LoopStatus.BadOffset;
+                    break;
+                }
+                byte* source = outNext - offset;
+                byte* destination = outNext;
+                outNext += length;
+
+                bitbuf |= LoadWord(inNext) << bitsleft;
+                inNext += (63 - bitsleft) >> 3;
+                bitsleft |= 56;
+                entry = litlen[bitbuf & mask];
+
+                CopyMatch(source, destination, outNext, offset);
+            }
+
+            _bitbuf = bitbuf;
+            _bitsleft = bitsleft;
+            inPosition = inNext;
+            outPosition = outNext;
+            return status;
+        }
+
+        // Copies forward a word at a time, so it may write up to 39 bytes past `end`; the caller's
+        // output slack covers that. An offset below eight overlaps within one word and needs the
+        // narrower strides.
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        private static unsafe void CopyMatch(byte* source, byte* destination, byte* end, uint offset)
+        {
+            if (offset >= sizeof(ulong))
+            {
+                CopyWord(source, destination);
+                CopyWord(source + 8, destination + 8);
+                CopyWord(source + 16, destination + 16);
+                CopyWord(source + 24, destination + 24);
+                CopyWord(source + 32, destination + 32);
+                source += 40;
+                destination += 40;
+                while (destination < end)
+                {
+                    CopyWord(source, destination);
+                    CopyWord(source + 8, destination + 8);
+                    source += 16;
+                    destination += 16;
+                }
+                return;
+            }
+            if (offset == 1)
+            {
+                ulong repeated = 0x0101010101010101UL * *source;
+                Unsafe.WriteUnaligned(destination, repeated);
+                Unsafe.WriteUnaligned(destination + 8, repeated);
+                destination += 16;
+                while (destination < end)
+                {
+                    Unsafe.WriteUnaligned(destination, repeated);
+                    destination += 8;
+                }
+                return;
+            }
+            do
+            {
+                CopyWord(source, destination);
+                source += offset;
+                destination += offset;
+            }
+            while (destination < end);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        private static unsafe void CopyWord(byte* source, byte* destination)
+        {
+            Unsafe.WriteUnaligned(destination, Unsafe.ReadUnaligned<ulong>(source));
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        private static unsafe ulong LoadWord(byte* source)
+        {
+            ulong value = Unsafe.ReadUnaligned<ulong>(source);
+            if (BitConverter.IsLittleEndian)
+            {
+                return value;
+            }
+            return BinaryPrimitives.ReverseEndianness(value);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        private static ulong LowBits(ulong value, uint count)
+        {
+            if (Bmi2.X64.IsSupported)
+            {
+                return Bmi2.X64.ZeroHighBits(value, count);
+            }
+            return value & ((1UL << (int)count) - 1);
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
new file mode 100644
index 00000000..d421de69
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
@@ -0,0 +1,336 @@
+using System.Buffers;
+using System.Buffers.Binary;
+
+namespace ExcelReader.Core.Reader.Zip.Inflate
+{
+    internal enum InflateStatus
+    {
+        NeedInput,
+        OutputFull,
+        Finished,
+    }
+
+    /// <summary>
+    /// Resumable DEFLATE decoder with no I/O of its own. The caller owns the input buffer and the
+    /// output window and feeds them through <see cref="Decode"/>.
+    /// </summary>
+    internal sealed partial class InflateDecoder : IDisposable
+    {
+        // Bytes the caller must keep readable past the end of its input, zeroed once input has ended.
+        internal const int InputPadding = 2048;
+
+        // Bytes the caller must keep writable past outLimit: one loop iteration writes at most
+        // three literals plus a 258-byte match rounded up by its word-at-a-time copy.
+        internal const int OutputSlack = 320;
+
+        // A dynamic block header is at most 570 bytes; the decoder never starts one with less than this.
+        private const int HeaderMargin = 1024;
+        private const int LoopInputMargin = 64;
+        private const int LensSize = InflateFormat.MaxLitlenSymbols + InflateFormat.MaxOffsetSymbols + InflateFormat.MaxRepeat;
+        private const ulong PrecodeMask = (1UL << InflateFormat.PrecodeTableBits) - 1;
+
+        private readonly uint[] _litlen = ArrayPool<uint>.Shared.Rent(InflateFormat.LitlenTableSize);
+        private readonly uint[] _offset = ArrayPool<uint>.Shared.Rent(InflateFormat.OffsetTableSize);
+        private ulong _litlenMask;
+        private bool _staticCodesLoaded;
+        private ulong _bitbuf;
+        private int _bitsleft;
+        private BlockState _state;
+        private bool _finalBlock;
+        private int _storedRemaining;
+        private bool _disposed;
+
+        private enum BlockState
+        {
+            Header,
+            Coded,
+            Stored,
+            Finished,
+        }
+
+        /// <summary>
+        /// Decodes until the window reaches <paramref name="outLimit"/>, more input is required, or the
+        /// stream ends. On <see cref="InflateStatus.NeedInput"/> every unconsumed whole byte has been
+        /// handed back through <paramref name="inPos"/>, so the caller may compact and refill.
+        /// </summary>
+        internal InflateStatus Decode(byte[] input, ref int inPos, int inEnd, bool inputEnded, byte[] window, ref int outPos, int outLimit)
+        {
+            while (_state != BlockState.Finished)
+            {
+                if (outPos >= outLimit)
+                {
+                    return InflateStatus.OutputFull;
+                }
+                bool advanced = _state switch
+                {
+                    BlockState.Header => TryReadHeader(input, ref inPos, inEnd, inputEnded),
+                    BlockState.Stored => TryCopyStored(input, ref inPos, inEnd, inputEnded, window, ref outPos, outLimit),
+                    _ => TryDecodeCoded(input, ref inPos, inEnd, inputEnded, window, ref outPos, outLimit),
+                };
+                if (!advanced)
+                {
+                    return InflateStatus.NeedInput;
+                }
+            }
+            return InflateStatus.Finished;
+        }
+
+        public void Dispose()
+        {
+            if (_disposed)
+            {
+                return;
+            }
+            _disposed = true;
+            ArrayPool<uint>.Shared.Return(_litlen);
+            ArrayPool<uint>.Shared.Return(_offset);
+        }
+
+        private bool TryReadHeader(byte[] input, ref int inPos, int inEnd, bool inputEnded)
+        {
+            if (!inputEnded && inEnd - inPos < HeaderMargin)
+            {
+                Unread(ref inPos);
+                return false;
+            }
+            ThrowIfOverrun(inPos, inEnd, inputEnded);
+            RefillBits(input, ref inPos);
+            _finalBlock = PopBits(1) != 0;
+            switch (PopBits(2))
+            {
+                case 0:
+                    BeginStored(input, ref inPos);
+                    break;
+                case 1:
+                    LoadStaticCodes();
+                    _state = BlockState.Coded;
+                    break;
+                case 2:
+                    ReadDynamicCodes(input, ref inPos);
+                    _state = BlockState.Coded;
+                    break;
+                default:
+                    throw new InvalidDataException("The deflate stream uses a reserved block type.");
+            }
+            ThrowIfOverrun(inPos, inEnd, inputEnded);
+            return true;
+        }
+
+        private void BeginStored(ReadOnlySpan<byte> input, ref int inPos)
+        {
+            inPos -= _bitsleft >> 3;
+            _bitbuf = 0;
+            _bitsleft = 0;
+            ushort length = BinaryPrimitives.ReadUInt16LittleEndian(input[inPos..]);
+            ushort complement = BinaryPrimitives.ReadUInt16LittleEndian(input[(inPos + 2)..]);
+            inPos += 4;
+            if (length != (ushort)~complement)
+            {
+                throw new InvalidDataException("A stored deflate block has mismatched length fields.");
+            }
+            _storedRemaining = length;
+            _state = BlockState.Stored;
+        }
+
+        private bool TryCopyStored(byte[] input, ref int inPos, int inEnd, bool inputEnded, byte[] window, ref int outPos, int outLimit)
+        {
+            if (_storedRemaining == 0)
+            {
+                EndBlock();
+                return true;
+            }
+            int available = inEnd - inPos;
+            if (available <= 0)
+            {
+                ThrowIfTruncated(inputEnded);
+                return false;
+            }
+            int count = Math.Min(Math.Min(_storedRemaining, available), outLimit - outPos);
+            input.AsSpan(inPos, count).CopyTo(window.AsSpan(outPos));
+            inPos += count;
+            outPos += count;
+            _storedRemaining -= count;
+            return true;
+        }
+
+        private bool TryDecodeCoded(byte[] input, ref int inPos, int inEnd, bool inputEnded, byte[] window, ref int outPos, int outLimit)
+        {
+            // Past the real end the padding is zeros, and a valid stream never needs more than the
+            // eight bytes a refill may have looked ahead.
+            int inLimit = inputEnded ? inEnd + sizeof(ulong) : inEnd - LoopInputMargin;
+            LoopStatus status = RunFastLoop(input, ref inPos, inLimit, window, ref outPos, outLimit);
+            if (status == LoopStatus.BadOffset)
+            {
+                throw new InvalidDataException("A deflate match reaches before the start of the output.");
+            }
+            if (status == LoopStatus.BlockDone)
+            {
+                ThrowIfOverrun(inPos, inEnd, inputEnded);
+                EndBlock();
+                return true;
+            }
+            if (outPos >= outLimit)
+            {
+                return true;
+            }
+            ThrowIfTruncated(inputEnded);
+            Unread(ref inPos);
+            return false;
+        }
+
+        private void EndBlock()
+        {
+            _state = _finalBlock ? BlockState.Finished : BlockState.Header;
+        }
+
+        private void Unread(ref int inPos)
+        {
+            inPos -= _bitsleft >> 3;
+            _bitsleft &= 7;
+            _bitbuf &= (1UL << _bitsleft) - 1;
+        }
+
+        private void ThrowIfOverrun(int inPos, int inEnd, bool inputEnded)
+        {
+            if (inputEnded && inPos - (_bitsleft >> 3) > inEnd)
+            {
+                throw new InvalidDataException("The deflate stream is truncated.");
+            }
+        }
+
+        private static void ThrowIfTruncated(bool inputEnded)
+        {
+            if (inputEnded)
+            {
+                throw new InvalidDataException("The deflate stream is truncated.");
+            }
+        }
+
+        private void RefillBits(ReadOnlySpan<byte> input, ref int inPos)
+        {
+            _bitbuf |= BinaryPrimitives.ReadUInt64LittleEndian(input[inPos..]) << _bitsleft;
+            inPos += (63 - _bitsleft) >> 3;
+            _bitsleft |= 56;
+        }
+
+        private uint PopBits(int count)
+        {
+            uint value = (uint)(_bitbuf & ((1UL << count) - 1));
+            _bitbuf >>= count;
+            _bitsleft -= count;
+            return value;
+        }
+
+        private void LoadStaticCodes()
+        {
+            if (_staticCodesLoaded)
+            {
+                return;
+            }
+            Span<byte> lens = stackalloc byte[InflateFormat.MaxLitlenSymbols + InflateFormat.MaxOffsetSymbols];
+            lens[..144].Fill(8);
+            lens[144..256].Fill(9);
+            lens[256..280].Fill(7);
+            lens[280..288].Fill(8);
+            lens[288..].Fill(5);
+            BuildCodeTables(lens, InflateFormat.MaxLitlenSymbols, InflateFormat.MaxOffsetSymbols);
+            _staticCodesLoaded = true;
+        }
+
+        private void ReadDynamicCodes(ReadOnlySpan<byte> input, ref int inPos)
+        {
+            _staticCodesLoaded = false;
+            int litlenSymbols = (int)PopBits(5) + 257;
+            int offsetSymbols = (int)PopBits(5) + 1;
+            int precodeSymbols = (int)PopBits(4) + 4;
+
+            Span<byte> precodeLens = stackalloc byte[InflateFormat.PrecodeSymbols];
+            precodeLens.Clear();
+            for (int i = 0; i < precodeSymbols; i++)
+            {
+                if (_bitsleft < 3)
+                {
+                    RefillBits(input, ref inPos);
+                }
+                precodeLens[InflateFormat.PrecodeOrder[i]] = (byte)PopBits(3);
+            }
+
+            Span<uint> precode = stackalloc uint[InflateFormat.PrecodeTableSize];
+            Span<ushort> sorted = stackalloc ushort[InflateFormat.PrecodeSymbols];
+            if (!HuffmanTableBuilder.TryBuild(
+                precode, precodeLens, InflateFormat.PrecodeResults, InflateFormat.PrecodeTableBits,
+                InflateFormat.MaxPrecodeLength, sorted, shrink: false, out _))
+            {
+                throw new InvalidDataException("A deflate block has an invalid code-length code.");
+            }
+
+            Span<byte> lens = stackalloc byte[LensSize];
+            ReadCodeLengths(input, ref inPos, precode, lens, litlenSymbols + offsetSymbols);
+            BuildCodeTables(lens[..(litlenSymbols + offsetSymbols)], litlenSymbols, offsetSymbols);
+        }
+
+        private void ReadCodeLengths(ReadOnlySpan<byte> input, ref int inPos, ReadOnlySpan<uint> precode, Span<byte> lens, int total)
+        {
+            int count = 0;
+            while (count < total)
+            {
+                if (_bitsleft < InflateFormat.MaxPrecodeLength + 7)
+                {
+                    RefillBits(input, ref inPos);
+                }
+                uint entry = precode[(int)(_bitbuf & PrecodeMask)];
+                _ = PopBits((int)(entry & 0xFF));
+                uint symbol = entry >> 16;
+                if (symbol < 16)
+                {
+                    lens[count++] = (byte)symbol;
+                    continue;
+                }
+                int repeat = ReadRepeat(symbol, count, lens, out byte value);
+                lens.Slice(count, repeat).Fill(value);
+                count += repeat;
+            }
+            if (count != total)
+            {
+                throw new InvalidDataException("A deflate block's code lengths overrun its header.");
+            }
+        }
+
+        private int ReadRepeat(uint symbol, int count, ReadOnlySpan<byte> lens, out byte value)
+        {
+            value = 0;
+            if (symbol == 17)
+            {
+                return 3 + (int)PopBits(3);
+            }
+            if (symbol == 18)
+            {
+                return 11 + (int)PopBits(7);
+            }
+            if (count == 0)
+            {
+                throw new InvalidDataException("A deflate block repeats a code length before defining one.");
+            }
+            value = lens[count - 1];
+            return 3 + (int)PopBits(2);
+        }
+
+        private void BuildCodeTables(ReadOnlySpan<byte> lens, int litlenSymbols, int offsetSymbols)
+        {
+            Span<ushort> sorted = stackalloc ushort[InflateFormat.MaxLitlenSymbols];
+            if (!HuffmanTableBuilder.TryBuild(
+                _offset.AsSpan(0, InflateFormat.OffsetTableSize), lens.Slice(litlenSymbols, offsetSymbols), InflateFormat.OffsetResults,
+                InflateFormat.OffsetTableBits, InflateFormat.MaxCodewordLength, sorted, shrink: false, out _))
+            {
+                throw new InvalidDataException("A deflate block has an invalid offset code.");
+            }
+            if (!HuffmanTableBuilder.TryBuild(
+                _litlen.AsSpan(0, InflateFormat.LitlenTableSize), lens[..litlenSymbols], InflateFormat.LitlenResults,
+                InflateFormat.LitlenTableBits, InflateFormat.MaxCodewordLength, sorted, shrink: true, out int litlenBits))
+            {
+                throw new InvalidDataException("A deflate block has an invalid literal/length code.");
+            }
+            _litlenMask = (1UL << litlenBits) - 1;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
new file mode 100644
index 00000000..6d4ad8c0
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
@@ -0,0 +1,211 @@
+using System.Buffers;
+
+namespace ExcelReader.Core.Reader.Zip.Inflate
+{
+    /// <summary>
+    /// Read-only stream that inflates a raw DEFLATE stream. Owns <c>inner</c> and disposes it.
+    /// </summary>
+    internal sealed class InflateStream : Stream
+    {
+        private const int InputSize = 64 * 1024;
+        private const int History = 32 * 1024;
+        private const int ChunkSize = 64 * 1024;
+        private const int OutLimit = History + ChunkSize;
+        private const int CanaryStart = OutLimit + InflateDecoder.OutputSlack;
+        private const int CanarySize = 16;
+        private const byte CanaryByte = 0xA5;
+
+        private readonly Stream _inner;
+        private readonly InflateDecoder _decoder = new();
+        private readonly byte[] _input = ArrayPool<byte>.Shared.Rent(InputSize + InflateDecoder.InputPadding);
+        private readonly byte[] _window = ArrayPool<byte>.Shared.Rent(CanaryStart + CanarySize);
+        private int _inPos;
+        private int _inEnd;
+        private bool _inputEnded;
+        private int _outPos;
+        private int _readPos;
+        private bool _finished;
+        private bool _disposed;
+
+        internal InflateStream(Stream inner)
+        {
+            _inner = inner;
+            _window.AsSpan(CanaryStart, CanarySize).Fill(CanaryByte);
+        }
+
+        public override bool CanRead => !_disposed;
+        public override bool CanSeek => false;
+        public override bool CanWrite => false;
+        public override long Length => throw new NotSupportedException();
+
+        public override long Position
+        {
+            get => throw new NotSupportedException();
+            set => throw new NotSupportedException();
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return Read(buffer.AsSpan(offset, count));
+        }
+
+        public override int Read(Span<byte> buffer)
+        {
+            ObjectDisposedException.ThrowIf(_disposed, this);
+            int total = 0;
+            while (total < buffer.Length)
+            {
+                int copied = CopyOut(buffer[total..]);
+                if (copied > 0)
+                {
+                    total += copied;
+                    continue;
+                }
+                if (_finished)
+                {
+                    break;
+                }
+                if (!Advance())
+                {
+                    FillInput();
+                }
+            }
+            return total;
+        }
+
+        public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+        {
+            ObjectDisposedException.ThrowIf(_disposed, this);
+            int total = 0;
+            while (total < buffer.Length)
+            {
+                int copied = CopyOut(buffer.Span[total..]);
+                if (copied > 0)
+                {
+                    total += copied;
+                    continue;
+                }
+                if (_finished)
+                {
+                    break;
+                }
+                if (!Advance())
+                {
+                    await FillInputAsync(cancellationToken).ConfigureAwait(false);
+                }
+            }
+            return total;
+        }
+
+        public override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+        {
+            return ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();
+        }
+
+        public override void Flush()
+        {
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            throw new NotSupportedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (!_disposed)
+            {
+                _disposed = true;
+                ArrayPool<byte>.Shared.Return(_input);
+                ArrayPool<byte>.Shared.Return(_window);
+                _decoder.Dispose();
+                if (disposing)
+                {
+                    _inner.Dispose();
+                }
+            }
+            base.Dispose(disposing);
+        }
+
+        private int CopyOut(Span<byte> destination)
+        {
+            int count = Math.Min(_outPos - _readPos, destination.Length);
+            _window.AsSpan(_readPos, count).CopyTo(destination);
+            _readPos += count;
+            return count;
+        }
+
+        // Returns false when the decoder needs more input. Only called once everything decoded so far
+        // has been copied out, which is what makes sliding the window safe.
+        private bool Advance()
+        {
+            if (_outPos >= OutLimit)
+            {
+                _window.AsSpan(_outPos - History, History).CopyTo(_window);
+                _outPos = History;
+                _readPos = History;
+            }
+            InflateStatus status = _decoder.Decode(_input, ref _inPos, _inEnd, _inputEnded, _window, ref _outPos, OutLimit);
+            if (_window.AsSpan(CanaryStart, CanarySize).ContainsAnyExcept(CanaryByte))
+            {
+                throw new InvalidOperationException("The inflate decoder wrote past its output window.");
+            }
+            _finished = status == InflateStatus.Finished;
+            return status != InflateStatus.NeedInput;
+        }
+
+        private void FillInput()
+        {
+            Compact();
+            while (_inEnd < InputSize)
+            {
+                int read = _inner.Read(_input, _inEnd, InputSize - _inEnd);
+                if (read == 0)
+                {
+                    EndInput();
+                    return;
+                }
+                _inEnd += read;
+            }
+        }
+
+        private async ValueTask FillInputAsync(CancellationToken cancellationToken)
+        {
+            Compact();
+            while (_inEnd < InputSize)
+            {
+                int read = await _inner.ReadAsync(_input.AsMemory(_inEnd, InputSize - _inEnd), cancellationToken).ConfigureAwait(false);
+                if (read == 0)
+                {
+                    EndInput();
+                    return;
+                }
+                _inEnd += read;
+            }
+        }
+
+        private void Compact()
+        {
+            int remaining = _inEnd - _inPos;
+            _input.AsSpan(_inPos, remaining).CopyTo(_input);
+            _inPos = 0;
+            _inEnd = remaining;
+        }
+
+        private void EndInput()
+        {
+            _inputEnded = true;
+            _input.AsSpan(_inEnd, InflateDecoder.InputPadding).Clear();
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Zip/InflateDifferentialTests.cs b/tests/ExcelReader.Tests/Reader/Zip/InflateDifferentialTests.cs
new file mode 100644
index 00000000..337464bf
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Zip/InflateDifferentialTests.cs
@@ -0,0 +1,87 @@
+using System.Buffers.Binary;
+using System.IO.Compression;
+using static ExcelReader.Tests.Reader.Zip.InflateTestSupport;
+
+namespace ExcelReader.Tests.Reader.Zip
+{
+    public class InflateDifferentialTests
+    {
+        public static TheoryData<DataShape, CompressionLevel> ShapesAndLevels()
+        {
+            var data = new TheoryData<DataShape, CompressionLevel>();
+            foreach (DataShape shape in Enum.GetValues<DataShape>())
+            {
+                foreach (CompressionLevel level in Enum.GetValues<CompressionLevel>())
+                {
+                    data.Add(shape, level);
+                }
+            }
+            return data;
+        }
+
+        [Theory]
+        [MemberData(nameof(ShapesAndLevels))]
+        public void DeflateStreamOutputRoundTrips(DataShape shape, CompressionLevel level)
+        {
+            int[] sizes = [1, 2, 7, 100, 1000, 32768, 65536, 70_000, 300_000, 1_500_000];
+            foreach (int size in sizes)
+            {
+                byte[] raw = Generate(shape, size, seed: size);
+                byte[] stream = Deflate(raw, level);
+                Assert.NotEmpty(stream);
+
+                Assert.True(raw.AsSpan().SequenceEqual(Inflate(stream, readSize: 64 * 1024)), $"size {size}");
+            }
+        }
+
+        [Theory]
+        [InlineData("sample.xlsx")]
+        [InlineData("RealExcel.xlsb")]
+        public void EveryDeflateEntryOfAProducerWrittenWorkbookMatchesDeflateStream(string fileName)
+        {
+            byte[] zip = File.ReadAllBytes(Path.Combine(AppContext.BaseDirectory, "data", fileName));
+            int compared = 0;
+
+            foreach (byte[] stream in DeflateEntries(zip))
+            {
+                using var reference = new MemoryStream();
+                using (var deflate = new DeflateStream(new MemoryStream(stream), CompressionMode.Decompress))
+                {
+                    deflate.CopyTo(reference);
+                }
+
+                Assert.True(reference.ToArray().AsSpan().SequenceEqual(Inflate(stream)), $"entry {compared} of {fileName}");
+                compared++;
+            }
+
+            Assert.True(compared >= 5, $"{fileName} yielded only {compared} deflate entries");
+        }
+
+        private static List<byte[]> DeflateEntries(byte[] zip)
+        {
+            int end = zip.AsSpan().LastIndexOf("PK\x05\x06"u8);
+            Assert.True(end >= 0, "no end-of-central-directory record");
+            int count = BinaryPrimitives.ReadUInt16LittleEndian(zip.AsSpan(end + 10));
+            int position = (int)BinaryPrimitives.ReadUInt32LittleEndian(zip.AsSpan(end + 16));
+            var entries = new List<byte[]>();
+            for (int i = 0; i < count; i++)
+            {
+                ReadOnlySpan<byte> header = zip.AsSpan(position);
+                int method = BinaryPrimitives.ReadUInt16LittleEndian(header[10..]);
+                int compressedSize = (int)BinaryPrimitives.ReadUInt32LittleEndian(header[20..]);
+                int nameLength = BinaryPrimitives.ReadUInt16LittleEndian(header[28..]);
+                int extraLength = BinaryPrimitives.ReadUInt16LittleEndian(header[30..]);
+                int commentLength = BinaryPrimitives.ReadUInt16LittleEndian(header[32..]);
+                int local = (int)BinaryPrimitives.ReadUInt32LittleEndian(header[42..]);
+                if (method == 8)
+                {
+                    ReadOnlySpan<byte> localHeader = zip.AsSpan(local);
+                    int data = local + 30 + BinaryPrimitives.ReadUInt16LittleEndian(localHeader[26..]) + BinaryPrimitives.ReadUInt16LittleEndian(localHeader[28..]);
+                    entries.Add(zip.AsSpan(data, compressedSize).ToArray());
+                }
+                position += 46 + nameLength + extraLength + commentLength;
+            }
+            return entries;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs b/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
new file mode 100644
index 00000000..458a0b25
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
@@ -0,0 +1,245 @@
+using System.Diagnostics.CodeAnalysis;
+using System.IO.Compression;
+using ExcelReader.Core.Reader.Zip.Inflate;
+using static ExcelReader.Tests.Reader.Zip.InflateTestSupport;
+
+namespace ExcelReader.Tests.Reader.Zip
+{
+    public class InflateStreamTests
+    {
+        [Fact]
+        public void StoredBlockIsCopiedThrough()
+        {
+            byte[] stream = [0x01, 0x05, 0x00, 0xFA, 0xFF, (byte)'h', (byte)'e', (byte)'l', (byte)'l', (byte)'o'];
+
+            Assert.Equal("hello"u8.ToArray(), Inflate(stream));
+        }
+
+        [Fact]
+        public void EmptyFixedBlockProducesNothing()
+        {
+            Assert.Empty(Inflate([0x03, 0x00]));
+        }
+
+        [Fact]
+        public void ZeroLengthStoredBlockIsSkipped()
+        {
+            byte[] stream = [0x00, 0x00, 0x00, 0xFF, 0xFF, 0x01, 0x02, 0x00, 0xFD, 0xFF, (byte)'o', (byte)'k'];
+
+            Assert.Equal("ok"u8.ToArray(), Inflate(stream));
+        }
+
+        [Fact]
+        public void BytesAfterTheFinalBlockAreIgnored()
+        {
+            byte[] raw = Generate(DataShape.SheetXml, 5000, seed: 1);
+            byte[] stream = [.. Deflate(raw, CompressionLevel.Optimal), 0xDE, 0xAD, 0xBE, 0xEF];
+
+            Assert.Equal(raw, Inflate(stream));
+        }
+
+        [Fact]
+        public void ReservedBlockTypeIsRejected()
+        {
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate([0x07, 0x00, 0x00, 0x00]));
+
+            Assert.Contains("reserved block type", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void StoredBlockWithMismatchedLengthFieldsIsRejected()
+        {
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(
+                () => Inflate([0x01, 0x05, 0x00, 0x00, 0x00, 1, 2, 3, 4, 5]));
+
+            Assert.Contains("mismatched length", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void MatchReachingBeforeTheOutputStartIsRejected()
+        {
+            // Fixed block whose first symbol is a length-3 match at offset 1, with nothing before it.
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate([0x03, 0x02, 0x00, 0x00]));
+
+            Assert.Contains("before the start", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void DynamicHeaderWhoseCodeLengthsOverrunIsRejected()
+        {
+            // Code-length code: symbols 0 and 18, one bit each. Two runs of 138 zeros exceed the 258 lengths declared.
+            byte[] stream = DynamicHeader(precodeLens: [0, 0, 1, 1], codeLengthBits: [(1, 1), (127, 7), (1, 1), (127, 7)]);
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate(stream));
+
+            Assert.Contains("overrun", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void DynamicHeaderThatRepeatsBeforeAnyLengthIsRejected()
+        {
+            // Code-length code: symbols 0 and 16, one bit each. The first symbol is 16, "repeat the previous length".
+            byte[] stream = DynamicHeader(precodeLens: [1, 0, 0, 1], codeLengthBits: [(1, 1), (0, 2)]);
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate(stream));
+
+            Assert.Contains("before defining one", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void DynamicHeaderWithOverSubscribedCodeLengthCodeIsRejected()
+        {
+            byte[] stream = DynamicHeader(precodeLens: [1, 1, 1, 1], codeLengthBits: []);
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate(stream));
+
+            Assert.Contains("code-length code", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void EmptyInputIsRejected()
+        {
+            Assert.Throws<InvalidDataException>(() => Inflate([]));
+        }
+
+        [Theory]
+        [InlineData(DataShape.SheetXml, CompressionLevel.Optimal)]
+        [InlineData(DataShape.SheetXml, CompressionLevel.Fastest)]
+        [InlineData(DataShape.Random, CompressionLevel.NoCompression)]
+        [InlineData(DataShape.Zeros, CompressionLevel.Optimal)]
+        [SuppressMessage("Security", "CA5394:Do not use insecure randomness", Justification = "Seeded cut positions, not security.")]
+        public void StreamCutAnywhereIsRejected(DataShape shape, CompressionLevel level)
+        {
+            byte[] stream = Deflate(Generate(shape, 200_000, seed: 7), level);
+            var random = new Random(11);
+            int[] cuts = [1, 2, stream.Length / 2, stream.Length - 2, stream.Length - 1, .. Enumerable.Range(0, 40).Select(_ => random.Next(1, stream.Length))];
+
+            foreach (int cut in cuts)
+            {
+                Assert.Throws<InvalidDataException>(() => Inflate(stream[..cut]));
+            }
+        }
+
+        [Theory]
+        [InlineData(1)]
+        [InlineData(7)]
+        [InlineData(4096)]
+        [InlineData(1 << 20)]
+        public void OutputIsTheSameForEveryReadSize(int readSize)
+        {
+            byte[] raw = Generate(DataShape.MixedRuns, 300_000, seed: 3);
+
+            Assert.Equal(raw, Inflate(Deflate(raw, CompressionLevel.Optimal), readSize));
+        }
+
+        [Theory]
+        [InlineData(1)]
+        [InlineData(3)]
+        [InlineData(997)]
+        public void InputMayArriveInSmallPieces(int sourceStep)
+        {
+            byte[] raw = Generate(DataShape.SheetXml, 150_000, seed: 5);
+
+            Assert.Equal(raw, Inflate(Deflate(raw, CompressionLevel.Optimal), readSize: 8192, sourceStep));
+        }
+
+        [Theory]
+        [InlineData(DataShape.SheetXml, 1)]
+        [InlineData(DataShape.RepeatedBlock, 997)]
+        [InlineData(DataShape.Random, int.MaxValue)]
+        public async Task ReadAsyncProducesTheSameBytesAsRead(DataShape shape, int sourceStep)
+        {
+            byte[] stream = Deflate(Generate(shape, 250_000, seed: 9), CompressionLevel.Optimal);
+
+            byte[] sync = Inflate(stream, readSize: 5000, sourceStep);
+            byte[] async = await InflateAsync(stream, readSize: 5000, sourceStep, TestContext.Current.CancellationToken);
+
+            Assert.Equal(sync, async);
+        }
+
+        [Fact]
+        public void StreamsDecodingInParallelDoNotInterfere()
+        {
+            byte[] raw = Generate(DataShape.SheetXml, 400_000, seed: 13);
+            byte[] stream = Deflate(raw, CompressionLevel.Optimal);
+
+            Parallel.For(0, 32, _ => Assert.True(raw.AsSpan().SequenceEqual(Inflate(stream, readSize: 3000))));
+        }
+
+        [Fact]
+        public void DisposeDisposesTheInnerStream()
+        {
+            var inner = new SteppedStream([0x03, 0x00], int.MaxValue);
+
+            new InflateStream(inner).Dispose();
+
+            Assert.True(inner.Disposed);
+        }
+
+        [Fact]
+        public void ReadAfterDisposeThrows()
+        {
+            var inflate = new InflateStream(new MemoryStream([0x03, 0x00]));
+            inflate.Dispose();
+
+            Assert.Throws<ObjectDisposedException>(() => inflate.Read(new byte[1]));
+        }
+
+        [Fact]
+        public void DisposeTwiceIsHarmless()
+        {
+            var inflate = new InflateStream(new MemoryStream([0x03, 0x00]));
+
+            inflate.Dispose();
+            inflate.Dispose();
+
+            Assert.False(inflate.CanRead);
+        }
+
+        // A final dynamic block declaring 257 literal/length codes and 1 offset code, with the given
+        // lengths for the first four code-length-code symbols (16, 17, 18, 0) and raw bits after them.
+        private static byte[] DynamicHeader(int[] precodeLens, (int Value, int Count)[] codeLengthBits)
+        {
+            var bits = new BitWriter();
+            bits.Write(1, 1);
+            bits.Write(2, 2);
+            bits.Write(0, 5);
+            bits.Write(0, 5);
+            bits.Write(precodeLens.Length - 4, 4);
+            foreach (int len in precodeLens)
+            {
+                bits.Write(len, 3);
+            }
+            foreach ((int value, int count) in codeLengthBits)
+            {
+                bits.Write(value, count);
+            }
+            return bits.ToArray();
+        }
+
+        private sealed class BitWriter
+        {
+            private readonly List<byte> _bytes = [];
+            private int _used = 8;
+
+            internal void Write(int value, int count)
+            {
+                for (int i = 0; i < count; i++)
+                {
+                    if (_used == 8)
+                    {
+                        _bytes.Add(0);
+                        _used = 0;
+                    }
+                    _bytes[^1] |= (byte)(((value >> i) & 1) << _used);
+                    _used++;
+                }
+            }
+
+            internal byte[] ToArray()
+            {
+                return [.. _bytes];
+            }
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Zip/InflateTestSupport.cs b/tests/ExcelReader.Tests/Reader/Zip/InflateTestSupport.cs
new file mode 100644
index 00000000..fd12e36a
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Zip/InflateTestSupport.cs
@@ -0,0 +1,202 @@
+using System.Diagnostics.CodeAnalysis;
+using System.IO.Compression;
+using System.Text;
+using ExcelReader.Core.Reader.Zip.Inflate;
+
+namespace ExcelReader.Tests.Reader.Zip
+{
+    [SuppressMessage("Security", "CA5394:Do not use insecure randomness", Justification = "Seeded test data, not security.")]
+    internal static class InflateTestSupport
+    {
+        internal static byte[] Deflate(byte[] raw, CompressionLevel level)
+        {
+            using var compressed = new MemoryStream();
+            using (var deflate = new DeflateStream(compressed, level, leaveOpen: true))
+            {
+                deflate.Write(raw);
+            }
+            return compressed.ToArray();
+        }
+
+        internal static byte[] Inflate(byte[] compressed, int readSize = 4096, int sourceStep = int.MaxValue)
+        {
+            using var inflate = new InflateStream(new SteppedStream(compressed, sourceStep));
+            using var output = new MemoryStream();
+            byte[] buffer = new byte[readSize];
+            int read;
+            while ((read = inflate.Read(buffer)) > 0)
+            {
+                output.Write(buffer, 0, read);
+            }
+            return output.ToArray();
+        }
+
+        internal static async Task<byte[]> InflateAsync(byte[] compressed, int readSize, int sourceStep, CancellationToken ct)
+        {
+            using var inflate = new InflateStream(new SteppedStream(compressed, sourceStep));
+            using var output = new MemoryStream();
+            byte[] buffer = new byte[readSize];
+            int read;
+            while ((read = await inflate.ReadAsync(buffer, ct)) > 0)
+            {
+                output.Write(buffer, 0, read);
+            }
+            return output.ToArray();
+        }
+
+        internal static byte[] Generate(DataShape shape, int size, int seed)
+        {
+            var random = new Random(seed);
+            byte[] data = new byte[size];
+            switch (shape)
+            {
+                case DataShape.Zeros:
+                    break;
+                case DataShape.Random:
+                    random.NextBytes(data);
+                    break;
+                case DataShape.SheetXml:
+                    FillSheetXml(data, random);
+                    break;
+                case DataShape.ShortPeriods:
+                    FillShortPeriods(data, random);
+                    break;
+                case DataShape.RepeatedBlock:
+                    FillRepeatedBlock(data, random);
+                    break;
+                default:
+                    FillMixedRuns(data, random);
+                    break;
+            }
+            return data;
+        }
+
+        private static void FillSheetXml(byte[] data, Random random)
+        {
+            var xml = new StringBuilder();
+            for (int row = 1; xml.Length < data.Length; row++)
+            {
+                xml.Append(System.Globalization.CultureInfo.InvariantCulture,
+                    $"<row r=\"{row}\"><c r=\"A{row}\"><v>{random.NextDouble() * 1000:F4}</v></c><c r=\"B{row}\" t=\"s\"><v>{random.Next(500)}</v></c></row>");
+            }
+            Encoding.ASCII.GetBytes(xml.ToString(0, data.Length), data);
+        }
+
+        // Runs whose period is 1 to 9 bytes, so matches land on every short offset.
+        private static void FillShortPeriods(byte[] data, Random random)
+        {
+            int position = 0;
+            while (position < data.Length)
+            {
+                int period = random.Next(1, 10);
+                int run = Math.Min(data.Length - position, random.Next(period, 600));
+                for (int i = 0; i < run; i++)
+                {
+                    data[position + i] = i < period ? (byte)random.Next(256) : data[position + i - period];
+                }
+                position += run;
+            }
+        }
+
+        // One incompressible 32,768-byte block repeated, so matches sit at the far edge of the window.
+        private static void FillRepeatedBlock(byte[] data, Random random)
+        {
+            const int Block = 32768;
+            random.NextBytes(data.AsSpan(0, Math.Min(Block, data.Length)));
+            for (int i = Block; i < data.Length; i++)
+            {
+                data[i] = data[i - Block];
+            }
+        }
+
+        private static void FillMixedRuns(byte[] data, Random random)
+        {
+            int position = 0;
+            while (position < data.Length)
+            {
+                int run = Math.Min(data.Length - position, random.Next(1, 400));
+                if (random.Next(3) == 0)
+                {
+                    random.NextBytes(data.AsSpan(position, run));
+                }
+                else
+                {
+                    data.AsSpan(position, run).Fill((byte)random.Next(256));
+                }
+                position += run;
+            }
+        }
+    }
+
+    public enum DataShape
+    {
+        Zeros,
+        Random,
+        SheetXml,
+        ShortPeriods,
+        RepeatedBlock,
+        MixedRuns,
+    }
+
+    internal sealed class SteppedStream(byte[] data, int step) : Stream
+    {
+        private int _position;
+
+        internal bool Disposed { get; private set; }
+
+        public override bool CanRead => true;
+        public override bool CanSeek => false;
+        public override bool CanWrite => false;
+        public override long Length => data.Length;
+
+        public override long Position
+        {
+            get => _position;
+            set => throw new NotSupportedException();
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return Read(buffer.AsSpan(offset, count));
+        }
+
+        public override int Read(Span<byte> buffer)
+        {
+            int count = Math.Min(Math.Min(step, buffer.Length), data.Length - _position);
+            data.AsSpan(_position, count).CopyTo(buffer);
+            _position += count;
+            return count;
+        }
+
+        public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+        {
+            await Task.Yield();
+            return Read(buffer.Span);
+        }
+
+        public override void Flush()
+        {
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotSupportedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            throw new NotSupportedException();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            Disposed = true;
+            base.Dispose(disposing);
+        }
+    }
+}

From 7f02562543f666d2f5900cf2d6337d91154b1aa6 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:49:08 -0300
Subject: [PATCH 023/115] perf: inflate ZIP entries with the managed decoder

Replaces DeflateStream at all four sites in ZipIndex. A deflate entry that ends before its final block now throws InvalidDataException; DeflateStream returned the bytes decoded so far and reported end of stream.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Zip/ZipIndex.cs   | 10 +++---
 .../Reader/Zip/ZipIndexTests.cs               | 33 +++++++++++++++++++
 2 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs b/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
index cb6b225d..86332b39 100644
--- a/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
+++ b/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
@@ -1,9 +1,9 @@
 using System.Buffers;
 using System.Buffers.Binary;
-using System.IO.Compression;
 using System.Runtime.InteropServices;
 using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Sources;
+using ExcelReader.Core.Reader.Zip.Inflate;
 
 namespace ExcelReader.Core.Reader.Zip
 {
@@ -341,7 +341,7 @@ internal async ValueTask<ZipPart> OpenPartAsync(
             try
             {
                 ByteSourceStream raw = new(_source, dataOffset, entry.CompressedSize);
-                Stream content = entry.Method == 0 ? raw : new DeflateStream(raw, CompressionMode.Decompress);
+                Stream content = entry.Method == 0 ? raw : new InflateStream(raw);
                 await using (content.ConfigureAwait(false))
                 {
                     try
@@ -401,7 +401,7 @@ private LimitedReadStream WrapEntryStream(
             Stream raw = HasMemory
                 ? ToReadableMemoryStream(CompressedSlice(dataOffset, entry.CompressedSize))
                 : new ByteSourceStream(_source, dataOffset, entry.CompressedSize);
-            Stream opened = entry.Method == 0 ? raw : new DeflateStream(raw, CompressionMode.Decompress);
+            Stream opened = entry.Method == 0 ? raw : new InflateStream(raw);
             return WorkbookLookups.Wrap(opened, counter, options, entryLimitName, entryLimit, entry.UncompressedSize);
         }
 
@@ -451,7 +451,7 @@ private ZipPart ReadPart(long dataOffset, in ZipEntryRef entry)
             try
             {
                 ByteSourceStream raw = new(_source, dataOffset, entry.CompressedSize);
-                using Stream content = entry.Method == 0 ? raw : new DeflateStream(raw, CompressionMode.Decompress);
+                using Stream content = entry.Method == 0 ? raw : new InflateStream(raw);
                 try
                 {
                     content.ReadExactly(rented.AsSpan(0, size));
@@ -795,7 +795,7 @@ private static ZipPart InflateToPart(ReadOnlyMemory<byte> compressed, long uncom
             try
             {
                 using MemoryStream source = ToReadableMemoryStream(compressed);
-                using var inflate = new DeflateStream(source, CompressionMode.Decompress);
+                using var inflate = new InflateStream(source);
                 try
                 {
                     inflate.ReadExactly(rented.AsSpan(0, size));
diff --git a/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs b/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
index 8a765067..995258a2 100644
--- a/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
@@ -859,6 +859,39 @@ public void ZipArchiveEntryOpenSilentlyTruncatesAtDeclaredLengthUnderOverDeliver
             Assert.Equal(-1, stream.ReadByte());
         }
 
+        [Fact]
+        public void DeflatedEntryCutShortIsRejectedWhenOpenedAsAPart()
+        {
+            byte[] zipBytes = BuildZipWithCutDeflatedEntry("data.xml");
+
+            using ZipIndex index = ZipIndex.Create(zipBytes, ExcelReaderOptions.Default);
+            Assert.True(index.TryGetEntry("data.xml"u8, out ZipEntryRef entry));
+            Assert.Equal((ushort)8, entry.Method);
+            Assert.Throws<InvalidDataException>(() => index.OpenPart(entry, new DecompressedByteCounter(0)));
+        }
+
+        [Fact]
+        public void DeflatedEntryCutShortIsRejectedWhenStreamedInsteadOfEndingEarly()
+        {
+            byte[] zipBytes = BuildZipWithCutDeflatedEntry("data.xml");
+
+            using ZipIndex index = ZipIndex.Create(zipBytes, ExcelReaderOptions.Default);
+            Assert.True(index.TryGetEntry("data.xml"u8, out ZipEntryRef entry));
+            using LimitedReadStream stream = index.OpenEntryStream(entry, new DecompressedByteCounter(0), ExcelReaderOptions.Default);
+            Assert.Throws<InvalidDataException>(() => stream.CopyTo(Stream.Null));
+        }
+
+        private static byte[] BuildZipWithCutDeflatedEntry(string entryName)
+        {
+            byte[] payload = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Repeat("<row><c><v>12345</v></c></row>", 4000)));
+            byte[] zipBytes = BuildZipWithOneEntry(entryName, payload, CompressionLevel.Optimal);
+            int cdOffset = FindCentralDirectoryOffset(zipBytes, entryName);
+            uint compressedSize = BinaryPrimitives.ReadUInt32LittleEndian(zipBytes.AsSpan(cdOffset + 20, 4));
+            Assert.True(compressedSize > 8);
+            PatchCentralDirectoryUInt32(zipBytes, entryName, fieldOffset: 20, compressedSize / 2);
+            return zipBytes;
+        }
+
         private static uint ReadDeclaredUncompressedSize(byte[] zipBytes, string entryName)
         {
             int cdOffset = FindCentralDirectoryOffset(zipBytes, entryName);

From 58bb3caaa65f6e8a50f246891bfc3f037371e8f2 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:52:57 -0300
Subject: [PATCH 024/115] test: fuzz the managed inflate decoder against
 DeflateStream

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .github/workflows/fuzz.yml                    |  3 +-
 tests/ExcelReader.Fuzz/Harnesses.cs           | 55 +++++++++++++++++++
 tests/ExcelReader.Fuzz/Program.cs             |  1 +
 tests/ExcelReader.Fuzz/README.md              |  7 ++-
 tests/ExcelReader.Fuzz/SeedCorpus.cs          | 25 +++++++++
 tests/ExcelReader.Fuzz/SmokeRunner.cs         | 34 ++++++++++++
 .../dictionaries/inflate.dict                 | 15 +++++
 7 files changed, 138 insertions(+), 2 deletions(-)
 create mode 100644 tests/ExcelReader.Fuzz/dictionaries/inflate.dict

diff --git a/.github/workflows/fuzz.yml b/.github/workflows/fuzz.yml
index ab0a4f81..50a4998b 100644
--- a/.github/workflows/fuzz.yml
+++ b/.github/workflows/fuzz.yml
@@ -53,7 +53,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        target: [xlsx, xlsx-memory, xlsx-differential, xlsb, xlsb-memory, xlsb-differential, xls, encrypted, csv, csv-sniff, csv-parallel]
+        target: [xlsx, xlsx-memory, xlsx-differential, xlsb, xlsb-memory, xlsb-differential, xls, encrypted, csv, csv-sniff, csv-parallel, inflate]
     steps:
       - name: Checkout
         uses: actions/checkout@v7
@@ -110,6 +110,7 @@ jobs:
             xls)       dict=xls ;;
             encrypted) dict=encrypted ;;
             csv*)      dict=csv ;;
+            inflate)   dict=inflate ;;
           esac
           ./libfuzzer-dotnet \
             --target_path=fuzz-out/ExcelReader.Fuzz \
diff --git a/tests/ExcelReader.Fuzz/Harnesses.cs b/tests/ExcelReader.Fuzz/Harnesses.cs
index 9b98fa7a..d05ae096 100644
--- a/tests/ExcelReader.Fuzz/Harnesses.cs
+++ b/tests/ExcelReader.Fuzz/Harnesses.cs
@@ -1,4 +1,5 @@
 using System.Globalization;
+using System.IO.Compression;
 using System.Text;
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Parser.ParallelCsv;
@@ -7,6 +8,7 @@
 using ExcelReader.Core.Reader.Xls;
 using ExcelReader.Core.Reader.Xlsb;
 using ExcelReader.Core.Reader.Xlsx;
+using ExcelReader.Core.Reader.Zip.Inflate;
 
 namespace ExcelReader.Fuzz
 {
@@ -119,6 +121,59 @@ internal static void Encrypted(ReadOnlySpan<byte> data)
             });
         }
 
+        private const int MaxInflateOutput = 4 * 1024 * 1024;
+
+        internal static void Inflate(ReadOnlySpan<byte> data)
+        {
+            byte[] bytes = data.ToArray();
+            FuzzOracle.Guard(() =>
+            {
+                byte[] actual = InflateWith(static source => new InflateStream(source), bytes);
+                byte[] reference;
+                try
+                {
+                    reference = InflateWith(static source => new DeflateStream(source, CompressionMode.Decompress), bytes);
+                }
+                catch (InvalidDataException)
+                {
+                    return;
+                }
+                if (!actual.AsSpan().SequenceEqual(reference))
+                {
+                    throw new InvalidOperationException(
+                        $"Oracle divergence: InflateStream produced {actual.Length} bytes that differ from DeflateStream's {reference.Length}.");
+                }
+            });
+        }
+
+        internal static int InflateSeedForSelfCheck(byte[] bytes)
+        {
+            byte[] actual = InflateWith(static source => new InflateStream(source), bytes);
+            byte[] reference = InflateWith(static source => new DeflateStream(source, CompressionMode.Decompress), bytes);
+            if (!actual.AsSpan().SequenceEqual(reference))
+            {
+                throw new InvalidOperationException("InflateStream and DeflateStream disagree on an unmutated seed.");
+            }
+            return actual.Length;
+        }
+
+        private static byte[] InflateWith(Func<Stream, Stream> open, byte[] bytes)
+        {
+            using Stream stream = open(new MemoryStream(bytes, writable: false));
+            using var output = new MemoryStream();
+            byte[] buffer = new byte[64 * 1024];
+            while (output.Length < MaxInflateOutput)
+            {
+                int read = stream.Read(buffer, 0, (int)Math.Min(buffer.Length, MaxInflateOutput - output.Length));
+                if (read == 0)
+                {
+                    break;
+                }
+                output.Write(buffer, 0, read);
+            }
+            return output.ToArray();
+        }
+
         internal static int OpenEncryptedSeedForSelfCheck(ReadOnlySpan<byte> data)
         {
             byte[] bytes = data.ToArray();
diff --git a/tests/ExcelReader.Fuzz/Program.cs b/tests/ExcelReader.Fuzz/Program.cs
index c6eb632c..f4613d29 100644
--- a/tests/ExcelReader.Fuzz/Program.cs
+++ b/tests/ExcelReader.Fuzz/Program.cs
@@ -28,6 +28,7 @@ internal static class Program
                 ["csv"] = Harnesses.Csv,
                 ["csv-sniff"] = Harnesses.CsvSniff,
                 ["csv-parallel"] = Harnesses.CsvParallel,
+                ["inflate"] = Harnesses.Inflate,
             };
 
         private static async Task<int> Main(string[] args)
diff --git a/tests/ExcelReader.Fuzz/README.md b/tests/ExcelReader.Fuzz/README.md
index c5946655..d3953d23 100644
--- a/tests/ExcelReader.Fuzz/README.md
+++ b/tests/ExcelReader.Fuzz/README.md
@@ -25,7 +25,7 @@ result cannot silently mean "the oracle accepts everything".
 
 ## Targets
 
-`xlsx`, `xlsx-memory`, `xlsb`, `xlsb-memory`, `xls`, `encrypted`, `csv`, `csv-sniff`.
+`xlsx`, `xlsx-memory`, `xlsb`, `xlsb-memory`, `xls`, `encrypted`, `csv`, `csv-sniff`, `inflate`.
 
 The `-memory` variants exist because the in-memory ZIP path (`ZipMemoryIndex`) is a different
 container parser from the `Stream`/`ZipArchive` one, and `csv-sniff` because dialect detection runs
@@ -34,6 +34,11 @@ directory + `EncryptionInfo` descriptor) layered under the ZIP one, and runs bef
 check, so it gets its own target with a fixed, correct password (`hunter2`) so mutations explore the
 parsers instead of dead-ending on a verifier mismatch.
 
+`inflate` feeds raw bytes straight to the managed DEFLATE decoder, without a ZIP around them, and
+compares its output with `DeflateStream`'s whenever both accept the input. It exists because the
+other targets only notice a decoder that crashes or hangs: one that decodes the wrong bytes
+without crashing would pass every one of them.
+
 ## Running locally
 
 No native tooling — runs anywhere, and is what gates pull requests:
diff --git a/tests/ExcelReader.Fuzz/SeedCorpus.cs b/tests/ExcelReader.Fuzz/SeedCorpus.cs
index 59a9af75..7b5b4b65 100644
--- a/tests/ExcelReader.Fuzz/SeedCorpus.cs
+++ b/tests/ExcelReader.Fuzz/SeedCorpus.cs
@@ -1,4 +1,5 @@
 using System.Globalization;
+using System.IO.Compression;
 using System.Text;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Writer;
@@ -46,6 +47,7 @@ private static readonly (string Target, string[] Seeds)[] _layout =
                            "csv-invalid-utf8", "csv-utf16le", "csv-utf16be", "csv-unterminated-quote"]),
             ("csv-parallel", ["csv", "csv-ragged", "csv-parallel-0", "csv-parallel-1", "csv-parallel-2",
                               "csv-parallel-3", "csv-parallel-4", "csv-parallel-5", "csv-parallel-6"]),
+            ("inflate", ["inflate-stored", "inflate-fixed", "inflate-dynamic"]),
         ];
 
         internal static async Task GenerateAsync(string rootDirectory)
@@ -93,9 +95,32 @@ private static async Task<Dictionary<string, byte[]>> BuildAllAsync()
             {
                 seeds[name] = bytes;
             }
+            foreach ((string name, byte[] bytes) in InflateSeeds())
+            {
+                seeds[name] = bytes;
+            }
             return seeds;
         }
 
+        private static IEnumerable<(string Name, byte[] Bytes)> InflateSeeds()
+        {
+            byte[] sheet = Utf8(string.Concat(Enumerable.Range(1, 40).Select(static row => string.Create(
+                CultureInfo.InvariantCulture, $"<row r=\"{row}\"><c r=\"A{row}\" t=\"s\"><v>{row % 7}</v></c><c r=\"B{row}\"><v>{row * 1.5}</v></c></row>"))));
+            yield return ("inflate-stored", Deflate(sheet, CompressionLevel.NoCompression));
+            yield return ("inflate-fixed", Deflate(Utf8("fixed block"), CompressionLevel.Optimal));
+            yield return ("inflate-dynamic", Deflate(sheet, CompressionLevel.Optimal));
+        }
+
+        private static byte[] Deflate(byte[] raw, CompressionLevel level)
+        {
+            using var compressed = new MemoryStream();
+            using (var deflate = new DeflateStream(compressed, level, leaveOpen: true))
+            {
+                deflate.Write(raw);
+            }
+            return compressed.ToArray();
+        }
+
         private static byte[] Encrypt(byte[] package)
         {
             using var source = new MemoryStream(package, writable: false);
diff --git a/tests/ExcelReader.Fuzz/SmokeRunner.cs b/tests/ExcelReader.Fuzz/SmokeRunner.cs
index 975ce40e..12558c82 100644
--- a/tests/ExcelReader.Fuzz/SmokeRunner.cs
+++ b/tests/ExcelReader.Fuzz/SmokeRunner.cs
@@ -19,6 +19,7 @@ internal static int Run(string corpusDirectory, int mutationsPerInput, int seed)
             Harnesses.AssertSameRowsSelfCheck();
             VerifyEncryptedSeedReachesRealCode(corpusDirectory);
             VerifyDifferentialSeedsReachBothReaders(corpusDirectory);
+            VerifyInflateSeedsCoverEveryBlockType(corpusDirectory);
 
             string[] files = Directory.Exists(corpusDirectory)
                 ? [.. Directory.GetFiles(corpusDirectory, "*", SearchOption.AllDirectories).Order(StringComparer.Ordinal)]
@@ -88,6 +89,39 @@ private static void VerifyDifferentialSeedsReachBothReaders(string corpusDirecto
             }
         }
 
+        private static void VerifyInflateSeedsCoverEveryBlockType(string corpusDirectory)
+        {
+            if (!Directory.Exists(corpusDirectory))
+            {
+                return;
+            }
+
+            (string Name, int BlockType)[] expected = [("seed-inflate-stored.bin", 0), ("seed-inflate-fixed.bin", 1), ("seed-inflate-dynamic.bin", 2)];
+            foreach ((string name, int blockType) in expected)
+            {
+                foreach (string seedPath in Directory.GetFiles(corpusDirectory, name, SearchOption.AllDirectories))
+                {
+                    VerifyOneInflateSeed(seedPath, blockType);
+                }
+            }
+        }
+
+        private static void VerifyOneInflateSeed(string seedPath, int blockType)
+        {
+            string name = Path.GetFileName(seedPath);
+            byte[] seed = File.ReadAllBytes(seedPath);
+            if (seed.Length == 0 || ((seed[0] >> 1) & 3) != blockType)
+            {
+                throw new InvalidOperationException(
+                    $"{name} does not start with a type-{blockType} deflate block, so it no longer seeds that path.");
+            }
+            if (Harnesses.InflateSeedForSelfCheck(seed) == 0)
+            {
+                throw new InvalidOperationException(
+                    $"the unmutated {name} decoded to nothing, so the inflate target compares nothing.");
+            }
+        }
+
         private static void VerifyOneDifferentialSeed(string seedPath, bool xlsb)
         {
             string name = Path.GetFileName(seedPath);
diff --git a/tests/ExcelReader.Fuzz/dictionaries/inflate.dict b/tests/ExcelReader.Fuzz/dictionaries/inflate.dict
new file mode 100644
index 00000000..e9af807d
--- /dev/null
+++ b/tests/ExcelReader.Fuzz/dictionaries/inflate.dict
@@ -0,0 +1,15 @@
+# libFuzzer token dictionary for the inflate target (a raw DEFLATE stream).
+#
+# DEFLATE is bit-packed, so most of its structure cannot be expressed as byte tokens. These are the
+# byte-aligned pieces: stored-block length fields and the shortest complete blocks.
+
+# Empty stored block: not final, then final
+"\x00\x00\x00\xff\xff"
+"\x01\x00\x00\xff\xff"
+
+# Stored-block length fields for one byte and for the maximum
+"\x01\x00\xfe\xff"
+"\xff\xff\x00\x00"
+
+# Final fixed block holding only end-of-block
+"\x03\x00"

From 0929fc6b1856761cc9fc70d78795158b3206cc1d Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:58:01 -0300
Subject: [PATCH 025/115] perf: benchmark the managed inflate decoder against
 DeflateStream

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/ExcelReader.Core.csproj  |   2 +
 .../Read/InflateBenchmark.cs                  | 137 ++++++++++++++++++
 2 files changed, 139 insertions(+)
 create mode 100644 tests/ExcelReader.Benchmarks/Read/InflateBenchmark.cs

diff --git a/src/ExcelReader.Core/ExcelReader.Core.csproj b/src/ExcelReader.Core/ExcelReader.Core.csproj
index 61872636..f8a3cc5b 100644
--- a/src/ExcelReader.Core/ExcelReader.Core.csproj
+++ b/src/ExcelReader.Core/ExcelReader.Core.csproj
@@ -48,6 +48,8 @@
     <!-- The CsvParallel fuzz target drives ParallelCsvFactory.CreateWithChunkSize<T> directly (the
          Task 9 test seam) to compare it against the sequential parser over arbitrary bytes. -->
     <InternalsVisibleTo Include="ExcelReader.Fuzz" />
+    <!-- InflateBenchmark measures InflateStream on its own, without a reader on top of it. -->
+    <InternalsVisibleTo Include="ExcelReader.Benchmarks" />
   </ItemGroup>
 
   <!-- The source generator runs as an analyzer during this project's own build (and any consumer's),
diff --git a/tests/ExcelReader.Benchmarks/Read/InflateBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/InflateBenchmark.cs
new file mode 100644
index 00000000..6b46963a
--- /dev/null
+++ b/tests/ExcelReader.Benchmarks/Read/InflateBenchmark.cs
@@ -0,0 +1,137 @@
+using System.Buffers.Binary;
+using System.IO.Compression;
+using System.Text;
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Configs;
+using ExcelReader.Core.Reader.Zip.Inflate;
+
+namespace ExcelReader.Benchmarks
+{
+    [MemoryDiagnoser]
+    [GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
+    [CategoriesColumn]
+    public class InflateBenchmark
+    {
+        private readonly byte[] _sink = new byte[64 * 1024];
+        private byte[] _xlsxSheet = [];
+        private byte[] _xlsbSheet = [];
+        private byte[] _sharedStrings = [];
+
+        [GlobalSetup]
+        public async Task SetupAsync()
+        {
+            string dir = Path.Combine(AppContext.BaseDirectory, "Data");
+            _xlsxSheet = RawDeflateEntry(await File.ReadAllBytesAsync(Path.Combine(dir, "65K_Records_Data.xlsx")), "xl/worksheets/sheet1.xml");
+            _xlsbSheet = RawDeflateEntry(await File.ReadAllBytesAsync(Path.Combine(dir, "65K_Records_Data.xlsb")), "xl/worksheets/sheet1.bin");
+            _sharedStrings = RawDeflateEntry(await StringHeavyWorkbookGenerator.BuildXlsxAsync(65_536), "xl/sharedStrings.xml");
+            RequireSameOutput(_xlsxSheet);
+            RequireSameOutput(_xlsbSheet);
+            RequireSameOutput(_sharedStrings);
+        }
+
+        [Benchmark(Baseline = true)]
+        [BenchmarkCategory("XlsxSheet")]
+        public long XlsxSheet_DeflateStream()
+        {
+            return Drain(new DeflateStream(new MemoryStream(_xlsxSheet, writable: false), CompressionMode.Decompress));
+        }
+
+        [Benchmark]
+        [BenchmarkCategory("XlsxSheet")]
+        public long XlsxSheet_InflateStream()
+        {
+            return Drain(new InflateStream(new MemoryStream(_xlsxSheet, writable: false)));
+        }
+
+        [Benchmark(Baseline = true)]
+        [BenchmarkCategory("XlsbSheet")]
+        public long XlsbSheet_DeflateStream()
+        {
+            return Drain(new DeflateStream(new MemoryStream(_xlsbSheet, writable: false), CompressionMode.Decompress));
+        }
+
+        [Benchmark]
+        [BenchmarkCategory("XlsbSheet")]
+        public long XlsbSheet_InflateStream()
+        {
+            return Drain(new InflateStream(new MemoryStream(_xlsbSheet, writable: false)));
+        }
+
+        [Benchmark(Baseline = true)]
+        [BenchmarkCategory("SharedStrings")]
+        public long SharedStrings_DeflateStream()
+        {
+            return Drain(new DeflateStream(new MemoryStream(_sharedStrings, writable: false), CompressionMode.Decompress));
+        }
+
+        [Benchmark]
+        [BenchmarkCategory("SharedStrings")]
+        public long SharedStrings_InflateStream()
+        {
+            return Drain(new InflateStream(new MemoryStream(_sharedStrings, writable: false)));
+        }
+
+        private long Drain(Stream stream)
+        {
+            using (stream)
+            {
+                long total = 0;
+                int read;
+                while ((read = stream.Read(_sink)) > 0)
+                {
+                    total += read;
+                }
+                return total;
+            }
+        }
+
+        private static void RequireSameOutput(byte[] deflated)
+        {
+            using var expected = new MemoryStream();
+            using (var deflate = new DeflateStream(new MemoryStream(deflated, writable: false), CompressionMode.Decompress))
+            {
+                deflate.CopyTo(expected);
+            }
+            using var actual = new MemoryStream();
+            using (var inflate = new InflateStream(new MemoryStream(deflated, writable: false)))
+            {
+                inflate.CopyTo(actual);
+            }
+            if (expected.Length == 0 || !expected.GetBuffer().AsSpan(0, (int)expected.Length).SequenceEqual(actual.GetBuffer().AsSpan(0, (int)actual.Length)))
+            {
+                throw new InvalidOperationException("InflateStream and DeflateStream disagree on a benchmark entry, or the entry is empty.");
+            }
+        }
+
+        private static byte[] RawDeflateEntry(byte[] zip, string entryName)
+        {
+            int end = zip.AsSpan().LastIndexOf("PK\x05\x06"u8);
+            int count = BinaryPrimitives.ReadUInt16LittleEndian(zip.AsSpan(end + 10));
+            int position = (int)BinaryPrimitives.ReadUInt32LittleEndian(zip.AsSpan(end + 16));
+            for (int i = 0; i < count; i++)
+            {
+                ReadOnlySpan<byte> header = zip.AsSpan(position);
+                int nameLength = BinaryPrimitives.ReadUInt16LittleEndian(header[28..]);
+                if (string.Equals(Encoding.UTF8.GetString(header.Slice(46, nameLength)), entryName, StringComparison.Ordinal))
+                {
+                    return ReadEntryData(zip, header);
+                }
+                position += 46 + nameLength + BinaryPrimitives.ReadUInt16LittleEndian(header[30..]) + BinaryPrimitives.ReadUInt16LittleEndian(header[32..]);
+            }
+            throw new InvalidOperationException($"Entry '{entryName}' not found.");
+        }
+
+        private static byte[] ReadEntryData(byte[] zip, ReadOnlySpan<byte> centralHeader)
+        {
+            if (BinaryPrimitives.ReadUInt16LittleEndian(centralHeader[10..]) != 8)
+            {
+                throw new InvalidOperationException("The benchmark entry is not deflated.");
+            }
+            int compressedSize = (int)BinaryPrimitives.ReadUInt32LittleEndian(centralHeader[20..]);
+            int local = (int)BinaryPrimitives.ReadUInt32LittleEndian(centralHeader[42..]);
+            ReadOnlySpan<byte> localHeader = zip.AsSpan(local);
+            int data = local + 30 + BinaryPrimitives.ReadUInt16LittleEndian(localHeader[26..]) + BinaryPrimitives.ReadUInt16LittleEndian(localHeader[28..]);
+            return zip.AsSpan(data, compressedSize).ToArray();
+        }
+    }
+}

From 408b76edd53d8c0e8c907530c7b9a4a47281528d Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 13:58:58 -0300
Subject: [PATCH 026/115] docs: record the managed inflate measurements

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/performance/reader-performance.md | 66 +++++++++++++++++++++++++-
 1 file changed, 64 insertions(+), 2 deletions(-)

diff --git a/docs/performance/reader-performance.md b/docs/performance/reader-performance.md
index 328a2f1a..2c00d4c1 100644
--- a/docs/performance/reader-performance.md
+++ b/docs/performance/reader-performance.md
@@ -531,8 +531,11 @@ no faster, and slower in places. libdeflate is whole-buffer only — no streamin
 the entire sheet to be materialized before parsing starts and destroys the inflate/parse overlap
 `PrefetchStream` exists to provide.
 
-**The inflate floor does not move by swapping compression libraries.** Since XLSX and XLSB are both
-bounded by it, this is the single most important negative result here.
+**The inflate floor does not move by swapping in a whole-buffer compression library.** That is what
+this measurement showed, and it was read too broadly: the decoder itself was never at the floor.
+Measured on its own libdeflate is about twice as fast as `DeflateStream` on these entries; what cost
+it the win end to end was having no streaming API. "Fourth round" below measures decoders in
+isolation and replaces `DeflateStream` with a managed streaming one.
 
 ### Lazy number parsing — a trade, not a win
 
@@ -982,8 +985,67 @@ before publishing.
 The C++ binding's full XLSX read moved from 93.2 to ~85.4 ms with no native change, from the
 XLSX changes above.
 
+### Fourth round (2026-10-08, i7-1365U): a managed inflate decoder
+
+Measured on the laptop, so only the ratios mean anything; the published tables need the Ryzen run.
+Harnesses were throwaway console apps: interleaved rounds, minimum of 30 to 60, outputs compared
+byte for byte.
+
+Inflate only, single thread pinned to one core, against `DeflateStream` (.NET 10):
+
+| decoder | XLSX `sheet1.xml`, 6.7 → 34.4 MB | XLSB `sheet1.bin`, 3.7 → 15.9 MB |
+|---|---|---|
+| libdeflate 1.19, whole buffer | 2.14–2.18x | 1.64–1.67x |
+| ISA-L 2.30, whole buffer | 1.48–1.49x | 1.29–1.33x |
+| ISA-L 2.30, streaming, 64 KB | 1.39–1.42x | 1.23–1.25x |
+| `InflateStream` | 1.56–1.61x | 1.35–1.41x |
+
+`InflateStream` is a C# port of libdeflate's decoder design made resumable. It reaches roughly
+three quarters of libdeflate's speed on XLSX and four fifths on XLSB, and passes ISA-L without a
+native dependency. An earlier throwaway version that decoded a whole buffer in one call measured
+1.74–1.78x on XLSX, so streaming costs under a tenth.
+
+End to end in the reader, in-process A/B over the real-data corpus, identical checksums. The
+`InflateStream` column is one run of 30 rounds; the ISA-L column spans four runs:
+
+| read | `InflateStream` | ISA-L behind the same seam |
+|---|---|---|
+| XLSX, no prefetch | 1.25–1.26x | 1.19–1.21x |
+| XLSB, no prefetch | 1.13–1.15x | 1.10–1.14x |
+| XLSX, prefetch | 1.11–1.12x | 1.09–1.15x |
+| XLSB, prefetch | 1.05–1.06x | 1.03–1.07x |
+
+This is the `I + P` model again. Without prefetch a faster `I` converts directly. With prefetch the
+read is `max(I, P)`, both decoders land together, and what is left is the parse.
+
+`InflateBenchmark`, BenchmarkDotNet `--job Short`, in-process, same laptop:
+
+| entry | `DeflateStream` | `InflateStream` | ratio |
+|---|---|---|---|
+| XLSX sheet | 34.91 ms, 541 B | 21.71 ms, 332 B | 0.62 |
+| XLSB sheet | 19.40 ms, 404 B | 13.68 ms, 270 B | 0.71 |
+| string-heavy `sharedStrings.xml` | 16.10 ms, 280 B | 10.32 ms, 270 B | 0.64 |
+
+Measured and not kept:
+
+| attempt | result |
+|---|---|
+| `AggressiveOptimization` on the decode loop | no change, so the loop does not depend on dynamic PGO |
+| `Vector128` match copy for offsets of 16 and up | no change on XLSX, slightly slower on XLSB |
+
+The remaining gap to libdeflate has not been diagnosed; nobody has read the loop's disassembly yet.
+
+**A behavior change came with it.** `DeflateStream` does not reject a stream that ends before its
+final block: it returns what it decoded and reports end of stream. A sheet entry cut short therefore
+used to yield a silent prefix of its rows. `InflateStream` throws `InvalidDataException`.
+
 ## Known open items
 
+- `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The gap is
+  undiagnosed. Next step: read the Tier1 disassembly of `InflateDecoder.FastLoop` for values the
+  JIT keeps on the stack.
+- Every number in "Fourth round" is from the i7-1365U. `benchmarks.md` still shows `DeflateStream`
+  figures until the suite is re-run on the Ryzen 7 5700X.
 - NativeAOT XLSX is ~13% behind the JIT, and the static profile does not close it (see "NativeAOT,
   again"). Next step: diff the JIT's Tier1 code for `ParseRowInWindow` against ILC's output.
 - 17-digit numbers are parsed twice in XLSX: emit rejects them to keep the text exact, and the

From 2ad7123d9dedb3be04df94b1dd3b97be00a44df5 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 14:54:29 -0300
Subject: [PATCH 027/115] fix: reject a truncated deflate stream before handing
 out padding-decoded bytes

When input had ended and the window filled while the fast loop was decoding the zero padding, the decoder reported a full window instead of truncation, so up to a few hundred invented bytes reached the caller before the exception. Also pins matches at the full 32,768-byte distance.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Reader/Zip/Inflate/InflateDecoder.cs      |   1 +
 .../Reader/Zip/InflateStreamTests.cs          | 107 ++++++++++++++++++
 2 files changed, 108 insertions(+)

diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
index d421de69..8c2222a3 100644
--- a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
@@ -171,6 +171,7 @@ private bool TryDecodeCoded(byte[] input, ref int inPos, int inEnd, bool inputEn
             }
             if (outPos >= outLimit)
             {
+                ThrowIfOverrun(inPos, inEnd, inputEnded);
                 return true;
             }
             ThrowIfTruncated(inputEnded);
diff --git a/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs b/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
index 458a0b25..db152e6b 100644
--- a/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Zip/InflateStreamTests.cs
@@ -96,6 +96,32 @@ public void DynamicHeaderWithOverSubscribedCodeLengthCodeIsRejected()
             Assert.Contains("code-length code", ex.Message, StringComparison.Ordinal);
         }
 
+        [Theory]
+        [InlineData(int.MaxValue)]
+        [InlineData(1)]
+        public void MatchAtTheFullWindowDistanceCopiesAcrossEverySlide(int sourceStep)
+        {
+            byte[] history = Generate(DataShape.Random, 32_768, seed: 3);
+            byte[] expected = new byte[history.Length + (6000 * 258)];
+            history.CopyTo(expected, 0);
+            for (int i = history.Length; i < expected.Length; i++)
+            {
+                expected[i] = expected[i - 32_768];
+            }
+
+            Assert.Equal(expected, Inflate(StoredThenFarMatches(history, matches: 6000), sourceStep: sourceStep));
+        }
+
+        [Fact]
+        public void MatchAtTheFullWindowDistanceWithOneByteTooFewIsRejected()
+        {
+            byte[] stream = StoredThenFarMatches(Generate(DataShape.Random, 32_767, seed: 3), matches: 1);
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Inflate(stream));
+
+            Assert.Contains("before the start", ex.Message, StringComparison.Ordinal);
+        }
+
         [Fact]
         public void EmptyInputIsRejected()
         {
@@ -120,6 +146,26 @@ public void StreamCutAnywhereIsRejected(DataShape shape, CompressionLevel level)
             }
         }
 
+        [Theory]
+        [InlineData(DataShape.SheetXml, CompressionLevel.Optimal)]
+        [InlineData(DataShape.SheetXml, CompressionLevel.Fastest)]
+        [InlineData(DataShape.MixedRuns, CompressionLevel.Optimal)]
+        public void StreamCutJustBeforeTheWindowFillsDeliversOnlyRealBytes(DataShape shape, CompressionLevel level)
+        {
+            // The window first fills at 98,304 bytes; cuts whose real output ends just short of it make
+            // the zero padding decode across the boundary.
+            byte[] raw = Generate(shape, 200_000, seed: 7);
+            byte[] stream = Deflate(raw, level);
+            int first = FirstCutReaching(stream, 98_304 - 300);
+            int last = FirstCutReaching(stream, 98_304);
+
+            for (int cut = first; cut <= last; cut++)
+            {
+                byte[] delivered = DeliveredBeforeRejection(stream[..cut]);
+                Assert.True(raw.AsSpan().StartsWith(delivered), $"cut {cut} delivered bytes the stream never encoded");
+            }
+        }
+
         [Theory]
         [InlineData(1)]
         [InlineData(7)]
@@ -196,6 +242,67 @@ public void DisposeTwiceIsHarmless()
             Assert.False(inflate.CanRead);
         }
 
+        // DeflateStream's output never shrinks as the cut grows, so a binary search finds the boundary.
+        private static int FirstCutReaching(byte[] stream, int outputLength)
+        {
+            int low = 1;
+            int high = stream.Length;
+            while (low < high)
+            {
+                int mid = (low + high) / 2;
+                using var reference = new DeflateStream(new MemoryStream(stream, 0, mid), CompressionMode.Decompress);
+                using var output = new MemoryStream();
+                reference.CopyTo(output);
+                if (output.Length >= outputLength)
+                {
+                    high = mid;
+                }
+                else
+                {
+                    low = mid + 1;
+                }
+            }
+            return low;
+        }
+
+        private static byte[] DeliveredBeforeRejection(byte[] stream)
+        {
+            using var inflate = new InflateStream(new MemoryStream(stream));
+            using var output = new MemoryStream();
+            byte[] buffer = new byte[4096];
+            try
+            {
+                int read;
+                while ((read = inflate.Read(buffer)) > 0)
+                {
+                    output.Write(buffer, 0, read);
+                }
+            }
+            catch (InvalidDataException)
+            {
+                return output.ToArray();
+            }
+            throw new InvalidOperationException("A truncated stream was accepted.");
+        }
+
+        // A stored block holding the history, then a final fixed block of length-258 matches at offset
+        // 32,768: symbol 285 and offset code 29 with all 13 extra bits set. Huffman codes go in bit-reversed.
+        private static byte[] StoredThenFarMatches(byte[] history, int matches)
+        {
+            var bits = new BitWriter();
+            bits.Write(1, 1);
+            bits.Write(1, 2);
+            for (int i = 0; i < matches; i++)
+            {
+                bits.Write(0b1010_0011, 8);
+                bits.Write(0b1_0111, 5);
+                bits.Write(8191, 13);
+            }
+            bits.Write(0, 7);
+            int length = history.Length;
+            return [0x00, (byte)length, (byte)(length >> 8), (byte)~length, (byte)(~length >> 8), .. history, .. bits.ToArray()];
+        }
+
         // A final dynamic block declaring 257 literal/length codes and 1 offset code, with the given
         // lengths for the first four code-length-code symbols (16, 17, 18, 0) and raw bits after them.
         private static byte[] DynamicHeader(int[] precodeLens, (int Value, int Count)[] codeLengthBits)

From 0579fa40cf9a63dfd7b640292debbf2f364726de Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 14:54:29 -0300
Subject: [PATCH 028/115] fix(fuzz): let inflate divergences and canary trips
 escape the oracle

Both threw InvalidOperationException, which FuzzOracle sanctions, so Guard swallowed them. Divergence now throws OracleDivergenceException and the canary UnreachableException; a smoke self-check proves Guard lets a divergence through. When InflateStream rejects input, the bytes it delivered first must be a prefix of DeflateStream's output.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Reader/Zip/Inflate/InflateStream.cs       |  3 +-
 tests/ExcelReader.Fuzz/FuzzOracle.cs          |  2 +
 tests/ExcelReader.Fuzz/Harnesses.cs           | 50 ++++++++++++++++---
 .../OracleDivergenceException.cs              | 23 +++++++++
 tests/ExcelReader.Fuzz/SmokeRunner.cs         |  1 +
 5 files changed, 70 insertions(+), 9 deletions(-)
 create mode 100644 tests/ExcelReader.Fuzz/OracleDivergenceException.cs

diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
index 6d4ad8c0..23a21d27 100644
--- a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateStream.cs
@@ -1,4 +1,5 @@
 using System.Buffers;
+using System.Diagnostics;
 
 namespace ExcelReader.Core.Reader.Zip.Inflate
 {
@@ -158,7 +159,7 @@ private bool Advance()
             InflateStatus status = _decoder.Decode(_input, ref _inPos, _inEnd, _inputEnded, _window, ref _outPos, OutLimit);
             if (_window.AsSpan(CanaryStart, CanarySize).ContainsAnyExcept(CanaryByte))
             {
-                throw new InvalidOperationException("The inflate decoder wrote past its output window.");
+                throw new UnreachableException("The inflate decoder wrote past its output window.");
             }
             _finished = status == InflateStatus.Finished;
             return status != InflateStatus.NeedInput;
diff --git a/tests/ExcelReader.Fuzz/FuzzOracle.cs b/tests/ExcelReader.Fuzz/FuzzOracle.cs
index a847f323..b964f7c0 100644
--- a/tests/ExcelReader.Fuzz/FuzzOracle.cs
+++ b/tests/ExcelReader.Fuzz/FuzzOracle.cs
@@ -85,6 +85,8 @@ internal static void SelfCheck()
                 new OutOfMemoryException(),
                 new OverflowException(),
                 new KeyNotFoundException(),
+                new OracleDivergenceException("test"),
+                new System.Diagnostics.UnreachableException(),
             ];
             foreach (Exception ex in mustReject)
             {
diff --git a/tests/ExcelReader.Fuzz/Harnesses.cs b/tests/ExcelReader.Fuzz/Harnesses.cs
index d05ae096..8dd070fb 100644
--- a/tests/ExcelReader.Fuzz/Harnesses.cs
+++ b/tests/ExcelReader.Fuzz/Harnesses.cs
@@ -128,7 +128,17 @@ internal static void Inflate(ReadOnlySpan<byte> data)
             byte[] bytes = data.ToArray();
             FuzzOracle.Guard(() =>
             {
-                byte[] actual = InflateWith(static source => new InflateStream(source), bytes);
+                // A rejected stream may still have delivered bytes first; those must be real ones.
+                using var delivered = new MemoryStream();
+                bool rejected = false;
+                try
+                {
+                    InflateInto(delivered, static source => new InflateStream(source), bytes);
+                }
+                catch (InvalidDataException)
+                {
+                    rejected = true;
+                }
                 byte[] reference;
                 try
                 {
@@ -138,14 +148,33 @@ internal static void Inflate(ReadOnlySpan<byte> data)
                 {
                     return;
                 }
-                if (!actual.AsSpan().SequenceEqual(reference))
-                {
-                    throw new InvalidOperationException(
-                        $"Oracle divergence: InflateStream produced {actual.Length} bytes that differ from DeflateStream's {reference.Length}.");
-                }
+                RequireSameInflate(delivered.ToArray(), reference, rejected);
             });
         }
 
+        internal static void InflateDivergenceSelfCheck()
+        {
+            try
+            {
+                FuzzOracle.Guard(() => RequireSameInflate([1], [2], prefixOnly: true));
+            }
+            catch (OracleDivergenceException)
+            {
+                return;
+            }
+            throw new InvalidOperationException("The fuzz oracle swallows an inflate divergence.");
+        }
+
+        private static void RequireSameInflate(byte[] actual, byte[] reference, bool prefixOnly)
+        {
+            bool same = prefixOnly ? reference.AsSpan().StartsWith(actual) : actual.AsSpan().SequenceEqual(reference);
+            if (!same)
+            {
+                throw new OracleDivergenceException(
+                    $"Oracle divergence: InflateStream produced {actual.Length} bytes that differ from DeflateStream's {reference.Length}.");
+            }
+        }
+
         internal static int InflateSeedForSelfCheck(byte[] bytes)
         {
             byte[] actual = InflateWith(static source => new InflateStream(source), bytes);
@@ -159,8 +188,14 @@ internal static int InflateSeedForSelfCheck(byte[] bytes)
 
         private static byte[] InflateWith(Func<Stream, Stream> open, byte[] bytes)
         {
-            using Stream stream = open(new MemoryStream(bytes, writable: false));
             using var output = new MemoryStream();
+            InflateInto(output, open, bytes);
+            return output.ToArray();
+        }
+
+        private static void InflateInto(MemoryStream output, Func<Stream, Stream> open, byte[] bytes)
+        {
+            using Stream stream = open(new MemoryStream(bytes, writable: false));
             byte[] buffer = new byte[64 * 1024];
             while (output.Length < MaxInflateOutput)
             {
@@ -171,7 +206,6 @@ private static byte[] InflateWith(Func<Stream, Stream> open, byte[] bytes)
                 }
                 output.Write(buffer, 0, read);
             }
-            return output.ToArray();
         }
 
         internal static int OpenEncryptedSeedForSelfCheck(ReadOnlySpan<byte> data)
diff --git a/tests/ExcelReader.Fuzz/OracleDivergenceException.cs b/tests/ExcelReader.Fuzz/OracleDivergenceException.cs
new file mode 100644
index 00000000..d3d53215
--- /dev/null
+++ b/tests/ExcelReader.Fuzz/OracleDivergenceException.cs
@@ -0,0 +1,23 @@
+namespace ExcelReader.Fuzz
+{
+    /// <summary>
+    /// Two decoders disagreed on the same input. Deliberately outside <see cref="FuzzOracle"/>'s
+    /// sanctioned types, so <see cref="FuzzOracle.Guard"/> never swallows it.
+    /// </summary>
+    internal sealed class OracleDivergenceException : Exception
+    {
+        public OracleDivergenceException()
+        {
+        }
+
+        public OracleDivergenceException(string message)
+            : base(message)
+        {
+        }
+
+        public OracleDivergenceException(string message, Exception innerException)
+            : base(message, innerException)
+        {
+        }
+    }
+}
diff --git a/tests/ExcelReader.Fuzz/SmokeRunner.cs b/tests/ExcelReader.Fuzz/SmokeRunner.cs
index 12558c82..8172ab26 100644
--- a/tests/ExcelReader.Fuzz/SmokeRunner.cs
+++ b/tests/ExcelReader.Fuzz/SmokeRunner.cs
@@ -17,6 +17,7 @@ internal static int Run(string corpusDirectory, int mutationsPerInput, int seed)
         {
             FuzzOracle.SelfCheck();
             Harnesses.AssertSameRowsSelfCheck();
+            Harnesses.InflateDivergenceSelfCheck();
             VerifyEncryptedSeedReachesRealCode(corpusDirectory);
             VerifyDifferentialSeedsReachBothReaders(corpusDirectory);
             VerifyInflateSeedsCoverEveryBlockType(corpusDirectory);

From 59970745d60fe511f608bd5276750223ef01fcfb Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 15:23:09 -0300
Subject: [PATCH 029/115] fix: update binary file for ExcelReader native
 integration

---
 src/ExcelReader.Native/pgo/excelreader.mibc | Bin 65158 -> 66015 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/src/ExcelReader.Native/pgo/excelreader.mibc b/src/ExcelReader.Native/pgo/excelreader.mibc
index dd5d3a56c56df794ca2c2193d20aa97f911492ac..2cd35b1641445c9845f44f9b7412bfa38c20329c 100644
GIT binary patch
literal 66015
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
zWCH*U000000000000000000000B&V>E^TRIV=iQDY*0%D1^@s60096206G8w0FMCy
G0000Qmhh1P

literal 65158
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


From ab3aa1ee82bb2ef80201520227cf8c8b9f1df6c2 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 15:43:03 -0300
Subject: [PATCH 030/115] perf: tighten the inflate fast loop

Keeps the litlen and offset tables in one array so the offset table is a constant displacement, which removes a register spill on every match. Tracks bitsleft as a long whose low byte alone is meaningful, subtracting whole entries and refilling with 7 - (bitsleft >> 3) as libdeflate does, and drops a redundant mask before the extra-bits shift. Inflate only, interleaved on the i7-1365U: 1.10x on the XLSX sheet, 1.07x on the XLSB sheet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../Zip/Inflate/InflateDecoder.FastLoop.cs    | 70 ++++++++++---------
 .../Reader/Zip/Inflate/InflateDecoder.cs      | 10 ++-
 2 files changed, 40 insertions(+), 40 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
index fcf7f008..e8c7db58 100644
--- a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
@@ -19,12 +19,11 @@ private unsafe LoopStatus RunFastLoop(byte[] input, ref int inPos, int inLimit,
         {
             fixed (byte* inBase = input)
             fixed (byte* outBase = window)
-            fixed (uint* litlen = _litlen)
-            fixed (uint* offsets = _offset)
+            fixed (uint* tables = _tables)
             {
                 byte* inNext = inBase + inPos;
                 byte* outNext = outBase + outPos;
-                LoopStatus status = FastLoop(ref inNext, inBase + inLimit, outBase, ref outNext, outBase + outLimit, litlen, offsets);
+                LoopStatus status = FastLoop(ref inNext, inBase + inLimit, outBase, ref outNext, outBase + outLimit, tables);
                 inPos = (int)(inNext - inBase);
                 outPos = (int)(outNext - outBase);
                 return status;
@@ -33,26 +32,29 @@ private unsafe LoopStatus RunFastLoop(byte[] input, ref int inPos, int inLimit,
 
         // Entry layout, shared with HuffmanTableBuilder: bits 0-7 hold the bits to consume (codeword
         // plus extra bits), bits 8-11 the codeword length alone, bits 16 and up the literal, the
-        // base length or offset, or the subtable start.
+        // base length or offset, or the subtable start. Bits 12-15 are clear on length and offset
+        // entries, so `entry >> 8` needs no mask before it shifts out the extra bits.
         //
         // Bit budget: a refill leaves at least 56 bits. Three literals from the main table take at
         // most 33; a length takes at most 20 and an offset at most 28, hence the refill between them.
+        //
+        // Only the low byte of `bitsleft` is meaningful: it subtracts whole entries, as libdeflate does.
         [SuppressMessage("Design", "MA0051:Method is too long",
             Justification = "The decode loop is deliberately one call-free method: every live value has to stay in a register across it, and a call inside the loop spills them.")]
         private unsafe LoopStatus FastLoop(
-            ref byte* inPosition, byte* inLimit, byte* window, ref byte* outPosition, byte* outLimit, uint* litlen, uint* offsets)
+            ref byte* inPosition, byte* inLimit, byte* window, ref byte* outPosition, byte* outLimit, uint* tables)
         {
             ulong bitbuf = _bitbuf;
-            int bitsleft = _bitsleft;
+            long bitsleft = _bitsleft;
             byte* inNext = inPosition;
             byte* outNext = outPosition;
             ulong mask = _litlenMask;
             LoopStatus status;
 
-            bitbuf |= LoadWord(inNext) << bitsleft;
-            inNext += (63 - bitsleft) >> 3;
+            bitbuf |= LoadWord(inNext) << (int)bitsleft;
+            inNext += 7 - ((bitsleft >> 3) & 7);
             bitsleft |= 56;
-            uint entry = litlen[bitbuf & mask];
+            uint entry = tables[bitbuf & mask];
 
             while (true)
             {
@@ -64,31 +66,31 @@ private unsafe LoopStatus FastLoop(
 
                 ulong saved = bitbuf;
                 bitbuf >>= (int)entry;
-                bitsleft -= (int)(entry & 0xFF);
+                bitsleft -= entry;
 
                 if ((int)entry < 0)
                 {
                     uint literal = entry >> 16;
-                    entry = litlen[bitbuf & mask];
+                    entry = tables[bitbuf & mask];
                     saved = bitbuf;
                     bitbuf >>= (int)entry;
-                    bitsleft -= (int)(entry & 0xFF);
+                    bitsleft -= entry;
                     *outNext++ = (byte)literal;
                     if ((int)entry < 0)
                     {
                         literal = entry >> 16;
-                        entry = litlen[bitbuf & mask];
+                        entry = tables[bitbuf & mask];
                         saved = bitbuf;
                         bitbuf >>= (int)entry;
-                        bitsleft -= (int)(entry & 0xFF);
+                        bitsleft -= entry;
                         *outNext++ = (byte)literal;
                     }
                     if ((int)entry < 0)
                     {
                         *outNext++ = (byte)(entry >> 16);
-                        entry = litlen[bitbuf & mask];
-                        bitbuf |= LoadWord(inNext) << bitsleft;
-                        inNext += (63 - bitsleft) >> 3;
+                        entry = tables[bitbuf & mask];
+                        bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                        inNext += 7 - ((bitsleft >> 3) & 7);
                         bitsleft |= 56;
                         continue;
                     }
@@ -101,16 +103,16 @@ private unsafe LoopStatus FastLoop(
                         status = LoopStatus.BlockDone;
                         break;
                     }
-                    entry = litlen[(entry >> 16) + (uint)LowBits(bitbuf, (entry >> 8) & 0x3F)];
+                    entry = tables[(entry >> 16) + (uint)LowBits(bitbuf, (entry >> 8) & 0x3F)];
                     saved = bitbuf;
                     bitbuf >>= (int)entry;
-                    bitsleft -= (int)(entry & 0xFF);
+                    bitsleft -= entry;
                     if ((int)entry < 0)
                     {
                         *outNext++ = (byte)(entry >> 16);
-                        entry = litlen[bitbuf & mask];
-                        bitbuf |= LoadWord(inNext) << bitsleft;
-                        inNext += (63 - bitsleft) >> 3;
+                        entry = tables[bitbuf & mask];
+                        bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                        inNext += 7 - ((bitsleft >> 3) & 7);
                         bitsleft |= 56;
                         continue;
                     }
@@ -121,25 +123,25 @@ private unsafe LoopStatus FastLoop(
                     }
                 }
 
-                uint length = (entry >> 16) + (uint)(LowBits(saved, entry & 0xFF) >> (int)((entry >> 8) & 0xF));
+                uint length = (entry >> 16) + (uint)(LowBits(saved, entry & 0xFF) >> (int)(entry >> 8));
 
-                if (bitsleft < 30)
+                if ((byte)bitsleft < 30)
                 {
-                    bitbuf |= LoadWord(inNext) << bitsleft;
-                    inNext += (63 - bitsleft) >> 3;
+                    bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                    inNext += 7 - ((bitsleft >> 3) & 7);
                     bitsleft |= 56;
                 }
-                uint offsetEntry = offsets[bitbuf & ((1 << InflateFormat.OffsetTableBits) - 1)];
+                uint offsetEntry = tables[InflateFormat.LitlenTableSize + (bitbuf & ((1 << InflateFormat.OffsetTableBits) - 1))];
                 if ((offsetEntry & InflateFormat.Exceptional) != 0)
                 {
                     bitbuf >>= InflateFormat.OffsetTableBits;
                     bitsleft -= InflateFormat.OffsetTableBits;
-                    offsetEntry = offsets[(offsetEntry >> 16) + (uint)LowBits(bitbuf, (offsetEntry >> 8) & 0x3F)];
+                    offsetEntry = tables[InflateFormat.LitlenTableSize + (offsetEntry >> 16) + (uint)LowBits(bitbuf, (offsetEntry >> 8) & 0x3F)];
                 }
                 saved = bitbuf;
                 bitbuf >>= (int)offsetEntry;
-                bitsleft -= (int)(offsetEntry & 0xFF);
-                uint offset = (offsetEntry >> 16) + (uint)(LowBits(saved, offsetEntry & 0xFF) >> (int)((offsetEntry >> 8) & 0xF));
+                bitsleft -= offsetEntry;
+                uint offset = (offsetEntry >> 16) + (uint)(LowBits(saved, offsetEntry & 0xFF) >> (int)(offsetEntry >> 8));
 
                 if (offset > (nuint)(outNext - window))
                 {
@@ -150,16 +152,16 @@ private unsafe LoopStatus FastLoop(
                 byte* destination = outNext;
                 outNext += length;
 
-                bitbuf |= LoadWord(inNext) << bitsleft;
-                inNext += (63 - bitsleft) >> 3;
+                bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                inNext += 7 - ((bitsleft >> 3) & 7);
                 bitsleft |= 56;
-                entry = litlen[bitbuf & mask];
+                entry = tables[bitbuf & mask];
 
                 CopyMatch(source, destination, outNext, offset);
             }
 
             _bitbuf = bitbuf;
-            _bitsleft = bitsleft;
+            _bitsleft = (int)(bitsleft & 0xFF);
             inPosition = inNext;
             outPosition = outNext;
             return status;
diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
index 8c2222a3..db517fa3 100644
--- a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.cs
@@ -29,8 +29,7 @@ internal sealed partial class InflateDecoder : IDisposable
         private const int LensSize = InflateFormat.MaxLitlenSymbols + InflateFormat.MaxOffsetSymbols + InflateFormat.MaxRepeat;
         private const ulong PrecodeMask = (1UL << InflateFormat.PrecodeTableBits) - 1;
 
-        private readonly uint[] _litlen = ArrayPool<uint>.Shared.Rent(InflateFormat.LitlenTableSize);
-        private readonly uint[] _offset = ArrayPool<uint>.Shared.Rent(InflateFormat.OffsetTableSize);
+        private readonly uint[] _tables = ArrayPool<uint>.Shared.Rent(InflateFormat.LitlenTableSize + InflateFormat.OffsetTableSize);
         private ulong _litlenMask;
         private bool _staticCodesLoaded;
         private ulong _bitbuf;
@@ -82,8 +81,7 @@ public void Dispose()
                 return;
             }
             _disposed = true;
-            ArrayPool<uint>.Shared.Return(_litlen);
-            ArrayPool<uint>.Shared.Return(_offset);
+            ArrayPool<uint>.Shared.Return(_tables);
         }
 
         private bool TryReadHeader(byte[] input, ref int inPos, int inEnd, bool inputEnded)
@@ -320,13 +318,13 @@ private void BuildCodeTables(ReadOnlySpan<byte> lens, int litlenSymbols, int off
         {
             Span<ushort> sorted = stackalloc ushort[InflateFormat.MaxLitlenSymbols];
             if (!HuffmanTableBuilder.TryBuild(
-                _offset.AsSpan(0, InflateFormat.OffsetTableSize), lens.Slice(litlenSymbols, offsetSymbols), InflateFormat.OffsetResults,
+                _tables.AsSpan(InflateFormat.LitlenTableSize, InflateFormat.OffsetTableSize), lens.Slice(litlenSymbols, offsetSymbols), InflateFormat.OffsetResults,
                 InflateFormat.OffsetTableBits, InflateFormat.MaxCodewordLength, sorted, shrink: false, out _))
             {
                 throw new InvalidDataException("A deflate block has an invalid offset code.");
             }
             if (!HuffmanTableBuilder.TryBuild(
-                _litlen.AsSpan(0, InflateFormat.LitlenTableSize), lens[..litlenSymbols], InflateFormat.LitlenResults,
+                _tables.AsSpan(0, InflateFormat.LitlenTableSize), lens[..litlenSymbols], InflateFormat.LitlenResults,
                 InflateFormat.LitlenTableBits, InflateFormat.MaxCodewordLength, sorted, shrink: true, out int litlenBits))
             {
                 throw new InvalidDataException("A deflate block has an invalid literal/length code.");

From 1d3afab67e931ce3d7a8769d4081f4cb5b84e4ec Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 15:48:33 -0300
Subject: [PATCH 031/115] perf(native): regenerate the static PGO profile after
 the inflate fast-loop change

FastLoop lost a parameter, so the previous profile no longer matched it by signature.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Native/pgo/excelreader.mibc | Bin 66015 -> 65834 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/src/ExcelReader.Native/pgo/excelreader.mibc b/src/ExcelReader.Native/pgo/excelreader.mibc
index 2cd35b1641445c9845f44f9b7412bfa38c20329c..d02ee0ac14834928031687233c0e24a10b3a096a 100644
GIT binary patch
literal 65834
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
z000000000000000003@fcP?#dVq-33Y-~_V1qJ{B000310RTDx007zm0RR91h0$94

literal 66015
zcmZsCRZtv2moDxWf&_PWch^CJySqCCCs^=67#sowcXuD$A-Kcf4ud<~?0>hm_Ez1u
zuJh2<eX6?qvsP7vg~Ne@f<l4{_LVmZ8jcmTf`*2IvV?^~`&V_g@@93iGq+&1baXrm
zg!jagTf3K~SPpXzr*6=7^-kNtTHn~H(hX_v5Jz<?>k#5O*;MyVYhiWS_~2TaI9umx
zz{0z38vSmJaX2>h7T2+^&cDsgHh9yiIeqi~zIJnQJJ3UFJoC})lcN)TUcR@Hd8Je(
zl!PFr;V|F%#1v-5lsaX^5$MM5@eHI<)Pd)+Mr6`vLq1?b_QND0U^W(X_|_1EJHC+O
zhIYE^8<qs@D%``#fq(U%z6resun4>8#~jk2u7*xB<lsZ3eVzTIE-e#X-r3MPH6j65
ze#Ga#DOV;R=pSH{#RD9dBT>|h9W99PWr8w;aW(#~3E0;vy1^0b`xf1?QoiD#<D1js
zSk8>kz!Yt+-+<eI&ysyifk`j)z!kO>^1jr6<L8U`=)zv3qq4`cqIgqnn03~boVrJ&
z_s;9AAmNXHcR7O#_&0@2&LImEy{=lqcRswW>?d!sE2EJfy4{Y%LoElj#TSboNIf=w
z?K;(_(`aBNFg92ni~?2wGlCJoL!LG3F@rfRaWuN;U<mc}xMhD}s;O6zg|K&{Hb&|+
zb|uqW8JSlcK1S|-P3tck_h~cg=YZn|-UmH$5_BvJ6`^%n5>~lq=Hak~G}1t96N3v|
zhhbN^81H%G9R?eJF~ZFRXi`*R44=+;a-r7In@*)Tnw--!FvawZE>vF*RZ?dmHezWB
zG1C@vNwQ@C#b~Q*QoxJMs|9kiB)2=H^w3vS5iTGmwNQx0j*pI@3`xB*Jha4XASFq9
zpba29(76d;rKuVCSCD~uCO|Jg$2wY4y|Y|UNiLu>?vb8vr(j1eAe3kv`N~2-WFjYr
z@GD5#6&r#BF0<4&pjGsUK2odf@ibxZU-mWIg6Qd_B7HmQ4khPIoWr_Wq23X7?<Q2T
zk>`yn;gA-TbsH{a?_vH#T&A%by(RgZGtUEn?T%-e5|~;F=++bJz?h=TD+lBXjOZ%*
zf3vgmyducaX&8XEj$Bzh;}kkLs~@Q@K>ZuObexGYHSe?$?OjPQno|<-^8}j{f{qkG
z1)&8`f((LNU|e7~F*;#==pd|MR`3SMU*1D2ZBi>%nOvC^LOHM2mJY)1m9buG1025b
z&Z=C>ygoo*B3>-o?I%{#>)2>&@l=#o3|5|CXg^}O^^M1g1y6_~1t2}LLq35EK*PZa
zu({+~=@d*=P$Zoo=SRBeC1!O;*+^L^7!pDcA8+P15O!rAv$x`c2Ou)&>y*p1-R$^l
zLk{FAmG(wODUd8PmZb(;f=R0hJ3!XPa|J#}GS~O>BOb&Fyj18gUu!c)SY*aUj{1n6
zv6y+n^ZUE`_HntL5pI?0915<}*8!LpmhuySFeZpBL@aTPNo7b2T_`j+dRX$#LM7Go
zvlU_v;oc1z^>Tm%&nrCg8_H|;0H-bj@#q{;f%$fP8RNUS>=hz%G2RTq6F1%1VXpiE
zn>X}O_~><Ir>~V{0^??Rx@`ICCpx=a$KZ`|gfCr=43{G`=zq(JtO)q>bBV1caVe@a
zacKENCO(y?(WY%r=1Q)Xhi+)&D)h(w>98oSaY6SK&;TG;EGwF(08J#(nS1R=^B4Os
z%6wbRfL6+MRw?*sM-y$|ijt{FQO~W}n4eNY)vM~POUI68csys^tAP8dz)+5rv7aN?
zl*C%41s$Hmq1qaJCa{meV#=4^)j%Pt_oWL2QG4dk>F^T>2fr>7%@Q)=fMUmXptnC-
z!PT<RQ-@k6?jbbGFe~-rzx>_Nn+&i$-M*!T?u;;@@Zz_b&={R=>pS5)H>tIv`f$_W
z>xNdP4eG`3!d-|>7?A%m-=s-Qthm>0v%0T$VydMbd>$xpnZ6AgB^yh}B3dJGF(l+<
zHTVN<7jpegVvGo0Zxl9-TO1Yc+fdl-FSiw#Dgf$;BJHAx4-c+QZ9K)ctTB0z<R>cn
zN9k6B2vXXT;6E1>2(@S#;zX61P5@5aqTElFh>GAb1@u`-g5vDDp)qQ)K`$8}S0cjB
zL`Q0Y<Vh=JUP<3AR(F0)BM?Gl3cOjpf|6CO2!NU5`^0>Ls$L}*9(J7txbE4H^>bOH
zHF7{{y3lyK(4QkCz$^T{pMj}o3Q#OEa_s~y@L|HQ;)26a>m4`ea8%(aLg5JgtfYd{
zAfjq?^;q^U41X*f`h{vl983;2HKiz<M&L}1hyFgfFgd-*HH6(e)2_y8RVgKZ<TvZV
z#x3)G{7`lGkuE{4GIKL5LNt=Xq(6kplm6~RkK(a{n3K+h?v?y=7!AMSrL>#TgM!h^
z35E)m3CguqJA3aU&N!U`Q2>i9m>6J7%q&D%Ii5JOMh~{lmhy!k3k6@nz@@5;2B~%g
zefb7c7OB7)Ot!9%4DAQ#Gm}`{CyzrzKGc>YohDz&Ng*B*<gkz0N{!&3pLG1o|8t5n
zh@F=PO$^>D<CyiXlCoj~yD|f%LDLg$p}p66o3u*s+LmCO`2hp*a@t+NRIm3_eyCQ%
z;uQeVu`K93{~5>E%$#bWMuXZcRpq|AVxgu&i?q$a+JTp0o1DN@*OhX}z%}fGp*8!>
z9eE`8#Ce9TwfmDTnSG7d<KSj$RuVr!0!iqrXzo{3UCQMzv${Q|9x`y>LDziQG@(M=
z=g5y=;kNA5WiF~<6yea5q*mGApR5GUg@sn4K4H32MBkxyey(tHdF9h$IZx`d&j>rn
zMg5JhCUX-eGp<?^t7Yn<u0^`VYlN9LHb?gTL!+D4hTNkA`8ZH*={YV+g;(RiQuMl(
z+`PW@=yY((CZ*`(2c%~tgZ7m;)zn@4_SosCei?p;ggvmgzrLua=;gck+fst?3xeLC
zl+rq$LS3G75}nD}+CwYk#epfGBz2&hS1u=38>#$PEqg)YFWm_pZ}TN@$#SM!q8vBR
zWqTKQS*rvt`u}w*tSdSOXhyIPHJodP8W&zZYa`_1jvO^x7+yr_js&`YOCKp&zPa0b
ziuSX39kOgORg6YV*+m`Wui1?<blzEs03&h;ky*(UFN1kY)4u`J+siai849{ZTj|Xi
z5vdG~lMBdITyzK6Vvh59$Me@ceEnL$T(ooTU$lIp-7qP-=KrlZ6sIleIYi9SdEu^&
zCDfm$-;&<U%gSAcvaKRmr(<vcdp^Ce?27@y^By%%sBmNNl75O3h9aC?YXI}oSy7}a
zDID*LIdMAi4ds!g5!Gu_(v-VPx_Au!m9KM1^-tRxFuxnzDmho3_=TO1dHcj|ozYWi
z*_K|LN7tsLa-t}!J0PK>(8W;Qx?YO01Yks67JC}|(Ny0?yHXY@M0wKN(q1KuU0>(3
zueH`t_gVs&<-ipiU0P+nAnzAw6>mOh4g~UtX+yk#UOPyEIhMd*Lo}J+1ds!H2>905
zSR0^o*`F9SOZnD~-RUA$Sk>h+3XSLOib(yw`(G>az0m9sV9W6A)KQR#ZP%uR7<=S)
zEQkN`hu^!`G(rke$6Q^2c`|+of9kw{g8p~~;G|8@aL(HI7G`cYzj{5~W)V5!(y{uk
z-iO`eN`APUS=oPKnhQ{AHVL^{>!)F(wE0GTeqD0-xNQE+KkO-5RPdT@<4UCnSJs};
z;LI6&dBi+x(|;Ct1>5NlWwz<<G7_+uTsc*ldHYo7W~Y!}X)p7XAtb8D_pG@X&2ArS
zVn1h+Ib%XNYeJ35cRFx`-`<|sJKerb*ED}0ToJj^)U&SmQZay_q3xCH{-ajfm4cw`
zwfWH68!bp?C#|XfnbINb{M$QW{~Zyy1$4PS_4}ukrq_$6R@dI;4$t5CFV`J^Kz3FF
z#jxX0<1k#o`@y&&DZ$95R;IY73-#^Y1p6juSlWCS!;{+O+KcDUo(T&>bofl*8v;9*
z!g8u7LUA&mj6<G(+qW%oW@)wQPet<~Gd~ZF{5QC_Ot~9NQ37XNN^r8RQ(wwlI!aoX
z(a=A69%o`KVRwZ3=EM7+{7O~#ZtmW^t4043<#$RTOhpHg<2kki_)RS5oMQm?)VN5c
z#4twy!pcG~UK?=@wDfkL*BnHW8-w9&6^Df|=bDq_9w2#1I1!}x<;zws;=(5}GnZuB
zznr2J?BN{I9AO+$9A)zpJ37HW#ugj5DI7@48<~9W>nf1u;;WJ$rpiQ)Lgh3Wds&0d
zdp$Y5Gb2>zPMqA&2nhu_w^>PX+Nm3q<8(TIpFEp2f4GE5Hp4Z;G}B&%3xA(jW{uEV
zDz5a0pdiF%IXA^l6}^sf8X91KC3SfN^Y1RMOsiqqj%fLt%C#u#d8aBSbhr7XSXBf}
z`kK~a!#CVkd6v{);8BC~{R@@ucN<-YE$GN>e~|e=o$Y0h3y%AE<*w6_Z_T>ktFvl-
zRQ~$C{&V*y+I$L}`lZEfU-)+y+Lu&|(N|5mp&6rLiNghj<{nb&s;Qk}!+JB6cd9MA
zf4x^7ISNNU01lx~9cby5s@yZO`)ZHu_w*O+|M);Zl{=`SYd3HKN=acPs8AJ?Z@%TE
zX>#^<pM1XX3DhwP{wY5CvZgiDgQGRb=%0NQR(xTw7^vvPhFU^!Az2*4?kVOit$kOO
zF(*KFCkKR;2QoTBx3$biqfv`S0&)uipRY>-FeE3!Ha^jJRAwYdK9WkB*EsPxovSyC
ze6c@Ut?Ek$veUG(H-{5>P_M`D1}RdPrhfT3#giJ3nRLvy1%C3+=}ETpsXSskZw%Gz
z5!G%?D<zvSsoJo15kPrqxVVMdG)fKpEyScbHjlPiX;<7$Z($T>CZ~!3NBt+Boh$5J
zZd=Za>zoLGuC*L}h$Om;s(Zm&;n%IZP2HDzg>9-+AMSZLPS<%Jg$AXuKrBxg*?DwB
zu7$s!sZbo4A5S7If%m1x1f05DB5ZZ~-3NgWdRzpK^%$~S$+2Lu_RJQ;QFw>%3!6c|
zG9@#m?lL28i<2QQsJw1X3D)Rn&V-FGA{RHkB3HSX-QO&r8Qw*|*{^&|Z{C%p{OqLB
zN=wrFO(64d215y7QEn+%2GqXAuFneW<$>MxqIJb{<#qi!(EC&2$K!#2-=O=;_=oHZ
zSZ)~%ALn<)LKnK$p)aQe7hr_AhneyFHtcwp?g2_5ZBMT|vvx(2RX@^SVR+&a61dAs
zCfd!OZIVb5$doZF3{>YY@-^Slij>QxhgTb(ezLL<$$Rz>ltllQ8#2(RquJ-NkLdpu
z6Vn;>-u=fH((6<&^fy-NaW)uM1XgHP8aGY1nsYr3LlgQtn%?GuzAtHQbmEH)y8Z-J
z^ovV$uhCSnmrZEzr*K+_VaRg2ho*`}Xr~-8Ei+ApQd-?GBnl>#Pb(2SXp4GxY5Sk>
zF)Xhwj6#hFhFBzB6I{pfeZ_oUzqIltRyw-9?4tnV37a#LtI~xq@>Is=0O8UIbUwA8
z$G*j1^mp$4?mZJ#wolvh)nopYyrd(d_uB9f05{YU=dup-tFaudP?u>mDmLlbaP}{C
zLFm&iQ0pS4aNVA=-$U+kXWvWdu5!>pHQ5{~*H!bHj6RY+r@BSy;L}W`%7nBr(J!wD
z&|SKVt4?fnU6DwDImH~0gtHBYi_a*yiz;D(D#;UEqU2sZY7~XcbQ+-f=#u$+jH<K~
zb}zizDyZO)sETH@zr`t1rFjWYDk37<k}zF;s&}dYw6?6CBm|kZ3so}sMH5=Lw_<2*
z9dqA{%BOrIrH%QG4WLsHglp%`GZKktzzWhmmS#2W`-<tM{8nm#<yG2pUDnG+pDtLA
z;&yPQRzKN$f!e2M+ccH1y7wrN;9TYjtIv0I#aHvgHPc?%*ydmNOVX4MD+Qi13%+>g
z-Sn}(c>@)^e>SA?u%?AARU<dFeq&oR-Y;ch)gNh4A;MK$L^fkSWjCrpbcS+<BSlz;
zTSr@m5hnJ5gN#J=5_;-N2>1tT8`FB?gc73*lls6wq`?3yqoE^0Y33PBdo7Hc0QZ4S
zZZd<G0RI|ylq-GKlb~>8)yTZBGC5OFImp7OKHv1xpecMfiQu*6!b~4RYk8(6N~=Il
zL#Y}p2y#@F?HUB6mVp+WA0|&mx+fl=CVfHYAQI3`2tE`W+y$I5T;~@bWQh7M2`%$?
z(QMIunbOJXep>qtw%)gEb5Gzg#>Jurj){RTjYZ<scF@9a7P2{s)==avP3}DHALGB?
z96~TVHo6H{4*$Yz)2JwuT8tQL^Y1D2$|622a1=*z^w!57<xi$Q>F4~#bY3TD9;KS%
z-bSoBmtKZsYx)J^w0*C1<o=xFSLh-~LIP7Gfr1N{PU@q~<k4qVKSi3zl6R2)LjnRr
zYh9a<B&OTk?8!7f+F2z37d&(bez8&>TD&8v>!n>=29ruqiuNR)%Sbb8%8|P$uDFwo
zEEVbl=k=1><<;?(PiO&M6Ew0l{JKv3c0gL?{oLNefK7C3d(Jciq>IlqpcZD$HfM6D
zIZ?JGw;VfQs7Sw>+ESt%*KyJZdgMFqXt|AW{6P@R<GeBN&l7##(oNPgH5H<?yz7UD
zue}QD(Nkv%{ITB?lEfw;(S~ru9+k$A?gJJ{buAyZw&^K4W3u&y`*ST_zv_%@dV*8~
zOY8LbJgLj$I!{<VB^KGkQS}JvxzfxBW4dFJ9o#eIGxd6%Z##$J{henW(N2g%hd<i<
z&0_SFGn;#bJyRMcHhqdZ!n*Y6BwHeS0hFPqx3;5-pG0gc6a_bEu6nf9Tk<tq&Wkj!
zWBy_uXh~($PvyILny@>Y>@OKui1|2}Ewcs1_<Uf7TJ`)Lvhaevq*c;7xvP`_vsCUJ
zkHd@kT*^ry)m1YtPS5z0FBD7MF`8)y^*%oH?CcX{AvS4@qmJc-HqNWXTpJOj5ie2+
z+F0)u3UMEk0{q02NK*?Vd5+xxv&^_r&u-_tdfk%W4&&Ud)9edN(zU1RkY8-R3eKYq
ztc!OmmhS)=TMIvPA1m4L-oj3OFgSeh&A*d@#A4gSwI0a7_r7e2vxQlx%Ub$7V2BZL
z3Q*~v%6Ff0z|Rz8U%G3MI%2`APuo^v0fRH;BCFKk27fdFKJA4VjYweNOklGe9Rw)z
z@(b9E4}gA~B_gRrn2!gjBtgiTfiwyIW?;(=@#EJU#ytPHQ?RCoEHM6$3h)!OfhFlA
zUu!IV=hb0E3SQMGMYw+)${crtn6I6Q``8|sQNi;>`#$PV-D5{_MjdNORczJzV63$a
zQQaV|kc>x^q)S)@Hf(do-^K-cjITYc7%?CoL0$JVUk8>lL)nPb>S9f-2>&h_|K%v%
zeQ@n6<SFHWjHxjTE9y*Va2&83#HeJ)4FGJsSts3PTkSH`guFE`fm*NQ{h}BN#MAMW
z-<|K?g=KYu_0gE}!c!b`EjR#iv8A=E*OTkz1)b`*K1B8<=6-_JRf3~F-kP<3^!a%e
zDp(3C8Ms_0;(MJ*M#*1`_MbAx;L4{2dHS`UKs5PiGzB5ls?}?D1jcPUA@t3^nf>>T
z;v|~F_q4P1$_qY~ufgwf;GgLc&QN(Md{3CDQ|v%1GCJ1AtWsXY8dotg5Uh7*m|<TB
zDx7N+>GqK%Tq)L3|3N_OW|N?Yk6E1eavCs(6Uij)AJ0-+k66v26lk@QjI@zH*+&=X
z49%A82p7~x+~Qm}kIec+Fr9c*DJ1Wh_d6wdcPW8$y-He?>fXuszF3hV9=WsU%AKyJ
zZzbPU@tXjf<l*Mvh2Z(z(j?3?R4uzMbA0E?4_C9lFqnGVT_2JcfwXQ|8FGh5L{UjE
zTEz(tQ3(h{{X1LvT;<ipOn+)<^PQXeqi?h|@0|o|1##2xH$c}x9sZV*l=nruBvJQY
z)qVGmFWO>AE{z6ksE!*10=FDvEoEo2NNB`_amA`?3)X)yucLP&`dk`wZVhEJtq%NV
z5;WKr8b%|F(TO?b@t}^6qEpN(yjaG{rQgeDb)K9|ryGp(73^xyP!_r+W;zhyurQW)
z!NAuuIu^CDne10(B61z7xK_|k(uyJ2Y@=!=6LI8&K!d|Tk-?a-WYD500cel>$M?Vw
zm}xA2>y5@~x)}C-I?j88x7D8NDIt`5xi|gM$=3EBy-^aT^JZV{s#hF{9heJb6EdBc
zs!=0P-?`cmIwuy!?|y_y;h&`Bs4{TRx*RAgxZpicts`bEB`)*EPX1_tr_IQdfUq<b
zVQ^eS{0HbOYL2I@TmIO;o%k!nSUkjpT0qkxh~%LsKAc46`;h{Pg36p=N=h2m={WTw
zgyT%dEls+O2SHkxpfugsO@}ep_=bDf301MyjxnT08b&e7W~|KKXzHkf{|zf-qUT_f
zCB{f`g#0c~UfwHASmw`z++@{prSHVCV<B$P9&{~l_g4kZ)XKSAYj=_!7scrUp3zJM
z;{}BryVc;A2G-`QppGJUf{Po)X<v}PNz%!+bmv$@>ogC*dKLZILh*--UQcd*E}{i@
znEV{5BQk;TnsLN#Gg)<qMERju2#Y*WWrcS3^aoL63-KkImr4q2sbAK3>_7_fNT&xL
z=awZ6YUhyIybG1sCDaytH(~(UBQ!*6R+wTO6eww7SQ>5`7YCu*X_LVD>|85EW6ArN
z?nAqd?yKgZ<@!}3{ZvJspOLMo8jWBj1V!!<+aoo8U+j~f6Yg)uA^FEWstpRNv0blz
zBvF~W06aIZzw+z0;X>+SKIAK3Vt<B;HSsn~f11W8sODFeP?ZbUxMt}s@ai))p<LDh
z)r4$GFWJz?!jTSi??uwyA`U9GgO)m@hB{-&k_opai)}N~n;E@&qyB1q(OiHhL%Pn8
z*~HI1d2UT1)gSQZ_w^2LCJ)QPeO;i)Z6bf82Uy*vS5wG|eJFB5Dh?lQt6{yqEkj|I
z#-CaQ)1rF`Ah+FMEe&fcw<`dvIbn?o0$sOtzV3Xly4zkm+Vvc9TO)^vPTZmuZ`RCe
z);!0<VGN&DCH<7h!+u8Yy08JWQU4a?zfW3Sxi71(+PnB0qq?N+&b2wcsr(*6`z&%2
z$Qa7DW;k<Weu0$CNLWTTdBm}fVJ#8T7$#uJrfsn|4|}0wPoml}iB=uOkd)VE?*)(U
zHK7vo8rjJ<yTz^>kpcIc(2TPIS(1T=Q8}Qm6GM*b#Mb=KoG@Cg8?C;0Z$=){Q3iX9
zpx881#5z|q+XIOo{WA{uZU?;V>^WtglvF!}I)pxi#fQR&#)nNS>i7(`yrQqh<9;IO
zP&O(PUqxzcX0%u-l6hN3ZHHSTSTdd%y8x03aR@mLJ`MT!k)QNWEr<S&@DB5e`$z=w
z2AfESpjmC&eRYxZOUG#NxQ`O>D-?&yLOA#v-8}md9RUS)4ze<E4{=-=rhJ%ls$S^v
zdYkQ79NY8felnKrj;)P^Kut>nLJ`qb8T*yt>DP9d#M=xpF{bjM*HBbJ=8N%vW>Ea1
zY>KFR`w>d1elrLms&}ru``(ZrF_C_0I53Gaxv9zIak(BjV!cTDdA5_B^euY4xfg?{
zWofaGhC8eVOJS8eQd=`5g>8}mm4W->#zy)1=i}>mTup%;``4!vMLblR{wz4WGD}kh
z&$j4=h7BLZeC_FPmn#!%J<_4A>*Otyh+a3n*p3lz^O-SzM7#AJ^#Qr`HguS&kIoh<
z;kTd6A2wyWukJ#R*O}-PnE`Gj$Hwr((ZBf57h@!lXTP>bjlIIeN7jEB)ktkfjz~Yv
zlY}dI5=C^~aq9#R+i*n<nDl^aEg8@LwCT>Mx17sVsc#@PRTVx&U5^Dg#io}_6eveM
zGq;&SeBqn+t%0@&eQ}K?BFi%-d^`#fSppRpqAY=4kai{;NP_{3RT8nf*Ah9e{MDiW
zY1V?WiyU9q|21*`SvVmN9h{=<fBx{9RVKzcd&5oFyI~TX35$0A_JgVu`!9E9&p3Jb
zN5o6$!`Fz3U_o(&Twc@y{|Gqkb;9v5QptG0F@hnf=LtqAu+D%rM}p-t>A2>m)WX+?
z%-tgWy1}{Z4XiGo9C7*2oI(E_u+hBaLa^acJs=P^yY?&1+M@O)p4xzKu-2eoaZaRk
z@-T!A$|UYr5JoFuNmNNrT9nD)qcM{$`vjN=bJ0FA<{@zaT{@dmpu$GO05QgwoNZYx
z>PYfaq?T0Qk*Jhs%Ro$Z9}HK!$wBx`AnpR4hh6SEzu4_7&+I$GBMU?bd|u~%Gi+Vq
z8u<hHm5-5+$IiKWo!IZ4)b0c7RgFH0>Va!}lDTkdKbwUJ=FVp?F0O%NX~NoB{%PQ|
zu}!81s{B=PDz^?V;~LH~53XKhVa_MP2mM{fa`aj!oG>+!Qz+eqSr0v)_#DLyTOsNt
znot^!tQ(uiX;=!PZ#oZFzexII?Py_}H`hzRT_b#3n`CL~r_$j&>Q=@X>tAn9n#wc$
z8>n;I(6|!N>L;`<rTZLnZh5D#hm`AxtL@eb`6y9_WJl}0rL4RX!1?wlDa)BZks{Os
z`b|*=`U5qTh!N*<il>klHHsIxc5sUcP8C}%O5jV77DDs1XS+GiC`RmDz($r>ku}We
zy2$-<!RYSsy)LV14Y8?)e^sV*zpCb6eTyDStHy>ek@kdp*XYd&0=*|@=a<YdjFn_%
zOAdN?Tgn}2d&+$Qap}7EULbA6Tp-bOOUufsGQoY6nNExM26_MaDG)`c?!FC0*f5Yr
zU(fNR0`HFii%KQu#b=?}lWHGtk2?*EDA<L$Pr%&f3N_~+&8D_@JN2D$nG20SK&<%T
z#BOHpWyE$yaWa?n?I)#O`Wj$=X5AoWZKV7~z4q}^%4h2jZ!^~h3yW2Og>oxGtg1&u
zy{-Ui6+00>B0qjBJJ5{R(kcu~4A<q;h0jus*Lj4#^vd+)!3YbBcfSJH&wfAx<=k34
z=)x`8$m=1;NO%kgw+)LIcz>o%{5ve3e9!N;7ajC-hR4nmOOz{9WX}Zuex1+O%9dYB
zEhredS0y9;Qh%AoQEg0te$aG)K@BGc1!X)G73j-VNA*4lmtwnZH=5)5<@qly*cyz-
zsS=-0=#`8cXV-f{@LNi=i=&~bm<5?4_~H%@-%hFzZuR4ceWl>n{0zt<c(^^%b|nGX
zW)G%g6hFD1Hf^cc2lz?lW|f3_K#<j0u1YcJuY#6Z*@=jr{wXq|h_AtGPGxRGfM&*-
z`fwf*38pZ#59P7?Ta=|}-8UA>8{S2T60CJ^{cfMZUJ~V=4wJ@a?4P{mQ!h?+(FH3e
z9JVA1%p0O7vtM&qd!8iHb*0`IozTJ-d2f8Rlk`)+{`{EQ$rVPK-W9g60@6$`Z`qlJ
zYi?1HmAnd`x+wSAR6I9tV~KiJ>0C!#SP|(kd~yGl`5T6Oa2JOh1?9$Y12>7<E`-)8
zvCx{;u8P(vweZfFc4>He&zj_lk>F~E_U4%CLI_v>O7MA3FdN@e(8YeX19)5Zl6fb>
zUmpaH61~FdS=tMv9Q7cWZg05OzcO#VRK5pgfZO=8BCO+u8AX>9JF$^-Kvyq+i}P}>
z6IBV>H#{1{UmQ7RG8S>(l4x|z!p|r3=I;;WDKkp6yvS4PL1?A|roKQ{ElQl2$bgy@
zY%TGq7?1)8u9mYFrIs;T#ZKN{!l69LtfVm^uALA@2XPVV8Kh*2eJf$LD}<=4L05pm
zfvc<47lSNEAI_>VDzhwXD*DU!LRcVb#HJu|O=E$!s<h_$Hf{A5e=uDjSSxRlB~xw$
z0p55|kB9r3(Q@w&^JgWbNfo#X5(Kq_{6H|Kfu^vgQl?a<7N(y~HKuXZM#l4absIdL
z3d|jyEGOmB^2p~b-K2FSONq*s7nq-0+j-Mj{2pafjCuM_8acR~mWkV(pdFDN;T_Q(
zVI5H&5gjql#IK79Z766tuBAKJ(|<|(3WT<mnKw|9NrZXzDf_BF!7``!Hww(NJstAr
z!5r}`=TN}*RI$jrJG2@#!8Dp?AaV0k!}k|uHfnGmD*!0F-*?nV8F|$Xv47Yba#MPu
zgt(Hfj$yIUAlEH>R&!@}qEvpnj3T^%J3~|AMLX5=I~pfIyH08QlmSFNDZ?B*K{&%W
z+m<;sMLBoJP}lEZ_rIgu#4W+*wYZF?T_WNV^J(M}%xk~yS8*5%rM18$Redg%ul0rf
zG^ZHec&?tMr*dSY2uHBzsop{+zmF6>-c&377r@qz`gBNm6%`<GwL-|oJmAiFI)cxd
zpP(L)Y6H=kHe3n2l#x`)>_B=g)Fx+v^+K}mZo#htDrc}w+VHT486XxL4>3??@wtw|
z(|AgcscOx<Cz|sc)CUX0=$Ikr<xk=O9SZ>2)Btbt>I0E4Re?&bS_SUdlpH_Ozqz5b
z*mf(<<?QBSqSQ1cWwX%9Up4<mzmwk3&ulpOuEmyYx8NSQpGp0g{MLl|>|nxqyO7bX
z0&x^YXk2YlMiIqv48I=OMZ7GDyt<VVehYyOE=$)$*!E|ytu4)77kCEo!%;-QL_$Zx
z%0bD&$U)2bPpvTbZ>`O+TH26GU8`qYSoERCt83$lB>(UdIHiPYoaG7s9z#E*QdILL
z9Q{Yu-)7G%DLJ~_MP;McUdcLbtb#Rg?(`>p62NagYM6XqY`XLMQL_>fIYF&bu$5#u
z;PmQKWSFU~Z(Q}?^aH|e?TJ+ZT|kqBEN}G5UarDm1#KPgo^V+1eAqnoV*GM_dZrZm
zvSRixeI~KP??8c^;5yz<{K)(S{P6s^{OJ57{IL97JMwF~u9BxK>_pD(+x8O%%>t2l
zQ^J=@u?j$ZA>&PmcUyqS-!Be@^zw+m>Gyx^yiu<yJvhi2Ad9xum~cnm{B>9VyrHqy
zdOFV!I5{*n2*z<ipNUBcvjCdP3h_%NO{EC5t0u9gQFrB`G%ErZxlfqF%p3lmHH3Hs
zdxYEs--MvbmyAT?IDfxvgj_r3aj8EBTpVQ^g{S|6yijQ{Y0zn~I#4>mc>|4wOA=;W
zQ4;fVh?-yvqD>~6mmw2Fjc-(Y`jP?pV8<q<aFVy$sC$D&Fiwrdug&qhZUdNDvhl{K
zXZ>oHmHEs#AKG-rZ2{!+?R`63tz?kNf)|?d4dpM#1ufgU1rX2wKxd+0qL4^vK4?DJ
z7AQ<aQfOgp9~_7+m?NhkD(dbg`iRUX-a59(0$mJ`%+6imFg*q?zJz*1m?C;g#Oblo
zLh{q340qa%igAhIOwH=Z7>e*>ELPtrwS6516`xx~75pnU@h(a;>ER|51X$`1pLQG1
z)G;1-<@czT#6M?S%wP`^<3bObtu-9Z8;wWIffD}YgAK6+Gk`QgN}yE`bD)Jk``|$w
z!2+Ov3M<GX<WPVMtLHNZ4))&Ps^WGct!y75^A%`eG9PG&B={>>1{52T2E_(%jL=E!
z0}oLEYk?|4mY{0jjS)LZePG$qJ0PB>1YnjwTPU6AK0*)-a5ktTxFgsbcAWC8>#-Zt
zN6hvAVgBU~s(>S%KeHwhT)oUR3;vH->#9SAq1QWdUKC5fyI;6jA<QE2)HzV1$N?yi
z+z<kA1L!c=KX@9}1giUpnEY?4LW4Mlo!MAERnSP2PJSBJ;W$VqxCX`qwi_b=_K_CC
z0$u}o2VcT$!FFT5LOoK{{_buWE3k(V0(P&^?#yo3kXT}j7i@|~`-sRtO2aYhcF0$x
zOU&Y8)lxz{R2jElPy@arzoI<yK>lNo27k~*M;vnHhbuNnf5-d~gZd8l4);p%hzij$
zh4FnP+4>Ik0rw97N_0fyR*9B7`uG*P7-lZ`7{m$s?+3{g-c-hv##C|utrDgZr82cp
zv3x#hzHxr#mUauVBGVNPce`ywt5`gaANz8fT8kv38u~UQ1H^0;N1TtBR4y69MLHg*
zeuoEnP|XN)EKGx~M4o^@fW8S)(&Wml!|Qf{J%u`jIfX_Iz5`H&6Xr11OP9JT6mO7^
z3dC=tP;lc77R?oHMMSlIs^zFfu4Skts1>M%ueDNdeAeXY(ww9!Y53}kCk1q!tLkI!
zmZ&wYf_^D~f_Ww^Ep$UTIF=LQ6;2SgtDNF}5_Hura3nFf=X1*Fwk(6_d70ZQ@<=gh
z>N=PbnHrdOQ0wF%J*%wgRT`X|-%FJ*=(g_u&`}UCw#42QYv7Dt2+gdwJy-jM0g4BG
z1x<liLDe8<&;=k-{V;4)Ev;BUNas@d$|7EyVTAX_*QQ~$b&<QuxE$?Xyj~=vD>xF$
zANB?61?C0%1r`ws5e5+&5f(Km|FY+pfN4(DLdNh!R@09oyWsw^wIG*Va-Z|#4A~Z`
z+=Jfriz~k?oGY~}j%%ZC06Skit|FH2b`0+spV8K3oZK&DfDFlGmk~0qW&ZtdMH}UO
zU6C~2cdX}UHkYPX)5EyGt~y?pLD-{Gt@yr!Ts)#<SUgzf^%xX<xIQmh`EFWVqwQHV
zQeP>`(2DWxSxV!#+-~u`u+~9qsLx<&e>avNi!;BoGRJt8zZx+D!X*@pGL>XDR1{;_
z#fAiGqZUQAjSw<OMa2GY$QZ-n54C3Mo531nTG*F|Nq{&R?rG>g_L7ELGPw=!&D;ma
zw7xzc7%jR2POO1G<%-;P8MlLzOQjw~)K@(xw+xr%2d&U+Z4AbL076#cPKUHUn!uce
z!ZaEN6|rRQG#9!ip0YY>o~1%jpl1Prh;g0KEIY}s@9wk2%B%E%tcl_L%$PkxZCOw^
zT^ED1d5QgOEYPz(F$fE29#wI@#6fap#JSV4p~L=b$4FCT`{0q1ud2kzWV(Idk2k2z
zc=6K*E7kit%hKW1_@G4t-adh)!mrdFSDK_Uw&U$$1K9lw^Y&x$9#!K?EDi4x#o5>k
zLiwS$7GPoSc3646gN~O~g@-ckr;K8EM6IEW^jGUdplpqnp;R#%=h}vmCIwzQ$8H(f
ziJP3%tl+wZRAg7d$N_Q+*X`}3gQ%!fB+A*uS19#Pl6?eh2U>s^un6NpU57f$Ls^$N
zuSRiJF7vjHI<OkhBd`AbAq2Y6XX6ozFI8%1Sn^&qVC+FzW=Kwc7CVi5m?lsnM`thU
zZF6$(;fgE6EdIq&W>x4?RgGiuZ<6BYcchifn$l6(dtXK;?y@B6zzTrKtPI6>w-TCP
zJGj?eeC9(>4M@Y9zA^>yVi9Qqyk{)<T^ezQ?5x>Ky@h5T&cH_`y@Th>0zl-AinC*e
z$)Uj@3eGt=_AUYX`_x=fhf)1@woNKC_24P;gUtMNU{Oub=F;5_)rYV|<GV?wA%|9y
zL3n3)Zyfi^)wMEVO;!voL#+37<1cRN$s2b)$}fr5k2@P4QGlIp;~6*f#2K*zptC0c
zKb@NNt**MpS37#KPMV!*(n<fXg3g@#y}DlGq@ADX=WCIA?5{J0r%#7Xq5Hd)QGWd6
z)sYsyF*Nu-a#8d{@c+Qa!>O#FZu6Q!=4~1^k31%TWgl+(11Ml}7e<=7&SzvGJJ=#D
zJ|<(4Pg|8-sGR8;r`WDo{QJT>B3Y6}+@Pt(iL;s{(=+APE0T7D0pOj<a2<?kKT9>c
z#B@A`P9T5fJaT^&wUzkk11$S0^%^xd#$OkV!<IVc%$%}2tlprcI}%|fO+jR@?hiOQ
zDqi3S(iia@n6n%(ITa+O1YFwA1^_5ot`Z%iy9KKyk1KkzM&GZv^h&8NXsAfFhE_!W
zfsBV*`nWGsG^^1@gil&I*9TxzetdpRezMkJV%)MaHHxOsm#qsq#3y}pjiaJ!)qHYp
z8<UCQG7>;AP@_1$9`ILydsd*F8a44!X2%VkFEs;H^oJRi6|ows8m=0q8lf7R6vYtL
z5Yg~b*l@-MCT~mY*arOqZ?$9|{xI%OyYB6XgLtvq*lk_I62fxe+@s)c%*?Mr3Uqw1
zy@I`dn6f+>KVPKF&w2QQlrwnj`AKqHQ0j&m!fS-27LO5<zf(cj!T<Q@m1Fd?$hvRm
zZP-#KgkH*m+2AXhz-0ZW1EkpwNh9L^s2`_)WvQ?QQGB?OsWS*cYcOv~VamHCCwBCn
zE{$>iSYZ#|inDK-11Y=v8Tm&Kir5@b;R6-v!j)pK`hlWW4y*Vv#R6^t+9s)xbZVU=
zp#<S|kA;WI8XlOJA>xpe6*t~4=UmB2*onjVBJFdsSU)igA7Ka_I2x2BKQ*o)y3Wkh
zqQ~K(*tVDwrA_h@0chQoA=am+$h2I24A;PqXVqpjGB3uCG0c~pY)u`CbEvv|mKbQp
zwTo12pZd)@@)J*I+G!OT751DLR>E(@FhM+~h170W$TjF(_Sx%Iew2M@3UhtO7l096
z+sS~fHUY}c5LC4|E~uk*>lgJ&buCyFoDQtCP{1H9*!vg32F(SRz)oZR{*sO{O-aRo
zV?0KErYjOoUq0GtKEiP>X9DaiaYSQAtc4Srz+P*cb;@SiZNV7e@~p}^zmD#?sAmbP
z1hfw02oz>gwy8{MvF-hwAo(JH_01G_vYD=n%49LZSg;>u%o{-GFpKfj*(8<ZOldX4
z7bhxTpZ5D_kSm5OlWP`7jXq~mao!}!E3uAy@86m5*TdDt$s`5#TIu4Hw~1LVt<TOS
zAblB6c_|*}5T0C|f!`|ndfNtr*86-*Ll+!NLt!GRadp>XwASyD2FI8Q8SmIkZ!{cp
zxi&>&m*UI@8FM1?R|<LGcASz%P)h|w!f;&tM0+QR{uSk!LyZk9GYhM|QGEknC5`tF
z_RC>$7&va+bzVD#FAnyv9(@^d-ZpHUnR7`dSUF0iAA+q1#D){TWGQmt{n{DqyRj76
z$4{_BwAJQ&ft9~{h9zTL91-0lQAS^XbED#WlD$fDxwsZ?@}P3Y7uyjP+>zki>2@9n
z+?AWK(9rSY-03|a^@yq{Ix=*8oPu>mynxEV?1b{6aHWG#f(I?b<eOx8TeSVHp7W(r
zd7n--NPDlsyLgkI+Xl8@ey#5v*lVyH2+k~`Z1Gw@R%<_2bM#{-TagZt^cPydbtQ&J
zh>b<CtX~23+W0(nZ;mlx?VgQnr>Grb5>mvQM~ZCk#)H#fYoLsgI~7{+H>#~yI~Lx|
zL3u33gFA<1?ohA7E81Sx!<AFPt4)<wGTKbmmfO&}h9X%-SpiT*8UfNJqsI{L-FTfM
zM8%;UQYHL|ueIKO14uxDkAGc$|33b6zv{8>)d@w_fSOdNwH8U8>w!~x(p{$@*BG`F
z&xZu!2Sx`Gh43ABD>>m_6X~x5lN{W5j5gweTcBLvH)V^5QD|f7Dr!v_BkwDSGD0(~
ze~97q^ySVE?*Am^?I!P{1w0>^u*bHB+!{4*!e?Z>a0DH2_tZ5BMxsTu6r5Z_Z6bG~
z{!3`{K}f+}pqJnWSZ`P|sQ-@RCmt=OsoKkTvJtVM8#%lz%_G7(FCkSy-=NLc6;}vy
zlrY(=>i>gmY3>j1ck^3_FX`+9C}PyskD~KYi_}c@01m1w01Dn)ssyuF8S=53XXSsw
z{r?}R?y6_mrmbnO?V6U^?%bdW3g>3bN*YJ^7>?+g{|Of5;cF%zTw4yZ`AUD;@vQ)<
zz`d`_NoB-A?XCL@b80tUmSbV*XWLg!I_6(H%DOeD={?EOS3UMV*Wo$dUBXU4UEdWG
zV`+yTxB!8juCHgQ%%Apkz;9Y$2hh^!34$48A`Z2_Pnuc>jH24#!NEDjcMfnIyYsX^
zP0%zIf;-FI>Z@LKQn&Y0Mf5?M7+}!;T&kP$xP<}E-2R&n?9aP@9Ab9$1klsrCq{rp
z(fa%?+%QGuR#LN>bdR6R*S118iF0xi*W`N}+n3D+YI+{+@<OHDu62)#t4z;2>g-F5
z=9^v2=2))*)vK2l)osrt+AY>Of9a$gO3|&kJ(bbeXzf!bgc|-u1To+tulmhptGd_n
zj|vTlrx$aMqBjO7q{H_7A@~wj3@Qle73q<qme%;pJtQ~ungHSf#s{&5m_YX+1i`-I
zJ(56rK$ju^o0NcEKwBaII7yu7W7{RpNBhM@AZ$3&q>=bwdPi^=4_7`lbaa)IS<ir~
zk>RvLk@19P@-@=?hMrd+kxa>%z1S_m15uH*z=_FG+IQG4OA+Ger|Zml9LMga$h4F`
zzvx3JBZHGYWBN_Ii48+_P8BwSbQmT0V(7ULt6-}T0+2iC8iWG+U$R>*VXa^-!e2yd
zn1*2AbRu_%(dTrgBTxW2ECNU$^iL=&Ttq30JG1Qgp8kOAeUnPxCO%I#nU)mfL(xnL
z3GW-n1=ebRD&+2}S!ayFO)j$gaf0Bb7IFvNxWm`}c>?%Ar_SZfvRyioE|7J&=}a^H
z!yG9Vi=vf@v<lqCbU;PmapK;vNwEsV{nLE{O9Vv(Lj+9(n+25x6m$X%jtgl-&Q2_*
zF)E#90eDO;fhJhi@m?8oXvaK=%}~v+!?VsmZuRMe6col1&qc;Vo@a^u8@6N-xpYad
zol+xTd|^|$*{k&_#`O{y9khm`Ps{QaQ@LZzvmM0KPdvLCsYIn{zJ{SI&-d;#G$U2A
zmlT{sBU0_XyM@!f$vOXi>Ya%>Qev_6O#Fx6Q)?=e?~ddg$X@ZkW*!0~^wgLJsoK*O
zj5LGGQO{70{{-%ArrE-Suf&Q0>p2lF&+6a)@Maj#7li%YVqXqO+jUf`g;jpch}Y)c
zNyz2Z)k(_GvI_Z~jMWIV3*HMlc8X9GoL6Y<D!T`sHd}T*{){emBZ2XaV1=HssOIYW
z(`-2Vh6k`K9tK}fYnxV1XM0KQ8Bp=|B*!iP<u?=Euo%VmmeA_}UX`55h!^qtc8w@`
zw65t3>UV@~75)saVvW|dRC^|7Y-1#Cw^P@TDcF%nTs?talmUKSEDQoRO002$PjJHQ
zR~3Ok-1)*t>SN8c+j7NcsU&qvXt^T6LgO-P4Eqv60dkl)3rqSfn!p|FH(tIr#mYSl
z@1(U~CpcFB&?MVJ*|m|gp-YkA&)2MfDe;s-6uV}&^*#i)4gnwaB+@kMO<0<;Zt73b
zlWWv=rkS6Y5SEtms%zG`k6F`j7UO6|XaJaPg~LYJ9}ei<&X&snB0hF_nN1|q={Oa~
zF<S<tJ%y~Quz1R@y3crj;eJ-5Okb%?6h?!Iln<u8m~~cA$jcjll%jK(7FolUkM*Q>
zJpUdSd#Wlct2EIo)IUPV*#n;FLR<at8g^WOUH-hxWKN}0<ZRu5R)6i}HYj-EO*#;2
zLW7)zd9#XI=(A*On9#D)+}k0@G6f&EX+}Hk!D2rP!NZeo!_R<6-8Xo=bo?d2gP8>I
zTB4ph2+dGTn$kRRQ;N6xs$T*qQJAGw7F2M%&v4754qwXHf~i-FNF^m(B>dWht;s9=
zccLpKFgP&eE%=`XxvmJ8ck9bApQ7%?L@t#r1yfT5MB^Z?4qNN|<}}zpH@u!xCW#v*
ztPPi4)SFv8yP@5FBM;Xt0RA;^YvzAw#8h^`4BdfYufG38Jd7)AudhL{yA-bSJ8P8P
zll`%mQcXI)Jg=vLUQ#H;<(V;U$M?x_rMB(7i+r$DVoTHM&-K9gpUg%~lOm1DmgK2{
zNvj8cY;Sbd4C^;z+cr6DzMf}Nm30MzCGp!R2~aOca#je(MJDXeutV)cS+dAIO7UBw
zr1R;@5IKK8I~%SKER&C)&iO9G=AOi9?^<3?9>))-P<b89^D<S2>RD>t=`!=F-Z7%K
z@yMNa($O-k_$5)c-Mn#vEd6GNR_VP9PCi-e<g8m%<rg~>f#TH8$V6xC*}=fh^1Ka(
zKUd`S>h8(q!t<}HV0O2ZALqA70SR#NF!2cS(DCr`RObu77=O4}8ddVf2z)kB>MC{1
zs(APaAKaW&2zNwHR8fyyWaEy`^-DDCs~J=24yf!tlN}l~k7iTqOHm?xNZkdVbQGq(
z0Ig606FvCT*k!D#QW4*mQprdXzU4ywme=pG=itOsFUGQptVt|F@QAHK@c1s!NvoTY
zg~jDjPz5Qlh;X4}^7U<1X17An9!e(AHQ%=ZOe7-E1|$|GStaa!UuYHwKE7mUxW&GO
zv_ww6)#fTwTJ}w(e<RaXs%huw@-yY=Ivl#)3>my7Gx7?M9PwP)mQsHmiPoiFYCFkl
zz-VF0w9CX&ot?F8SkZW<Y=CjGuw8L8Ns@?J8l-KnQ;H)S_vA}GzOtAhUN@8LmQMPn
zIQvbxT@UEY8)!DQu1q_^=pOnzyv&W$6~&d&l`w-DvyO}rgTYGO_VWl@Ra}sg_1j%F
zi%)1;39%Xy$7eA%YOzDCjq&xL21XCW|NMX1ML9$MwoO?LE^!|yon!ZQY7ufkCKu1G
zOzMeoIp(}u5uBgi{cS4^r9T(!s#s@+nxN|pnGKW;j19C6>>+i>x~lC+-M11FBEFB5
z-Mx>CsG30kMXU|Gl-WzEz`kb>`W)>2mETpSpGU2Pzgz6eDcIj-qwXAL5yo657W#7^
z>)~GOX^^qox&TXr7HB=x9{wXb2cw3>2FHdd1}l0om8De(=jVhmjiz$2DaP|ss*6v?
z@Mu5jkxQ}2F){@+g;WGrgg698!Yl#b^SN7Z$LVC#P|a%fL@wgTD0vn7jP?bkn{uR!
zS}Pd$)rjCS2F~=A8IRR8j!QO!(|KVqVVx=K7U=@h59{7T(0aR6{;@OMegf0;350)f
zrtGU*ltlMFgpv{8X!*U%U)gG>zaUq_Y!x<K<(8-rSMVngRfrsP0s^U2xpJM)e8|SZ
zs&oh<&vH>?wc&A2{Dn7QHMMG)VuR6HV#N8FN%CDG>EqvB){)`6L%PQ}uSIR1o_abz
zH1~t{?(6L6EiY_^Wg~SuCQ!XNG)C}$*xqk%n=#&_2ACpEm~Iv5928-6A3+EjI0MuW
zYy&$D?F{b>n}aHh*($Q4g*t)Qo(Wz48IOSjcD^v78*v<ywXI==c5Jbir1z=4_i>Jv
zPGlQsJX6SL`F&AoEU24vz8LmOanwN>sE*wOi|Z~5fdT&jWrJda@nPAZjWdZy!_vM7
zm&4qvDK1ovmOh6-BG0Mb!*Rdor{Ac+<4RRr_u*7#xCU|1Rq7J>tfN;}uY$?&%#-tj
zM0u!IW0~Q%t4}#^tH(ohplaZZ;X4U^&>{L@FVJZSACwE+CR}F*nk!HI%gdlDnR+SC
z@1}0M3Kd{-kr2fc%~RlLQx^)Lu*;c7lq||P-C3f}8GaM54zn~YFjL*L2}?-bH{G-X
z)D4y8udm!y{7K}_-&y5;Oh$tJCB&eUULQwVi+IuebkAMkHEG<peYUmLwp1Jh#-nJ+
zon{<G>6C(y?VQ}R2HbGsoUOoj68T_4jKP7RmynJSOeiuqQMiCFk4O+Tumxy1L<K4r
zP82?X@DUB72lfDofc}%Yfa{hfY>y1=JTjXggg3;?+Y7CCG-pWo_lX%-s?OG2W%Om0
z=fDftwqZG^hlq{vO__W(!*p(xi^HI%rGZ~S<_ioa;EGy-S!kVt!I=5Q48Z_roIPwZ
z1-I3@w(8MGxZB}fp9Pi8g1i$*oX5(1`tj9hS+BUA{T)F&;H1xarJ|jEYRU9!K!ge~
zogN~}lK|aa7WC;MC?73UNAkr|d13AM3WIpe5(A8eH1CEMu56|9&5P!ZF>c7CM~&8~
zk>M;)W~1Wu*i}#YqP(3!Qi<hPVAqk>ZT?bl4eS<FH*x^#BQJ!+l!f_oQ;1hES@1gr
zgld*3Wu`!2MKjHTcVU<D2Ex%71XCHyf7(XNS7DvO98P3~-ndY6fSUA!^zn0J&H1%J
za?~;joBS9%>Dd*Q2wLyT=)vjxw<YJll1~BcnoA5S-fiDPUq(DhtpyXfvxl?3I#J8V
z!OgX8c#7s{J5ngZJ)Hb@_YkW5QQtxJ)~IT@HDH(ll%SBrb;OGZZ|>a5I%FrAIs89-
zy=71w@BZzJy9W#I?(XjH?ivEYHMqMD?!gJ}4nuGc?iwWc;Lcq3Z|`&eyY4;byy)ub
zsi}T3Q}fh%*7|%`f9ZVw(#d-Dh6A#nBj$+uozuFaScX+98&Q$I+s(dO762ns1+pg>
z(6#D9veT2WIVZH*H{9_8!i^q2JibFdQi5oAW`L$aeNchW?`W^kkF+3G4Zfi$u5^d6
zRj#Gb6}FrKwAr?$02V|p<*C1clqRf0?51Ol6|d@E(=z6{%{OO&dvPMLx59jNF|c{X
zKy?cA$ugp#y!FUO%8+$?suAhhfuV|BHTtatl&z=|ZSyHdcJZjT#S!RvcJtcLitfz`
zmnd~ME5<0DqF*-1)5mHF&8$4wGD)zzRg<Qdcd(RgqD4JWLvxSKrO3dBnu*2)&4fG&
zkq(^>uLGe2qXR_~loqTVq#e8%v>41CB*OM7v$PAEn}*pJu1aCG%zr9ZpXnJv7SLXC
zNLo5K!W$R-<iLlgP3Gu9pBJC94`C1G7VPt1JBN>mJ;LheOjL@NQ~45%vE8apAn)zn
z>x;wX3*5KMWvfId+fDZ!;1?s0*B75{-qDDkb%Z}@TAuXNL|hk|bJ~K@TAVzpsr!72
zty9;e$LP2R@xMr=!+X?`_)%%ys&dAkhBLKxq#P&LyV7I%6l&svM-4+$vdK`er>ubN
zQom`Ye7>vo)-IMvbJTKj8JeIgZpep2;T2@f@EWNn*czLHUF3-Yd4A6<mFb5VdD&-C
zhVB5WOmR+m(vFfNqq$ATnB|U=yzB*vp<N?w*tPvb`(8zYygjMy8EWGy`EHG*XzV7R
ze9xW@JD(2vA-jIpN)>~dt}$ATyt&2slAm+BKNJNPsfmxv+J~u?J>_RQOBjvjq*;y`
zGj1bj-ilT#jWt}e0lp-V`dWc5#qYxuWAZ;-6vA>%1R2W9X{Kn_X!#s#PU)@-MHSfL
z?68&v6-`=G@jNJSoxm2jNE!eXW&Su)h9`JLB!a7vw9^GHQfX}(5^njwiDg#6v^iVf
z3@)G&kGBHb>Zg}P#wXg0bB?DdZJ4lm((X~OSVmR~kQY6;nuY?{#!d}?lqKR)YL#sD
z!ZmceHEE2|(OmmHExoQ&oUTHs86Kisxf;piiT5QRi<ulh6$w$?a+9l7qP4^fS<70n
zQ3F?xvDB&vp>=}X2T+xnQ0-$|DlqPoYCt#Fz)5WvVsGEsrTASDu$5M#%5}^r{~Yd2
zt@uf0qb=>lm&-2p)}u>NU_kkbYI&Ke2cdNIsn<)+VxS|3T9AL#Ro*Zq@7eI^`I&r`
zp0lmX0q-|;GEP^p5tD2wU)tgtb!j=Dix11OjPf(fkjdxJW$I(14EGX6gVPk9j*=^S
z6~osWc^?kb^IHz!#IU@F=G5WSV*D5JpPHz7##l}?RRpc}bFL$Jgrl2A&SMG}B)nQ3
zT#>2ShcMk6cP;aG9unDrI~*3f1Vw_ql<PTS4Swad3Z=bHNKqI0%QAk*jLz8^1urD7
zDP@;tLg)6=s^ZhCWJLyNXpZG&nRzwxh<ZhV@sEj#C76vErJfU_CLumuI$`x0wuvVe
zGAjan;%1ei@#+;<d4$#zeLRNaj-U+r2o4OETn9Qhbx&1^gpPxyV0d(E(io}cJ8bhn
zBS%EnO`JD$*QgXuonS@}s2tY8jOxrKy{t8eb*Od7b!fqo*J2$vz0jg<ptG)>Xvn$U
zAgK~M3fkXUln%NCT}~6Lqp@no<3NrHmx4((t!tBE0=g;8zxH`Sc|&<2y}HE|rNNA#
z3HeE;N;B3}OYJ6t=NPG0ox4%FzcHy@kc5BOi{X27cDm?67;4}Do%xkYecjXWvSx~u
zE47!Vev_{-S(^G%7pUhYn6{5~;k{dGp{J+%iMR1Ex1QW)gj#2XZziJ7n^)=E&VvCi
zgl}d@;5L2s(iXmgJ{nn?Xy}@(7Hzt=h<XpStn%I{_4eulU_bbp|8zK|(7N&cV#pQ*
zoY@248)p$JdBEP{ut=bHo&cd|asJ61gCz&~S(cJw@YVS!0J|^`Cc|@TRQxC_M3lCC
zy@m+lI(~`RwiIeIyInZFBRjrK&P2{a&QQ)2&REX>QNqpw&T!6$;9<S11a@koZ>XHo
z?_>Vbx#1C+sJYO&$hq*j=tdAm6@*pIIj|G;hx2inH<fE8htWq=oQ(|dWjLCD9T}So
z?2r`o7g?IIQ!twP6edcU*fOnK#!$6rmX$C}evaWg&VS^7$08XwC%uokx&{rrEO=8d
zS<ZVVVbgv1?J(`w?I`U+)~u~ajJRDjzeXkS(G757*Ly!akl~#=Z%}BT94@NG2>N2S
z<+9tfXi}&}3(?93(zcMzV`$6o^(~}r5gYGPL#ujj>mO|4?8ubotPPdvy}_HUy}@tM
z4nGBIkZ?(QRtwBgPjT>j8OK1SOi<c(cz-5uw9#v0&$;`QJkDIRS1a|h<xbwX_Rq}B
z>`JsTtJE+*^s<~s1+;qWp)Y2Kk<%2Y{;mkU#0&#V<gs;et+$gy(Od>i8g~h58FE>(
z7sdO~KFqKE+J!GdA49$KUJ4i%kISTIgG7jNDzjq_R0d7~nSlerHQ{NVex!&(A8`l>
zf2RTXXJepr$4HZ*B{X@otXf5f&@t=BpJU|M+v#|DH4~QOJD3tr3J}%K7*I2)97+{B
zA593_n`X?IdXADH`BJ;&>Q*04w5E-x5M!3@^HvMd=eVj*Il{dyq6fNmy>pv|{$HL<
z&J6gY-KIa0N_k;y1NQ_>0SN~MMG54iicloq1foUW;Sav6I+zLlG{N9Lrj*|cw6h<l
z;YZf?;{oL&h#;?#B3G93Kcnf&*+A;hA!Bi<u~0?o=&2OvR*pCAw~VVBTQj;gqk7l2
zi%WTJv0PwY`HS?jLYN?IAa)~ovxBf){^0kgJGdoRE?a&_tIMlY-W*lLxRUHs`h}KP
znU%6i^IkR)ub^+-C+xZbxq|6U?dpjG`syMo?cGx{jlaa2IIewU7hIusaMgm~`{7-?
z41_;+L3BYm;qt0JUZ`l;**Q;-VRu;KAG;oI;P(b5YB}jH9V>hO!OP3IEsU$|_#mJk
zLgf;wXgLIBL3wD8Jxbg&`z4Ozxs4{@3!B@D_l2+gX?riBE}*thyGN`yq~-0CFSnXK
zQxE#YH`t>dvlUvr6m=wc00#C($M!ZByWeQutgQzzdhoKk|3#KOnCQHQ`GX&VnjXWT
zRnB1zHQ9$9!@?P=N8ytXC4rH_iAlGNYN*hz3O12vr516n!ZGb6&>|`pTK1HAT1Z;0
zW3`xFD=b<|GvK~uSnkNR9t}gJ?%0#}Ew-_a6SWduV{0>m9E82kRszVIv-L8Ga4b6g
z{=`-C<%(Ff!&85#<*pJkd?z=$Ed)&6YFPdEXkO%Bt@_yKXLSnLaGW(714vjIx6kaU
z1m#1qS&vNw_Q*Lbrb%R7IgMX38U3rB%L{0K*Zq%fH)C}<KtDtE6E}JV&>M{Ze%jYY
z?;u-(0L3{7L`%Rq295FFe(?5g{*$~DPc^l7RPVj-@!lv#m9c>o;C-WHnk-I5vGPrv
zY)_o4=g_Qa?KRy}t@Bf~x3a(tzk5{*0%}5+PpkAcqq0(HSIi?QwnPBtYpj!d>#K^8
zwE&#$I!IIaUP!-BkLljt!82`FZ)jPiuJT<d8Gv8zr7Ib7rwl3iq+xuL=vgioi*p$+
zRaNkKRMv+GK0fFxrgE;kFOoa5z{KDJ2r%?3HeaFK*pH!?bRq*f&a2Nwgi-sVBM<+W
z*U^zsuLAgw%yiq3VB}YlM`)1jjw-M~(+CzoTshV+ZY4a#22!?jukD17Bg%G<KB|AX
z^6lR7tc=hEkbghN3G#!slV+J6?1-GS(#wB(ou<5&?}aCa)wk{|^zJJ=YlFBI7vcwh
zs_%pPP2Gzh0l{Tx&<w+sday3>`?6i)_uh1|)`VE!pK&q8Iq@+ua6|)05QM%{0PG9;
zu)MVr<SSpsfcn=3I195)$il=-SE%_pNzxzl(Ur9A6I3o!O71D4$B{BqvwVg|>4gDQ
z;vU_yI#K3kSM&~y>RHC6(V1W34rr*@CbGu|IF%6*tR<uvMent5Pp8`PIlo0;7d)K_
zOi+oZT_ePnVOvm@Uz8^)QH&`v^sAka(pKj0%`8M41A65eFGt1p4DutgA%9dYEqr+m
zufiz+Ji0cI#yh1GIyWi`7y%MI617a*3GUPC0Grr#JTol3U5DQ;HkKd7gsM9Q<GeS}
zJH~_$4sWD0Zhx$k6m&>lOY-iVIs*S?P0g<;h1v-UL6n+3tNbtj{!Z<!fFyIS5}xL<
zD7Onan`eF%mfq06)Q^_SKE3HvHt*?<m&9j$w1c37V4NVFF^EbT<*mxozh)YYTJ|cb
z!a{$ilIXQ0{Qg}Qp>4)(=3$0fh(5V+JkVX)GX)>dqA+rO+_w)^utgDbWqzy)3o6x*
zBa&t)!j_H;n(=tpXW(&D(#~0R<(2Vsu@p>)C4L{Z7WTXf5|7wnnrW3;XbCaeHi)un
zo08!DC^Gu@j=;)$AxSCem23Jd9n0ve|J(e}<Qq)lf5i)xwbCgLIhN$hhkATTZEos!
zCk^3Khsg;ISf87~J#GcjC~bShCQ4bR4ntk--g`K_%rXlhT1+kECVo>ZbuE@N`|DRd
z{UVlqtMSAodzGJ^qod86BROa@b+<pL!RLU5_=DNU2BAyb_oqF^S8JPHx5Zp5nn$1N
zA-e*^_k-bg-K)D)BzcuHG91-2AICGFAv|A6-usA;lPs@iQjG2Er+z!f*Re)7Uc-D^
zTYD_txD5MT$PR{z9WLIC^3{&Xy@O4{GtLakDW*z1@S0xP2|gp4epv+;ogNN%v)J2<
zVdmdq3JJvVh|lbM5L=ging^VLB#1|nihdJ^CBp69(mZG#g)dTvCAA;zGFmFrxtiiJ
zyyc!Amd6C5=^~Cy{%GU5F&cWm*Qq^R<fWE@aPkHRDLh~1l3zW8+i1XQ=xQI4i#JNh
z{|{w0<1}+KLpD=1W8^5wHjIOsLXY!Go}x!X*7$)t?5vkLg`m-GvyZOXnBS3*yJrZF
z9wv4ao8?8Jf38l(LY9tio8|7kWSqeYWD@*<Qpv{QeA)4rEYHt$hdoQHZMyWE1W)e+
z1zRFnr_}01ehKWv(Un23Vl!^h4`J6$3ayyAMXP^|l4sa+&>k}2<Q*3F@x2#rpA0v0
z2QUo|4umc!06t%BUQr$ni;d-V4<P~0YGcWU6hj$r8!R9{tc=CGYhA<IDDKU(U~JYs
znZqV2!}-;1_m7-`h(vVE=g`C_yi3<a-B0k@a)XKVljy{=u&ld1?_A9lWzSOl!P;ZP
z#_q7I?5kds27fJo0-%>;LP=}WT_yb|RDdFfouB5?)@`J}S>srN_RJlJy6-M=5Tg~1
zU1;<q6Q$hMc*P<J=#xu$?7~i&=9}KS($oyyTJAJu5O2w1Jd~sU(mquI5$i{4-qdax
z?9Noy-EZ&gZb)fN*l_W!nYW)fDeeCy=&S@4y=Xh`FZRiF2(^D+qz;)uE*lYFa~zFN
zdP<gcLi<AaLir{;FsO7!m!tsKM|EVYUa7m39jiZG0<79P3|8r775*zD2!aj{4GIko
z2a;osd?OuhpvvK^>f>Fs5+STBS&GNS6sb~Mckj_Nt*}wsMQD2ZA}L%G=Zt^NL&OKg
zhsB4)N5BWihs%e?N5Tim_b*^rKUMbz;pdi7es)9AoL>0g27q+o8^P9=s<hU;)FNh?
zWaTA*`>JIDK<fQ8#;}6|lZBWIoBQ7?7{Lg}2*n7>2+0V}2+au6=y>a@*yw5ScUDUO
z4#VCex`G+g0***>MOo6v&*<pyKRI?<;U7Ku@<YMTO$3_WL|}bWPb@~1u~s7fzt9}?
z4Tuc{A(VDRK5V9<oU0yKZ$1#hPBO4KNLChw?8}UHh<QIYvzaqW2+==vf@rl;&~7cL
z(mIM`mHju-RLox=6{4T3k32lX9a*OHtsCq%Pw|E3-5%uS_Wy6VEo9r}Ii!713jzvV
z884YN$OAUfy)12XGH}1!eJ9J*X{f6=(}aO<q`qYnw$i(`%d4XyR7)u1@}cWrXYQL+
z#_ynPLBbx~Ko#HF_=BOxhVDPO?|C1q&(z22llF^+v!67kjv3JlDeyJg+XG4d>V$qG
zo|-X$3EWmEN4&8j&XC{MU+MU<BF$hF6r&rz<_j%b85`}G{HO!;>U69cX!~g^w3G2p
zz>HP$>mI}K%=a~Ck_@GWt5&-mL9>!oZF<|^aElyjA8RqbE@bXz=<Q|<qV&xo^|2qC
z&3XBn<)ZT6PpTtnbVn&p<~OY<r5o>#8*YB>Wwyzt(0fqOxB?jn9V3O9?23HLKepn~
zvL##B-NXw!ukqlE#M;A?5pCQb3bb66jh3JpI`P@}<6{AAIEh^-({BqIAL99ig)~nj
zYYkrI-{kohDW=I%BzLARa7V{zl}2qhd3c5e>N5(m`x^bH6k^93_`h>@|30Igdux$J
zD7&F}KywK4Qv6j0<^=!4V8C?~d&7fNIL_6%;S~6(s^Y2;uU#n+n)^j}&JFx9X6X&0
zH}*B`RjTx9du_s)#{)~CK34ve+@?WAYsrdE)Oeh$-$M9DkSSDK(t5TmLJrs06x<so
z_IVXTbWBJwC_qKid1My0XdcagtZyb?DYuW3^t_|GS_t<l8a*y0a?YX92J9Y4{I-$*
zk+^N`v%v-Ma)h>;KK>rDb5Vi@nm=AzwOWAWKUv*1ie95$$z6=Ys7U%BKB^W6VN-r*
zAoyXWmItXq7eI<2`>7al^dFJ<iL$cfiuqt}vqG9K!TyMm7Fc;kG6}xa4X#t~XMH%d
zqg!mNPiWyr!HeBu^@yn#(or1-3s?mF?{I3nIPkFsGn#PXk<6)&(DLk!o+i(>?3bwj
zCHo#f7=<|{u%`aRDJXk?^lQ46##D7d^-%*p(6msb4<-PX2>zM3B!bW$hp)G#&_9-J
zyQ7#7@TKP)y`FtkF)~g{u6gCL!0fqgyC%CPNut9$-f<xME99f)iAlAA#(9Q*>%C&F
zP#H~Oh4P0Ihf((y;;zJ2i1V&MYr);e>TJUayo8PmY%DEwbX9`&XsX0Y?a;Auvy^H5
zh15r3^Qhb?35s>Q*m4+Z<1eF2>J73boa|seGZRft;3}xM32zNaaDO?aPk3hkQfjCY
z%F6Nfvt8R=;heZikqaw4f8F3BBE5^n#a8yz>;3b<KHg5<bjlQmHy2K6F~Q=)e8_uB
zTIu3aL)ti~*$>q!k|CtAqJoL$J;I9iZ(Gr*)sNPR^0Mob-#tm+6PN~1?E>d;sDjZl
zB_D(6?RMtzTAVGpFg4dmD~d#e10lh1-|ad@8Fc!emTC=96RGzf>O)<&$SltJZ>y;^
zzq-h(?q!{wOL{@NNS4|$D~>&49==biaTcBRpQKpL9}z#Xe3bX4#~9xYySB(fwXv!H
zye_)EZ&#fAIqn`#3t+gTEVFEU!A3GZ5W_`5D0@QF+4>DpO>HGlkoLDeMb@r>{g_kx
zrFmkotO3R`Wo!+NfPF1_c!slB`LhF^5vvpZ$MF^WP@|wQ`O%chkgMoVd?b=78Vn-!
zVW*`PIn59B^3p4koPXQEWNAP0^L#_?qZQ;Dq^+L#<GyieHAY3K1-N1Al^LVirT*I^
zR$!DE=kRsHN<VR>4)$g!mo{mzx_pT#jVg^I@%@?X^m9Gvi1h&oP^*GDI1tM+G~i8U
zwrmp3*?l1iBi?FA)wjvTxoXeEoN0kG$7weGM}zKI-RczFqH7DkR#$4B?=}X@3Z|k2
zI%;!$=SiB!%dzN?)t_HikuAl*@#{29A#q8Iu~)Gl6?=*pEpvKG^1-`SS{u1si=<^0
zel)Gx;!s!A2hvwm5&12{s8BPJDx4#JD${D#=xdGn4OpsPkj@N;j#XkpPd<eH%m%Rp
zwFI{WxdgkUxSp67P}Ve0s<(f*x^-YH(DnKjOZhdj!0sFrE*P)@Uf(3$xafs2t`Mmg
zUxU01;XG!+_bmU#%w|Mb9bQ6?l^gMci+BYgbr?tkECbpA4}rMs_w@WPTV+<Vml_5X
zc{;w^!B$;_Ne*7%-LCaS2e*ghb4QWtiiYjVE>l8u9m6ZY4+g_xjBi2Tg3p7_i#>_m
zj|6iTIXsD4CW&RyHk~U7PJ=20p#&iXp}Vj(ZK3SLTuM@4x)eR68#&dXH$j`kEB^u-
zki8M=dF#>ZS?fvbMJr1|(v$^1ziQJY?)Z~AV>q+bWAMT7rAn3QNj>%WSIi~q*45QH
zT~!?CEapq+!}ICqkw=n;?*cJ_$w2iB6+`U8SnZ%$kO)mtxBI1R!n1=V9s7@_vJZ&X
zHB$=~z4hW}pB$+HcZgGM8{a#|kj$e`B#G<>+D|)lZl(#nRBNL_m}GgKLZzBmjryjD
z&bt;ziwztx+S#S3bsj3tU@A%6LI@~XKxN97@Td81S89BvbT;*%yV5F%{)WQ?K@xps
zYnO~l+{G6KQb&I|yc3Knz_F8Oy@A6Dw(2!-$I`V|Qg(-*ZiQ3-40*^TiHX>1tbgbn
zp2AYfn3>9}<B2Uj2qP)~%dsUXdgNYx*dwl0y>dJb-n!LW<skeBiTHhVYw|?cSDjZS
z_rFtEU#+5vr5}@eZ{%S%%9-ApxiXF$p$C}@k=9StLKSo)k(>@>_nwoCq^HBBc=E=p
z#*nfSh6~8k$u#&C&K*D_R4}OzUcYy;?S7)tzO7(j9GO%G1-T}2ZtkZ?sk*7F!Zs!K
ztOEIg9Y7!86A%^{4wMEC0jYtdKx^Ou5C@nB)CT_7ypqSk?@xV=J>sQEYgSm6WyKuv
zw(jgD9c$K^aok=|P4)2qHY7K~h#YXOX>56@JH!fXA1B;E?HyRCvy!$%%l!j)Ms{;Y
z3U_HV#FX;KweJ_=Wh*NB=axkaV58u_zUd|8^fI5^8gZh)Ee3DSsSp2AS<wF}YW@!~
zOu>WQUE5gsDn@)As`Yb5#yS}}{_}qPM7eIY5v`Cv@ro3Q0Fw+WAO8(H;#US3cuUNC
zgj#QEcD4!rlt!iL5?iWhJwM(1!02I(G>c!<)LoE)w?uPCEYV7L47IjO8tLZZL%iI_
zlI7TasA1AN_Ds2PxI(br3?QzZV<2acEz}HDKB^FWJ5D>Qx1;)UTYoY0z`<^JRP69c
zHPA2PfH6V8gKn914W5_Q$)EzUDlTU%tz>{Ix=!z_!J$!RuA{V+gt>p!*QhJl@VRwo
zWdmmUZ%SCx*0IqLW}ng#()9x(nqWlaXuJil`@X&~o!Sfj{E!)bJFr0HV8LKKNLDx#
zsBSH#^~^PvfrkSiV~{RX9h3=bH=H*!NMPp<NLW;EbywKWE1WgxK4MfVb|dkyl|ZKs
zLkYN*Utsl98ug{nS_qb@t3*4>==!MVrSLY*xbWBLyyVUbyhaopBQD@ALUe@MLg}WS
zYEfO3{h4Ulx`kk~)t=$q5>}mM9Ar~k4IxdJN%sVckNqP6q;uQ79@GYX`F{XP<(^&e
z##_n<(a^`1386B_=k9G%TcxhKKuHr4Rrzoip8m-mc{hwrs5Is0j8?f=XbQbXhKW#S
zF{vVBJcT0U4|Dq_VSdFlq|CaQMZNf*lUDT6%1z7iFi!Ta3XKb&MO5o(6|G7>=3C;a
zY8I*d#u0e!u9N3z!HO@?eN>)PT|!dX9M1X#sQr3Z&U~|9$3P6Yj-Ss5_6CDt&(!n6
zz6V#67%|+Q{xqyCtP=@lk*XMx8?M03Qpa2pp;5OXp(|QeBB$&6nsCGQ#3Hejk|0A)
zB1@i+0Z(J~wPA+__JDq89%vgh162Th;Zpv+pwSO#;9_<KE0S3F(PRMA3*-0s5ef7U
zaT@Fdu?^Ept>Qj<sIk*UMfp{CJEZ9`Lig0UqQC$%A*vqG9jUhsA3!!89rZ%#Vlepd
zuQv3+!7R+}s&G3TwO)vT{~9+N{LH!bJCB)qP`<`}`A8CB<lDJ@4wc<HYd?F)ppM*w
z{2X)Xdnjj#;7E)`S<Y{Yn~JtU_gap;Q|0o~&0YL?pOj;v0e45vyn#Er2BV*&tEl_U
zqgeghWjE5qJBL~g!9IgjE~Z@{->XoV$`Va9*@?LTZ>fOG<a|kI%3xq)tHO5iY#_ut
z!s}Sih4oX`psP9h_P!}xqETI@kk<*4g%S<s@Q!Ts9$=<pNND%#(4T&{i`BFO)G1C1
zDF2`Se$@U+io(+eGln4kWjt*B9EBnAm=XC=(>8g>C^pFDgh<X*`-ft{=P%9o?ETs`
z<#Nkkuz0T{R4U|W#zI<EJOzHw{N?I{2!wr?5%_3O?9?!a!nyVG2LBUx6Q{0$G?&Tt
zYI2>~T8q#f6}(2h$1_@oT2{X&Qynw@aqhgE^I=H|8Uv=f8)uF$)H5$WsRh3mx{F}w
zSou{EUXu3)R2K29u5hjEHCZ$piXSR%TZ9f+CLDJ!xr=-is2no~WGUO-JT2XdPwQ?x
znevJ$&&x{AkKO4RKt^PW&}2`KIYL|%xiy~t5ttu=twlfGx`JCCIb}Jv<ox|mb|WeP
zOymHPuF2+G^hnAoK>tsN>OY3r|MaNdQZ(y@IYce)^nJjwh^6k+?qf@NvBcxWd|KaZ
z4>(_4%7!>p1dIW#3RsTgcVT!bbPr<&0TxI<D#ld%up@{@g#7h^4*DXb)Dti^kWIn-
zz-&ih^DmWxSq?=!n4Ain_A;Z=T#*)xEuO4~l)`2qF^z<vKKDg0|BZ{3X%9ICQ_a8m
zRvle>>PdtPC$$0#-%^^VCO5H{WmPlW^J#=><h!Q4N!<ONp)*r%LpD0T@p`HGDjl5*
z01L5a|LSH_ozZjK@r%kWm_?J#Z+t;z%bU{7l{@JyaZr9%=%Fv+Gfw!S3iEHkx3j78
zq04oF$I<EQn}M_rp7=kriovKssKN0;@$<13_u7`dh_7{$<=-MMKU57c9jF6b0`dS`
zfu6v7;Qwb_5J&>d2busSgHDqHB99lyXYgm}L=Z#>L@-1sOiGE^PnrrPA^noSZuXpE
z@RLb=jtEqugKvdXwD$X}WT-t8yJm@9(NB^L3;g~vQcdPpS53~-rJ8X$qd5ONs0-2T
z?U{T6?D~)Qp0eHw6ZRfK;Xy4!@ScLSgc99;KGq%#Ct*7QYDxb#5Vm<9)O!z<>kd4}
zqo+*1;qKo#@4#KZ;~P{3IB8<lT_ubU!uOe+;b%XNPR~rwj8D(}%*x9vNCOlU<fWzM
zr4@V}X$5(Jw3?diQ1w`Xl6;FAY{J<wRVf)2majf&BH5(rJ8UVZ<EbrQ8q$7!o<%hX
z_ESVeT2c~njHQTm(%*agJFg+NMoXMgbC?i5H@mgGq1oFq?Cc+xS;QTEIps{|hML8F
z^r^!Ue>a_fihhq&5vJu%;CBN2$vD;{f-Ih*m{Z9u=WlKD;~bHn3ZzY3#~;;6Q`E#i
z<gZUcHqgzI_exIuU=a-^_#V30LpZ+6|D@NYf6uTI{VnpyFd{E}fAYsRi@rw)j#o~D
zHI~YEGwbhcPRtx|#6S*w6g5^X7w`XSMHA{Eo%9WO6SPjb)Jf2*lUre1M+^#N2c@__
zoD`vP$@4UE$(y8KY{W@O{;(P!DOZUV<f!TQhSliC^8SdVcDRA|!OO87m7_m3t$hgI
z|JmB2wMV8_vG(|!JJp!HS=O426Y)(@ZB%Jq%iSqAC{b3)j?Hhbf^Q$2M9qndY0-xq
z#p2BVNJ!X*BC~{*>vIy;4bI5$3$v$XNOpD8Xs4HqU(8-0Og_yNC!0X@BKRRba)5Al
zs!9+i#yV?Y-88Ss4moj-?HyS?`Q9Z1CTd@H+PKiw&1d|Dg=1zMB-h?SSv|=YX^j15
zpe&coez<}xs_Nzk6Q|$)Y5K2z#kWq^?g}iUdqngmq;tjkLv9sfHj15vPW4iWiSE(|
zv9gOVJ&sHd!-)qHy5L#Q$U&JTEV05HA2+YhCx~3A`rQ{YDhm|hpYDC}*FOdW$OaUc
zDUAsCIXDE;T=!Zw8kXj|++zf_M5QK4Aw}T=pkC2Inme|@nP5|hf9<(nSuD0HrKTA=
znZV&-%TWs)juSU?z_dGfL;sr@zOBrJIX_dZw$-A(hYlvT%Af6!^r6Qs{l|H(-NYzI
z<$166ifTk1>sRKB*>UWamita!ZNgYfdAs|bcsfluU03T39u$Jfk!H+seukzT1a%TU
zNIgtF#7w%Iz#gmR5=EY>Yp3c}qsC>uW=_THqMG}F5%Yj*jk3%m*(m;uYs5w!7v&^n
zD`VXuvkJIsG@)LE%^kic0wVnowLR47uulVsR&$?~6k8Suo)s<8{40wSkjNv`r~is1
z+E2JIr}$}!GB)A8U9EDJpJX^(Xbcp`#L$Z=wFLc(3G)cP3xWkk0A+yxY@EPHO_m~g
z#PlyCU^Fgux8kpBpV)cxwHEO2&e>1EU6xu8kopNWe{E<1$tyBwnXRuOHUZR3#~z4N
zDI7s(V(9%PgRJ3H{9<3khubzN&%#{A2_Qu}!ap?L^D%<SUI8BRw$m4mKVGa&<3UEM
z+XE>31)s)4gp>fZH#5T&Sbh^mQ5LiNpj9z9?-sg0LiO;B($-q_rJm~HHKTGhU)=0;
zxC~zXYW>>wq0C#x%T<HIh~pNmdl2UdPnoOsu;XGh<(-fUjF3>pqwB9#B%|gx;RnKn
z!aC*d^nY}&y^$_22D=%<+9JDj>E-Ia_YL`kZ;abqhOjRYuMDgvX?UuM@-d5|ECEmy
z7Cr1Op=%2u{8&bD48o6<GgVel=%+p-q4hKWxj49py^5+#P;E!6k><9M_i-zzM7<}s
zj`1$nAbBa=@&9PFu*LQHCe$R6xyWuEgH>?lkryxh`X@$6IECy_u}bLcL)83^K0XK#
zGdY{7V15foF0Q1C67V(SPZLn_TT*!zC6rg1e|J0X2p>&Sx7RQ)4h_}Y#BTICX*8jW
z6;rX1@&Y=~7Eli`k@K@Su_7KQuBM3LkiOhYUg<1MUt3hV;2a?>+%XWB`!BJ#sq035
z?ghTaTr%}m{4(h?z@waCkkO%M82<4E&|+=$V${;EMo{H+<xm|8z5}9CrFOFfJ=2Vj
zRBv!IdGSv$J9V!JZDY9eZpox><D_@h9hWhbq)KhbSUvtTYq^8Fvs*%@;F`%zLxA~1
zRf?JJTYE8p8<8Y9D#86B)7!M@5-+|wNtS$n7E{0Q?js<gN%dCb&Zri}Msto((SJUD
zq-`5<Y{cyz?4r=M2jOBm@aTnw54KHCv5!uDzzBmiu>YQ%97KfnMjC6=P}UB*)9o4Y
zid1aC`grce@5&1#%S}~Wxq@=M2aiQ??ak)tE9W4|KDgoG@Jboy6#O{J&ri#*uaeDT
z2VjxUaaUY!{_(9awKcU=Eggy;8>#sW)tcTKd5F3Zp~%A5CAvsss5ItFX@#^{Y*dIn
zP6h)@&tAx03i98Y!T{5mdFIls)4P|hhnuc~?Zo%1i(FdHnMt9W$w|&GY-jkr8t5U%
zh)=aW;|`$9WBFMyaTG~`1^1Iq>6ULy7t84BGrpDFRmVbMdE?gcK=DY7!Y{<-EnY}p
zw7QM><gN9zpg<4KG3dVS^@lhp$>(fgNhC*be;Q{2cTjddH$<LFIVYV5__6MC3Xxgs
zSH4KYLw5cTk?n|Gkt4{RYq-#xMnZz!g;i$%KMs6>;a<V_=MX$3C;2<xKN8)$b6`II
zWft(BD0ixUh2<iA4(QrQwt20!H!^WqHNknkPwp3e;jD-UypUS3zppJS+!2e+6Qmi>
z!=AqQWd}idX|bFZ$HQbJ@baQ;*t-Uj9`8D)lsVytDVxb{BODFoXXrsc&pX3^*{;Pw
ziP-KDbaStVlr3Kd4~!k%iX;@T*763(JW#`kOg#J5Gm(=$BKnu$<NJA3{XFu5+mgv5
zw7wIxycC@M+I8wRyfw_cTtxDK(id;Nd~5JWFwhnzq0?)%pLU^TLPg|rz|mjL6=1Py
ze+IEX(tBvJ>T|Gc0muibph-1C{S93d7Cb+oN)EmS0eZo^wEkdoZ)dPM-|gRw#DNCR
z`_Ey7UfK;MU@@bIKwp^g_KJ4<&MGIe`0P_o0(3$?0`#YWS?@&o2eQ_Dui}%98^LcC
zSLV5ve>>R9bXPBiFuMFCZt*=xC3d~SPh4NvPS7?$z5*GSH(OH{1;$>(@GF7dtdTPV
zq7R-g*B$eJn;cCG?vjNzd!K75I0!lo<s?auS<iwPNp`Abz`BYc;nN8l)$I$KX#cgU
z3rAf)l1LuTP5Wy^|7LFty<YKex%09)>%<G?EVrY3`66>Yo4tNE+M;JPb}#Pq-aCg*
zaab4mng9CC`8OX@I~?zcpe`Ce0xdbaZ(tu9FYwIiOW@W5_=fdORQOHw@*Mmm2A+u!
z8QMb0@!Gk<Ctfc963|`@&wKwEMzHo`mpkp{^ovN2<0083G8@(SfWOvMI|umihj8@4
zGUVXdo-`w}!%_PL*_zEuH<YH@SC!&IvK!rA8@clmoTuFLW%l;s@A>oJi=1EY$E0g~
z!Zz*q=$^MC>rP_ct1(t;eOKp;&QH&Qgts>PWJuQ-d**{j7zMHpZ;7nK#;eAUfh}F2
zDAoSk`PY((IxNtKJ;u^6b<1xSdpsLFA8#zA$@1rEuW$MW|L3e?6zdDjDGB9g4R*a>
z2i$bKfs&}#!Zq7~?LWH1d*G)U4_dW66LCMBD-Y7e6ZVPc8qwQc$a`79YXnKvrLfg2
z`5yf-FweD}v&fc(jffTbsv{69qI_lOg=%}JsiE%WVawOXg>U_aY(N(OxV-NZJq!M$
z<Lh}|{3+tga<HY>fKWlx?Bg%PncEP_Q_fV?2cL_Y?dy~!TUwL8^&4ML3N#~Ej?S(T
zrp*A<CSR{qk2kcVlwcUy+h_QGaIYjjDXU>u4-=6b0cVo>w3x;oFen&Weo`!D#$}6S
z&JbE&6`g96H_81?Y%V6aq!L>G30l4ZTK*kcUNkwNr2gG9h{Ti?_4aOG%vA6N;B0TW
zDdyyV^t+41HQPVS0^8_*^PBf)n}K1k{kdXjVdE{kY8=zo&}<SHA7${|h~>qBqI$>M
za|ZsGd9d&9wnyQ#vvS+yZfER-V`Avb@0aZ`^9m3ul#`QJ9?t1=!~`ZPKU@p>ysalO
zzR(u9+Kcsg#@O-dj~I*SyAR9uU0_wy1L{>ESH+@4f?omG<?&BHd=KPbN2BE9Mdi$|
zNNKmH+lH*sf7k66*4+ar-;PE!d=2gtM?KqSoXbZp=I+)Dm;ad36F$mS?>629_1LFw
zn!9sENhabm5Pm`W>R;Odq}A<O?m(p%i7~I3ecm7rY`J9BHT5iqxdn>}@F(pz1@ith
z+{%OAMnxq0%lI>qt5a5TN@VQz8><UF0+LW$qRqvR_#P$t;kRO6x@SjdvHtLhce6lA
zRYYkN&<Z$slOzz%%3dn&mOhPa+v0pH%}Q?W{y4KAjr4v(<MY7)#h#bfSA4%oRK?3;
zX#7Al3z0o%QW-}7+9;5JT5UOCn;#Sg>VhsWeBO#VBS!W>qk6iP14^zt!PR6evqD4P
zqZWbE9hnw;Pdl&DVM<_M(*0&A*lao+3m;K&2MA1eYp$Lux3^MB#6_ZVNhJJMBDXJ%
z3w08Xk8}FwpL<79y=uf-30_>07}N0wk4W&E6|c~KiyXW)f{)NMp58kWDc6|=A1^-@
zUBV%Ew^uws6>r}`UN78d*e9|PsG}s3iNvg|EdP2E(llET+s!oV|5ffh_xy5v+#hgE
z*^g}ru9P{q7J2RTH`*+)8s(~puXG2_nno3OIbW-n`%R`ggsxRw_6b0nD82oOaI?vf
z-^I-R{hjCrES15ObWPRyKz<=U4(TqsboYz1^P%X4t#chy6r}z$zzf}@kKYF0DJ~~!
zev!Ht-SjR_as#?xfGz*BOKEptdw0u;EUYf^;TC_`@L3}N*Mfi8Bl{k0Q~||1&K2k2
ze4pl2ea7ii6x+061V8BJP5b!f$HUu?BZ>;5KdJKg4nHrYbY`SdXS<tuYYHAp3nKw@
zUOU!CUC8)%uVw5k&-kAoxb|ff`2rp`sJ^`NRcAclWsb07vQmu0h>3$X8TZ`gFec&b
z`-&r6gGaZuAm|{qASi-5GnS4@FX6SpX4mhcg?(W7Tz}a(?{&+|JVUlyPV5(}%F}gP
zS#Zd)z*NSKyXmxbFR8GqC#!UW2Wc1^(_md`Mk2<m8i+tDP-@g@G6zybdRB8-y?2#x
z*RWuiAfrFm6I}k)C297u#z4;>{f#xEcRtFP@mZ49R|wB-;quN%&lmOM-Tc*zcb~sS
zZ<pf{Gv9O{J;#3MBmZET$UX`*UAj1)STp_Jcn<{jZ$k$LfF1_LSX5tqSk9s0x6T9K
z+c%GUjecp5^vLK14x7IF42$5=4jB8rUG8%t^(rF0Ne7pR(jpc3l;*>({|=_C2L-!?
zgP+=q;MNjF4)w||m95_XjKAEtDC3V>|0+0YtYP&j?*g>BksbF3m*BytfIO$(J3sDG
zPFRO(^?E2aEcXmp69S>8*THXjKF*6Zyx$%TDZpP~C2>Hb_yvE)z)N{IG7=HQ+Ie>(
z6VJ^sMZ}Dfk-#X@d4&HYES%vSRGJi+)lV8HF8LhdN%-0OmhRn^Q982sF6u{=dDO0m
z`U6qqD9E3;&fcW#Xgb#KwNj8CPA~wqPpB4Q-$9J)8FZO-oP|ha>lw&2+yst&5f)ti
zCV{U*NOMoDz|GWO$K9(7=Pue;&OPWMOMLvvIAsP0aZ?rrrPxntymu8vsS<IP>9uOv
zM5Y*wzx&`db)T@}Uv~OEbQmdPrpjZ}%IDj1M9*-b`y4L(Vnz?;J3XDPV;^MOQqnrH
zdakPDcgI-5=<uZ`l#gx#nLFQ<0N}*M)i2<S(d6GnzYbl+f@Q}7^4=r=7om_%(i@v!
zqy%Gd%Q%crf#Im0LkjOsbWw~t*B{q0X?`D<;Hb1*y4Top{0#B+hi$kXTpKI`!7-6x
zl|=EMy!jT-Q`h%4!lg4_m$fkEGk+{PlX^LYhqpUT#LqU_VYfx_Y6#L_n4WhcFGH1_
z1N&N!OiJJX2vEIsxa7@f;#?-bd&NCS?axaE@;ZO(7Ci4&MS5R*8>M``{7mKv06tj5
z=a@zCA5JZZ@-S=bDorq!9e{J+JglMa$6?Mc+p=_N%<7bY@5S%8AJ>7y&0*X}nY=Z+
zI(Bu{bML&9Ge+!KwI8o;JkMj2ormPwEvQ~+rbVrbl9LWBscvhbvsncNin`8vG&T$5
z)xF$3<5+Ybi;>sA<Id&}$LGwD9U_Ah6bEhG-9&<f(8&|PZO#|^MZ$4H1(JRwR|tD0
zfr?DRx}!ZoLWvZ;D;}`K<DO`H6oU#<v=%Lwoz{K)^#RLqZ?OmM68PSyDVJ%55lkCo
z1s+d4Z>M3~{8;w6_|cb&cRlu&g~BglP9$vdUof0|xOW~*u+A5Ah%=8e)L7bzUaSiw
z$%Rw$!biHEThqLZ-8S4Jhy%|$vJreX61?Gy;IC8)UT@F3&ev9dyY*Qz)hmI7y_4L1
zEH0n(sD0uumCc`e*C~@;@V5cc8Khj@gaA+Uy`HEpj70G6R8r347ST5A>#T6xasXQ6
zDL>oi-=AJCf;(mj#(1HwI?51QRi258&%P5>9jQQCUT91|1oIXk3;p)@@G3MHA#A)F
zIEv;TsNYh|W;>;YBSD-a@Nz$QyAYmOCEg=PxnkR6tProe55G|V#YMS#rs_u$%$9;n
zf0gCufnV2hGg$5(C&hY>c|ke)sy?{P79;#O0L7&)5k_02&gx#MaKWRxqO0aNL7xHq
z>R<WHzN<)&p72M$YhMd8QEaQr@Z17}?~>gYlok2QKV^43`297<42tLH-sY48$9iV*
z_y!-E9UiE9&Es93Eb;5R5L$+fsUJ7}+tSRVTvX+qG~Rj4j?h~(gdJP14#|7h$53hh
zxNu{Azd+{f<u1us<xd^-8AOiCi^_nI7yB8<ghKQ9aM<%GH_S2!H@F#v{ytKWH21RA
zjz+5MXau&+5c=CSac@v9PKX(J2qw;RP@U*T^tl+(3|A%Z4SqZnZMSv-%2e>&zT@t#
z_qp-gEb})8{;2zVET*ae)-pAJEbiUQ6Xnxi1tdp%!xiJZVC`8A(l>%<Wes-zD3m_h
zrWGB@48W^@i2e<x7hWx-KdyaSOSk4$zQSLDxP!-Fvz#4p0qZi?YZuGy-^y3c`UwWf
z+-PqUWDDF*T@(5cupef%gnFHfQ7A%rr^QxvAIDUHb@p4IdBoc|*9-V`{!EwWi^*!?
z6Ya-IAN)R}^ljkyG?N$XT58!l#}4Mb9n%#!WF)>xyBPxKOyijzXM#D2Z*th|uKII0
zopt;{q_waQC_RxoTEf$dM_$T{0Gv9^##iMC3=x}fyj&&$k5r~W%@7rMK7MycDB8s7
z2OvExE%_5*WM8wLEE=PTDy+Jdx}2uGyv*=iY*!A4d_T)2EVGtoP$)mC=q@airp`#c
z!`&S9Q7<4QNh<;aV9Bw1$3PwshA~ekYYs`iAFYeXzK+O#pv#;ypJx++A)p{(6%vPW
z&8bXlFoz@fDuw`g%?d^C%z)d=uLl4o$vYcklZVkBAz8TY@Au*aC4yeGTs2t5t6|1h
zJ8l^F_t|kbo^Hm=$Hv%SJ+L|xBO%e$p$udob;#Z{U><pMAkX0nzi>hh9Ez``;}^1u
z7fiW9E~~&i??u08xs63dhmFb)OM!}|iGscDB$TF&T<xG<vlFj)bkbD2A~trQ#x3o3
zMx01?=B0!306|A0!jDYz#&RDIw4JQPWiO=aXP^yD7GXx9v$qX?iDUyBm8dRlis-6*
z9SMFBL{_l-6~5p*c4|pBOo#SZUSzeE2q)T?0NEYI=R#*j^PWwd%&V+&p9%30Ik;~`
z<v|%d@D-OXLk5$gl#pKnJ2eCPO(3A)M6uD0irh5ilryMtFrQah!D$cpX15f+@G$zI
z3EaeoX&@qjZa5ohpJRl;TMNEn6-tNlZI)8GrU~{%(GW?7w4NUwxjvwhf}}ekohVTD
znuN;N{{)<IQiPaE^j&43E&mj>{z9ZC!B&fRSZhR1%Svheb%>bS^*ZE~M@5BU38Ha$
zcK(2h?#qQcKYxf%fnJs-8Lb-(Xhy-LRYdAdSIp=jAv1T^ibHnP`Pza`&7p$%CVu4R
zU|(~gh`{oxdAH;jY{1+AP*nlt)u2|sUPP*I5^~%$GIVB{f^1l3Vb^Yz?6VC)p}Eiw
zdFtZzYS5|e$UfZ{0)-c@^yT#aAfD8@nNenQG_^HZF(cD>m~LM<GmOreX`y`4T)%0k
zNLdEpc>?*qoj?q1_YBO68cLr`k<I(JJ?zq4BI9@sW%yS;7}QsU4q?JTA+U*S8`i68
z!;!Kk;JD%l4@>QI$?S{{P(I6C3Gr$zurmg;AM{ALG<AeIg;Yod58b#J)TRw7LWIgE
zMYbPsxU`5d@m3Xlt<19XLP<7!m-#aU%lQaxIGY=Z4xOe@i*uq}*$nOn4~dFkzG&89
z6;PP;4dpZZ3Lmbs4qiC?hPiRGgi7v`G$RYgDfbR|0;P~h%18~Np*!Y6I4aT}{`8;(
zVY9B#cUz(&5p7`$W8rHb$Bq#E#DU5}I-xDmjOYkV7<3?<r6>mc?UzaEIi|vm1o{ml
zXQ4ozCM#6(rmX3#oxU>c_0qFHPssXj4u#z&?mw)^Uuc$MA0&5{Yb+avaf~x*XhjRT
zyajhs8j_|<zdMUYUC&6No>?KRs_bAQ@$*M@E=0AH%y)m<l>DdyAXa!MWTI5%Q7}Qm
zSBK<hP6_S`;CLk{gnG!A-wF71_tlTejJ_43PA5pvg~aSxDQN{A3y7{?QGSUNY?yFv
zMI89D5qlQFAkk}E%81Z0I;|4qu95=z)(%TYNiCMe=Nfa(d(XDiLc1)6nm69(pq%8s
zDDw1}QFFX`p_s`E*}`Qpb>+ux9`T7oVQ$f+G%ZM}bp|Fk<j&rj$oa)*oHO>IL<9Nn
zXJkH<*?ovtSD_u$f#7l^dfrn=N~It-MaaM<$P*i=guJXiPjX+dR@BuBLZJf#<SXJj
zC=UR9!&<t9rtI&@4P5Q46MQSTh4SY<nS*4?i)=7zB`@eZEDZAqnwODyK59@~YHAn+
zV0?@EJ|>cu{mNXBblG(iV8tKiN(0rK5P(bB8!BvuVJf0LZd^qs)ldA3<XoDEhBjD>
z4*0Eq>&6{vCrbUdMPk~}zMP$#$m?@F5#1v4$6r!B@&_0jzT_NF$sBg?>!6eRyQFfE
zE;VF~pVG8eZPokN5o5Vc*;Z}L#zZ1+iwPbY8d)kTTD$ICrFbYiKaMN!fR6@u35l;A
zDMBF1sYoJWo=*Xr?HEZbTNwNMRsBJfaY4Bx&i8)60rsF7U5I!8i&hQ(EH=oE*m^ki
zTltJW^2{$Vturbp9wq>@J6Zt8YxR4{Qa$fjfj1+>k<FR%ce#|#5DezZsqxR0v`<D#
z3F#YcbhdHn&TbHQZYFx<w0W@;<#zJ!JZg@kUkyvC>4(`53^=S7FVqe8%6;9l(?>lL
zRRDla=h0b_YJabWwwcA0)ygi}F?ncYkCDj?)!2iPxX5OIlkYD^^rYN47JY0lQO4t}
zWnz6uic1XyuU`0D@kj?<RNV~F-nC{oWp-o6>6D)Q^5elKWci`ZJ=n0Rlut?T_3}wS
zKTnWvDbTCs6BDG6(K?~S+99mmcowbeA@+%|^H7N^lIY>5)aN;bEW3^ZVuMoHa3%cd
zJBqCc!M`Nr2Jll=|ETTwDZ-Y3{-mrQiA)Pd4%DHC(da2R8;f~8hhs6@RSOdrQ@=Ec
zTP%mQ)uaI0MuJIt`7j+I*1OXfo2gtcFuT&b`w-Z|pb?Mw*L9u%C^)IJw{h-)fkjB$
zIaIW~O^7<oPcLhiy19QApORF<Z)8i;t@us#eo!km0gbugHq=#iZcb8j+5247LIX~h
z=0aD-srQ37T92UHHpVb6yAG0msg{dXyd<SCk~CD6V(>tyE2>0RrxBK1!ed$_jkkzp
z;i0}udh7%mqqg@Uz&@Y@`u!=tPTV{Eu7dWgux2>(vM3F5YLHc&zG|^VyrMl?>5(@`
zA%ZktUk<Rz02JHTw?sqPMV1#NBm)x2oOP%C9W0p8kL7odM#K|hWP@jTnkAexAzBsh
zE2pn;;R0$5A^C~F!M}+nwecQ*ryuPv;G>Z=epEr^Yk&hqQ;1gOR+}KNwRopk)#py;
z!dSa6QvBYP1gQP`11XvaRozC^?;@WKf$%3inoWSxU=EEpFgbqHl#~tRL1~05+q`dx
z)|>Bi{QNyOvJNog>A%SoUMGBj67YuFhhpE=%QLoPZ}70(+yW{kM~}mePT?a~k7}UG
z=Oeb0lD|-#CexY2<_^;v>za3yC!x<1&DI-hcljevrmn3_J5<6Kz*0%pP>c((Xyj|j
z#s-jnJxuv(q1TZPlX8Hjz!1%LOt44MM!*B889Z)JcA(a2$akQg3EPxm81+aKjE?16
zbfEFrk17pb_(6)kDstsACr2~2t(raBP#;<XtBDh}BB!(Z0MJPhxq_XGX&|Ci8L2A4
zX^8heyG-&dX)6Y!?YaAjt^MAV35W}f%<VUwAsdSQK_I`d_ErMOt#}P{Pf>aLJSW99
zPAW&cy8oK&jy1ApDo=}O@@rN`gXg=b9aYNg*PlOlmC$|=7^LBedo0x9gOVndJhX_o
zvcLRo=R)382+`E2$nhg&kLrw?XV2`E3y^2=NG^`1w4-{Xu|rv$bxJAIr1nt|&R`hh
zoWPs^voE;$am&lUUn^6DcDf@B<TE`##g}{wE!Sjx^Bap_P}$CriOx$ALuaPpzjBjj
zx2wxiJi~S^Cr>QjR{mgWJb4$@#-3#>BK*p{b8+W}&uk2oNLfV0(x^Bq(-_81qiMge
zr)l>{6Utw_z749pK?yIYh@yjjYwYVNi0j}i9D66ORnA|*?s+v69D9EMQyshT|B!SI
z;E_DR{(rg4<zibG+xErD#<p$yf{Trf&5do_wsEnwG4Jhr@B6A%(^J!3-7~#CwNpR&
zYnc>g%tduNR!mnb+aC?d8KRSu>Ib!$zA5uI$yk)p+=N=PgucuEIQ#kIb!0fmuPi1J
zX?3n>bBH)m8L(Fi(p8OrcnJ?>>D+izSVqbg>N2cEr#bgrZH@nHVc~QhtdBX(%QqHS
zkd{>49`m&FHv75{ilW6&Q|C3C$G+z_<_sODe4+43-@pHi#ww24PQHa(kXQ-LHI7{%
zdC6rNu@WBQDUQ8bkXqeeWK-^2#})FS&K!A;ka*<YN<$rh;77?34q~y&OLFRr+8Shy
zU>Ro9npTf9n(yP5n9%C{%29SOj$~#MPaA=9_5@(^g>VzD)T)eLU_O|_jp=)T^~oZt
z+MZ59EiqwaI751HV$Jh0!=NF}KWCLfwek>8pfT-)ZvB$$HEKZwP7nJ%E;WqTTNv@S
zMhgBrukD>hq(NXvcM{lW5>BOwm|f}_RYfX4GGfc2lKckUfwqOYi0Si1iPDLsCit5S
z?a7Ym9FX^jaLrNrYobvuot5DQ2M6%`k)d~tsX(zinG<hL5<BztAyLw1c+&S_)Td-I
z(GsS1>bY4j8C;}IsFl&dk%~5n?+3GkovN6F9Bv&wN&y`e#S4py(?j%#EKUrQcGk#t
zX8Pq&gW5A$@^X9YX_b!nE5kS@b_9wSy6~@7rdhE@y69{iV4RBl=5?j4&}us3Ar97v
zg#A{^qtE1_aFsTGNP4Kt*FaYU<Qt%u(&_U`Z{fy1HXBa0{o5%kL-KR*#H;|e)nRh8
z*Nrs@+jf`wjolxes#f7nhZ}JVQ+dV<_k5F&hpABa=D%Yz5tS!r{iBb1^XZ}AdhYRG
zrMvt8eELsnpBhcQWradd^ENxm!C;T^5*j$&(l=_TyKZR3ixRzQgLN8{vNBW^DlaNR
zuek}&U9<LGZKpGGQE6(7wl!&P_!K(;T0Y@_9Ddrn2skB<<_8pzWH5;Xh&uRA8O|sN
z4zaf7)Z2kC{9vFv`<gV8R=pQj8;L9THRW|E(y`tkk<w_#sP@-JJ>r*3@}<fJmW1oP
zFuD?OvaN=Vdr2MSv$2gd*6pEB+jZ&9i;`lmclG7d(mlNk`T;5Jv8x|?W7p&gA?9~P
zkKv${CqqrHH7>rG)(9JY0jr;fEcnmgf#_e$nvklf7=gqMAs&f?X_+ro<SfN0?NSG>
zc|!coFgv5Mh+ARL{MSb3Y7c`0;AEydqLif0=^*ljQTzH;2XqrNh2r0%Ew$vJpdGo-
zJuaa38rFbRdyp;oEw+K}8n64nBVM})f0fX*f=J|x_8K|7VJq}Flr`>O81kIt?@Ngi
zq<S5>jdNibJ9mip`FT;D*{`T=jmh>ai;0|r>e}&_RCc1apo+kzc}_9DDtNd=Z><tC
zne~X%`})klVnEl$9CSkw;YCGyva%&?;V6IQmb>@*58loycMNO^_YnGo=6Rbt4VgGH
z?~^l@6+rSTCmfn3GBj+XE#8=(Np&h5@Qv*%0m2(`1rnU<TjBd^-!?8z7gY&RHnG{f
zZ^w(o-TYx!o`=AF-6JfdxT?3qY*_U6$UMczkd;=(T#c)b^R9l=3z&>%h``;T;OpX(
zVrp18>Sae$2sGxrVMMcvO<F6n^6Q+Gm!uB{epsO<or3ezS-I9Y+)5|q=FOvlZDT30
z4W`K#3`-Mc$+kXjRh2-Fu%)q#h=n@IW!d$Lr?HH&;NW93pV8E&nz0ON>qVb>0aK09
z71ox)(`VskwLRB&dK=0XSx{i+Ccdr$VC?g+cR?XvG0itFE!%1;H?&d%H(>S`qBF`h
z*w21p**3}fbXzn$a+^C~uoSPwrt3O&I-}wqB?k+iG@F;ZSNp7N4nCi(CD68lkcM5_
zwuvkxNR!c?l$b}U7O<V8#n?KAehVKgQE${KV@V!57r;~alo({XbaozGs7d_AWXvg|
zx?J8f`K0_2UUIIRci?wP1xT{azhxnJxQCowx)^T<b+ZWm7)J<0_d?Bv_Zzm)bp}%i
z(wL3SnRH1J!>&$#7k*F198GHkPe^Kqbh#ImQ{w&{!0YQ;5!BdD4b+%F$AG~VrAz_W
z4b;;TLf58TWL;6D$)q#aAG|Y47ula(LoW|v1HK$&!qvO8k$-t<8xE;hRs!n6_Ydt^
z$JphrDE$UVF!C}Hh?E&U5=Kc5ow=0g^?o}1#E$wS2y+g07*b3XqW}IxHKg<Wos|dE
zkD=F~q}YB}Pb^)L!r>=0*-s{PXV12%N?awf9f06uO|k<8ouqBN14YcfJ&+41GuJXE
zBW=d*$esL^pdiX)EZ@yr(+|$f4~^nCkRRly?FW?A@|N<8{9WP$Y0S?%N^tg-ofrDt
zT+1PqwDs8=IPpN1=NZ8O+OK=E3IwAxBWz4O0e#hmYcR3jCRxG?hyAwUoZLUnL-+-b
z@97bttAF}~V<b4OV052bhhb_T%7s;mMI#}z%8>=UDIM9cdbH8zaZIng+Ex>SCl1|0
zVozT6>tFI_=#UL21mjTa?_OYy(tn43A=&sDslvJ!7Dtj8$ppC?3bbtkGyxtGLLkSw
z@_ZOfdo1NW^Fjnk40|ls;i)SIKRqX+4Y<-czKGr}b=@H455?WRL7ds(v2=g6)wcFl
zVvOW0(x#l%whColOiW!vB&Bv92bL0uTS`OS4b-ahxh@PxD}VqG84u={I!WAv@v5xl
zlak8)N)m0eugk(*S{yvOr<CGGc_aZuNaG+qC~8NlLrSx+$F8Q-&{qNcI%@$~36j8C
zzd$frd#2*oOlDR1cAeR+U(PEt%22$hD>Pe0e$;<Qaa*YA)^f|QH2{`|(`@5xo49K(
z0H)B(gFKCgM`Jt)_}Zg$&7?e8k_WH8DjfeT2fs9T{^AYsVR!x_i2&NE{#Eb%(&B`G
z%1!nBL`><Y6z<GF{@3XFaRutmyhbn;K>*BmJ!NkmdrCF0Ha_@wRei>MURAT>Ly^ky
zapZ~GipuwmAh4RcpUE7x8rw^^EB_w58imCuA6=8nq-$3{!(4O#nv%F)RiOHnL_z-D
z9cP)Vt2^mmk~Pj`9pyy*l66`w4gHe&IR?=y#nY4B^6!ITs=VIQ%^GT>LV5P;OVWnX
zvyj;!saloxL`e_Lcg*$VrbYper`(r1^{fd^9d6%j>zH>!`7|^Vk=*I;+O9d)Q%po^
zf7pz3CQb3y*sN$vxzVUHXkI_xn5ao1KSEH4;??}q{?O2MK{lt9h!O)}+f*S|VLBFV
z1Bq=0DeHh9yv-5G{Lgg&BI!!(7H9bpk1VzN@^_><VP|VI;H*?^$tFXy^VE9SpnJ8}
zTbgFyOztLqvs9iLU6O5u9)&vinvsthVCgxnOPkLGl0>B#N}%_3=TUr&@t3nb&P%pG
zMw;=_u|2kS7DA~4I)%4DN{s-{!ECH5psu&}<~SdrL6nYH^I4W<DnCnH>6ed1otF}<
zqzSqg9~Gnm_JSq%t7PXc(s+AKTNN1P5|cC(sr)7(DJU1`rOQnd$O`C=#NFbeNc`tc
z>OuYU7klH(o#YMJy;|)p%`#b6$SQE17S()8S%+d{cuIxqMm`L^PJ3%~Csnt?{&1q7
zzcKkA?=7Vp-3~vFqvt$XW3mDIQNFq~cPPai{xg7cTVJ6Pt+p8QG+*~t9#a_G$!`WA
zi8=hOLgVU^u}iKb*v{J?|Jp3&rwmyJy9Zz5*X6poc1SpH;&Yhc7?N>Oojo+SdMB{D
zOYIM+raoo2rgzSd^AX>V){d7DJGCaBIl!jPe?3BljOSjmce9Za4JiC8IJaj84!?Jm
zLi8squ-P(<ot%BJRcR2>+a+iepDSsMjC*#RaM2VkmUVHw8z>W3r@wugwx1eq!rQAU
z0#Yni<rVY+5hv@9mOtEqJs7&C;{bj2VDPoX_FqX5%stAZ=pm92t*=wLIsml)@bs*7
zx>mX6r~fH-K;{>LA<^-Fp_DBGV|YCR!#h$8u8TRD(zNB->*Zx==7l4^LS2-v8P|vU
z>5QQ>)u4+#2E#>ECGG{&#pBrT;MmxH^kW#g=$>Wc7iT8#$EIn+DVGozY$VW%y^&kI
zaBdE*0gFYuu+X0@h-1xluAWuy3t?`z;#c)}8I`eZl`ioG*<joUJiez($UP;#&9x1p
z8DeK=MlQWxIk9w6L*HA#<7(qOsxAIA*{lB<$`L=!w5MRXStNrlJI7qJM~wLK23YvM
zEmxhfUhRZF5Iw`5d=Yx)l3@<yebA6&E6bq0bD$h39)G{gGNHXU+nJhsO9enQ@1MVT
zD)lszD5BLm=6TWaQH*%Ulq8Z}zi=HW@q!KLQ>RG|%t-}!q;cN3+nWPQjOls?8WUGf
z7w@G%5eL=z#&+bo!}*8R>yJs}>g=5vf5RJ$ePZ!!?TGtDWt}4zvX%5?22|;cl^4X;
zf#%1_;SFdBvsCvD7znc(mv^R<DeZ1Nr1J$ljLPxG=ql`QnUY0HtI%+ka(3<I?w&i+
zVn}Kn@!IFSb9++XoKK1TnVtY&45c3g{rQ+=eoya=BP;wK+8Gx*_|LZ2-3Pqc^4_Iu
z(nsUZl&bat>dB5v%)V;@yW?UT9wtT&{>OBUfCNV^^6@R2LcCPw|H+<a6-T^ON!>4I
z08KHJLSN!;QT&U#-*0cLU$}Z2`nZONI}>`iwQ6VK8z{_i&Q4F?CPj1aP99{&*~J^#
zcw#iizAB0SXnp$TNp5A6i$G1WlivHu)7qZnNgiew1_hADU-aHqU&T`t2ThE#tKC<w
zqAH57B>%%u9PLS+_*PxSOk|)y97l+yIm)*;3|%dmdv5g(WSx?LbMeM^A~J_NvM1Za
zXs`Y)pQqDay@{(y)l{Q{rTI%pxdzS^y>vzYbEVSlPehu0ufP|@SdVb^?#7e#Ura&@
zJ&d!FoK<R2c*e;AZq~^G;&3TT4}T2pmSMCh44vA>wwF4-(rNW#Njtg=)GZM1<A1FJ
z)^NOig}$<x>idQG)O4ho*V|;Z{mT~FwZVr>P?8_tlPn}5DoU3v`<ohggUTiluSh;j
zuoT$CPD)!U4Cfou8-o-957h|M79pyyP<nsuWfFu3y4<Jw-iD*nJNYy1>zHvsJ#(qF
zwzU?z>ePi^H-pqb4?aS(FawOIu_;^0F18a@5}mZzD4{T2#J^YXd2%=2EBJL`2I;@U
z>2Qlnl&9gNqQZ9bcG4q(>qUV(_>g=)*$%vQV!Q1QOjG`h`zh+gj4<PHk9P4^L=~Xp
z-lt2tBeQx6zhLR6tqEEiu}3Cg^&=G1(qln|F3hrP-uDa9I!z4hy<!bJqi^&hg3EM`
zm``YaM!Gg4aivz?mS}dYwjEnanS?t#>Th|O)#8{W>1?Gzy6moJ`6~G%S9VMI7qXPD
z@EMzm^uJA)>jLbamt5L4kl3qAqn%D2_afPzFdK({R6m`Qca@GICL5Q4=}qbqPEcxT
zofT2a#K$r7{z}W^dyDi4HxYt;qJ*puYpXOb$(iB}0O|qbNZtU!9{4KRL$pci#w&<q
zpOgc5WoZ@X9oAI9139Gk3h>wFG)m=fStflSddJ%&or+KnWd{&5e({bU8*U=8F8!*r
z-YW7Bg)lqz^3v6%u~>zd9mJleawc_){ADrB6=0B_f(E3@Z0*O~r1_B2Lz$=EQhT*=
z3^SFwn2Z-mU)V)BjqgqSK}{zTJ3r*NAwp{w_2C|>`6B9P*s}&l3|9x<;mr`iOXIsA
z5z##uJo6AOy{{_E4OTpbs!P$PSdG0cFJ%(>uLrU0V23LQ*$dN#Ah}sB&|asa-wp4K
z2%{n>y#+&$qrog(Z$*p<fw-`6Uisr&wi<Y_vqhZmX(J0QTW`-*^<>jBYW)<hPQoJf
zH(}SGCvdK;UJYIUcGVA`78(o*UaC5Y+(A6M0cW8#4wcBBb(Ro!@2Pn^UcTgFp@Ig0
z$O`*uC6Ev1nmqaUNk)kqqgLM;S$iS3%x?^fh&W&ayuo~Sf&7SMyUP7d5?lMiiJ+X(
z@-2Ia)=1$uTL=7Re2X-<!=6+A`Ub70d-jku1PJh#mv%Mzthu+B4b3PCNUWe_zQN1e
zmqfH!{6v7Ygbbhn%Cw+7Eo1kPZ`T)f$o`Mb)4Q+Q0oeAHzfn4rBdTS3dah+WD|YTx
z9al%KK!{NX<<}VQSo1o?D;t{5C7N&M1>QcMZ^h(EE0$A3x7zndg$jg=0;Kev;LQ5~
zpL;^ql6^Jbu;{ASZ?`tSVHeU~7^m@F+}jl}@8UZoHn=09?xXtbW1@VfyDS;ANNd>e
zA|iaIWiov;l_9ellt^Lv+)mH(%45@1e9~dE_MhU{lnxBxh;9j>@>NLn1t;lzLe`l;
zWGQkv?Mx!LyR5c+hWJ#)n#t2NjCIB!@R`^}d^)8patOvWVo2i@B1mM#mS++n)5&}_
znr*;53%9txB{3x!4k~sJx}=bDk<Q1#$*xr6F@!GC)69Xs8gc1|Bzg_}(vM@Hb(w^x
zs+LSweZj$0J{}2KMNWXfV+~yo59B0$Jn>&L4u~OM`EhGfyUj)&qI#3d!6Tyk&~DTD
zia1eS0iL9bTTQP6Y@+g^>fo6L662_gt|8(OZ3^aP%LHG((+NeXUF3ZAzS9$gr61Qt
zY({vymrAm$PM^tY^|hYD)!%XyY&eYU!M^U6X_=MOQt&~wCjCEcoixe3td<&?v0qHx
z#WiVOthWo8!$EK#l_Ek-Mk6m>>K>YjlZCglo<<YzqWM+zi7A==+GhC_nPN4zJq;<%
zqgM;tSj)6Qc)}sQS$an1jR)}1CHsGBjguNQ)Khe2jJhoq(lnZ_rW1|ywT2;+5lL(H
zjEtA7<JSh-_h;u-t#-PD#9F|b!FxAcMN*%xaZWAQ-9{~dNJ7CLoDRx4fXz3yNQ(-N
zWGAR4rB`@14`wG|X6}rYUzP|XJ{HPM#vx*&mzn(G@RKd5eqhVgeD=n%c5OIh<(Apl
z8TK0gIHUu*#6;SYFt!9-v|+sxb}VhzbUq-AmpK3rGDOD$_>lX{wCZT0?817$%8zvI
z{sh4coPR6Xzr7LZ;|8bSh~zs@!|ztrLmxgADXtQFh-pysH}54w_-s#Aj;a6EwT7Id
z3&EAlo4jHtkBqg0XZpK-58SZr&bIpzBUM$9Lus!B{6PFSxQ7m45;Ci#5efRplkg^`
z=7C~n>z@$f;)mIS4mTlVpHI1wM#VcVt;9vGrM>ky#fA8`x+CqJ#NS;1!Nk^lkn#hu
zhv#@ZT%P8*hp&I4FjPk28;7K2(e<&Jgk=$PVLjS01IPRfYoQd8jD}ED9dS%4DLz(D
zU{)9`^M-%)11maUJ8o8LZt9=qJ9R&qY~&|@zntxyAx{rbMS;IR&9Y%Ls7YG-v24az
z_n3^o{?@zellsdWjHAM@uRPV~(T<4*^=0|Mt+K+<@8BeP>rzvEH|roYU#Kfs?wuxi
z$;^cUM7)eFEIV#So=l*jB}TdWGBq9xBa=bZD5tJSuD+ky18R0^57#9Qol#coSg1rj
zho=y%sbLOn0@Qa_d`WsXskH0V8WvCT9i|;iX14P3H$-#Y9%i-~+14GD<*sJ1@r@ta
z@b8{?7EzqL2k<e11!N7S3uQJRym>+}LQr|v5XB+Gbzepq-sFSZJUkI>dY2R>ovsc5
zNyY$3rw?Kx5bmKkzk7e-I;~qajy9}X8lCw852BH%Vb-!{3-k$}n^0wKlVCz;voBW~
z=%CD2^iD_KKgQ{rtOte+%bOnrHc4ozY1!Pfnz_`libU)f7TF?)T@H)E2`K#>&WyRm
zA_4tJBTk(Ql_ZM_DE^N^B^XF!k_Vj`22B4yDiaw~&6h1#q%=bqErK&s4q+`5N&kP2
z8g*jwmeqe_)OD%4aWq<Sx3o@-PGrNas3x1?EZhG_SB9!;`uj-lOQHnm#8iB@D}>>J
z@0Kk1G^4vKTdg^*nJ?t@%+6d3G+g3W<^)kNl4l3<l12yiM`C7lOJha|^_g1dSr~1Z
zu=>iVZDBl_EhNfR1{&QI%JDMl^$8ug5iX2dqgk5W0?uR*?S_sr!@X>cM&oP~tjX)g
z@?f<k7)2VyEY8AQ<Vx6^UJ*Ws7lkg%{`XXNxIu=W-s{PsAxpbABaW50u9lq;12nlM
zFHeis<qyV4)G_{Vq=p~cDwViSs_?=&ZGx84qiSC4aLk~h@f<(B(5V*b8FdfD%>m=a
z7FE{o^-0@^iH|FqBnYQ|udfOvA;G~S9Jxw8+pDPue|L(fiT=&jcst8<AMWs4b*<HU
zm?#4cRG8CGFj%KF1l|apj5teL7sVz~mlTdu$A|tr#^HERhowrAL#POku{LHLTuj6=
z*K7-GHjHRwo~i!t$sr=MP&@4j-67iAIC#~2evm$T6BV?3t&Lzrk>DYjJWi3&QK$}N
zvUw8YU^yp!lH_2a3(;O5)TJPZD31?g@~0^m=@vlSL`-lHQyZNy=XAjYOBQpv7+Lb1
zpB$iGOL~Ril6~T-k@V<oPjax_LG}o8lclRng&Aps33|`Is%5{m)^{K!yLMzLvVCHn
z*gLSpDXxl(hVO{mZV*BxJh9jZ|7bvnIayS;cVbMm+jj4|mAPWknEcGkK#ktH91Z+J
zxa4>DO8AE<3K&G!F$cBbj7{*=91Ug5?-S~dGI@PP*3AQ9A-6oA;wtBoeQe*t_l>4R
zSq3SGzFIeMYTIrx?~CS|W1{5a-lB7&q<VbSijS$`L)*bb(w(gR3(5v<q7Ko~3hpj&
zM?=*HYSY|#B9-Qv6&9_=sHIFkhYniM3N;|r`M>OlfQ7*Sc1AR5K?8E`wD?cKV-tc+
zc|!+gdcsU;7p`_oPKlB!5a}DIS%Dt1?ytUcxQW?}mEDH*3l>55tk@q6mjz=Xmkbx~
zo=RT2SFVaK&<qH`^sdSHEJGI#HhLI|KxD@{bIVjkmt{;#I?L>zY{X`U!wBj=FzIxb
zuEq&%v05DM>347=^Tiom{XSL=lOu-|!U>cb*Ex|P=Ga$JwF_Kd`4>fNGCI~T5*(y9
zY#&E+<2LP==WJaXzYlNmO)|H<2k@X?9*b?#0mJDCF)_}3NUJHDSQMtbH#b9hXBqun
z@4vWo5Lg5p?jCMT5rQAQ%re-(O6A8>`d(#+W(^uhCZaW+gW%>hI;Qcr*^A@>?iQ6R
z*WdQbG~_SGlYz!Mm*Ne1wM+W!HsSpou~Dk760o{O#+Qb@b6<2_JNE|0sFH3Y|MsJg
zOAUqe8M9YDM9ry@lakZFs(n8q4gliWsqt%a@~@Y#+E7O`s=c=wn!A?mDgOnZC=Z>l
zbIc_~PP^h`*Mw`%h})c`gDVQ%?&a@7EeWgG9KvH&T@gYJR6bfy;D$`bIIER+T{j8z
z@;ynxu_q9y<Z5m0vQ<nlR^|wOk`RiW1u5kU^+mL?b9%Azu0<4Sa%B1D2#Z<`PA`!s
zZ+nJQQ74ApR3)7dZdE=uykK0ldB&whAswb7nf6*nXKtZhBpH^SERo4#*id8rKy+~$
zzj+!98Ku6HI^yXI<1=c;2sb*bv9^=iO3XQYwLMY_1hH1=$Up&NqflX(GSQYbG1gvl
zYIatk%bZBc1gA~WMVaJ@(?+e8*D_T{TA5LhJ`1VVF`8Exiw!ohc*#cJhNh`E_bMuY
z)1*WBO!|LJiVVaC8U;$;j;{Nd@JAkFXD4&gR3_5YjSnPsd>wFPV2wk}=n*Pb0#~l0
zEl_*O*+$S%mPH7~i|l3}u+J9+u#ccSash}i7DlDbO_vZWC6!o?4%1X7Lx+fmvjPP$
zA);RkYK-wPFS4#p)-lV=;aM)>7TFJGOGoKDa9lF}ti?$Tb+d|Jtl2-wnPHpYVTJ)9
z2Ik1o_u19Et@}N#d`Ka^Z)DXSnxc2%R4Uv~HF#1w%1)JESxbQzqrALw6)752$d@8F
z#8a2r&f|&ZY>baNWBw(#(5%=0s&aPKeJGV~c*Gl%!)w8~D-s`@$D}LrT3u}<$M}=;
zVttizPu|`TAg$&skUx&-G^NYoGVrsbT4h&DhmejsPP2K~I_aspi%h-5mDhd5I%yT2
zE>1JU*bOkPZqGXukX@$I-TtUZ-?-uN4R*Y3jcEjKTypWUF3{Nx_l92n#ilYAtE7_{
zlZJrMopE`HJv`MI`jDrJol&`zpg1nEw$?%dVwA&m3S=c^7n&w3!&NQj84?S|82&R!
z=oDB_SxR56=TzF55?ZJ7!8I7N+nw-hk)6$$^xTzwFeJZ282nz^<@DzwPVH@fb2X!_
zt_k8eQ>8qs-TDWO+A>cV3g49)O44pMnNvc4)4+BtdQwiWiWBDen}r{)Mm|9mv?`T9
zu}1!+nCp4~FhG<2$800cNlv=ZkQ%kc>VKlBFvzbo@`}}2UM$rjUNlxpnjx&TxQb1l
zN@;oT{fF2N8ur@NaV>P&oWB<KN<BN2vk}tL2`~-v3Ccfcrem#YO}uH79g?*7pbr}s
z7WOLY#Ojss)~FHjj|A}NLcN#_<1_(#QJN(tR=>Z@!)w;o!_EFnVm!_NFp+p0iB^|G
zeRG~{x?LK_GMDMpYcuy^Xri-NwYK75^BOcTv8yy2oVw+F%z9|{WP|s4L|cPe*}64f
z-iK;2))SC6ouLeR>sn{8S37m(M==OxNim8hI!uyQ81_k$AK88OqQB5|q05eK*@Ffx
z%n|LBIr4VLI1Fxb(Dcn$^ea{YO7>Tt-Nntd+REfkT^+H6d8z<Ls7c7Ju2{k^=|U$|
ztLb!FI9#yffrm7ZgJkR@#u^e7qNM?i&MIUZKVzFzY0Xrk7y`i@$LvvhW!k#-Xi4m@
z`QnA0t;OT@Fgmu`^}@O)r;5!KdKRz)w~Iu!4A5rtY3B_1N??2zgL9S;eAJb~185N4
zhyH|j(h`JXPVOY`$*2`zt{PU8Q-R}h?(}BDUY-mmMuwxpQF#O{?-VjbZvwuYB8o)B
z-t&9L&DEca&XMUHC!J<6NA@sp3+3m*gcqn53|oC7)m?y+Ai4ikDHSn?13e{9T`kes
zPqt&Mwqt14)|w=LI8haQA+IHLMa<0+uED}W`NRv+fy$$7SkX$)QdT#E*~Y)uQSU~x
z+C%>hjQ1{30-ejCvC|Hug}~x19UHreaNK>=bHFZ5j!fuBF3$;=SD7QfCA=;}&P$;C
zNwLEOAp1F>L28I)miAYTGaQ*xQSGL`3s(Pd<MXe@3EYi~pDSKO5rrs5pah5IpbA82
z>K!tL7+f6U2HjHWC+EMzZ!xqz_lhE&aA35Wa;+O}kxpy2y$k3X3Qe_%plv{Hc@EtZ
zrKZ|B`m<QYS^PwrrJ5W<taM|!yAB$9rq;=qOf4M5KYaA<=|f5lXP;{WXdLB{;uH~i
zur)YH^|cDhh4Zo=ltdxfG6=!19rtQj-nklDqfruSM;>|w5)T8V?P4)!o28**G3BCf
zt`N@MyJ!U7QvE$PL{Lpr4VASjxRSj<>0{`hVxWXujZkogZiYnZSxc}soU<Que#TnQ
z<JMpz&V;o4z@7v8hVVc1GPqZjay<JlT79vV4;SljUdl8n4$y!?k%#GdR=E%WwqIg<
zj2F+w@F9!VZblL35&yge0@H$O!9V4tHCH|5Lem1x;xctN630^YH8z1p?WKI$1q=wv
zq-$a$Sl6`hV4$B>j;O%_#4;8mxK-Xzu@BrVH!0i$(k9?vRQX0(GiUQD{qrdJ%oVBP
zTWZ>eS3&Z6323CrRc2~ruU9BrNCc=^NFd6Wi`i;0>StyymRV*Qq+x{8!Ml}XAE}b}
z*{|L@$BmzArW_~<@Vu0h$DQ3Iodfx4Yj661e~3mBz<!HXSo9KvRl0}L;8F=DU-q%W
zaeZr}Gu4$8cB-Ya@r785rLy@42l76Cq3Gmo<^j!9#Jg2$LIHCk{6oyM72m9Hzty3k
zwln_Ql&8ub(#;woSSow00#bO;x=$hiuvW{5xSZU|qYs(BbCu>@wg+=up}q3Q<ukfH
zD3(79OZR(KdLWjMlQ7Y8EDDecv<WwH)T(y?TO|?X>=m<deWUFZ?X+$^U4!7P2fdPx
zy^>14dALhE_6V2stMHMmjngqKBqpPsD9qH?PMp)jHxycEr4b5D^k1B4VVO(L)ElBg
z1M*golK$GuF8w`i8dG0_xx1FSQsw7z@o-N2cEQ!FiAMPaze6P<y<Q0S#<CvQze=Tx
z|8?s?LM`HO;Xq>P_io1l<q~?-3_wS9M1_emOxo~>Ulxk(*a)q5Qb!G+!2)CsTQo)g
zhuxL-Kv@u^a%<Ma3z9o@JyGGsB$@XHQvcyys{Y1ct;kJCLqo`&a~9unXjar%_}E<G
zE;l1>rLiXa`s}Wz^<0{Sq?Yh6I0<Q~xfYy+w5Xty`dc-Q0-1!cyy_8_MzwORLhe*C
zTgOoa&~es$>QU5KfhOCuSop(vJ9|E_bkth*RP`IZH$O<lY38>Zpk(jYq6$sb_{h7#
zF**e^(|Q4|rW-SbGI%1MjK(4jmyA^^(|RmPLuFkxtfVt}zPNnUTL>iga5}ENUMA)4
zmo;C`k9o(tQ^uVqPZk5PE~oM$En-j*(~-9#y!8U)JTt!VfTX=1_Slu_Y310Pq`iDA
zA+eU_m+`@0y%c{QilkwUqK0l07t4nBlBA8wK%`P-Dl8*HF^#1uA;X|%I(u3=E;m}v
zN;!o~Ra+u889K2NGO8w#PQiz-$|P5SF2iyZ{9~~MxZ5_}UW06ShV01cB@<=3L0l(_
zGR(b&Hk5KBq`!n^lCH@G3%8caC3|6wT4mXhI@Vcb*_H|Fv^zh9(h3TXQ&)=IX;Yp%
zl=(2#qKfOYBOxGpko?Mv1LV58dJFLx41Z7+OGu|4WUaH$m|XM$RVX#mAp~Zc)-;CS
zt&}+0y5%vGa*+gbX{r5j#&vX5J!0pzHZT)j9*Q&%UCA{s3l<Wr>@+UuDnJb7@YSfx
z)^n#gCL#Rt4eeqjCe2M!P!H8V&ZWMb{X#YV^UYefqrg*L;8gLW>YcViGE2uLafwmn
z+z6Y3#HvU;3l&?ud}zhy7i-N*0K2=X4La>0@^Ep2F=pe;P&rqsIBJJfRPVn5NUxWS
z7qYaq8Bz|v5T$+Xxk7PhSs&t){AwXNZcun(e6(Hxyx6<P%R69tl{-cw_9#Y8eIA^r
z-a~s@|Ec<(!ETK0k)QjPvSZg2Rn~?~xjIz52vg~vFeeCMfYl@`AzgttXp--Hy+X@X
z_BVHnFobO#;sf8`+B=Oo{}RH_n{wSg!+OH&`_LJ!QE%~d$)}%Us5g-SwGQQKob6xk
zp$PS`ccgWxrXHcmwS_ja!rlv-q1AdF8PV;c1vxWB%XE%>Z})Xd3prJN$MKc~l!)NE
zO9G+*xSZToYOcKCd0thf!{idHliDm3+lmuLgQVrqd(PV%49B3xjlm0$%);iLoLBsj
z+!`Gu_Y$AEuxT7<C7Gd<)j@E=Jnk5U4|gr=5`_(S9-*^o_icQI&c-V2#C0=qnUR<9
zZGL^IFk+_IExe_e(1dTWFak?L6x%#@Z#o<xW3!Iy<YZ){&3~m3bzI0QUo>>5JDh2C
zY206~?Jco+<;lg6Bg9wAZb;O$lp|dMT(wTWm#<SIPU}{#uigX-B74v)mNuNK(o4<A
zIB3ZIsG$m6KV3zyC2F!E+lwi6<D2b5-|Cp_g4qgueSWW4@G!)072VTMmvEQLTXdKD
z1#@BS_>gjswZt~OvEX*bad$1fQYJ$mbIRM4b)m3QW-u-gznzb#??T?ChA`>H*QMrK
zWQroJ7k?+*o;NM`M(^8o0RO>tdY*9Seb7n718+UijvSunt|cfHrz+HQB;p<Bse@s0
zjzUHzmZ^8y_-(!NYz?bxs$4xua=p^JglrhAW*aZrHcG<)KiR6G{C@$D^bt$=_m(nP
znp71FA3*NB&a*;!#lM56%0E5twaU~!A{s}{)p`V8DdiP&e`FY=FBTRN7h#uQBjwth
zqsY*6G$T1p#aGzjE8*d@O#Lr)EM(Ds{PgAeY{&QCis`u;HgG#@g?1Qm3ultuw*5-;
zr*b>GZLC=3AH^xBPS8Pj{u5*|xh#7q(%wwSmY^NH&OW4!iG=l>HOC%dfU-K)q>t7k
z*ncXWV(hN=9yZ5*n&h@`h{}aFNLDQYXg#=R=}nFa*x4xcP6kNAQYUPRUZG^7PH6T9
zophsam7pBgefjcWN(9dqL)gf0!?oe%t|>2IWumXGU2J8NBE1g;B)jb02Z2{_3!}qX
zg36aHhsv^JlY}v?RUp4eMJ}o7xYD)E0mFG>?wu7WIZ3_TPetFX6-nO$Dm-V^4~NR@
zg-dGP1Zc+ewK-0bzR7ock{?Uf5Ed1#$ak2}O2gixdR;7xIVkbLw`s<mYRzCpHn9_V
zK&O_69@-MAMpzCQc#yi662Wf>j>cG_FOH-x%_A-CuwLUW=4%&iaEwy&WO#n<P$Nva
zAN|RV>$;M+fL0r?Ak%Ans<@TwVHlrR4a>_Zr6?*ySNb&L?}KsyGi~fH#Th#)_21JD
z2(eTKajQ<&;Qlu6`-9BEUfu)nl5^JRW-ZU}PpbLFFF?>Mp4G2m30H@Uy`W3ApjQ({
zN)xVm53&#bd74L{>Td^<#?`-!5^oLKza1G*Le0K44g^4>K{gQNhGrZl*>=OPKCoL=
z;|LdaFZ1m4qj)I?76F&MyoI6<@~gqoY~=>n@>3^@0y$iCg`$}851Cb>P4X>22d0BJ
z{2SKN1$aD$4_NRYCRq6+cT<*d5xIqy*EnQ~zg2XrIBDQ$LjSTl8$u2bxcb%j-`6=P
z{_s<taI1yg8loW!_?mG`RX#!;HoT>rdw9w?W49>=+?X?48v!fTp6;8aB#8&PQ%P63
zGd|$;)Cr1^!M&6Oj&>&D>KSJ_pRH1nlECuo7f4m3uN~B7M`h6xZkBR35_Bo@h3mR^
z$`Tdcl8@)ORcC4GN=0hfd~A^f8Y5BH7LDbQXJ*D+`L;ohg!WQRiGMa~xVGxgFSbdO
zXw(URb4+VV7Q%5|j8gvcc7I#BrD%<1`XbY$>}Aa|72GwlW0_1~>G>1pL$By&w>Er|
zvx$<Fvq4S|RA<I1<(_n4(Oe;9z)ssBdRbXcrEhLNwkXS8*0_9<A~?k~de8def^ESm
zWy({*HV~hg`l5q7DW7`0`CmT41{>dESiQs4g<=g3Xyq#ma;Wv>J#8h;8`}nEZlzSz
z11*#_l0}YEF2I|iL3FpQk}9EK!HJel`J$9NaV=j{rE<lCx|!;~>blQ(T$<{Ie`&Zh
z+jhxjR$?Wh*=9$*-7y$_)6p2$=?<fjkQ}><p^>#%EfvS!E=>x3j3z532c5F4JLI)Q
zg#1WtB~s(>-lO!SrTkU_c=I29Ik)B6v61vO-pBoMiD$K8Rp?|N3sTwKX1_7Y&_$zq
z^-vI=mo%R_etH_EXneFb@J>){t0DP~m$cXG?hPDX(bw=2xC@v1k9|vGTn8SiF)?;A
zOjNjk<4-zNGZ5ksxmNR#g?XO<Yim=n!atfXMZgC>S}aA>CoNa<-u9lPHk^r3KF2_=
zFFo9$<yOFVt(qc}WuHC19O3ivlfuwpF=AsJ(JFyd^K-Fg5G;=M;6l%xD*hpYjnbj!
zdk*<_uRMpr=BV-vll4SJKbg}-zo|*r>Z!cM@+XsGlpQx#?BF^fjR<0s(c5<h&2T+Q
z%0zZ^ewBXRA^y>5bBp?lwd{+a3!jUp3#_qhpa(@?XN-U56To9aB!r>AuwUwBAB=s7
z8R>yRG2S(fJxKnre^#=j=BMz=!+w}C`=3g0c)-S2!5=^1C*kPfFA!{z;8xZfCmQja
zbOLMOl}<TNx0m&1yRfm$ag3;0Ct2y4H?3E#Zn#2mJ#emBuQ&y*H!b)LZ8^Gae-EtM
zUohve=(CTL=_SA=_R!1`;D6{&j^Rk#8dmbSt5(u5vQ+ch>ut(8wTv7N#l_~L^e}H@
zLX0#K&$)Xh^oJ>Y^gi^d^t-S}!I|g~BM)UYKsWbU+}K#zcRo&fZY*M~FcF)g2C$v^
zF5xT-kQ+xYyQ`9^BG%krn4f1XPM?Qgpek07%S{#(>Z0|Pdu?eZwgU>E2^W5!!d+w^
zjZa81nrV$EG5v0;pISEcDs<W9Z%M9^L-kCmoPe87V<r)-ZFj1zmA#F(BfllP)UL~@
zklE~;2~u9;VN6y9mTzA5B^9!YmahWDM^O_%$_oQY%00!F-kC=z!~SVQlNli2`#`Pt
zu(n&mfh?YkVy#F)HiRgL702&fS;z>-HlZCyu`^F^`eH>z&NGf(7oSd_3Af!lPkTde
zFCQN{g9-lfafHL~Os%W{Rc9R0_qbLdU|T-9+v||}${<%T^3C9%%zF;zb-3JZ>?+nu
z(^sdwwsp6vLcJCK%l7875AOrXb-q1|b+^l7NciKf_eSyIpXXcFMF#iER{-iE^D8H|
zygtiK_A4T^+}Qi|=JCq6XYxUqkEwXgw?~ZqY4(C0f?e^i`9|w>bCj=t0jaSEhi6uw
zZ5#Dp&~5K4-Tt44m0`ZU9lW@8<mi!01H6XE9h~#WlHos(#<#yV=mj}GErv8kTA~zU
zuCe^NyS3h5o^vt(J>6dJ&5U?NS#&?{VEGGxGo13WndJOFPUqdK^xCVtG~27ElB;d*
zKr;X)NXi9($<X1Q<prIuTTAorr4|#l>7m61gPs%omAn`ID(+i9utAcS{%X8DFAMYF
z1EwaAL4#DJMgzQ_^mqJy8x`WzYMX!Eu6l31{Ij3y@0Isux915lVDLd)<N5jr*aAeH
zT4VE14)<lHsbylN$%V||-_gjSzm_1^{OeK81Wx7*Am>r*6qy!sEctwW0TOB^svJJ0
zY<w3M6psjR&&S;^uW5UTUV3PEUL^gMULV5M^>X;Robx{N+Wo;WODhVWd9PZhFiT%A
zdn)u-1WWZ-K1<FZ<FX{vb8MCBca6Ptz8(Z&q(ah?rIAaAI6-S6zSq(Zs=}3~w?Y_g
ztBYT6PoS@t2djVFtuI!{N`@a5y7fLMc7!+}O}m720(lsz@vYGR<xOb*6Z|B^Xe4ML
z^y2>V>#cAd;z|n=+`axC5HCF{Y?l&RI$i!cUqNb&fw0xBj*$hcuHO5~>Xx}$hCavM
z3g4*wi!O8Di`?^?&SBPbqlqm46$Cr``@Jrl<>uzVRQu(1DGSZoFaCRP)cJR};754b
zQ7vHXtNu#0%(r(59$tGZ#JBJ-vdj8Fe-q-rjr<_aIa%!?;^6|nj=7L&ir%)tJX(O_
zE+A@&`FI`cX@a!0*YD#%(*5_9gYCi4v7i1&rK|sa!#r}<SBR3nUcw;F*W`8zy}phS
zTh-*gdp$fP<~%|Q+_!CSg|}_QR-ROX$5yv(E@b!?Gcmt!7hmT8eJqyMJ#TJ4|9O<D
zdYA&;LL{yKS;iHb?R1Ks8rE6|%uL?*_xfBt4T`inJv!aW^4*~CT)ynw<#c%M53h|7
z_uRI69%=JQO$*c!=->0oNW0QR>m&5X7+OtTK2+bY*n7{pRB+i(isfW_R^{>SyW4yH
zj@x{iS$LcA8N1W}EAD6E<+9arQuX`{z?rq7W^idBcrjkiIMn~0zteU};Y4@BDEYab
zL0qYfK2z{Fq<iNaieK`tEy@#_!)Xe>*VaV-#sl>=|Dm4yei5N-SH~UQ%9j3)XyR-<
zg@4tCzRtDpzf+g`DW=xjs`Of!Hl7<0bNi+Ej*t)0kb2j_Ft7)&Ra&SZFm>zN4y;&o
zaxEk*o_oI8>NFR(;&XK*I}@|-5}XaYvi!zwzp~t6zt<GRXEZW|qkGm?!BTEJg8i|2
z`OuG8<74D9rz4!$^Y31zK3zuopSjOr<Z*uH<|03U^Jz>-<W{`~g0g1wCl|@C1ylTr
za$B`cqZ6@zOyl24T&&F}`VMfX=isSxLcca+6KF7l!bak)0G(PmC1cchM5!sOAP`Xy
zrYO_pD2nB`Epyaw-%}Er^JNLW`dS^szEOkmam7b)ogbfk?g-OkDvD((E=rxi$A-(N
z8+#|MYva~CDre)NfX#BQ#UTrGhQGyYUxM%C<&UJEz|)zQ)7Ck;(fwkg6*%Hf0d(4+
z@cVqJVNY4;q|;ly^PsH-y9<*E92g6!$#QIj-58V{pK@1WF_i3AbG&^)vX+DRYNJn1
z()s#632#43abt`_uF<K+^<_4aD`@(#cK=adfX?$lc^|7E1;^D$@WhU>s^bg5qZR<+
z*9LEn#=&ZywF+?cTX@-Yd#md{?gw-J5N2z6?X#=#$?vHbxdC?UIk_BdQg<IddI#Gt
zq^9;$d-a`Hp#!ew3vr$KngXZ9nXaCIJRW-HjtgLiV`i-mm(j-y8{d{=s!T}(0ZNO{
zBcVIqF&13w*+gbQ2}<_EW~ocmqwo8f)*pth1Bhe%v!s^xBk2FE#^|@eo!^4OuoI~f
z)R}@k655(`Z0F(Iq|@(~`+tNtpHZtrRRMnPr`o?nv@~A1cTU*v!TcH%tMD1odzuj-
z(Z4U~J<s+LX$%^Sf@<+Nq7dSK3f5eYMt8WBebcUIb(x6CNnoCzfnd|`oAQ{#G0YPV
z{YBCGy=SDe7n%9&(dn?`8L07uekwbs>?blAESwr%zcH|<R~+&loOVl!U_dHd4Ek_`
z0@HD{l;`|4BI@rvv74`euU3HGi@h$i5M_G^wlui6YU`Lgs!#}@*gZopAY=;0599T^
zs^Dv@#bcDLCieW_Sunx%lBMZbxY}_-xxH3G?5`Y9*|LwJnk3w~ywa8DQ-<9>rlJ5x
z^n@{G#i7Gy<Tw(A_RoBVuYtgss9f)nuf?KYuus&^pLNGwYeM8;#|b@dblL3RQHukA
zy2C@FaeiFcqk303UC)XA@TDOm0#N5Thc~w%WdP%0qsJ*pHwSwn0e>*N_M9PX1(@8R
z5Rv*`jXi5hgAlrRp|Tg4TQqoQnV7@7UR3h=M^1U-fyRl!(dX0pubUOO3hR`OCC~4^
zj?CSgHJgdlZVFF-{+*`|tD`2<L!B`1XNKF(RQh&&`e9vH^cKv*pdGXssbTV*gqYyT
zzkh5|7P?O;s&}Gt(Nj0MwSM??9b44WS-H&>cS^~%@h@~!uV)LQ`XJld@Q`QG^7*V>
zl4CC!w?k<kdF-(POAQ=N9MTXP_vx;ZT`#AiLWW+_*Fd0`A$*PMDZMm3j6o)*)~&~k
zjx!_v73tw0h1gg_7Y}Q66I_f<OiVM3+pXLk><z2>nmGm-G7W4iSQ`_NKeI3}F*P&k
z>g4DF%{DX`r*_iXHnp|U=r0<BxSfJxxq9m9x#IQ$dVf)$JbA<0JHz|>N)zatSeSa3
zxlHJ|lzqn_AFd}DzcRrStJnZh`MZ<At#nbZWyLYR=*PL_JOTG-Pc6~KROvP5WP4zg
z<kaF}u-}CDYP{G!xM5ecrO{rv-e4`9Le@xm>aCeCayCHDR$DEbKW}h4uOy{+E*ZR?
zR?in+^F`Pu<$fxn1f~p9^rU*C_5lNrm?!2aLmlUI9`?!CClC3rDJ0)sfVrF2Fdmzu
z9$%-;<>8EM=C*z!$U%9!)Ev8o$1*$_lm6ZO&eVqKZbhK;(cw4aK{g#91rd?|)c<!f
zE45Y6Ugp1?3($|>CM0mz&w5O}%GQsu*yN((7T2v^f|m`T!OP9=lZX0i!UEhq(CA3m
z-m2b%=klO&tMHSWknMwS3HFZa!qnCP!mqT@XF4c{{mBgf2C}qokj>twc5UO8o2Q?4
z9l2>{aAHSq6nag^Y|q*qUmDytRfIxzyd`7$S92gUo(N=!jYy4}E)N@ng?~%1+K&45
zMX#JQbX34W3lodjr(*A+l_r(D{P?++h|OO1r3|Hiwg3iN4AY#0@#@F#7_{JP@Nxtx
zQ!mzqrxSt1Wpx%WlhnFi-APr5N2iP*233`1Q&;`T!{*?*NLtrERpw>&&&z&;wcmX%
zN?Cr!mY6@EcJ4^8V39HWWsF(voN)XZ^1`%J`FkwZzqnh;s$#YiHw0M_>C>9o%+L!x
zg-y(4|1o~yE5E-$-x=2c1eLiTC&xRczUT4bySJ~NR@rM1s5uRh3@Oy=Cj`C^Uu+G+
zx9fY5fYskStjzgxT(0%+mlJhX34*=1Wte9ay_RGO2rZ<sUYUYF_*)OUiXj7iB#umg
z$>BN#qSnoH`RcKB9+~dw>%yao;#>`FgQktt(5Ras4W-mb$LKBa52@8a<S!;yWIrNM
zFh$h(m1}Xd`g!vU&)#C3j{Y%c_mr!m$i!SR#^Nko$cInE*2Tl2Vpp_;!AVF`u^jnA
znIjVB)Hz%@S%Wau#VZ8VN3ztNA3q?kJjY-YVUy!T7H6=@jhN>r(%rfK&#;8<B!EZ(
zA@Pw)ZJA;yfaM{hXJ1_4#Hut@7NwEO3$KA+pB=lO<A!~hAYo|Q(6dAK8;`U)s&)pH
zjS6L*GX(Yaq|NVVf-~V;Wt_L3Q=iU55Qsd<AukTjIN84#d)S%46bK^&rMsKVoKVY(
z@qFuD?Fcu1aac;+8y#QGV+E&lPEj*w2>R8o^;p0mlqYhDQ$J;lGmj4p(1X`MM-R+Q
z%A5p!zIx-B8Srsd5VkC@_+;8*@xFgwK>X)3iGXZ2?G=H2NDDaKOQ0Y75zD}<Yuz_Q
zn$q#^SiI+QiXn_~@lfg%wQb`&owVR;o1<E3=}!)Md*LaJ*47o}C)Tyqd9X7ju@J?V
z(32Cal*Q3bXNiua)uNgyg&7tAHNJk=QGn@1JI0`*XpZ_)jU93~mqmQP|I#}F$m3W2
zfm#s^+`#>DDqPH5vw}IXt(P3hDSc>ig;`zI_C=#$UPgab?KCPMFa^VA6fb7@q7+J&
zQvQqR*X{dcl;14o-|VCSxQ>e&uWya*dK9*O{36^<ny`imOl{xb<nbnTsjXJM4=B<;
z`F8EDzfVZ0YE$mhOJ}MvT1Eu^;0^wJo5C77*wn6<zE@*<J>6O<ZHkljO~sG~I;At5
zGJARX&X>y=e5Z`VQdRWLofYS_VCBo|nLCA0!Viu_89@xb2ve_D6su$}v0BsDNDr<)
z#_j)lHz;FaE!{epyfbP1kaldLGvUITK<w0bH<&H^G}?=QVjXcZ``B9S2jG%Oz{`|#
zu{{mT`v<nOF(fZco(aV6$7I9$_h>bV@ux|KwLzm%CN&+4cT2~n`=0(&t$nr2skGRl
z`-w;W{UOJ9`oJ^fvKNe1I-~yr+yBB0eujc$NiF)DmP7HqMAbF-9%+7=JExmx*Ar5w
zrKzmO@e(oUq?^W^_nYrYe-qQGZ<1<Vx||P9{MjH#V{pKx9A!ro;eaOd#U|#R(S%Vv
zCzbTqQ1y^LyQ&DR;o>|7H~FfRs-Q0g0@hX@e)S(H+7W2h`TKWXfokYaz18z$>K^QE
z*(YS96n+}983`pE)JQX43erD~*=<<Q!J<*eD}3c$tZQfPW|0zN#VS7V=L9%#b&Ieo
zU1oqk;krm%ohRBT9dwKLTAU41-_VKYugD*E@9*?QFbnqKR?gh9w+u0fx4!k=1TE!I
zu}l)2V4}z|Wn5F;(TS$h{2MbfqrB#n@J?=tfq!Xtq5B68gkNLsypX_+6(=^9vch8d
z7Tz|g>rAPcpaQ~Sxv*Bjqni>UagIdkW45f5BYlHvA&E=YuORazZAS6OC6_~VcY8^}
zr_!prOmp8h``4_yYqWS9%N$Q{<36Q8&WKJtR{RsItB6>dCV^#;hi5I)<p{>!=({n4
z697oT9)~)Cig2@gR!&?wZ*3|#limqZ6RyOlU!D5y@lK6U`&cbXk!Zk=B=@ee-esv)
z+*>OrTbss|vZeMTDLv?iyZw*iq~UO8*6zPl_<k3CbHd*}#;&CC%+e#yCu*2@!fIps
z|0h{Krol$(_G8#^L_3Bl4&;6jY#w4gEnTwkWJ=1#u%C^C1RxQ}B$%-DViCPLq*Gi9
zqovKDBMZ=UL;jJlT(EgmCQA&L8OFg(c4ruu32T%DEz4I)#@ZYL3vBocIZWD-d@25B
z4s#Xq$WV!%=f(;mts|@NTF~{P-liX{a?OXoBw=0}S!S+n&^BZS)IOQK2pSWG{g`Mv
zcRx*G|EqEy)=9e11uKEMrB9=#%!avvA}3ecL$`~872oN_SSwgJ1oQr)q|_uxXvz(J
zt}_xr!}pL(vJs?NGDXxX*_1nqQ|z1JG-Pci9$5Vn=OrL|SmmiPnKvX7&wG*!DJV0;
zv!fvPqKn>&+wbLbQ0K83^l?ajn69)EX=x?69bbpukVjp?E@N9&hGeH#9+TOk6__`q
zvpA-5mfe`sOdKwIcRbqXy#M5;S5@%qVGt)#pQS%ulxW3z&rc40{laECR`4b>L{g2k
zc@jd&&O=Drb{pYkFG;+py);i0iGB6rqPxka70kTSRTR-t;OyOXH|Q=zNRx3N3G$-&
zD;^dPEl@8?!C`Zo$V>9`{iG98&)07Hfm*f~Lz%pS#I?YSJMOwCq|!oSNlHCZQEZ5r
zK%^z)oO@e^vk*L_>ZBNH9QV3}!N8LmoaPg0B#4<8m6G&Uy@G8=X|?TC#xTUYh@e*F
zEy2~4wj!f4nYp*y&7+5D5kMHhD19XihKvGfG>tee#AZmBIgHKVv{ER%t{>#GGLehj
zSI4}R70EJl1bj%#N<V+m>-1c(O4Y+7h}odi3*#X~e=VczL*q9@^LYkgkyjtf@_3P|
z8u5g)0s9~=yd2*40$x?p3zA`Y6+uKwL6*`8Bm%E={j|V>8@X#R0Lj5n;>e|tF|9b?
z9MX7L=2qyLFv??4=L>FpsL&x0MzKSv1(&Sz+%dEnG(}~y&kq1A-DCvIx*$D!ssPKY
zO86GDe(d!wdux6KLG`sho`=0X#2#}Fz7*H)^beztm-AE>Yh0XWen25WT%THrm&5RO
zf1QvNrxH^#m9q$X$@MvbX10>c9)#-QY6$#YyD&)2`knhQxK=jPN$nwwHWy%107glF
z9tFoSdsm@ynJ7PmqQQ-aP#JKDV_$2_NzAE1$7T=n^9-MJEDa-5mrSmPD`D{b3_H?5
z7+EeJhUeE4pY-tOXYx+CBiU5daV2;_2+D1V92QG4_g<`!FL-wkzeO<V=}{LBwf1Td
zM&1mtygG9TMbe~zo5`FCK_f*1FAE~lsGf=e<k^{Tfssqw+;S*E7EvhKj-l8kK78L&
z$3S8}=y=Z~vFOPVzqCOtcGBQQGM&ZINul(j*JBWl51E|n_Y%K@4`i83{U{1Kow{bd
zhkA&=>#v__2P<${%28dwVD&nELM?>roKR7na7tlP@}jbIRO9^~%Jsa&V{bJL=vDX(
zcxdB04CE|Hsc}s##9qG}9x}PH#5Rm-2U(hG%0ToACNCn&p^xER4y7N6EZvmJ79UlP
z0|i>~qPL<@l1kBwS3(X8qCA-aK0|QMEH_VY-ylAn#;xQPLy*!l7=~kuWbXM~8Td#!
zB@I2K0W*f|$T0IRZTN`{ER)4r>+3{d+MRwrQ_&rUB(KZAmlor<Bq2$$hv7wcgXC>D
zkT}K5(mF5tcO;jC<txUB-tokXp10nD<MSBTo6`7c=>vu*Mkb};BR%fmwDe?p`#rhD
zGFvZD@lg~DEuEv~jv%F@3V|5}gL1idGgyuwDUbmcG?2WSj-Zt#KTpInl}Rj0jnzXi
zx(W;s@JXRPDWcWw!rZ;+#ejGRa-47|adP<JHjP>vuAlh9>g5%YY4`KUTk7BJz)dp0
zB4*+{Ky~jT?FQFkZ%FdYi@uUeVHOdC<gG|yHw9HbujQ;j2B*Y7%ajrHDrf`}9l*<7
zujj47s-BT)i1OZwz&^uMt=L6xWj?}|1ac|CdyBbmLmrdGmp8(T{;HqEr~(_F<bMjo
z2apS&mI7W@5AAgEU4Na%8|mvIe16cw+-@truo=m+v*8M@Cp-b)@MPjbpEK~JjGO%x
z>=KG{af2}MJ8n;gyQswu&VjgjG3Vdx%!I*;ze;Tm!=C2`5+O;+Mc-Ww!Wazm3{*Kk
zSUt|U4G3Av;7yDc2)UjYynw)X7=&NWPg-$D!g+5$_gewd?n<-@3^UC@Xhy8;<kY$~
zpPXT>pv$5^t<hZLa>AJxh3iXRbjR;_@fj6yi=w~fOodb|)?7aTG}q0H$0`3^>fe+Y
zX@+C~tXuibC5l<cawx$eIa%VAY6FvDT1uvPXy)9&U-4pvT<YJ9<*R-iXT_uoABf?o
zj$8&f#FF>g^HI2=`g%E}FLE$DMpwlq@nV==4?DNyR=*bbul3=UxZ>Zu+4I<1Lq0!p
zAtIcd{CXngu*xDN@o++NO3`h1&71S%HNp{P?nIQ1bLpidT;Jfgn5_}J5!Zrsw{!ai
zfAyAF^lrKFE%eThWj!Ff7ra~U9Y5?x3;md0rstfS+{zo0cogWo27Oj0X^q}ZA~%<n
zhnY6f)Mc3L=tpXH%e|fh<@eS2<lX_T$$><&a&_ck{seYu4k0&S?v-H-$iZgfrK%8Y
z=vfxRdLELc41d|Du*bbXVd5j0R9ad}+$jIzoO@S7$|WnP2q$w9)1t+aQ``<X#J?4>
zP>Bq*^|xg__2e-b+`%-1D>$MMWSLJr`H;+`5m>CjuKUD7DZvwj)IvYG;C5~!zVnIa
zJJ@PB8BCVEIQGMU570=ovR<SJrX|rO1rwdj!7?A}g4-c>bhzkoSxi(Uv*)nVR4B>g
zBo|d+>XT#h<<h$6bx8-x_Wm{a9vR1~)saEG63SyzRA~5=-Hj_@?tmSa7}jjAgiBth
zAK}~!<)%@Vu%^J?7+((YZL*$T*lbax7*;{p;pB3(iSP&pW&@dk_bkm{c5h37{gc6x
z=TX@h;$P7H<F)k*z1zb)L+Z|S&WLhwZtG?k-iG_&W(u^4yyo-nrU0Ae5SE~rA?P@!
zU_L^mup7w+#do;aa2C1n=G^$UkPC~_WKlyRR*6=(OHUd##$a?_U_UsGgi1>@E(1%q
z{FP+UU%i!F4p$+Ch<0{#OXMPRCEu071qzb!8WeehP+{Ngu@7Mh;ZV>(`FnD`DC3p_
zhZfUAHC4r{j~1X$eN_R{MRNs?y6X;S<vns)-cfH|nkUWgSsTb+>91#)BUbV>=QvF+
z&6HYBzOdqRDejL$KgbtQx@0agJD>f~jPyL*Y9AyePV*2prXu(yO1fk)ux>AZBE(w-
zf@i)%4&L6;@YC$1-26HpYKxUUj*s2^;jxeud!IWKuHSf`Xh*bs%MIou{*07Cj>(Z$
zc|M%L3xxL@A6?+-QUHq&cf6jI9*|->L`indxqeT^bw!Y3uO&Xe*y{DfatJ9N(fRa*
zT|`{G01buYHA*OX32Bgu@2v6rOPgyq!`@feX>VK!(}<khWUsCF@-Z_C&ijiAm-9^!
zJZ$ckMM&A9^pM?M=1Rkg`b5ef=zOm%LrqjAlwE+}3;ya{zb7vHYkq<lH5mCK&s`JJ
z3?-rE5Lp~0hlMB6@EDT@CgGPNcRdd;MB!@Wu8E8Ooked=K;XGSlb?8NG@X>-<s_E8
zHFy117<o%QpUXmNP@$VqxQ33zF$}YCDgg12ql+Nde01@vN@WKeW#yRt`G^ihwvup7
zTnX1nJz5E)wITl!{4)|kNf~LL3oUO4LhcTcTmS!{ormWA;W6p_uDk5TF;$G&VFrKM
zPm-QD8+3h%K8hs*e0*UR$Bspxed-9BgEfZGv}x8=f&)bWN-b37aO9hUurCRaVYw1o
zy6vxn;r7=FWX}$JnBrDUxSWkZVwAlwE1LU$KFoUf-Ju+*u_$$A$Y!?e1$;UY8`DcR
zJefb_LQB1Z1mu~!w6AamFF8)<<CYndd9ny(<&5G0(pqoy(8?sjW1|z}fh{TK{6NgP
zejru0i#U`jRSFy`lDY&XDe6h4A(6;r{tOb4NseBV2;P&>CP@5)48+swMU;+n=_M~w
zNfO$nC_;jh^tpK}9vL{5#Sb}5Bsq}jN|^X7u+ejdv|tS}PGv3`MlNA7VEZz7WQ=8C
ziY(0gYbZ)lo`OGm=nQr7+2~7Qlta_P&O|hvKh8l%y!F|Y6giH6C}Y9z++OhSgh?yF
z;3aACIrlED-gv=_vJ94_$rwXMih!_l@OT|X6MX}nr{gkY201QQ9+W($2<tNHxI=pI
zQz)q=i)lQXhsA#sn_&)Foj95V$E&-ucfAgsXUvYYKsA=blCoflQ_F?KgRC4Wz8Of$
z>u@fGk_?x~qYj@8gwaso$`L$CX;LwAipUF`Nbn;sJ|+VOHwe5+7NJ1helW!Jmcvw(
zlT!O~h#`2b@85BIL@LNQrPii8;j$d6Q}?OwL(Fxv^bya9SWL3?P$2zK`5fwkA9R<)
z93m(Au7pQDi>eHXM^tC0KV-j?1W%c82$c`~k!7+N85QFo@2E&Y=}zTzxTZdwGYXL0
z#BrwzbK^$34hbffKo=@t74QJ2w{j>wCFMDUWMORxrOx`QxTuiP*#QRWVdZWx@uK4$
zs#yN$Zu(Uv&#87UL|(^7-{vEz3i7ItOFcJ%VKTWj<F1pWCYCnb^{?_p;`GMaItjA=
zninSkj<NoQ>!fjn>u3?Iw3owhovpce=7M5wT;Ur`IA|gB4%}e#=%MWVo2_8;P_9&S
zk7h_sBBCSus;Wcr5;@rd<J@0YG91~-Wd7xq)(VbgL@bxIgJeD;>)CSnvgby)V#9OS
zDXC1*2%7Ez@i31k8m8j)E=FLngy7~;nyqIlK1umIDeED=P|7>(UcbS+K*kJXrOJq5
zN*;+XzZQVTcwL$QTd!m~?kKLzk(@a9(F`KXiweq9r^;Eh;6cts%0FynO5L53kalEp
zCcYz6OgI)IFOpt7ubUbGl=74v@MloY`wL-sJH@p*geHa6(TO1~EVC^fLMI!;h~rw7
zY^2#Q^jB8a+<<IL@;05+{6SiyLMlHfmYc${I6Z`7NlihDb1PU8QU!y0)3P9?PntT#
zoENRqS$>v@VEAhXWCs%qkq7p}$0}2U0|!BpF^w}09sbGX(1Fhj;aUzwV)do4AEh4t
zSl<583c94UEQhivTZWf6IGb3vv=Bd}D60MKWf#MZ>%O<4ATOq%2qq2a%+3Dl>d@}t
z2n=%6V9tq2)3jd-BM3!w^our24x$1%n6F>pv%9d@t@w;&#xWOm83S7rpP8dTll2~u
z7y7;1bKxDDCF;usH;Ry<PP~Id-j<t2ia=5zLadI$q!I&Pf<=dFpc@fWW#TMzq?>{d
zUBKt6P6DvN9^o{|*{2wl-NchSBa%Z7nUlp=-KQfYJ)}WKn3p7{<aUF{mdeC;mWZwP
zBe$oJhk49Hk1)&Z+#x23Ic6-BZAU_BuvnIR=o?u^8h)0cWEe=4AzSO~=rEo3gHKta
zVP=%cqgLQFBX7->NS3}Nz??z>S?mvm^~*~51kmtJTnelDMA_+}(oWzY>}$B5OB``W
zsOz&-4sc6e5c{lY%FNU|d!)F6m79XrVTv6(lEyV0zPD@m%_F%Fv1HTIl}ROxN-!^u
zN|Z7KFqMu-#7b?T`G6(RA-4nM@L9)8Vblu3<dzpnu{$LM!`fqpRwoCC3*s^Z*z}^z
zlc5mgBK9cMgBOOF#cl={!H$yrMv5=$4jEkDMVE?5v<x;mgk27Y^A!XSiIi;>DpU7y
z?Vwb)h!wGZ83A~~yPE-gG*5-*(7dP<-4TUBXVB1kl$K#7CoeHlO5D;?lg(|4z?k_i
zc3FyQ1+l*z(!oI`=A`$A5KVwl;Zle%#<-j-45XCI``nEa)*0!zBLvUGC=wolWKi8&
zz~<DMeiVn1IvN^oNVpwzdi}1~>aY}cXg#TYlE^mTE{{ltQJ}Eb>$N(a{u%-cQCUp4
zMaioN!bn_;z4&5?pml%E?Ja@p%Yx~-#SAHJ?AhgbUvZtxncT&N&wNF({0(l;EWhY&
z{^2sg&pmfWhRVxNJ=9f|-M074SC?4~H?sN;SAR?q0js~7o#7n0y4siJZ9`!y&E-)L
z=yPByN-8RnWhn^@_CM?##-@iQ#Tm?mIMboW;oH-0uugGQN09ihh_U=FML@;U+7Z2h
z(9MqTOB4)Fi{463-xYIV;L8eC?3uc0A*EzF6kTn%kk9}OD<ul^)RTFPM7-eL1p>TE
z3~Q^Rbu&I}hi9dhubhal1vha3O)kH*?9ssV!&hiZ`gTnG*U%ji?33qfaAGmjrCTS+
z*b=7!zK1~R*OOSRGMOa9?xDicauajB45c_8ELVm{o{Hp>$KF4{Z_9fGVp8W)fX%=u
zNYQ1OzZA0^4#Rxrm9G(qDcBBL0IevjB#IMreb^}J?tu8W1fCtW5Yi<!QJPQWlw&ky
zTyPE-_OlcH@x!l-BiSexh{IIrEXGaA5}6d0HA-p^u{yz-Avi9KPLa!dO7b}`xN-hn
zx0}1ZCFTonXr(dC2km3U)a4ahsr<-J?5tJo`7=u}czdh9NAsc1fXbd^mnEu5A{k@}
zjJnJwge7=WVc~4`6QtDglAIPOEY=(-y$xMH1|2K0UI{hIvl^3^cBy}p&K<{xZY({M
z9m<WxoZpGUI9y4N$%E<h$T3{*7^$Rb)EMJ(Cn3|m9&-V(w6Vb=#yg8n^Kn<Rb9S+`
z4{}<K4Chm5hL`Qo88_&X<dxfz!#E|o<gjcNZpCrf!I=VXOS*Y6f?ltigSpxq0xipd
z>UOsrs@3ftq6yr~Bgmt~0~<z)qj{X{Mh+!UmW47{2ui<NdCOtq_701Qa*z0{x3aeo
zG#lRvd$|I*f+bbUhHA~9Ugr#oDU*S4suV^dL(If?j^NVhWwIzB<oHMqqm-*5b9|~@
zD*@JMC6K?ER={2>lNWqkPK#wn`cjUFcqFpL#Ga`)B&>edUw`UJ1iQ;NxvQ}XL|SDO
z1qjd<;8b3lVGO(KaN=17KJ%Nf79nVg5Gr152r2Cftw_Sk`jESNT>O@+$y0%xrTTn5
zAO<{v>GTXEbMzR}KH-#hlOo{1UG)RRl+CYX!8UpFE^j}&On&0DTTprsJVYoZZ6iYs
zMVblo7bIy<(%j87Cs)(_&3^{3^TTV)7dTpDJ~w}56Q9M&zQy7?#gc&gUBV^otGxKJ
z7FjHb4`~nN#ah1QV_m8URTbNqk!4aRuJ8?YF~^d~G%Y<JDUKDOL)Rf=q}@1Yd1dZ~
zU>@j;{PwljyV83&d;U&OEec;A<KrXEEb6Aw1)O4uhGAU#7~S!5nJ(!ryy-Xv+XqJg
zNk#^ersO_eYozgIe2h)nv;o-w8;e7PkuErdb0!wq>Bk(Bsag&puXKfPf<0EC1qp|X
za5YDCCuQ7*w=?om*YFXEHJ5Y5H7vPP&%*&ifJ3$qg;bkL!SbSxbuUO?3v*MKAyaF;
zLh)^^(oC(8#L}c8bEx29WO_!9Jqz<IsrQchk%QRa>)pk<bIHm>rh<4<P{q1LP(s?Z
zIcOlh<*y&d?ZDSEc7D-YNfGJ<O@@#xkP#{*mAz7N-tR(eMaD<x5Xw_6GEIkJ8fL6p
z9#`zI)YUNLiAYxrTNh&Kdrl!1nAorv%L}bRF%?D{gp>hWp<y*mU&6_0(ux&^k1>Hz
zDU7naDR|hnrm#v4Q?OLB6qwm8u?FHa&9N>+vSk(!BrYM`1O`LucrIfo#ORn%qTzaH
zq$!I^Ug@u;COj+x4y#`|rZAkO%4npvs#^H1Ag2$<Lmp5P8i#^=X_(pUBiQyS0c9+>
z9L8}E2)Z|pba8aJ)$Kx_k|A22mncrp>6sA6S(v=dudKwtUGX-C5lS|{;3rr>D}Jv>
z$%Sy8o|nT7dQx=vC8T)cDba|czf%B`8b$cPFG3iy2IkW*cz3fmWs0;3c)P<cw5xtk
z;V%10501eciW{y_OEh6bDN-p>23|_4qoQt!5@gUZak&taGhjK|R75dD5;x31Re-l#
zhR@xelR6aTG<m%hUKlsk)lyjeors#;iufL;c=#4_katCr51FcI2HD<`MS8kPACjqL
zEE0w<UnYr5h8vkei!^y)k&tGBl*uI01=&i7s}o0WCBMZ=r|97sT8phj-hLQvv=VS^
zhzbnwA|>f%(OdW2Wa!3X#5#af1YI|hw|=V78?;wmN&zf=75hlSaxfGWliyoHbMCrK
z$xCGzNbg!;lGaI7tSHWr0pu+{bZaPwO{t64Nhp)3g)qiNT5wB944rc4<V@t_gn2Ke
zA4gw8U<XK`%;95J6r4pgBZpoJ{FN1H;Z|bw5H5G;i1c2|p7HHQOP=c5v1i5QA3q^0
zkC)Kl44PD>pfHd#&eBri6k0+F#A0)bm6&MNOVaJba;-$lXdwphZ8&vt`Vb*_X<8l{
z_P>W2&TukC7lCshFEhR1gA$y~&VafS)9T8*hjWGDRh3{o45kX3ya+HWbQH@Mbx0ty
zy%I<Riz6bSVi){m%>~Kj#=|uc<H}NCaP5Z(*KZ&c&hKz~_O471c}V6XqNrrl$MfhN
z`-rMf7X$&hFtxluOwzx+$QxzBp~dW7pZhOWh~dM+_?rtEo);HXl*5JR)nyvAQb5Hr
z3@=OtrBQ(wHq%P_ewV3#>Z5~5FHzvBG6`aJ1!5PaC^2+9hmZ~+8omrWhbx6B_Eao-
zK_Z=1>5?SIF7HYclGDHi#svI#e)9^SeehT5yu$DN2A1L4=ZTN>10S~TIs7Rxm6JO&
zk=hO+<#~6!h&J&dR+{Ie(jrF@MjWp!)2(i|y@J125P30RzQLP4#zDfLW#yLxHi-8!
zEJOAwO=@R`CjKeoqLIo+fTmh(nw2U}DJG2#mDWKS62++h7_%$a(C_jC!xKF80m=H)
z?k@Gh<j9R#sTQ1J@R#N2&`8&JQ=jNU6t1mPHJPj;T`?Hg>>>t&)LvJtc{wELyZ$;o
zWjtcUlgBA#;LY$EL^K*gDTD2pjvG)K$4yjflUpmK_Zg%w3gdN9!#f`A0-1|fLP-=-
zim1lYEhO{j0@`cXB}8cGpgo7@5nV%6PiiGp04a6(92)z4Zic|E-b#Zwq)?<vDZ*?r
z>#~9}do^K>3HZwX@`4PP%_>q?Yo%Aa%D-opS91xz<n|E$5#S3)j>^pUc@N`x(TkHP
z++6B}ecHzDV7;G^FMw0&aU2E__ypA^e_QY&<(6@@fssf9$EABD7ioi5|1rfL5QJ%L
zclr;NS7+ioN@!xT5#M>}Sx6|5y`I-Y8TvaA@?FH5@mUEZ&=VPeCJ*0V4mYyDYOok?
zWUl{IE++Bnw!aQT0KQA5xFWudz^7q+$q%{;<Gq%`Y}^PpQpCgV2E`vwR1!9lN3W(*
z=p(q}<3}iqZc3wLs`)yH@0!}A^_SKD&|GQI<39v*F}~o@D-pj32|srd<bu3<boTD>
zoe>NlAJ;m2S1fv~phhoxo3nStoO@Ra23?O+ECw+gAA*;oP1^N26ea`b-?9o=VPg2Z
z{yHa8yEV2Kqn12~Wh}HZ=E&dJAlF{@$Dy)0kwcc{4-ch`*p$Sd|B8#a5Z)DVi{Je!
zGwfYj+LT}gI&wF~!~Y;?Ub{$DaL&1aQ{kI3z>H%g*uBDtLq^P8FFAjiPh=`BjB$Ju
z6Tgor=5`<<B1`F)vcJ73UtjtjLn`Vh|L3acm=4Qy9eVpx#D_CBl|2Owy%2UchYvCn
zCcAhIklKg@NKKmcq5e&k#OxuhxGd7@W?iJE&qX-~cowAEFMGq}K1F7`Jw?&=xhX{6
zXP9>bSw*H1q^O0+>v9C8^q<C*MSlkYe`T(>c{q?iCphGy_}NqhP5{pgLNMHD^Ds4M
zFIeiT%KmC&&W|Xmqy%y^LD&B>R$iBuAuzx)iOat!A)WCO;w7Zsr=7~={gO*jP#mAj
z$sEB~D5V>wQB&e2w|D#SpCC~;-efnp^IvA76glm%!*NcJQAht8X#U!|95%g2U4q$V
zRkCC0%P_&jpf!w9D@>j%TX#EtvdJ7z0n8UtP`b}}%2KQx%oHZ!V<QFGHAA!x;E{u}
zDq8c%G1;LL=?^`gu3rBKR1AXihsUM=zg7G9IoA6hsoHknsfuakUiV}FCSo@>bAOOF
zhoneuj_x4fTPl6si~JS3d|(y#gRqealrw*hem-K9I#<n*RKaA<?8*vD)V<Aowh|um
zf}{}NxFkXmi8bMhL|hl1h(s)W5sE;F(phmvJT8PWFJd9;F9}}+qANnN0l3@}k?4q9
zLX_@`r^J&&)E7lx1R@c>SQDNQ^%<($6EmVGA|cMUMId64h)DFQ1j^#O{Jo2mcEu9?
zMj{d7^xyA|S!$O!IV<jpj_^cJEDBG!qD%cbBUC%SEyO>5SeYxb-aB0G+kc;O3u0A-
zVp&AOrLjSYZwv8Hmc%Bt+7oNyj93s6mB)Ktt~Hm1FK(jz)qhy|zeg{x{cdVJG$ulb
z|M}njAFn_7KYu#^<9}mmf7iVAsVE4cncx54cK_zT|5uy;ydnx(y<Vu-3#K{YjOmWy
z7$Z$hGb>G9GbbEd8yAJ9&_<e?X^sfZG)qEE*bU7zgg!YrIU=-bxj5lGra6Ww1QO$-
zBs9yY+oz4Du<Y|iK-OeYXj<Jq&5&UT&1p><O--w7g{IJrrl{MeN1DQEnU<#6ZR>;>
zsb~%gPCHkNLZ7Z{(?x+QrcI%tWwmLusc~vV2**de^|C0~_qH15)D*sCHcSH_oGyui
zX(^;-mW6KF_jWDQG(|zLYr5SwgjTB;4569yJ6SJ`2(310SemeBN1DQZ7Oiz!$g`g<
zG{t1q(h8b&LRcrnRH333Oi`e|O_iFuHZI1sO0%HjY2Q1*_|*zcVH!=%GRs9#D3{As
z)6(=Q`MOaMLN5wkuUWbwbgfn!5t@#l=^EhaS`ojNZZ>s&Tv+2;si|4x+PD}Inl@c)
zR<&}eWXONe1pD5*wbAAXJ?(q%HEO2N?0fIo_ueZv3xsXd%0k!ed+*x!-mMB9WAZNk
zH-vEReOPMJOdAIM7Mr?O*G!|SYtxga(42b@?0fH)CY*a8X^v6G;<4|&>ln4Bu1z@i
z{#JADy=mY3xY*P*`Ec%ig5sZJR-2kOE>PvT&`Uy}oVM?MSwyA3nMSv#OB42%ra4AM
zXp@v27q%#Ab^G4CrctTX?X9u8W;IKwv~DO=v02cNY!(?W(N<GXGbijVTer6+bd;N(
zoUAu>&Dol=DAV4W7!lg!q#?ArHdPY^&8(z3MWNYSk5#e4%0;1-?XAa5m1hWHZ#{-_
zG0ocWcgh&Sty9{#FzIP;O;l*f-unpi))eDnROo3<W;uPcM&(lwMYU?PpqrMxb=qne
zg{G*LntH9~Y@Hox3ae0@u(!@@1<boOE=+6@yP*|oG<gN*ajl?Ji4(#yIcErEj#(Pk
zvP3ilvRZ`+duvuR^1t@IclB>l?wo!!mw)S&KdV*w*Zi7<hbuZ##Ul^-Bvvc7(YQW^
zUa7ZAx!-(k5?`}49i?Zr6QX`X6e?P&C<?V&tyUBTt!83V)oL{?^{s34`*KMXw8r%0
zbeYGZaY7VDL9f+xPy&?KYdQwl*?JjURIk+vLU280Q;e9kGRP<=G)%!aw_dXfwPI7l
zG?m3j%`|DkgjOqqnBu2gE;R)etXP^}r^c2+7_@TzgdpmrOPXucERCj>CiR3ERdWVF
zQ6H>NXX}TPSdf!CR_r8gzO5e@o5;Yj!9yPthUskmxMrG`v-M+)+E1`EElr%j(zIs_
zO)+ge4zM)gY`v>FMp0<v!f6>z;cUHEY-*F(wM|X4>}NrzCQJDA2Tlvmmb3Li33<-e
z2gRnaoUNZx_Ai_k$oy49XgXD8Z#_66ikj21z9F>fx@Ofiq_k=JwG2xiwX_0}S^QfP
zg=uSgdfI4e)2K?*h*<osq$*52_34tpJiRel1+UopRIk+<Mh#?d>$HSTbmQKe)Pi5p
z@8{oWnwqoqg?;a1)86`0x3_*}Z+$L{pJ<jfd+SRHIrrX_1!XCsb6a2X_NF2QA*M~9
z+Hp~C7EF7f)rovK_a4-~E((*iZ<I?~M!o7<U8{>>j47~-F!jxXPPB~ozbQtv$%bK?
z6-z_vgfPL8waHouOXq~B6)GASwr(<IFwAB_Yk)FP6M-5RMWLGw!vt$~?!C#&<nL(m
z>h|d|G14%ctLUmdn7{xH9xXSuhBJ7~9-R7mvp8W7PHWEKv6^WQPT7OA4d<$Ei=t)^
zPFXeG!oT+5e5I*3oWYbmIA5E1TpMYe5Y~h<cv?FlfU*bAI*((>2%~aJ^mGhv(R-uK
zLStMNXP{;e&f9}$%h(vy6{k4@H20M=A%4)vV?^!2dE#J($$glz2Q4sE%a}4n!5*B_
zb-lzrGRhc23u9^s-89W=v!Ge>qi9lNT!3#ngO{Db%XKlLQ+09(XrN9x!qA<;D}<F9
zv_T=o7)^nR0LL`#f$La$!8)M<JRweC6!c<+a>^6Vz^9Zg3f4FkAwnoDeM}Ub!5W%y
zm1oBp^l4vyK<Q2TeXW|6(nm$1kpf0j(`8$?N=>~n?OcWE)R=Z!PD{rcZ8<GV6!<A;
zdJV(v41TCNEzHmlF;r3l8yBUf=3M3eH%Lm-oE9if3*<o8)zhA}XUjsj?`<Ik=?hOC
z<5{;)*X`3Kp;IG>uJDI`%zInMM@aTDCAMWWHIoD&6ZF6`&8iq_Ogmd2n5NTuL=-h{
zI$@la&Ok-z4SVnga5MmN;eTL)g<JOEEzGw)c$?CrqNq)pre)SmyIr$%$udEA&0<Bj
z2R}8zX%r&`meOXWS<p-ib-W7!4V%m!yl0*ic<DXM9=z#neP9pXb6UD=q~)|MXYjs-
z;WzEUd(~#axoS4lsM>?KiAw!dwOO#AH5>M`4f|Qzx?3L*LjaxEoxulVqM&EBnoZ3f
zylW3YukFFR=15aB%#o(3YerMEpEV)A3_iqGpk<*?>$)RKsMMOAv}%@)W?^(StA-4F
z>qBdD(jGjpbh~Z0i<SmPi3x!mh&B&CsZpEj&5<<Sum_(`G>d?-I|jc>u}*VDE-%Ug
z5n+<?IW~NG!XA7<T1l~~VdaBU555H1C;7Ml4qYe|icQ_D7tCsN1P^E1u&@;Bg?hoX
zDwbIk`c%Czg*VEzrp^)&(~3&dz$<mb)T?RIGHp?`w;z>Iy<pW1QxvA^g}OntRGD^E
znV5WT4_c2kLHSxv3%iu%KxgndeM6UX;S9hg?7=LQ60;87W~z>k>A;DCPTGSZw6bLs
zg<d8=pPC}!Y{K3?#iC5LIii{1ukTrU9cge(d;2t&+J7ZRHGA+Tvay(^j{FbuO@#SW
z1+-y`N{)*Wd+;H)0IehXsR$4-r)3X5B#vMYJ{$v~{17Eu4X0IUrUk|@>zo8Zr;+%O
zT4--SZ4XXOGr4@s89at1y!|x&5-oKG@6+1;aHOf}(`8YxrW@0fSe(KcJO%<Xn1Y6Y
z*J)!ogZIl5&i1pkC@_xDBSgd5ZjrRz(41`&P_}2WpPj+`P76v<T{G?NwmtZ;4l=mi
zLdM`_XM6T*!We=rXS=1d05f>MNEI3oBJ74X4!UhLA<l!F)-emUrlC#qlAeYjiH^<D
z_pfsIrpnZeR~k;s79(22X<7F6%T~kQe#Mgd9%zG(fxv^e`dP>?)6U=($TsJ}3V9_F
zRU8+MW|3MnO<4Zbv8%SOf%^&r3*u$V+4h~mE4n_`EKJLy_TW^psZUSWC+lKFm3j@O
zAobeYed`3eh_x+7rl;$5&DoyC1b{V|CKkn<bJZLbBS^H&x>+}CVES9{Q(Cv%)Zy(v
zwFeU=;&IH!?X6$YV|y1Obj{h`Dud>1-?z7ZRc?+T1#ukX_e1(cxthJbTPsdD+dqcp
zDeUb7FmdN<tzzlA#Z<Uj(I@QfH#Dq=F(S|nNuS4vFhe*7WPm}{%%<*K1)%{uu30s!
z2Gtz0cflkH(=1f9V#U%GSgz>B348lZAPWjvuM{MbG>oEr6a<lf;32_-p9{0XT1c@b
zMp!grxu^^x*8+_*K|@;h0AjN}m~~pb-IeA7DnayM$}*;^kSng*gHtuVRud)2AS}Do
zbRtFDZ`p%W^=5(T&GuX9Dbv&Kw~3xop||Zp%O)n5arf=FCI8$0Nxf-cxBSF@7CU%w
z3jEO7dJk<pRT5gmx$3lFIC8c(@d?_USDmY7Q?FSyd;47|JofgxplG$4z5U)uQ=8T+
zVq_YW$$nNJZI0B4EL-;015@Z^ECQpdk*Hf1g<9P(oxztx)eWZVhUskEOw|pd(2}Yf
zQ)SMs7fhn%lww*=$&{8eR5z?TOf^$=qh6RIGF~V{S*lfOxmK~)u;8jyOCQlt%9@(0
zVUeXOX^H3C7$tplRvQ=faZ$81P0!}rs5D6|KyJ+<Rdh~2p+UeaTRKGa`U$Npt1ZbI
zOJhRMRY^t#orZca=M3h|LQ_nYg{;@0Ms1%$qqa{`qX1B&wqbOrk8^8)<<<~7)1vWK
z?l;w<GdwjA30b>rpsHRf*@`n6u>VzANP~St)2q;vi$$<Z2p3unlcrflxkAF`V9IIf
zHuY~RCufc{MPs@OF-FR_#U_>*Bvi=SPD?k5BTP9hLXmVwTZ2+2$fUh}-W+Wf@Q|Vs
z5x_|c#)yVC*|48w1Z-K`zW|$q&1~=?<a3B&q6o2(*Z?FU6ZR*2>q7`V47VYL7^A{)
zTJ?f6cum(Q%hK#pFVul%+Y9B4i-NQLF(ELbpJ?{>r!-R}h%~f9xhZ*!iJduI&`c9e
z-P!(Fw?K$>d;3$%B$;~qQ}YpF5Q1K0yA|z`3hYaS)5o9+Z+{`bSEn@zQpqH8q@ov!
zBu5r4i@q%hr*%SLLwpGXC(SE_FkLScsvvRF_<+T4o)D7iStcb4)(KIaaCS7^-ZAW*
zGMQ`fZPfRLR*<WQzGLr<VP(_}a})+dHtOuyb|(2qia1F`J&%zO+tRqJCj?c0LYPgB
z`(7o=T{Q8PYNcTBOmKrnEdz!H&TuM*ndVH`J5yTm8&;u^+hM!~<TfLtR<`-%uWFo;
z|1~O_y;H8qeJPPe{zRooLkN+AEU<E}a%oJVOczQ`O}Ct#hAEg<7V5ODSll$7oyH^0
zl2&te8qW5|SZ*YRZhvf=q@6k2A45{RO0U+O?T@k2cN%0HFBD9Zm|n3cIqI8Q(cXD<
zxSMhW>S|VGUzp0gsTD_?BdU5`XY0@4wYo4gd*?Amn|9lruy;=DjxlM`Or!Ix#A|Rm
zNEJS%a;0JGp|tMRVSASo4+FXhS)%0(USm<?^P<pdkl%z>vj-o-@I9D?@R#G;=!kqM
zDp`bPy8T0Yo2+DzKHe)cxhT|3D_ibz$5@&mfz00iVXE!zJZ;1JygdtEXWBbYJA;=^
zq3ITcOh}E+_Wf#&2&D<LmqqGAEj0!V9&@(0ob62zJ(6}IF*`dgh~qoYk~j<MXjEa-
z-kBwPK$%i_y-MmhTM1CY-f7DcNTCFXvN-_(QGF7k7#gP+ngVv^YNc7yOgItD3S_Pw
zl1O*1!OU!wg)W84v8JK1Zs!d8`q!If@cgIk!CA%;mehJ@(02xXP}!{yq>*B04TAm7
z8YqUd^O`g0tM}x8^8as&a++-(lMhV;xjX$d7ZV{-EPwY&dXc&0!nw*aB(w?L-g>|*
z<^ha@xvI&Gf$|MQ9~A}|u!;Xoa&9?;IoOq)9k*eaWD*`c27@oRmL-0)0rrUoJ7ac!
zNDZ=g?iZS($f)~3>Gsb3oCyJDrwU5}u-ZX}m1#)kBGrmMsg<FCk<x5JD1-KeFWWo!
z(VC`i5`#p--ac<X3-OK;G@WnKj@emru2MCRp_;ElL8p{6_!S$iprJp~EGaAB5Wd*N
z`kcZ8Tox`m`!pm~4T(Zil<AW@_h}qWw$|9sR>cT?7>Wt_+0I+e)oB{Ctq+_XEYNA5
zx}8@Hp;syuQtx(tT7$~*zO(f~tzkGjKVhZg!&<{I!IDc8_Rf2{VVHvSBl51)4cNb^
zetY{obh>*#Bh%D0>4f?;Z6|x@eGAO9Z9_e@x8ApR-sh$B7_D|vjxg}sZ(-oK-=cwM
z(faFfuMLRLPv#|QrZ?N|8uGW>tO^fK(RSE=%h`TQP1N>VG*R1cvnhP%1Mc~UG;2E_
z$XP?8(kwI#aCGo|&BTb1dCf8_WCNJQzoa9z4bZNd0ryaCn0iV*g;-I}U!(L530I&Q
zLLW1s=W+sj#wx)5XPWS6INSFN{4mYOH9Wy@nUEL8n<KoO3)0!-Y@L0?(u%s7f~n`J
z24SO|f+IpJl<Q)|w2Jtb8^j-~L8!p?AfoGR-)Hd~)?duG&}!I<HBfIDFt0jSr6daP
zwN`+3wex`W>zxM@A~U1C^8hS*@P<iNEPL<<#?CY?Rx&foEGTcaP|>PIDu@U8E*t%K
z{uWkHCdD<ApAPMPSbImoAb|ZC=35x;$!1Ro60mkY(M&u()l4$8?)(ZqPnLzyMfqw~
zk%n<$Rv|lZ(yR!`Is`zkw%{QqD>bJoA~pJh1Jsy(e4et8&&iwuHo?|5=x$^R9uZn)
zy4chz?6;~IU$-<vuO6AkiqKiE<S8szC{`($`H3~Fqn0+pF0Lwt6BO`MDPx*X@$k$_
z1?=8O8uT&1HJ02l+B=`};}bmaPL+8dnvBw)YW(~}K7RufHI3$Pcye~(R4$6b<n-iZ
zdBWZ;>-O&0WUZ+;ChT3ChQrjqE?_s7V3tt><<FIa3CKP@Iaz}jB||?V^yA)!b9dLK
z&w-PciSqA`+1Y$fIJ*<@WC)UMXj&!8CLumw2>Y;B8y6#oUM4S)S*wlaD&Y_aC|;If
z>O~>y_AazYd$(cPyN|*UV(&JPqd8mGKsU4+EI!WG%QYR_Q%cqN7Zb=fkQ2fjwe$=q
zSKvR{ep4$!J1CXl2ek@?f?1|lip8Q?5xhid)Fj=imB>P1)yPsHHG0?(2v5FL61CtZ
zAE~jxTjP}kqk~zqch5^lw_%p?Jp=#2po4u^vv;4anax6t5@liN<e+7gvvp19U2H(4
zJjLE7>=w|6d+(OO`Qd{h<A&wz&Vu3BoU6|6ESSMAn-{OzyH`oC+I?A{ws)^NR|`#1
zv6`iZVb&_;vc3JohP?~Ur(5MJwtd|wTV?V`m#e~Hux^wK6|G{z$7fjOa<y5SEaUaM
z0j0^=b)Bs*VBTcUBDn#+tTsn<<$WA)7Im4FzuO1McXnO!Q9|x%7!=k)9LC=DA#x}s
z&))Tz2jqlXp_S$CwRb&>ImCJ55ZKS4m%ARUW(H>8A_dUM6hH&<C}y#!;!)~YWcS{!
zsmKr$&PDJS_(p10YO;`za?>ztCVZ2y6JROSDJn;+7ho8z7wTFC3;0iIO^{Y(@BV4I
zsq0qFvUj&wINjZ?*}L~y{&IGAOEj0eyUy+|ByxInOd!-k>EM-SwrR)|;uxkQ3b_*W
zV+gHb)W${8+4`hr@4jj8zGd&eZSVf10tZQkF@Yi}bN453)Y!Xkf%uZKQJ2<5<%}(i
z5+MKqwRhhui;=QbC|iX|8H7`)D-*PA;Ap1po)DH`eVv<UZ@))h+kS6M=sEm1MCnL_
z*|4ztKD<D?A7J~Ht+FGG!v)9rUDMuuyKe9PmA(6>iHI)K*?OY_2k6!(W?d^oE6a(o
z=9nm$&ekW=(Sl{W`xB^GyFYWbKB?3x0O1WX=GE=ppTS5pIUz=<TZU;lyANdZJ}L-N
zCfWCzG==Pb1krBy6G(r%9~CF;-A|?EYxh%@2jFkp{S`U+cR!~c`#H%c+n;C^sC}Pc
zzcEZU+fOu8!DR5o17gPR=TyZPRK*vn2-J5x%1!N?yI*R~?iV(-hZ|z={>s^f4vHq!
zgzoJAhBH(nFp<FT87aOhG-t0YJ3?%qGWP5$m2>vW&hF>1;(@t*su{Fr_9jLul}d#N
zOlX|2a)uBY8UnSsp&1oRlSsn>E#7Js)Y}!SVhZSqs7d9N(=Wj1#4$MIaJgxO(&cDF
zIxJ|@ruj8ta8tR74Woh%PdIy1n!VRR;!z}sBkw(meLmsrJtjpDXYUlHMoF65dyKed
zQJ@`_Vv~d@P@TPoC72@_R>R(F;0q-Cpc6u~_s&wX#1m7J&vKzDN?#KrLwz<)d+#hs
zOQ^_{Mb)zcN@F^^pCcAbb_m6a)E|00$|BouG!wJILWX3-$bMFdh6=N*p?2LQ8yX~O
z(j6P)Fe8YDz1QMQxLb8?dKz`KHQ0qDgVCp}%`9D-u=lR2D2c(`c+<#MP=nh_YSkW=
z7wURNF6liF^;c?RP2JvG<K?jDk2aZD7#7VHQU1L~tvO=vtpVli`L)U@IgKP>2(4mO
zcsbNcO|60)9v%uJt-zjBQEpb<lu7LKiq#yEs}(Z})=%Rpm%haF02tu3R5uyR(7j4!
zRB+n~qP?@pz&P`@-A^f=#NPW;#FI4jY5oRa!)%Udh@H{PO@kA1T(-FJ2x#4VR4ao{
z!;v&~LZoyW9&R2S1Mf?r+pwA?d+&!(&`h0v%gqr^5bw3j(Tv@m5ao()OxSxrCNhEt
zZDz9i%SWkM0QWN~B+cLrW}5Ki$kBn6Q#MD0Xq2H5Q7d@&;-^gf>%3OdE%R$)B+F3v
zDPeGbD2slGM3DSgF7t1>s-(!WDZ?7dUvC<!1@cWAiqYnXS(dw!I`t-|obA|XK7W<l
zR%@2z(9mzaS+w`wq9pxHU?|_R;N^j@29I*RYzVCikGWp0mZ6_=cA2CBB#HCvy{$M8
zn(($9SE5k_j|<vAa)&^x-1{kpxLmUeB#=9Uxf0y(_TC2tAu7E7%0;19tP1!SEI^>&
zsNfL+rD3ZD`Eu{Wbc78O2g#;KkeV_2!O}Ot2lsx#Yhe3LW+iWGhAmx?6wycaZDlVv
zY&Jr29g5g<{ZKw68WRE8+Ze8jjpHgXwN(I(wf8=h&Ihipj@|T&4CZ|RJN@3H<eHG`
zy!2^N>==zrfk-a*UP&8V#c2Lxgepx7^C63_Op!a(5z{oyvd|h_RgtWedQFjhMduYL
zRYe#YC1y;(_CO2NG7F<pG9n0ubgmD!I>uKZRquVO*?YeNk8^f^V`4f@g=87vlM)8#
z^O|WgZ)kwrA)#9kVs;;x4SVl%)3W!zbVMmb5C+jodw-`nhAoO&R>gAmwTdX{{ALZd
zg<2H?)9wS)a`q{vYxff@()|e%WA<D`_?b|s3PeVr2sryw^xL4~zoFs{^J|Y&kqKx2
zvFyQJ`3*$9{ZlZFRP6mzqfOo3KTRd3r>o5od;hev^VYOZUdM{F=abZ-HcbV_R8E?;
zYO~NVo&B@U-WJ<H_qI&x0HF}0s3Q%%Ln~QCIFYq~9`W~xs533ov`G$`)6Mj?nv5<c
zOoOyD0JUaOzHTBM>mP|?e%&A19@3Aj6Q?q2cGGb7ej@o6IC{lt79~dZu~xAKP|n_#
zLXgnIaIG@Ni^JL5!l*$7t&G9?ytif6Ox@l;MHCuAr8*ug^X#{z%(LHu=(69c!$-M4
zMN{4|tr~eR_oqyYbh`bkrDj0~xwi#KB>GAJ+WXhA&-SlzznTW|2FTYOrfr&L!z9v9
zX{%YrHnR6$Htqda#&l>ISgiK`%W3Krxq!!@r=vC^OZ%=2qM@df2(aIxJ!<c_ib8AD
z8s-TZdt&dm4h?vt=Inb=%<X-bJLJ>v+Eml9_g_1%H08fSzb_Y>V(e>86U}6LqMIgH
zi7~bJU!!8LQJ_=-wn(AtRdO(w%h(f)RsQ#qP2?!gRErb#{-(;<-=qwBKo=%yVSkgH
znG??bmR5pm6_Of4d@y4Tvx3PgH4!DT_a#c*CknNHA1VcG33%+^C#i7o5k2<rYh#6q
zHpZASIEbl)iCWc+nkHF38ak6GqE}<^e@jhhY(!{d>g3HBtkn%?f7i12-G-@Ku$E(7
za4^KO_g{nKjS?)hK-WN!DrGraXDxgG07Zd#gA5a6hS0~xVE?iA-@vyjV;J&^z5f<0
z+4~3f{u^}aVgC)5L(HNmR3W``i^_bK0R1{4^b?|PX}Qmx5S7O@T_#J9YZ_Evig?;O
zYl;!QYU<XQtf^WOg=)2GRbdv;N9EGw0U=wLq~zEU|3!*8@{1+XfLe*|*H-(m4S5z7
zPgY33fWSRnnQ-=h!bu{GKc(Myso(F~`-qy<oc;Id2+95jd?G^{P4|C7`U+0@m}F%|
zMCG(K&8Ik!MJ_n`0!3;L<|zDOatg*n?9iW9L8QKHU_N0BnPlVd?#nvq*VE4a&(uEr
z1&Z$ff{Tu#eZ;Vx{arpJL&<4NE2uP8Lr<C*%d9qe@fptku1cG^bj8`<Wl61~P-7`-
zOd7}c;Xq+i9R|3B7=7#ptifMMaQ_!{7Ht194V^$-JJ||$ALRJkM?A7PX=6J3A4xHq
z;uWy4Ex0&kw5>!t`yW~MJ~^%T!51}W|C2I4`!QZ92^}Arf=rKdU67fPhj=b&>C;Cl
zx<LjcFtxI@@Hj>#6;*UoXk#qCh=M+*z7Cn9q9lDXSy!;5stRN8e?e}HYTnvit!4*0
zs#VF<s?}<hIa(EK+^B+I6ySC((5|Uw26G%QOKs%>CI-?)b!XpJMuRWNw(vy?=IjQ$
zU(kZv{eq;{FG+$#hRhz|w3SXFRv1TH$~*hzR36$d(?GZB*M=2xziscIa+)LAC!9Uk
z-aiE=my!wW{Zr_XfkQj?{%^p+N^q<~m1*Lz0jQN|*!wM*=q$sk%6~<nIutSiLQ}0)
zi`ZOdwJJuiiLql|K`amsEl_n(jG#y3qtz-nBmS|>(Ugwb`)`aYkq|jKvWmbm_5CUg
z;(K3WbBX_~{;>|h|MbraY5KcJH;;esa;}^ZH)g`<Vy{Pk40kQ=gpuc+>Gpb*_y0U5
zn*UV%XZO!~L5vC^djIu*>W2LP|A_wt|NOsDO928D02BZK00;npc}QJ;$BQ~;0RaF2
zWCH*U000000000000000000000B&V>E^TRIV=iQDY*0%D1^@s60096206G8w0FMCy
G0000Qmhh1P


From 782ad91a6bb524d0f7da97cdd542fa37846d65e5 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 17:00:40 -0300
Subject: [PATCH 032/115] perf(native): build typed columns in native memory
 and hand them over without a copy

ColumnBuilder wrote every value into 32 KB managed chunks and then copied them all into the native block it returned. It now writes into a native block that doubles as it fills; a column built in one part hands that block over directly, and only the parallel CSV path, or a test tracking allocations, still copies. A SafeHandle owns each block so a builder dropped on an error path still frees it. On the 65K fixture the peak during to_record_batch falls from 26.0 to 18.1 MiB (10.7 MiB from 16.7 when streamed); typed parsing is 3-5% faster on the i7-1365U.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../GrowableNativeBuffer.cs                   | 103 ++++++++++++++++
 .../Typed/TypedApi.Parallel.cs                |  37 +++++-
 .../Typed/TypedApi.Session.cs                 |  11 +-
 src/ExcelReader.Native/Typed/TypedApi.cs      |  54 ++++++---
 .../Native/GrowableNativeBufferTests.cs       | 110 ++++++++++++++++++
 5 files changed, 289 insertions(+), 26 deletions(-)
 create mode 100644 src/ExcelReader.Native/GrowableNativeBuffer.cs
 create mode 100644 tests/ExcelReader.Tests/Native/GrowableNativeBufferTests.cs

diff --git a/src/ExcelReader.Native/GrowableNativeBuffer.cs b/src/ExcelReader.Native/GrowableNativeBuffer.cs
new file mode 100644
index 00000000..658a5abc
--- /dev/null
+++ b/src/ExcelReader.Native/GrowableNativeBuffer.cs
@@ -0,0 +1,103 @@
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+namespace ExcelReader.Native
+{
+    /// <summary>
+    /// One native block that doubles as it fills, so a finished column can be handed over as-is instead
+    /// of copied. A <see cref="SafeHandle"/> owns the block, so a buffer dropped on an error path still
+    /// frees it.
+    /// </summary>
+    internal sealed unsafe class GrowableNativeBuffer<T> : IDisposable where T : unmanaged
+    {
+        private const int InitialLength = 256;
+        private Block? _block;
+        private T* _data;
+        private int _capacity;
+
+        internal int Count { get; private set; }
+        internal int ByteLength => checked(Count * sizeof(T));
+
+        internal ref T Last => ref _data[Count - 1];
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        internal void Add(T value)
+        {
+            if (Count == _capacity)
+            {
+                Grow(Count + 1);
+            }
+            _data[Count++] = value;
+        }
+
+        internal void AddRange(ReadOnlySpan<T> values)
+        {
+            if (values.Length > _capacity - Count)
+            {
+                Grow(checked(Count + values.Length));
+            }
+            values.CopyTo(new Span<T>(_data + Count, values.Length));
+            Count += values.Length;
+        }
+
+        internal void CopyTo(Span<byte> destination)
+        {
+            new ReadOnlySpan<byte>(_data, ByteLength).CopyTo(destination);
+        }
+
+        /// <summary>Hands the block to the caller, who frees it with <see cref="Marshal.FreeHGlobal"/>.</summary>
+        internal IntPtr Detach()
+        {
+            IntPtr block = (IntPtr)_data;
+            _block?.SetHandleAsInvalid();
+            Reset();
+            return block;
+        }
+
+        public void Dispose()
+        {
+            _block?.Dispose();
+            Reset();
+        }
+
+        private void Reset()
+        {
+            _block = null;
+            _data = null;
+            _capacity = 0;
+            Count = 0;
+        }
+
+        [MethodImpl(MethodImplOptions.NoInlining)]
+        private void Grow(int minimum)
+        {
+            int capacity = Math.Max(minimum, Math.Max(_capacity * 2, InitialLength));
+            nint bytes = checked((nint)capacity * sizeof(T));
+            _block ??= new Block();
+            _data = (T*)_block.Resize(bytes);
+            _capacity = capacity;
+        }
+
+        private sealed class Block : SafeHandle
+        {
+            internal Block()
+                : base(IntPtr.Zero, ownsHandle: true)
+            {
+            }
+
+            public override bool IsInvalid => handle == IntPtr.Zero;
+
+            internal IntPtr Resize(nint bytes)
+            {
+                SetHandle(handle == IntPtr.Zero ? Marshal.AllocHGlobal(bytes) : Marshal.ReAllocHGlobal(handle, bytes));
+                return handle;
+            }
+
+            protected override bool ReleaseHandle()
+            {
+                Marshal.FreeHGlobal(handle);
+                return true;
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
index db105d17..f7c3b530 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
@@ -66,13 +66,20 @@ private static int ParseCsvInParallel(NativeHandle handle, CsvChunkSource source
                 CsvParallelOptions options = new() { DegreeOfParallelism = degreeOfParallelism, HeaderRow = headerRow, Reader = reader };
                 PartitionTable merged = Task.Run(() => ParallelCsvProcessor.RunPartitionedAsync(
                     source, aggregation, options, chunkSizeOverride, CancellationToken.None)).GetAwaiter().GetResult();
-                if (merged.FailedColumn >= 0)
+                try
                 {
-                    NativeApi.SetLastError(DescribeFailedColumn(specs, merged.FailedColumn));
-                    return NativeStatus.Error;
+                    if (merged.FailedColumn >= 0)
+                    {
+                        NativeApi.SetLastError(DescribeFailedColumn(specs, merged.FailedColumn));
+                        return NativeStatus.Error;
+                    }
+                    table = BuildTable([.. merged.Parts], ParallelCsvFactory.Normalize(degreeOfParallelism));
+                    return NativeStatus.Ok;
+                }
+                finally
+                {
+                    merged.Dispose();
                 }
-                table = BuildTable([.. merged.Parts], ParallelCsvFactory.Normalize(degreeOfParallelism));
-                return NativeStatus.Ok;
             }
             catch (Exception exception)
             {
@@ -92,7 +99,15 @@ private static ColumnBuilder[] NewBuilders(NativeColumnSpec[] specs)
             return builders;
         }
 
-        private sealed class PartitionTable
+        private static void DisposeAll(ColumnBuilder[] builders)
+        {
+            foreach (ColumnBuilder builder in builders)
+            {
+                builder.Dispose();
+            }
+        }
+
+        private sealed class PartitionTable : IDisposable
         {
             private readonly ColumnBuilder[] _builders;
 
@@ -114,14 +129,24 @@ internal void Append(in Row row, int[] columnIndices, bool isDate1904)
                 }
             }
 
+            public void Dispose()
+            {
+                foreach (ColumnBuilder[] part in Parts)
+                {
+                    DisposeAll(part);
+                }
+            }
+
             internal static PartitionTable Combine(PartitionTable left, PartitionTable right)
             {
                 if (left.FailedColumn >= 0)
                 {
+                    right.Dispose();
                     return left;
                 }
                 if (right.FailedColumn >= 0)
                 {
+                    left.Dispose();
                     return right;
                 }
                 left.Parts.AddRange(right.Parts);
diff --git a/src/ExcelReader.Native/Typed/TypedApi.Session.cs b/src/ExcelReader.Native/Typed/TypedApi.Session.cs
index 3fb46e04..98481aff 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.Session.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.Session.cs
@@ -94,14 +94,9 @@ internal int NextBatch(out NativeTable table)
                 }
 
                 NativeApi.ClearLastError();
+                ColumnBuilder[] builders = NewBuilders(_specs);
                 try
                 {
-                    ColumnBuilder[] builders = new ColumnBuilder[_specs.Length];
-                    for (int i = 0; i < _specs.Length; i++)
-                    {
-                        builders[i] = new ColumnBuilder(_specs[i].Type, _specs[i].Nullable);
-                    }
-
                     long taken = 0;
                     while ((_maxRows == 0 || taken < _maxRows) && _rows.MoveNext())
                     {
@@ -124,6 +119,10 @@ internal int NextBatch(out NativeTable table)
                     table = default;
                     return Fail(exception.Message);
                 }
+                finally
+                {
+                    DisposeAll(builders);
+                }
             }
 
             internal string? FaultMessage
diff --git a/src/ExcelReader.Native/Typed/TypedApi.cs b/src/ExcelReader.Native/Typed/TypedApi.cs
index e6eae494..a5d4baaf 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.cs
@@ -337,22 +337,33 @@ internal static IntPtr PackBitsLsbFirst(ReadOnlySpan<byte> flags)
             return block;
         }
 
-        private sealed class ColumnBuilder(int type, bool nullable)
+        private sealed class ColumnBuilder(int type, bool nullable) : IDisposable
         {
-            private readonly ChunkedBuffer<byte> _validity = new();
+            private readonly GrowableNativeBuffer<byte> _validity = new();
             private int _rowCount;
             private bool _anyNull;
 
-            private readonly ChunkedBuffer<long> _longs = new();
-            private readonly ChunkedBuffer<int> _ints = new();
-            private readonly ChunkedBuffer<double> _doubles = new();
-            private readonly ChunkedBuffer<byte> _bools = new();
-            private readonly ChunkedBuffer<int> _stringOffsets = NewStringOffsets(type);
-            private readonly ChunkedBuffer<byte> _stringData = new();
+            private readonly GrowableNativeBuffer<long> _longs = new();
+            private readonly GrowableNativeBuffer<int> _ints = new();
+            private readonly GrowableNativeBuffer<double> _doubles = new();
+            private readonly GrowableNativeBuffer<byte> _bools = new();
+            private readonly GrowableNativeBuffer<int> _stringOffsets = NewStringOffsets(type);
+            private readonly GrowableNativeBuffer<byte> _stringData = new();
 
-            private static ChunkedBuffer<int> NewStringOffsets(int type)
+            public void Dispose()
             {
-                ChunkedBuffer<int> offsets = new();
+                _validity.Dispose();
+                _longs.Dispose();
+                _ints.Dispose();
+                _doubles.Dispose();
+                _bools.Dispose();
+                _stringOffsets.Dispose();
+                _stringData.Dispose();
+            }
+
+            private static GrowableNativeBuffer<int> NewStringOffsets(int type)
+            {
+                GrowableNativeBuffer<int> offsets = new();
                 if (type == NativeColumnType.String)
                 {
                     offsets.Add(0);
@@ -460,7 +471,7 @@ private bool AppendTimestamp(in Cell cell, bool isDate1904)
             }
 
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
-            private bool Append<T>(ChunkedBuffer<T> target, bool converted, T value) where T : unmanaged
+            private bool Append<T>(GrowableNativeBuffer<T> target, bool converted, T value) where T : unmanaged
             {
                 if (!converted && !nullable)
                 {
@@ -559,9 +570,14 @@ internal static NativeColumn Build(ReadOnlySpan<ColumnBuilder> parts)
                 return column;
             }
 
-            private static IntPtr Concat<T>(ReadOnlySpan<ColumnBuilder> parts, Func<ColumnBuilder, ChunkedBuffer<T>> select, out int byteLength)
+            private static IntPtr Concat<T>(ReadOnlySpan<ColumnBuilder> parts, Func<ColumnBuilder, GrowableNativeBuffer<T>> select, out int byteLength)
                 where T : unmanaged
             {
+                if (CanHandOver(parts) && select(parts[0]).Count > 0)
+                {
+                    byteLength = select(parts[0]).ByteLength;
+                    return select(parts[0]).Detach();
+                }
                 byteLength = 0;
                 foreach (ColumnBuilder part in parts)
                 {
@@ -571,15 +587,25 @@ private static IntPtr Concat<T>(ReadOnlySpan<ColumnBuilder> parts, Func<ColumnBu
                 int offset = 0;
                 foreach (ColumnBuilder part in parts)
                 {
-                    ChunkedBuffer<T> buffer = select(part);
+                    GrowableNativeBuffer<T> buffer = select(part);
                     buffer.CopyTo(new Span<byte>((byte*)block + offset, buffer.ByteLength));
                     offset += buffer.ByteLength;
                 }
                 return block;
             }
 
+            // A single part's block already is the column, unless a test hook is tracking allocations.
+            private static bool CanHandOver(ReadOnlySpan<ColumnBuilder> parts)
+            {
+                return parts.Length == 1 && AllocOverride is null;
+            }
+
             private static IntPtr ConcatStringOffsets(ReadOnlySpan<ColumnBuilder> parts)
             {
+                if (CanHandOver(parts))
+                {
+                    return parts[0]._stringOffsets.Detach();
+                }
                 int count = 1;
                 foreach (ColumnBuilder part in parts)
                 {
@@ -628,7 +654,7 @@ private static IntPtr ConcatValidity(ReadOnlySpan<ColumnBuilder> parts, long row
                 return block;
             }
 
-            private static void OrBits(Span<byte> bits, long at, ChunkedBuffer<byte> validity)
+            private static void OrBits(Span<byte> bits, long at, GrowableNativeBuffer<byte> validity)
             {
                 int first = (int)(at >> 3);
                 int shift = (int)(at & 7);
diff --git a/tests/ExcelReader.Tests/Native/GrowableNativeBufferTests.cs b/tests/ExcelReader.Tests/Native/GrowableNativeBufferTests.cs
new file mode 100644
index 00000000..1f394a4b
--- /dev/null
+++ b/tests/ExcelReader.Tests/Native/GrowableNativeBufferTests.cs
@@ -0,0 +1,110 @@
+using System.Runtime.InteropServices;
+using ExcelReader.Native;
+
+namespace ExcelReader.Tests.Native
+{
+    public sealed class GrowableNativeBufferTests
+    {
+        private const int Count = 30_000;
+
+        [Fact]
+        public void Add_Should_Preserve_Every_Element_Across_Growth()
+        {
+            using GrowableNativeBuffer<int> buffer = new();
+            for (int i = 0; i < Count; i++)
+            {
+                buffer.Add(i);
+            }
+
+            Assert.Equal(Count, buffer.Count);
+            Assert.Equal(Count * sizeof(int), buffer.ByteLength);
+            Assert.Equal(Enumerable.Range(0, Count), Flatten(buffer));
+        }
+
+        [Fact]
+        public void AddRange_And_Add_Should_Interleave_Correctly()
+        {
+            using GrowableNativeBuffer<byte> buffer = new();
+            List<byte> expected = [];
+            byte[] source = new byte[997];
+            for (int i = 0; i < source.Length; i++)
+            {
+                source[i] = (byte)(i * 7);
+            }
+
+            for (int round = 0; round < 300; round++)
+            {
+                buffer.Add((byte)round);
+                expected.Add((byte)round);
+                int length = round * 13 % source.Length;
+                buffer.AddRange(source.AsSpan(0, length));
+                expected.AddRange(source.AsSpan(0, length).ToArray());
+            }
+
+            Assert.Equal(expected, Flatten(buffer));
+        }
+
+        [Fact]
+        public void Last_Should_Address_The_Most_Recent_Element_After_Growth()
+        {
+            using GrowableNativeBuffer<byte> buffer = new();
+            for (int i = 0; i < Count; i++)
+            {
+                buffer.Add(0);
+                buffer.Last |= 0x5A;
+            }
+
+            Assert.All(Flatten(buffer), value => Assert.Equal(0x5A, value));
+        }
+
+        [Fact]
+        public void Empty_Buffer_Should_Report_Nothing_And_Copy_Nothing()
+        {
+            using GrowableNativeBuffer<long> buffer = new();
+
+            Assert.Equal(0, buffer.Count);
+            Assert.Equal(0, buffer.ByteLength);
+            buffer.CopyTo(Span<byte>.Empty);
+        }
+
+        [Fact]
+        public unsafe void Detach_Should_Hand_Over_The_Block_And_Leave_The_Buffer_Empty()
+        {
+            using GrowableNativeBuffer<long> buffer = new();
+            for (long i = 0; i < 1000; i++)
+            {
+                buffer.Add(i * 3);
+            }
+
+            IntPtr block = buffer.Detach();
+            try
+            {
+                Assert.Equal(Enumerable.Range(0, 1000).Select(i => i * 3L), new ReadOnlySpan<long>((void*)block, 1000).ToArray());
+                Assert.Equal(0, buffer.Count);
+            }
+            finally
+            {
+                Marshal.FreeHGlobal(block);
+            }
+        }
+
+        [Fact]
+        public void Dispose_Twice_Should_Be_Harmless()
+        {
+            GrowableNativeBuffer<int> buffer = new();
+            buffer.Add(1);
+
+            buffer.Dispose();
+            buffer.Dispose();
+
+            Assert.Equal(0, buffer.Count);
+        }
+
+        private static T[] Flatten<T>(GrowableNativeBuffer<T> buffer) where T : unmanaged
+        {
+            byte[] bytes = new byte[buffer.ByteLength];
+            buffer.CopyTo(bytes);
+            return MemoryMarshal.Cast<byte, T>(bytes).ToArray();
+        }
+    }
+}

From d2ec3cf776df08dc08fb8f85337cbb61ad9f3c51 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 17:07:19 -0300
Subject: [PATCH 033/115] perf(native): regenerate the static PGO profile after
 the native column buffers

ColumnBuilder.Append and Concat changed signature, so the previous profile no longer matched them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Native/pgo/excelreader.mibc | Bin 65834 -> 65999 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/src/ExcelReader.Native/pgo/excelreader.mibc b/src/ExcelReader.Native/pgo/excelreader.mibc
index d02ee0ac14834928031687233c0e24a10b3a096a..e08a44d4dfa74b918b8adf2966b2cca9a517806c 100644
GIT binary patch
literal 65999
zcmZ^~RZtyJw<L_)!8Le*gKKanxVyW%ySuvux8T9u?cff<9S#I1z`-R1CinYq{dK2i
z=55!0SP#2uuhreFTSXog4i^dv3JIztM#eA$(rcm#4Gjfl0}F-v@7BrEo5j)A%$&u-
z!Qr<dya&GY+Aa_n@tL*zX2xuAN2t8Br$^mj)2w`X2VRe1c_&dVw7X+@XQ!|Hw(TRw
z+RE!{hAAR4!11;ydDyqveb2Q>!260+aNmP<^sd*f@Z|5`juXd+kpaqv=U`&N`I@12
z%^Rl%h{9!^Y<OXnklpSZ-r(Yq{4q;WKV3Fo;LQOwV>n?;_z@y2`Y|iI9~vnklODUh
z*WFYG$N400)Wc)1sO+SXnj6YI%zNL7ujpu5W+4yb=v^B8<tmlBAS*=B88Gjd`mBWi
za{Ms_67a~zZ8-fjUlaH7>imrOQ9+t>fVQJf(NX4;Avk~GX%UxoGWty5W5n-Tfmpbf
z+?m&q-)C2T;;U~x;g;H*MpwaQEbPCZmP2+M((Eqc?n8PSELpg=v^5@VedqTev76SX
z;k>eG;jE&UmSyqc{~Uwc>h1bLW>|RWE1z}Zzq>dzboB7zjdQaT8T^F57yj~O5y11<
zOT@g?C!ZAy5vZ*6C5#lXhO&ksfX#x+g4Kr7hFODIEB7UwCh*-=%QW!}qe>HGO-Fmu
z4O>Z1y4hZk;?seaZ*;n^>|g$3#2cX1_-0l(SrDCi3MiZB-?lFH;FL%}T;E^4aN%3D
zM!;D8>US?2aM@W}KsuaCx4Y02OFR4+gxX6E5JdM8gus!Cdbz}(_~!J^JA%9B(8+EE
zli@%A7G#)|XYdU1n`*k9b(@kIBS=XA@Jx0X&xmB2OiNNBCi@khv`By|ZDcnYWCeI9
zWh7I~sBs1BsOocplymazl*bP&HkKvl;oP#OvB%Tcq$Zhkz|orOVUH2oiI`+BDq;Sh
z5!&vi{7)j897Dg)s`e!m;Aml$;R~g#+RB?bvtr3cUuB<GnxhNIAJK|D&0|gCuNaXi
zarj8Fio_|em``d%J)$gNeTl@&%yGRFQ0}I&2UYpG3ZETE=yCXyffUxFS}WGE2Dh`D
zTb?cy$eQA>GooX98!hsTrSbES-fcC+Y*H)zmg(QwEz@E>Ni1SGyWi~@c;!1ht#_NO
zfc}L<+|}|EARY?HEJ#131I8J47rhtOhZe#D)&lQ<96|mePie>1^m#Shd6Kz;V96gf
zZeQZ5!{le`-Q(x}kd_tgMn7L8Iw4;Dv^`3%r_;99&_t`LwjZfIPttl$avhpZ5DA$P
zMhZZBW`kgXOF`oy$*@JAHFZR_^eFg!igzH&*bTa6>j~(IP;mU5$B-)>zffu&D%~rs
z>XS6|zxnxlg-c~wFV=zkcg%{%McJ>yoCNwt)L~i`cGS=LbEnM!!ARjd8VECZ3*;=b
z_QP`iTieu-)mMCoK6@S4l0EOo$k3AFQaAmki6U{WjXNd&`n8It2uv`{JL+4chLI$D
zz1;@Zo17rJmIxUL+o9w)NIe{;FcdD&xh|?F<)<@9M20Ec0+cG)_k{ufD!cjs!vZ%r
z&BPANQRl0BNx(be<l7MoD4R{UKZB<s;8b-~pL9vaQ{Vu2nf}n>uNz#N#k^12)e5cW
zS-|v*|31C6u8XoPBX$UmHjPj0Ve#;`_eEVsU$c3uT1___%fox-o@?!ERtpKeDVINT
zt=6mjkALsssJr~SF4Ts^qtIMyTUMJk7&4b{tu2Re!@KVEI9NWQrcy0lOIXd|=fP~)
zDp+ITYguNZ(C%j5+>0d5b$&`gideFOdr~7p4ynBOJICc_J@T=+1Cma(glP%c0Ff*T
zF|3<ch@BPPbB2i6;C;_i4FUMBWEq(td!;yRlurnmieIL{8RnB(e&<b-96Y9cVl1~u
zGeF#m6j-O*mK4lg1TYP*P8=`|yTZI-qyym86pXM5yX=xPw1arI+QsbE9KH&^J}O*i
zy%#4SH^mm*&{$IZYKA9D!~bDJP*$Rvf+y%=8{YWYQAQNl5cPo6Paj>XP?-Yi3Rpjl
zPx=%<v0W#I5wG@DW&Gv6Hca6=Gk%d5FlTCUKE?!3Nx|g(M@*62tsr4@Uz5q?UQe9I
z@}rB5iVcn6H)eBWZZY2hr9<~02UZAoj3I2gXsj8t=)k6kx2CUqrxx&kN6wr=4MKVR
z3$rRu5IV#8O9Y=Y3A2ApFJW;lBmy;T8q6Z4=IQ@(n0M;dedp`0%{pfu)}%JLh|Ks&
zn(-5`uB|QEj+%FIG4>GdtUl!O7t;*N<+BT>3tQD(6nmNy^Z@0`PDq_;0(F?VM~lUj
zPISu8hw_s`o7kYt`Qou0xk5!9w7w=lAi8*e6s+{A$~i-m8sw|5g%a7z-|w*|)}+N9
z-r&%>xuzFW@WnjAA)^erz}j(sljflM_a?rypTKoK;o9lci7h&?O@a8NwuPumTQcZ2
zXceRIX}A$bMo1$S`t7^3Cfq4Kax^@1M<^RRa66JNoI|#~K>^*o;1ky}Z44!ym$iyO
z&KzG5=4mk(yk*W=eNip@waTomG%%64mu9<ElgA18EAQx5(xsBo8X*(UfY~qGZlzoJ
zEVypD!B8`cvV+^9>{U}M38O>7hnqg^yw7|?Arq;7?JrpIz02+s!@bbXsW^-l)MnnM
zz2h8U%f$qn)_b|P`PxVG)^TExA`uOFZe;t@@5VPYvskc_qCZJL&LB^&2G_<N?^Btg
zn@sMUNLD%JP<&b<l5clbB#;{jnX4J<yV=vo2>5QDz-P171@bNPLzsfxh0k{v3lmg<
zjFM5w_Gk>zvZn8_2fnEHBgD+?vuJUDF#M8<R9+ReG8bldQ5oS3VWA=5DoXtJP5}B4
zvxWif(&hy)9!Ke=5_E~WO*WcrEbgWCiOm1Kpp6g;XZne<yiQT3)AcyV(81(@r5nc8
z#<AO)U}4Zij_`R6c7j4;)&q9v;_$Sd^iiEGbhg%%rlZ2cIgzJ3{%aT$jBv&mJ2A!v
z@~*E>8@Pl!Rvy;?N-h2(hc?<<+jB7?#K01#_I@tbmksO#(WB>*+qnWJ%B&v4cJ60n
zK%t3y`ouTLiXPq)KDN4d+a#^!a`dV^rIkdC@sTti%H2a8OOUGeUr!zUjE$+ai>mo-
zg$p%}eao>kZ9m%y>{@DiH|s^T@WgIm9?1y>i)=I0+G2$(JD@ijM6V+|2pzqSUy)kr
z3y4-a3G2`gv0tmo!cB*gcQK=|(}_nYVmF{=a@F(UF#C73x<?{JS&4t^$UX#@_26y?
z#*lo$XwcW}q)p4};Byx%IQEQviP7kYN_+3h^@OMokV6@0aF9mkExXrUHe(U}tytEO
zx~k?P{-dqgSEgAV!&`DW+}Ts#*TT%)wc|%Sulb8|dYL&xP?~py?zU)@yGyFWtfD{A
zwdu11IDy&s^v)tZf|F&bl~LBFzf_Af-G9r98;o=8*pKoMwI$zfmhDL8`Azm*((&Y?
z^vV14fJev6-h2w39cFUk=`(V49qN6q|Kt!2oOC%=N9CEA!Kg@&byz@=Kb*hOpF@Fl
zlTbRAqEgE;uCQvZp}Nb9s~a}f34%&kUy_G#^t0j*9xo2Agbdr;VW@@&v7L@+d1PJ|
zGwIDEk-}f*;b*@LmL^}=*+Jxj;r2R|bXmXU=zB|BvT>UB6MG|ryvc`pui3u^WXfut
z1f1QNhpS7Q)jEwncL@mUdi#ki<;Wn$8=wC)&RsGlS}-mHvt7)z5OjB^H_dndqHSBm
zAJnvX`rY8Q^v2L6sv*2tS%SobWuSn-a1ynBjy~8R`_}BGLvEos#qeC)bN`Aab<qL3
z4%zDo<Rg|&&3)V`vpU-Y*nj`ahTHr#RDFrB0(u&DDHJb+5Htm10KqjfG!ixXb=Nyf
zMIQ4<t;}LGHR@GKb#L9B;n&nD^I~AK5ZYds+EKpfeI@saJmG3;AhW4-qLSbq&P4Sg
zH@ggv{&(=QD)%QW$MHFimpP8iJM4Q-RHQ3z`9xjBVz{)g=b+7|-0EU&xTqFad3K?Q
zp&uXm!@F>h!|gptBfT)QY&>CSBPm6~Y4Jcd^)4iTWT~~qcz%}GJ}!;Bt#4IY79bnq
z<<Wb`b~!cSgW<d;V|uFFkZbrDHBwstDNq&@eM9O;*%*ihQ~|OA9RrEFCIL!du2sVp
z4N=hXs)e1a$lzA47sp3$H?tQhSDM0Yof*e%xOL3Jjf{Vennyo{P9^PMd|;`jWyi!V
za(sKpTxK<dS#?4Sv<l(|7OMPAAnX}!Jm0M7IjR5dOVlo7hod<6&9u`Cm@l~VIw*Re
zC$E$gRNrkQR?iP5(B(Mg*Vui3sIT47>`>m&(1Z4p@m;^mWowmhXD1A9Ny11Y=QpwH
zeiH4lAP7aogxn&#r%YhlN3p08C&l@!gONU~I+#0-WIJ&w5p_8cPHj#4oAJ;92JN5B
zUlVT{+G7ji<Dw@k4DADyX<7s~=42ae@I_OIc;^(GDuSrUI5Sj<#QDQDZr_C0Ye0jF
zn<5{iWX!B@&N?FO&WPW89w_-Z$%1ceM*{w~?cAlw(L(I(tRDKTzWk{_2u}Pu`Da6O
zp#fEMRL;NPG_m3;{c4xXD<yJC&1fIb|5JB^0A<ae)tNJr<X4Kxcc3g@drBj-Cnapm
zyy@bJO_5O|eGx3y-DhvODHi)<bG85sil()uymlqREizOtuS+e{nG=HYPPWGuhGW4R
z{=z@Z8Q=BHIQiFf_=Oc@TVTY0{{9lQ*Q)Qc`{qY+pnYjM-=tGmYJ){lyJN-5hw?{~
z95mk5B9@`Rj5m{OX(vp0f!`{aZuFB1+A|`D&_M`Rgkh}J8B!kp>*Zt?iM9Vo%B1r1
z+0k5@y}9O4&D4#}4`d549k<+_f}fB`JqLTqCzn}GapeTM+9og~`XumD)sS7oWcHzV
z#O{wCc++~;vT>6CQ(q3Vl;DZpu3I@l?ca=poMu@$t1!;!bFM_X(r;e06Ern}oOw1f
zdEa-gJ)JSG5`+CAiNpYzo2MrArH`VWBxU(zi!_E~3w&qXofg`(%B*U+igX5B#hjF#
zORgY<u?qz-6W9Tq9}`X-7zfT<L(ZDIWc?t%3@0}YxBc{RpsxhS<K3K8jr81&K5_kp
z?~Hb7ob?LYjb*Z>m(#Rm)ZBpdik_6idjAgsBe`%tXMu4#X`p@1qF|aDZ@I6vxtw~m
zbdgQTglZb~S(B5>-<{p>2m%#UO%Uu1B<h#J$)%z2EzurRim2$`x&rY5z|UJiXnaU~
zsJslxib1`Q{n#sJ0pZ|{b;K7IPvwwW_mm*2I=a<yT5J_6*oH3zXQntB1sGJ6_l99;
zHH<pms{IsSju49s!_mtL?StBj>q0$M|61z84TmZO)!Mr_<PJ)zIQddsBMQ)f`U)*9
z!?#$o(mj?NXG_F7w_QK?sTL|x0x?9wNM}{s-95>VsptOzgdjyb))#&}t{U3-;47j?
z&~xTZfe;L^t_Yf5ENv!%aS!NP+*m9t1%KB=U9-(7)3qXjz&8aMvX{QlnAht?kg}zM
z#EwvWgvzNL9B<l>P?bCtX2*JQ!sj3@yFO++BT>fJt1jaRH>I5Ae%{udA>Q3oxZt~$
zG5SqPiuFvNZt$H92*9SP&AXP4{HUKi@`2O8g5@i=&vCyGC~X_@<Q<5!hz+@HA5Edy
zCDoy{u@SCA^Xi2^18L==iVmWMDd?wAhcz9p8dzDyJq`kR6y<SOQR8+Q8>IfqEneBB
zU|={2qnVd;n1Uh-$oRuv)yBV`t7spoheuVa(JS3Vc?B$oZ+`!Ew$J3zIG4P6_&k`@
zF|~kZ(+BQLoh)OGv&Zxm819CX?1R)W%;m!{y8?_(1v8x3fV$=WF)dkK+0&v6V{Gv?
zUM-iJNq%7qV)cQW)jCnLNanhUXMSid%r2x5Hn1OfAA|;?3Xz6Mj{8(Ax+=l&dftMX
z^K${o4HW_hjs>NM&{p<@4Yy6`^NO5mG0)u5WBD(^<f{UH_f1ue*h}FCN3j1GR;i>=
zwuYI9DMS;b-N_I^;yx?}o!emI7NnN3`>}{Q!a1?G=T}pV49eeVL?KpcE3sSr>bqxa
zzQde-0nLH{Ap|h2Fh;1`Fuia-^bmIN(U_2e&N~c$pq$hX=DKj^QVm{ghpdDJ*$RP9
zX=T*_M^nuN$+74^n(plZ3W)o9XaVXyp?Y}rUmqI~g@1efA+jhE2Snrva``4u`0MVc
zFv1g)3hIq#Q;xwE6(|!pwlA+GufKtxXHAs@MsjH0Ovd4nh<DTF8j>lWlFOy1!Bz6F
zkIM^R)^A);@V*t1`OMn844F31k)<*hA7{gh{!CTo7sHl(9&BzKjQ+{tOpnd!(|{Z>
zP&>Ka-Oqz*54|ylz>180^HS%)dJ8A&3Fp@Fjd?8;MzNY%){wKR2I#p`c9pigWMFn5
z7rqjePGh^M@y>V2W@J04plCECvPTqx4c5o6uAy6|xx7OmJkh10*XhQ(*g-p7RCqlM
z9$whwl6*)QU)WZLD%zZ_P;IgdKe`+yduSa*%@}a@#buPm<8P^vR(SKze=|k!Rwz#5
z(_#(aI%u9;-^#kcu{vtImx*nK@#`RntGswv!%(_5cUVOm4Pc;Z=m8i)be$srl0-k4
zveI1Rjz=T7UOHpKbO)Uvy)=;m&dX+~=Okg%A6-3IaSQY0Zze~$9vLmOyAyj>I<h-u
zIK}$IU@NRaG{4rv${4cN1?qzRv}a?+Dt(n|eQ$M!Ny_{1rJ7=;Zx#!@-K?KFDsM09
zn#f7&=A(n9wm%R>S7TdmboxLwqsfN*m%76y!-=0|j>E|B1qOX;wUzNML>Bx%uT%^|
zs!g@thn`;r4vq=)5ZlzJF^n!^TbEVirVI%c&@ZqHrrF&V4RbvjfI{D8G2|DAbMHHW
zwy7u*e>)#<n2ag-(0Y6?%bN<#^rq>h$nzS5kITeozs{f?_LSMNRHe!DtESJnS&56B
zt}xaHHo!FebptJ<jIx>1GDPA*jL5RlYr$|_aBnVjnsQ7G681fGF%W&MRBcL%!&N~Y
z#<+5prF9d|>da-+Xu7bpQQZcl+jSNrz!YLN>#5Wc>)2<qDp~d~F*Z6t%A8^gj)!n&
zS7xR(YV8qIu*Hso?HdOvt6}lG>MV&Yf7q_96r4ky?^ojsmU4(zB6S!ZejT+u9D&Vd
zIYT#}lZUqLVjGZS&F+@@ttI@&c%8%#i#msqDLjKKZLaqi?JvF6sp4TOh^5@e4mk;>
za*;yuGwSv24Q<mXd_Uh0qjeAesOUnmgqR>xX1n|G>eI?_Q(k-cb^<)a@2ts=-7%g!
z(;a>QP+2lEohaz((OtN8k94`?R(}QsE&VhJxPD={Fos#~JE$Yvw)LD`G9oZyj@ESH
zt~D#V<u?gC{iLevS*FsYDe_YO@w)26AwzDpqFPXzE<jYa9q{FRU(VS#k9dBOe{1yA
z;FYz$JS1}^!(YQ?h0>+Jp?ID>1&+a9Ut@5ZjxYv$Y_j=|?-Q&o(qtWf)$+(hjcu|Z
znfv}+F_zF5MCgRVi76>%RCrpq-;3ztw$j}z;`ZrWV#amW-n)L55;=~Huh|9X#@JUr
z2S#$3&|D@m{>Wm4KhMhHzED1roi5x%3>R>BxH(5~89VCgof##nL(q=8!xT+|BM{HQ
zXTzuk%nXG&r?pwB>qFz3gMZ90NQ_2ZI{Z)xo0O+Jcy#6J<iNhX$Z`n0`k#D)%lxs<
zcj{f&tcrGR@zvTt!c3Zeaui>|6To34BZ#{GA#l0ohz%F?@IddyNFJ@YCt4c!9Fbn)
zGrj3JOJIodpuS&`z-1N4=e-uS+^d1DX>pNUKx4Xo>O!OjnzayJOSf*x9%+{K9NBsG
z3dGEhEm{NoYBta(6H4Al9&CIVg7loEU!a;HpCJ_B;hxC=efxSFV)yz}v&d^~j)3P1
zHMW(RR9?zm0LsI16537d)!JE@w$qp(z17ST{je4H<xlt8?30lMU+5zOme%e?syV0J
z=wbv?aDw)cW-Uz(Hb-yJYo*V{scAAaIifIh0QNI3#1_l}vJRb3bz&`Nad`<DN9g!{
zV@7GP<xLbmv)PuN+yCx4yU+t~R2f?E@*UOE=*CgYWgMj^u~6E604f0M85?2=W-NnW
zA;lJAWuJJ_{+vYeDqc8ilDvKlPkc2v+N76|cYI!BZ{w^ga*q-9FdSEYykt`D!k7{J
zcbH%jtHpL`@tq7kJ>sCN6y%&jQr$F=`^Q*uD5*rmqZGY-%%*K>Dlg`N8Qb0muN`3j
zgQ8|Z<Y4IQ=zV*S*~_=SB}yMQ0G5(EasUmsj)I^%pJqILsjiD@+V$tV>uv|hCV%A7
zQo+=ebA*?{6*K$dXDNdXeE@qzgnz?)fq(v$l-^AeQ>>5W%N`Xqx%{g4)S$uai`zr)
zLay~J%r(&-N87b~Fg`I!N1st%-1dofq5IBLKh4UoSf9bs?Gp-FtIZ`XGsY<A4YFS>
z2(}6Mw6^#TofzKvujr{KivsGG3%k<l!C-Wf7+6(`__AIX^QYqJ)u_XoZj5Q*19w(D
zuWKR_`?Udhh6jE=?2p^f4-v5-VT2%<H{54Jh&z~|%vUVvIqF`n^#Z=7Wr%kG_)aV(
zdx?<O9$h#<Ss2SJ5wv`dk84?3<zk%favz#;z;dgf=rTT;P?J}3t**(mCt=a%`Lnsl
zdK-(Be!KWE?#bxWV8@T*Ysyaa#BlOaK?<Ihphl1UF9F1eo_-N45TS#Y;;=vO6>Jm4
z;*vCf!9Ib2N2;*DaBqaq@*aUv$yuLU*Q4KletZ93ri^jh1}XW1_Y1My;nC%eIXC;v
zX+)Ad=OHW|>7~|8ce=7m*oih!drZ8Z?z`axW^m+JFS=}I84-CkU!hw2N#u|ZYQpDP
z_kh-)q20W0ut*wf4-3ZWQT*OENFLuW%u8tusbtr(L+h7>pY3&(4ub2bkJe7pedtQI
z*dXjM^C>Va3fg^k1jr;w8-T?GQLNqclC{6^Z+Q{w)^q)8^qXXDWf^lqJ4QCLjD3XH
z7wd)-V8w4~Sgsj(6cdhxiMQs3iQmqNmUTE<#*zFJ8#vP+iK2gxb;srhd}focTet1V
z89n+^<Z2^oU??e0$`M-vSKOI!P(BnkDFI$aT1ryHlCw3kJ;(9&<|R^>Ru>>xl1aEF
zO64kbGcP?o^RFvMJ#*7m(y4Or8UJ>6R5rjl>0STZGt;X0hkM9f$XzHRGyx0&bXG-|
zIusDBr#|W)N6<ckD>xp6q1|53xu&G}s_<_N3sg?0#D|AQ!)QZm!>&OEhd6yJ3LSt7
zhQES&M|dNBMuf1IxJOO>Y5iWCLAhk=HCK}TOS+%JWXS~~U#18Z1tyTAGyKk9p8DCM
zK{)dqxG;V&;JKql<EVKnlpDZGy%#kXbbR_dIOL>+b1)nwpgeeMIis1czy2HJ!*{S5
ziJo@6E=QOY;|WD!)*>7RBhtLnF^)jW!7OAxkM^rE@?>_~yV#pv@Jg+xdW@8}Bdbue
zy?W@@XuScV!1A_+etd>X<7}c3ahQQByjFiJ6f;?kYtew+;`PXhu~k5Ug1Oa{b`eq=
zqbz2qJVJ#;R?mQtL6u}ZsQ|_a>35AVa1iDrr)4CPckf1E)Q<X8@$OisT2n2EmVa&%
zjkbSlQ%ZjG>X`Y(i9AwdAj|0SZBcOQW!<Qkx^hQPmTh148%qhhWr%q3?_i#Dl@2WS
z1yxT13LLZ;Q)i)_z>{Asgomakd*DWkR~pLgmz|`{ZgZZ^taC{^Z@ewin&L5Hw8%~7
zzV8hZ!}3VYdl4y+#db^uk@-Mvfa9^%8GN0BCKU6AVm)Vlb>_I?qWqQGquN{fZ&=bB
z#Gc^qZk2y5GTYLAeI2ON4hOS%9Myq(LbpPmpswL}PlO4~GzSl~i8)tw44<TW3)pkK
ziIXrkw6?JRBq0fDk>1)G=~u-YJO{HKjA|AHFxXYRiNJj*UrBWs+RP{k*{Y1MfY(<|
z@rx)zGjt}K!P`?&3lWxs)@`CH%1~LcfApsRSiD{cp6gVo?Q(G`yy$ADY-7;ON-3Pf
zc%_y@g<li=4h&DY;(LOQRLQ`+rAC}ZU)qh0^B1l*b+a9AO@B8I`5-7IqRHY;xc$I>
z8z8x97g*=Rqi$_zHlhg1&<S>YkP(+%M5Mhyq#}>A)|1c$nlf6b`y(;bybLN~89s-Y
z8#>R<NO|y#$JH-daCBFz51sZW64B^-WG^oj4v25=Nw-O%J0|ikeqca8%r)!}f3B*$
z2ZwzWg?5ZG?5|AEVqfVIS-obN(T0&ui_H&EUK)-*@{}`Q@;ra^t-n{ieNf=$V)t82
zTt&?hO(I!~e=kdEB=t&ThTFKlOLU*0;;wwyJ5au;x&pL0+-<a0DGCBrm(J{j8xZgv
zJWUdJkOLOnJw4^OY#w+wr7TOhQVo<MVr;m%HO}WEXH%fvc8K-7KKIHMW3-QLBOH*;
z@mNwk^XJ*tcVxMr{q3fiF4At$oZZfQxXK>@&T}fxN2I2D2i=u*_-69F=iehKZUOsJ
z5q(WJ?o@PNu(FO3G0{zfFC-a)Tdwn*p9~8EPXmu1q}HY2>pvCDqnw#*o~3qaOEckA
z134~THHjswU~2)r1vBKW*0Soe8f=}ySr^QGUwfFHv&Xz_iL#m&?;8O>OC9jO=6O=k
zy4r9RSSp&f9MCIN__4jn^BQkpvYFwP`C#4A>a3m~SkiCnA~|64Eux&tsH0v+A-Rn2
zCf7^#9>}r&Tv+LQUeJ7%SD!g$cz}QY_|om8i{j0Vu-o+%UXI)ly$JY%D1XMP_$9o2
znE?DTZnFQc+6L~r!*y24F_O#Lze4!`RcK`UG~;~{m!n%Q5c)khfyF3usDL@N?lH)t
zO)7+Y!4B!3!syjWo{}5m;jq<sr{Ar{sd0z7eBeVkg2Y=h1F<^+o<U<S_x6|f4@o&)
zo~y{*-)O&Ke*;K9y(9o}e@BTCzn-dh{@S@*X(6`54E$!vEp4RR1(hL5c-_k?o=R_D
zAP8O$by6aC`MutiD6N|t0<ikjEckO+%<?o+z=+mm8Cv1%M;=l>u3@~?3D~`3L*U)B
z0MQ?z4i`5Wrz&MD0vs7<g5S|9zuugXp|TTp@KR2PtC>LoV3DD5ehz!?HGLgRucY>0
zw74&(2UUS=Es{tixu)suRhD3`<!mZ4hSVK0Y}I9dnA{YO_e4q^`VRlXh?txcQ)>xz
z4{@jJjJr?zjurgPC1vLjF{6nl>&ZQZ50l+`lN5DEih!5>Ada||T~nhvOe<3>Wu~x~
zK1g}>mPoi-!K=#mRO&wyBZXxp%Wb&$Bu1n6$*bRb^9Hqj8M!TsCE@3(3Rk*O#jXME
zvUL{{J*#W^kuEd_cK;l`9Vvot+~;Wz%m<wsd2qoH2Y#+-B-0OUU(|No2wjCpCa>Jg
zQLWMnKbKy%I>PFXiFDB^Dw)@-k&c>;ryIP-O>3zpVF3n9Eq~(5lpB^JCd=LrCA4AH
zjIjWe18?eJdu-tjyv_E(=UNNdPA)fRx6V~CggJ`-2vJRtUZf<PcTZD+OEwLCu?#J3
zd7HX!v22*yHZgCK>xRR(Gs&ks;rY{D*94X9+$RM3-A_S!m3LtZCyI)G+G)b>tVKZ)
za1Y8P3$&ZA)8oC$K;QcBJ{Vf67h32YcavmgC_>tV5yf7NMdv7|5<un%)Q@MOA5&^(
zJ~DK8*~ffQUjy1>en>h-y-#90xI}nf7B6={%G{!gDAWk5$s%e&SwS(Tc~ljGAZVvv
zb)lWuVj2iq&@>^Mp(`OPvH^0)X7YOK1!(ezQ<wp0aP`Qw@b{rPAmERHnK5s4Hf`F{
zIjamE&sz_eB$ZzY-I$W=0VdEXzE{|6DRkzdRNmkHruEc~(N0-CPg&0?B!lY}m53Yd
zux_AuA(YABVnXj?OzDrG>nO&=)c^I_YY}TPnBcgfxZ${AxDmLax#79*3`FDJ4D2k0
z^w+o<#<X}h^G7iIwF=YXoN73gYD=AKtW}}QH3u_Fq8myXAQ{=W{958S0x4UWp#MnY
zpmvZK=n;etN&-4pyW*Q*Q<*6N!jNS(&^fa8m3|MG0aY6HI?sr)ojwr5b~eE;+Hdap
zKd-%eY35Tx_g1+}x+KG#^u}!)4d94y)57-EaL%i8J=%a+#=$pq+Qk*&cQJDs@7Z5G
zP%c>oTQew(<gm?B&kRiYeerZIcagca3D@DX9oFaC6lN_xDQ{N03AmOMSYY)O>+FOI
zg-9B;hK)`=ZfAyV)X?74mnAgK|E8QNyAY}**TD1BKa!vb%FTh!O%U?=N}mTD+{Kyl
zGNuGx`|AHBgL!7c()f(n!2C;e>T?<H0+zsqWY(4=#_Nz6EkgAzAJH{utfR-O?2nl;
zy~@#(GqY07J%jCV>Jo%PP9AL56wXeJ(Gu~ar`r;|28PgK7%f10rzgp8+x*mKU*aqy
z71l^u!fM7%5j9k6ZG21$s(K(7^Q5ZNPpx!*`Lru>1J|!?dVjLP3|~)x5@!8^yJPfS
zZ>SZv^EdN|k!$>ubM-i7K0R|%e)Uf2OwD5-)kbtn)t9eR9I_DlKlaY|Yr+=yH7(lL
z;8B<a+cwuc+yFWw=!v_0@_;n_u_c0=d)P<B%;8>k%)RiC@c6BnzbQmxJa80IFwxM_
zu+mV{Fw)S{{&SNpVagcw+gNd#cvH{gDZLuy`Z+GiR6<FKWK%;?wWG&Sbq;9z#*}e4
z@*9i@SnhAhCpz1qG)}^GdHCL8@M7OHqE&E&KW4CSgkw44CBAaX|7t9#r~Pm(Q;!r3
zA=J2w=;n{%C5ID-H|FKc35;>6i60<gs@VL^o+rV4tx(QdLfh1SD8rFaZC)_4i4(7>
z?vCVd#o&>uz9nGLuhsPX%PI{FEi^4`B~&F$C3Ge1KfjSwzFl5Sw1OY^OjO=gS1u&e
zaj>|YV_smXL~S5ck=6OR#}oGQyWf5yF1&3KPI+^CZ;?gbS<tUuxk1{eHu?0$bhxUj
zt18DGPrH2JgC`%s=TUv})|UwII&l7%{c29GN8!xEXs$;&@JvXvQ8%rX#??3ntsv5>
z2rVBrACQljk0BW25tlEM$f>CxxjhO$C$oRorKR;FJ3q!3%jJs;vJ1Tnp$nf2ylfvD
z7i4ikZDZ|A#gwq6uDMDDedBCf(p~Pjyk`0^yqX|7LF(kmUo={}EM_#d-Xu{!){ZN)
zvro@D6_U$K?s-TRj&LI!gPd<evTRUP7_~o2;NGk2&DYbhLM>|QCE`g@1>t<?T<~1D
zT>dZWE({r(Ac9Zr2_2b5;8}d&`&bNfT9WvG?S7{MT)vsxeei{*dE7++`JY;kmXeT1
zISHDSheUh}jEa?2<FtM932vge(|-&KCb0cNjhB0-=3QNpbnTti15>Nk!e`wl)i{O!
zIe37y(A-EP=Nzj$yyw{VY9md13g-U)Zy6a@8M+Wf5Y2}lf(p(7wS-v1&O;Xhwvo2s
z1TlR2IbdJ-GVzN^x>q!QtFFZIP-Xs~qA-XtL>s07#t5w!!G{^b4}Jg<hw#8S!&I0N
z6e2KT^rGEwg?d9>!|lRvqx2GYqWNI3k(yo)Km7$=f=EG#As8^^Fv6$-aL+&LMa#7+
zu>*Ta^Qm?%<O&RgOKGUW<9L^%1-rCrWem?g%O_LC(uOF*6u}6i1t2^#LHNK*;5!gO
z2rEA#5@&Vy!XyQ=LS*s?hVP@?J@!EW;WG+E6KoG!3w4ItgX@P6Abv)N7=rylPod;c
zB5+nVtD3@^fbH1(*><b|Z#TzCzdyhO7>fOLg6%=&*Q1?EnQm+tErcLwIlO@2*z1N6
zW7q-cAi&$4yD^iPbgLS8Z28AK*?aKk_hAl_lgo4Q?EufbFenk|V1##=H@r^3Gcj9e
z!h7hoNazRjJNz5*DYa`YO3~!A5_BeP1<X>&QRo>61%zrMX+mvcX@X}WHiBA<P>Wuh
zS{7f8n|!1fckY*Z{dYxMFibeBZ$vXq;x`}8^{Xc_yCL8dmLpWR`xBppHn*l5g0)~3
z#RCZ=_^E;&aYKd`F&i)gdkhN*QPAMXZQ|~~fVzOWfWCkQgrcPxTsqaV%SWuPEKjEc
zPiC|RQzS`BEv~T~%}sDj)J-@{+)V%`@+LK9Hj(FcFx7?1bIt{K%%M#C6?w6`0RYoM
z2G~c9%gFmFl|Dq$lm_R=bx45QwW~`z{aV-(37-8%V~6eZeYs5Ryd8FWUNxFt>Ch(B
z7R(m(7Ht=+UNKf*A9eStuoZ2Y7kY$%kx%)Cy&TOK7+%Kob>^uI$%~LM4>&IvF9a`W
zFL*ClFT_WgI1NUQ7?LR4+?KohD?E{7o1>xMF2ZLd_3iCl6%Y0qgOosjs76}IR})qf
zXA^Q0V-pdRU@#Q;EBG@QTxNsLClqP9S=orx?krKB^;6dV8eQVGkaGFc(|loS)OY^q
z|JiTjGZ1lp=`_8k*f-k14j5F(+|*)Ph^e_oKgsE-UQ1l^B`f8OEX$EOzENmMe7)^^
zGZ~hr;Q3C&E)skA&o1SnSiNkOjj9Tupt-<wlMe-$J@EGU{bNHd78CTq4AE~#t7&$B
z$)$r;rAOO(`@SD*wi2v~IFRmkO-?#2-5(yMNx+TZ>RU3L2NAjW-GeIqqu!7R6I{FW
zR<QNc%<VEq|D4~_a|fpf-)?{f6p2^_X!q;gm>2pd$B0;DcNDReJ)3BlGy0!B^ZC`}
zus>?h3)2+2#?jVy6>lgNHz{H5aJ&Xf)9!0&`j}*2UX#iqd%3GhWfg%{ku(pPWqGrw
zuF;oiQD-4<>FLKdi~O>B&bv5A3~9ra2_ZuBR_fa$N=sz~)Mp76Cs;@_H)Np(l~n!u
zQUS^S&<JXRWGgsMNvy6*ewz;uwfgnezp^eYNpHy64_LR|0<i`R1i9_o3Pi2QZBg*I
zvlV8GqVwusrgm05mO_J?4y!Qr+pT35<F5{+#{PPzm9g%JpEuiUd#`vM+NzQAnL-A%
z2(8V8^Cabn`jBpBV^G<*cDOaBmkEfnZ<aA0x=OKZNw1nxskT)e?jp_;(IJZH<OJ_%
zE5SJhP-Q;)qiw)dg)|0Z-5&^lrVSm*&(R1{5d#g=gcr+LfoA~4O={V{+dc3p2cExR
zcXZGb$N?K9H}rcvju<5LvhjwCBw6>=UAn1MkJ3EpB4hIw@b25zjEh&)(Q)xjnS}<q
zw|~aD10)r>o9ESSYh(+k&jb`1<ZvRlkCfy;k1`&fIE^I8TVwfF#l=Yhf|yv{9o7w5
z{K`LdnGhQACCU!hZvk(xnwKBAq|=kYMJE8;($ZQp__+3u(bw^iy~DG`9r{Sf9FIJH
z+QCD_AFA_{_hxO8>x<WyoZvz_y$@E!dIP0&{iw8v!32$s8x#eihP)}7*mwmm1vFW4
zH6hky>M*RTDArw}=xpHC1s>@dCgERmmNTm?k5t)%1@e>ET<Z)QE_t{XwVew1ItQ-H
z;%;^f<rUbxl<SNPmui}w36TbZMKWvY<>3u4A(C-*raq8>n8X(r2LI9Zdg3$F4JT*Y
zMdP$(HfCU38jj$H{BghvMjU4s#>b&|xq){J4MtY{n1rGph3o~_nNF5RhXUX1EGm7Z
zUI@3Hah`<%fz2Y<;+kP@t7ckzF8yr?hTS67;u@nZ`URlOr?#Ph|G?W~M5GJr16Sl=
z`BsVP^Jsi|HL?84bJJla24LeyFP#OI;`wLUg6&rRQRNyLX+cG)x5WBi6lwQKG_zU2
zMQrlP%+u0eL`;DX?i?GeK{SXLG5%9A(iz@f7@tSCgqTpNqTHLj%(A3{GAeudct6d-
z&%w?il1U`REthoqwBTHKu7r}D55+f43acs$NF#60rba}HreUV2ucEfd{^a9a<f{e(
zQm!Kprci4q6u{UjnJ`(<|DWp`1Az=i5VsShlc;m7E2-oyxH!kqR!f^z8~4Ob%B3><
z11WE>HT~G!y1|pbbf1i^03%n)$ve&kA<THB8-<W7C(%?atT{Y$bUs6u%1UeGq;#l$
z1(%dxTI);?H~7C-#s@6eEB+DgRFhi_%bio{Dm-zJVBnd~exMP8s(i`j9Uah(6Y>dL
zCXW4U2|P+MVvbk)vZwN?k@dzt<$23>YT0G(h-Uq9-uy*}JocBh=#iS7v>FjtJy>CV
z`^~JliX-QM)vuY5b>I_)zi?OF3AddNxjp0|mhX94^T1(BtVrzgdFCXETI-TL+E0Yc
z2L>VmmIbBD&WUr(;-q+Tbm)F@m$zJ5*{bd4c9-q^B}qbrL3RAN`6?kykW{b5U}#=}
z-QOmWnCr?MOSr~xAr&qtsa*yzSVTKk5Y5)zu86XQ=R|ECM%7@?{nb_=$UERl^_M27
z%;J;o=9%VAFECmHZU;A(E)P7XK>8#0enBF=6HRzqrc>2koLV@Ojn7YMkd6<}hX~>U
zCIoRr+Q3%~w@k{Q{NuXV6t$E$2rJ*Dz8JAyN*bp%C~bVoel<n*%6`x}vFq@xPuk=6
z`BrTIK%&i`e<!!%^^dl$0vp*R(PfJwlv(6ijR<q{SW^xh`x){amHnhcYtj1bqVP1p
zX-W%afWz5U_*@SFeY_RR>*q-$H}u!RE>I#!aje%)D3f#6))<uRQci$cpgtk8!q6Hz
zoj{vmW)iEw_$S9QULMD((xfW>G$b6mN6cQBK7p^OwSA}~i5cWvpD1KjpZLe0lF<Ap
zSYhT3qhpbrjN|X9)@!_Zg~+^I@NR$hcg{-xl!FYh%aJYW)M;gRzklreKA<Fz=iep7
zVC}QYq|JEu0`p<w4Zt@sFU$V%h9Wj6tLN9rkt+{t^7y>`<nL=?Z}XRcV6RwFylzBJ
zs&}rSk#&RIrhooJ{6g9b{DBH$*V$*RVWa2`@~?4g<j+1$Qjf@2Hg>01$;3UAJV`|X
z0PXFnK4RBD&sa~ZSQy{1o?NM}a74_=@(zwCV-R!vXDI6ZO70r>1;{%IeV`#?U`bGX
zsD4Nm6e~5cMD^e1$hJ+!9#zt=(4wZ1UziNd0=s?}?m1Mq6r;nlD-}{Ro+Sl%{f0A;
zom$9_Srqx_X~6`6DA{qOsf37CF$O*6?VGgJTDkVkwcGw@Q{lg+P>KVLvpL`7Zkn(s
z@ViLrg5V)?U`<d>=-TOH$<~U3e@C}=Gf(Sijc$qH%A@Ev+O6uj-`OjKDzM9KbrW{u
z2~2`efch5Q?#VwY{M2F|-TCOsJnKCSLNQY)!r3gS1tuL+VC9}^9GRQrkB)7f-8k~;
zz2g?!_>o^I1o)zMSM1`;Oy10|XP%&oP#!2}xLvqjLZA4n>E%wglb>OtO1uYl-Q9T5
z|A_^JD<o$qoGEG9Hh7?2YVxobndjoYtGuBEs}W@J_^m&OjXVV8DFjo{9w03C+Vla~
zIiB3#W^7f>?LE;g0oM{Md;dS~h8TeZL4QKGLIpxFpvd8b;Q~HA%iNE~cXOv`PfN**
zPj2pVJ-ml(aV;Mqva77+)}N2%*XQc(=Z&GV8gEUns0UwPTMl6|zNKXE`>O-KrPof-
zj3zkzGeO)NB7AYLqA8PJXd;6ZMh}2_214k;OCalzd6**DD>z|{fWeHUy7RpDkdCUV
z3-r6}3fucW#ln-LvFM%UL`*?0p7wuDcs<BjiSD{*6)85sZRn_-7O1ab%#09U)*x8{
zM}H3I*FS^&ZyMmNUhp3`SeU&v5ETj*pBS<#=K-};AF~J+Hd&#KlR6u4dZ;f<Zy6!)
z3=l5xg@xxZEPX1jQ5A%x)C)e-@4LKwMb?`+$kJrH@Ja5iP`Y+gpJDi=4V(7wX`B{L
zAnOMOUX3UEOI+D?1!hdu#y%S7Y96RV#=d6jjqLngqUvTuOA;YS;GpiCa;vCD8_QuQ
z5+ALQLmK<+ES_<27i)cOa?1Bv9r_gZz(<eyE?S$#@-&ZPfpwMyk#&|8Eb)%(J+Tom
zzGA<6#ZwH8kYqrA<z!JRF;3mQHmZ?pEm{!Gnq%4Vo~!YcDM7u`;L=Ky56ceU1n9b?
zZ4b5|;|=PW0zw5I2N`UyA3=-29{pP(f>=Y1p$8CxVBhecNg@7V3=nzf|70N$Z!kIN
z9|?&Se(rk0{pent5rQQ{$n6Q4`r-}!$DUh~@akxft4au8+}bseG2``%x+(+Jvp2yC
zvNL``b6((rHH7E=uhb@E-H+g6<9D?Cv<H{kDgeuiW<oy+$`hnnO-I?aug+e+U>h;s
zpU9mj>)XuIzfBL+G_-oCE$9~HVFGW0&`8;c-N@dE!UkQ7@*kQ5UHji+8<UCfaTH0w
z3CtZFsScC{2ug=o2T><$dDG<e%CmV#L?LKYsFzxf6|-FW?x>8MeIygHP{qB=09%Vb
zEP&#gu_Mlm56@PwzFSmC!{o1p_ut5jir2+par%-OnoTbLg&zz2g4g8)KU()2O2jg}
zLcI>3hc`vPqCNRFvsX{OGDrk+{ZB!T%5yVLnDAPRRE}Jqyqcy-nP$Z<RW?X8n-8C(
zl5f!-+5y?&A-Q~q=&ViFt2N0Y<x*%mba9cyzhzGgkwbzE#UVBNvKLyO_*1Qx;ICR`
z%~rX<y4rpsyGxl;x`nPNi62U9^8N=L8atd5Dx#zYIc5Vvcr;<H880Rg+agIaZV4%O
z;iY&By03u?)M+Chdj0iW4<+QKfe>R}+d_FFE6KWVv8QGX)T*JaB37C*(w8^^#wC~_
z_TD)(+vf^a%PqUUGf6{!a6;rJ^^==HLM*X!`K`h@9nsCWGI4Dl{Y-W9S0%Y|y3)Im
z+X=5T$0&LJWx3Y$s^4k$trkLj;}T1quOR{Ai6N(7c(RRD^jU0sB-I$szH|!2<9)ht
zC)mM+UyWg=qoU&GY}fhvq|-cNsJiN8@kTF>rBbHo#LBKtde*L$RDT8bwk0tsm8Y!G
z`Nj~<Q12CemHRFCz{Xpp%*!vtGowtMv#J4Dw<3kwi9Px~>M^aX5ZP`~Jk29l-fxBa
zZ<Q>4b4ckFUs>VN49PP6$ze#ZAqkcE3(FY}&xLpAq@fkHcSPRyrkj%LSZCRvX+F*V
z*~E)FHzlf%tJi~I>MFJBOMt;T*pdfP*>3Sy+KB&mAXf_TR_6{~mMG<Xq;2)V^T)*n
zx?=YhbtG4*tg`H)ILn!9*1s1IZxA5#TI@t~_?jvJvu^VXhge?$DWZH<OZ+-zcOALL
zDNIT`^5mJ;YEc4GM{{?<pIONShY7!Vkb%}@P;LcR4H{_gdCeae;agkQSZGjCWp;s8
zc9Zq23uzwmGihglA%pr&*pym{;bhf<VsW$u7QR@&GKhg6kj3UEr`h_~<{Vh-`?egm
zz=j3*Suj%9Z0RRm_*}L=06@t$U^XoBTL1al;X5A}M!M|7Paw;2SdM)9oLa7{Lae2d
zUY%^E?4q9{zn<)4j%zVcVl~GddV@|}G#P^!tx^}6VVczD*a)->5(f2yf<W&qIHEuN
zj3`l)F%=m<i>Jf3#W5A`yUcFUY_)M=D6_g_(9yPrOqfgll+=5*rP;YG6DX1Z=fR@O
zCgMwZ@3y7c4PrMQf2YwboOd;VEvw*4{}LpAIMU^cD*iW&oC#MFs7Lh57f*?c^IXx8
zfIH6!W{8?~yq2VwLVK;yg3X{cLRcy5dtoq~>y<wf+kV@4haNGE7m;fTB6sML#^$jO
zOs2icZ5}}Vn*0fg1dc?(FFLKx=9AC71|$Y%yl^mTej3Y3NS{EXZ?usS&!LlT|IDy0
zxyDBwp)RIFJWyO0ML(I=P;&F1C#6L${dqYa)`xkGc>hS8u;7V$-pZx@(H9=0z|_HR
z!%qkKWV3STldOu<G;8ZwW#CbE?lqZIxAA8~$S+MaSt1OxJ_M4mTyhi=8XetrrDV{P
z4ESFH2>c1G1Lj>cO8mj_Jce)H<~ozJj(skfxTV(jfrsVK!-(aqKk*0XY4cYt{ke*O
zkmk1f?QnYheEQ#?kz~4wl<ka@{k7|6paz?@Y^Us;BW8R^GDn_8*@86<`%yFI0AD_g
zc_|Fdo7x)mfQ`#kCPpy@Wo$0rc7&kccC;(!qu9vKLt%9+rN1vdj=E>0b=&NcXVOoo
zgLO9xGGi2pH&5b3+K*={p!5fR)U?B=ja*;PB<LSt^a?qgMfW*i-_Xn?*pBy)-d7VZ
z)%?L<@^@0WzSLJJI<NkPBUZtPPM&rktyC!KCRE+eci|FVl2fq{^`MvQz>Sg8KT!+X
z`h?=Oy=C!_JU7KUG2#3gXWvP*^n253h4WrdWnC&GO>5OncgiT!S2WJ%@J>N)&dvW!
zYigH|nh%qYk}pLw4SN|M2Rpsa*otfsrBxwJ(-P#jhA%icoi6GjIx{j4n3(62C}Q^x
zuem7v^$%oDyv6`%wKr_+5Rfpy42DWsWr#po`HHCi3AG*dhtTdT#?Zn{JRzsxiQSoy
zM+|2x3ygxKcV1Xt99{q~F)!^#MwFO%Qk%f#dgn_65$(s5M8M@nOVp`S4X!WwInF|n
zxN8R8{ILUHo=o=5TT&u9eHFF;JLUjrnLnTbxMN?PE-_)Ps0sSsCtH7|kvAi`Gyh*y
z5zYY00LcK(0M(#GpT4)Ny8OYtQE#d>z^!#ZMa)jFHkO~p6~2NU%nocJ>4fRT_F;oy
zf{Q_#Wy5rr%z=QIuA@P=m0BlnX-ljn;C{OsSBai@iQ0jt=53W`sDhazbC&SKgr;2O
z8fAqiXgK6TwiZo>_Sn~<k=5Mgi38(8dT;-}quuK7lj`7{&y;vsN#kIZn;E6@Eo(}j
zDq||dRfM(X#6@Eg0gMHr3YCUVMj(R~%+$zByZHf#pY@DEz_6>7uQKe~6e4r<mfei2
zTc_M%S^sR&bI(N)TsJ8KQ4VsoBI`ozp7OwpT`xU)ZFTi7mhDUPVDFm&F%bU6ok5hf
zRTq^c#Snz{p@aazlXIgS8N~Ox=H;3&{r~c}2!f<O2oMFZE~q8+1Zp1M3C;<o5K)l4
zlW#*4d1kyj7tRiwkp2tu;iCTDUp%C&gAE6vj0<oQSZv4S%_%*-&_%YvW|6pA#Gc-A
z;OmC<QYf$XtzUW>=YVktN*AUN7Q_sU52gmmhh{;uDktF%F|JD+Li_(H&t0|9a5sh<
zdBhAJiW5;CdZ}c^6ZgLzf~n1M5k;o0wIKA_Myspegpdb~((S#zEc@9gH{(WZ)ieI=
zsfROy?<Mm27u5p)Z+IO5(P9U!@Lru{eGQz@F2}5UP{avLD?{CmeKJr3XF)DCWp1}G
zybkU{Pb1H`aWA~Uq*#AKy4QcuD{2E8sWU2(+p%u}Y;BdA%l1SIssnd(7OYe#VFSUz
zv+*U8q8g*7%<V}mm182^`3;PT0|aPXNS_WUEgtW5@pMDIk)b6ZPS;~Rtm6A~|H%u(
zT*K~SY@=^O2S7dl$6W}L4oQX~|9_xy=x0g@_2N&-$Cr|cY%Y`+^N2;jltFAcFaE#X
zG%9sztPu6J{aVf&(7k7}q9qB4>W~X|v<_3GeHw8{+?_i(#Wnp90FL^rndR)E%ifr6
z04~-_bfO;Y>+3*mL5`#2zitd`*6ehB2x0d#4v_*)bw7jxO|A1@hn}f*CeHvpjvcQ<
zohISbxK9Z{A#;S+89{{Sig!u2cL~CX#)!ws+^T857WEL^26eb&;tfu1?N49WX9=rm
z%<)2>0~<6a4GkAPb6XWrrf&wSS7mIsQhF?u()vy{?@QJ~8esRJ`jG<w&)g7F6GtW-
z&k)a0@{sp`sCkh%W3ZHOLnGOqdu5;D4)SFv2&Oig_o640yT&?)J>tRwt#xVb7?2i;
z{*2SsFncTft+z=)H06IW_Eu4CHR$^`?(Xic#T{DQ-MzSbai_)IU4uKNI3c(eEm|bF
zyZgtyGr#%I;dhXgtgNi89PI3U=YFo|O6o76r7g;6f>8J5-^Z`N>wXu)UcGrl)oJ9P
zah`sENIDdr@F24kRQZ&*@;Q+JvCRGFp}(ZiGE_Rk*_^;`nWwITrMt|NZRG$k3YGH~
z;YU}M>CaCz&GWb$!V!m&z|V6$pXUO8oY#kJB%Y~;botJO`;KZB<BVdgaT@Z|{nbna
zS>sOP6}wBdR40YgS}Xviq=C?Z=njz%Z;|H(!D7%skZ(w<urH_&LKo=Z0?<3eJJk=3
zWLfi3=}aYasew<+B%Xy<2G2e;)7(5I?{VJUIKy<b<HhKSzAoW;uCtS^Dl5;fFWZbt
zKjWe1%&J9r`c+~H1M^q%_p!fq`}2)6jsC2x8S=k9qyMpJ=qBHsyChsC=9M-G*=d@v
zk3K03{!Ji^)hGj9iz4!yv%tYUkdWB4lB&*e0pZ@McHoGmb?l~?iO`9svAj@k?EmL)
zf;G|#RNG}P-ET~Mr}l>vSZcET*#lBq?+kgOz^@1s8SZ#azfVVbh<}Vi?m=A#KZ2kr
zpy5C(AVE+E$QLAS(Nd3bs~-@lkLS^CX<)QIy?lKh13V{eCN<HJ42&E+0cFjAJzt)E
zHn>K@?FxyRGFGl?l+Oj+PWK!uBu@2c?GK&T54_|hiq{!=`Uq?kwGjsOBT{>eE7Bah
zRVR2=kVLUu*`%m4JjTG}?M|xf^pO}+?u0HVJ`O2ItD+1hi}thPgo|1F-1Q^AR{-%Z
z$x{>i#AojD)<z};9RTG~Wzm2PO#_7}WhKviLyrs^-7j2n<n4fc!&wohXudW8YxW<`
z!6aiXSpD-od!PbQ-j?LXBCS!qT$g%c6wXhde9vx&UtO!oTg|4@0`#@}YdhGxxwG?&
zfTP(((~OS@EjXrhiIKs*Oe=DnT<0d2(FUkDnkCL|R*2H<1ng+i-wQ)E)t$MOye&|T
z$`#4U4;XY)-qhx2bLZF<BzFAbSKm<&O2tB(rK$5vH*{iTKT>5mdmm)MNmbx%-u)C<
zw?j_DU^76j(~x4n9#f?#Y?mCGAW60J4KzP%4WIF6Ly^~81z`pII)VAYx~>f(?@0PH
z;FU7rB@yhKBoma8f^gxeINJMIrs9&ulI&1mmARhNiA)vLSPi_MZsDmYnxoUKH082;
zDysePg8(FZuu#SZn7^2>akq%y+4rVbjA>hxvNUVUGs<8(q)S}k=?IYOT~D&@GaRT@
z70C`yrUDS_Di6un4q5-<OlAP}w6^$3is^W{ZO+X1_ja>zhsVkp9%VUOqjmLizL@e!
z*8%m31L5v`3Z8C>yUDyXLbt6SvkZ+U4J#+lWwt^EDrQfKcHMY+SElMX1$hP6tt-RX
z-`O_-(cPSI^$N4?Y=;aP&11B+9&+0nxh)R{DOZ-jm1E1`jJTAeG_IU|KEC3xF@gE%
zLE1~JrmC+$=~&(U8zEPJle6oMt{sPu$$pdFRnH67=>WF00hJZMH33&?f4j;_7^(+m
zON>nezKv1U5no_u+&EQXyF?Mc)^L}9o?FF{>4c2v1PZnTi8=w|d=%~hwOpq-W(b{t
z5+kg4dnHiq=%4CIj`4<FT0V~P2R4dSVglCny9lJ(B~Cd6-XlGHyTfzY#!*#-J`*p(
zu`j8oDXKP3S>M3DM$4^Kn2ukhGRgP-jQVkW+KS)h(A3<9m^@7KL1)O9w9I9w+GYRc
zPZ-}Tc1ac*9_&9gFrWH0<i$Pa9Rhnr*K#QFX<c21Vop}G=b4{dtpv_$38UrfCUhlA
zMW8-DY(or~(FRBqpiR`45GW9pMT?6S?p9-GD`Ao}vQQ;Th`5&M=4Fb#YK^nm$q3AW
zM29KGZ{TY{Z*Z0e@Ujgun+xn%c4%wQCVW4#<&g1v>wo%tXwSA8k8jKr@dK8pH<f4q
z`!5b5w#I>>L0*4a;8#1Co~b4%T?^5-XXBY>xZ#UZ%OLef`FZSWIb{~+fZ{;-c*Cs`
z>W$?;b5KlWJ^VIliX<YBBxDbIn>}mV`}!KTkloQS)8Ta;7Z4spA)qgyUJ&IL4Zgjq
zR4gM&@@R0VA76<rLox}RLr5bR$p-77yS9G<PC1pT^kydya2V{z;zHsg>;mON<$~qH
z>4N0K<U-^k=mO`m_b#nB8qawvxk6+U{SxDs#*d83LCg=&kI#?JPwtK365>?T<U~>v
z%2T2pDNs`7Xa{Ul<)p4|aqi&w0oU4lC-oc5sr?I?<rmGsS^excMr4#IJx6coG{Ril
zXwiqG#u|!`(cgXNmd^b!e$VVtcds$G0QcrVH%4C2|B(@TV@@o1+H9^dKazfYs%vJ-
zXin=Lp^57?@p*?2YIGwS$R@Ai8Lr#U4WfXjwG(UjfeVzHxOlcNZw<o*N=#hH_m5E6
zkBNVU8)k`Z?i(o6*N699(ucpJYpOizV%qV(@eB&*smU;ZsH5o5Ktj|kH;Q$}s6IEr
z|LYh?xRxv*RgPs#RrxyS?EufEKwTTH8x_q@;Ehm;X7<|<u_w~7uF=X{*MCMvT^13M
z-2bngqsdx?!dGcDDLn0e;nS+4DBgSa-@7`lT!q73G1NNHcG3`uS$7&Ha2BW*{z=Xu
z5zu@P2@oxqEi0D+I2Sfx4v=}sFl2&PLWa1%65|4zG*wQMpdM+PWw>&o7t5@lQtty2
zYzJTwJ89)(q!CgM@xN)7#!E{!!A23NlRPwMP59D0v=Y3P7tVNFN1oC<AlSINZSbry
zsd$|R2Y)Kjb2V6(meTeheEEeN;S!aF;3?aK<Q?Z5$pjBHnYmz;_8a`JuL{do;i@wX
zo<nN6tsq<bF**TaEq}C&RRlTY6>@kDKld9tr%ze1OQw2>s?lzc0xf-kM7Szi`K2JO
z_#-Cbq!K02H4HlDn$J%#&DOKHzX?niK^v?$;)OccGIXDSGRGk%x$@cE7pp#{5_Mgc
zH}av#nJy`6@=x-pgGkT(Zdqwf-3Fw<8Nvxn7m+|GoOdl)71NfzQXu^HcX>kf^=);9
z>gDAvf*<sSbnmwKi&4m0a4XU}Hqb9oQ=f3lom1+JK)NGWfG?a6Og(>^_RTkC?Llgv
zO@zVuh+R#TCjw*Cl~&4X9|5=s8I)SNm$UVUHA-Va0aM<OUOo^4*t+%X1m*>cfc%UO
zjZ&L=AJ3%hWtQKGM@XTg>MJ!PT2tvQxGH}S;R4ec@YbznO|&IZW}XvA|LL|pe{Rt`
zpn;($x3JOpf8jewY;bzgi)((B5{=~khcx*PFp07wO4Q&Ka^b@@Pd!!}xFxu7#VXM!
zJ_M*&G%0z;Ee(2>qQAYo1Enhj{ye3vsDrIE@9(AM(5fYpjK67x+U8M3S{ELYoWzGq
z+}MDfncM2Oxerm~pxjr5jYDzHz1!y|elwR{^DM&6(K|I245-{0aFIGbBWgg>(;g#V
zdHC3yFfYpy0lekz|6rmgVY)*KB<CEi3>zMrw+p=rhXlU<zy910sZ6W^{{pu6iC&}G
zUv@vmPh=-_2?iw9bV#F5*hWaVF)dBMGI`6f!Lskwv5@kB`rNuD=<<W@P3|RSTq@gw
zjScd*r;hCk&%m*YmEfX{iPo5{iPxdQYv=A@5Y`OyawhSZGKYjHm0P5<fK}T;rbAMO
zYAbt;J?@{o>W4to2f+(e@J9naFpumHj63%lVM&u&v24r5DPz6`?u^z^9X@{P`Z(DU
z?i;g~61H}(xO`C`icieA4}KkRXY&t2ctLpJxWERNgQkLCV**5*ZKkFo@J1B<;}75{
z9@#HmX)l<;i(ADIJ!nvY@MHHN^5FlNf?yx)qpPi&uz7^}6Kl!|;DC=bdCV6f3=woj
zdje2_xe55IjA^cRoa-ijKPWaN^^?Txx2`0tI9WEjg7+~WX*QsfLTj3g7}lK`{a%rL
z#n|%R5tshzOqT))hL~+y01wvFs#(rG-vfsO5Lvy+ET1TEgw7;Byi@fN(>>-aFOV<T
z59DAIP)~@lK)l@Uo%;8mHzv##CDuB=g1RTf>U>3s1J&`mDlV;ZTSr+3H1N<EaR!C1
zylvuN0^~xEyc23Lu0dNGy1K>aUTLCc#eC_+$siW{DvT-ajn51cRQj+@^~EOULxY*N
zYN_uN){A;{h)8KNy4<C>)a|RrqA7ATK60f5V=ucj^V%=%f{pgG8FIV{C^U6PwiSdJ
zMD|MELna*^mjY4jGRSKWR_&1Vod9a?L;ic&+tO-llSjcprAz(m6Sr#n9joK~A^5G$
zP^!C6Tdra|boZ$_Q}{-+5l(*oXK177Yr*xMkUf8BMzAKi2U_}}Rguch-9VbAL=D29
zjL_%b8N(QJ#!N%mxmJy)o3kd_Wc5y%w}p!Ie&*&)cj-O%U{?iiCPLOA)WFmz!pWlA
zJt#Mpgvr&a)e5L-Uls~Wl&QjA(*7H{4dDsq3HcQ)`bnc4ox1#vmz=wUfpob1eHPi@
zH-=#-!cv7Cq+`Y5hEtiTj>827oL);gUY_8%b+j5^Be)z?I@9&^c%aSrwmb+8hx^^Z
zr-i4u4u1!3L7b-35wGJb@27v$Pbr&f3UXhrj+6A|k(x|Z-kU>rpd^QbAsaje7TM%l
zSQ`_q6<AKj*V-$5zb*G!UCR#ZM#U~aueT3Nh8tX>u@_CSH*Fbda$X`S$6)@VNRxGp
zBsSr?J3d|Fdi3=7Y8YN}{$>teX<-MaZe~Vs3g|<mJ0|{M70zYWbjjk#$FH3>3)tKH
zOupiYs{EF-`k3VF=iX(4O`J}G(hOB9Q+Ec?)JF&M&xi6&+#31Z%$+se8ok{9^^QYg
zK7zlMKI<)<S&d)sI4EuHU0%g<Q7ppa=AP|cc?f0bb#--yiR`%nvS`0;o4}828kxh=
zjN{D1!2T@`XQ~JaLdIUx-BAl|vXE93_<Yw1`tv+dFVpup?F+J0m_0LDry`E{bRe1}
zP+9)B8Zm&;da{yYFh`@az0o6vT)~+yef`-|Q>v2XU^ls=gQnQgw3g;0(%SPJGE5qQ
zKZ>9~u$r`%>||kuq74{J5K9<K2ulP@FiSW~C`%+uP)k@#NK4r$m3ZlepJM`2j4a&c
z`{Fe#qB%(LthhpP>IokQQ){g2Xv=pNf{NWEa@1~6-J|s}1Bw558yIc-S^1<tnJ)+S
z3?me?G-d?*h%BrFEgejT>{>c`I)9$MuT_e4*@nm8VlF^hOCpkvl<8h7GZuMU?oq<!
z$SBTTl?VEixtQh8&e@_pDQu%Z#W}GMZx4%~2n)+P@?>Fdd`zC5uu?B}Sk*Euyo_KN
zjfo6P6L3E~5oVQ@89jn-QWM{P!mD>h66Y*pohn+3%?Ye3xp}|P>}UDy?w%R@_>7(&
zBz*hn@9@HM{7f=ayC%ywlyKwAmwvoG?3O`1Zggo*X}8;U#;^Re!osEIIY+C<g!~{f
z3b<6#gP$Y63mGl**A7@5mpuL91yPrl1wf_b{2BWJ36*FMK<{5V0fvWTHP7@`zD~`O
zErqP}*h|Ixc;GrK*Y5C^qwDUxBIFE`!pjX)F%kPC#5+aEE(+H89iJ$<$XJwOH*hr|
zH!wF4FHg>{$>nzoEho%Nr&Yn@a_~o1*P~fxU0YanQfqub*&yg(5joy8nl(vvxkN{c
z?&90G<TX0J<)~-5roShpHEGnP|1%!|L4y91aY03(ub@p3CMXG{2ATnJfEq!rpi2-U
zC<-J88l}Qz%_@IVm9qO14GbYtWMO?|Xl2>cl;lye$c%iF6UnKmtluDd{4(=kf&0O>
zOu$S+O~Oq={)e>rfAuMpA(A1SA)4W)+k#phl$p6=w?BAgc^>^JOS_`Xk4g=ZlKe5#
zZ-<AYJhtTiMs*GS*G$gO4<2oH`D6%6{iWT8*6zj>ObL<*sSd6Vu@ANnIS!71T#Nyt
z^iK3&c0+o@T*!jeKqVo=5DBnk@WN!?p-xk(kFvC8nGNN>_plrENekr*fIo9tJYBqX
zv#7m;c`S|P&m_!dzHGvTQMpjU|D{MmtRbi1@}Y(C+c4V@y~!^8!Fy{)2)C_t^KY~s
z<;4>fZ2L)*%~)BF3Ati-BG>jc-ixUi`vnSM{l7Aa@>b8@t;9mIwEYw7XG0&SgFhcD
z;0*8fXTsO|FUv<#eChbx!&mVJ4_@+h7p>VprZkuuCSZb?+FNL5$zC{VxA5pc#E0c9
zeCah0jW1r#mVzCPVVay?jv8xAUzoBeMP<m%_%{TmaA1W;EamFcf!ZC*`g(3!@&F|C
z48&v&oBY`(`?4S(L?cedpIN&5Y%s=>+MSmREq4Bj3)`B^FMl#O@eMZdhf#Vak$Twn
zOlP||5sJgHT=p1X8I1=@t@!lJJVAAC8|-UN>+_b`D%oc#faD}2@7VxdpEN%$@AQ;W
zRgqwajcM7}sCez2i^1E$nGC$g%X5}H)ne6ydMi<Z$GCBt7pN|3jU$$+#K#|o`4o=s
z#&4T#6T5AqGo@qnNwRB_(Wiw}T8vxw4tb=TCJSSD6J#H32&^$&7m4?O(G7@tSY!Au
zGVhN_3Rda>N{kbvMgE#5*?t60O#Vjj{b*~!j-daN$ns?(Rd}B(4J@=Ssd85(5uh9|
z(7ij;NhCd@7pVAr{z%UD)^M3{_2KP`&B9Z>lqKZ;9QbWQ&5(e~3UN6tyrg`sp7U)p
z!BuHl7Xatfu)sMM)~8r70?~ED(H%@FdlTli*Dy*W4V<EFyui4(;mh|LTj(ZsY*BJC
zcZu)D-?)eTN8gCiMfBhk-0aF5@Lu;o9oJrh8ZfXPFFG%#di!JY$X1vtNcK}`;sEtS
zAkIUkDJtS?7>NFh57Gno1tIt+XdmVoLDXyO*{4??YFEm?2gY9y|2xysflbeQ5G>FH
z7AQ@w-Y#5Pq#4v}w=mfN$Ku=bXQuZ`FM#m<IP&qIOc(47y#WbC_D6pZy?_Qs065;t
z^O|XH=<@Mv`7VWJoXzSSfC<wW<j`V}fk-bX4+0m+vx@H;P~*oJ9Xlg-=@#n0YwBzE
z8wo%r#iBh>fv6<#PpyFP9Gf&w;IG1f2#Sr)68@BfBu83Ft;iDQ01y6tb-!=Pf2Tki
z92#T^4sXFXK`?JHFUxHv6lGMEyrV1zIW#&$$;b>&8pCd*{b*z=YytC_)MQmDHMC#Z
z@0+&He<fV1wBP`h;wvv4d9|207o#1VCPvZ?HZwjBQ)5qrNv!>|{@Mq$gvVy-p9{<S
z?oP-;OY8vZ-}J@GMYnk+t8czlC6mbd>*+IKWThS^C)_-B>fs|yRI#Fc&-Biu-8z}o
z<(a4CputbeurI&$n)G1Flq?S`zTECN19~hhZFyWAel+c|I4>?0MHf!sSXI(5$a;nX
zVWSoC>>B*-{Oj1(kSmY7d)wkpWI94=rXk%a$Ul{$`upnOImObM$v<Oj-TWt2R-Glt
z-#7t(RcrT~b3BTim>MpGXR4x!RA-R=YTt&~$~rlf@S=2;kg{=9u)R;(dz(=GTNGP!
zlx(5l9(I+FTV=<Z_UkBqS3d>j(4ZKwBXxM{ngP%XIz&>T(>jt-9JaV;!~u+ju&~`I
zg%Q*g7pdv=@GE`8fsOvE)jz2ua5~3^oil_5rb+ol%54TmomOBio#UKc1nMd-{kT;Y
zW%Lxo#0|VtEf-_v*$QiVyHm(Aa4Zf|A#)%G@bjeIFL9gtm<l#PRib<=T18g>d^3n?
zAe&y$za%Iz7-fU7%ZDCfxk4yg@^A7(-j1Ul@2A(jnHq-<R%E%I9Zd|a-xN!_Svr;P
zN#z${WgSF*Pgj77crBJDFO;Q|r7M-eARaw$|NS!hc8huC#V9}XmMaH!zCCK6olVaX
zhzOJo8a=2LJtVL4ebCdWtb_g;A|sTF6693Q<;$Bmho58CE~7X17f(hCJwVnYfktGD
z>2M)=+*@OZScM{BJYu5Ln;a1EQWW5weAxT0f14hqKL(}z#b_5SgwLOb;LgB9rAR<O
zBY(BR*az8cRqE8kLZWM7_88d=G4c^5c^l9g*c!+h0*{POZn*OD-h$2erta9p=9YKQ
zjY!mlUKH&k*jF#N-!{$y-#zbt9EhU^qiWpy;OEMD^)~F_IE8HL+q2TdC4#w8N)JIp
zh1~zz2ZQE?Z-HouZB!XuzUHMB^39k<I&5BlMWgw<7HrY^jJ~lJXpz&I;NW%rRVwaP
zxx0JCyFpN19Yt#y?uQMs1H1$J3C6GELZOZ2RYQ?w*FU^oBmy4&MRqmR#b+=lC?`-S
z`r>(r#h61$@>nNq^QfbflBgcTUg)Nn7Z9c@;1JM%Fa3b@KH@m2swYiC%+UM)2>~>m
zv~Hu1cSX^{#@#@xjV<*#zG{&eLv)uWK?yVor2Y`<VCs;P)w~vl&pOo*C7S_?l0Jv)
z2_(169T%{nli6m_!XHB+q%5m7EiXB8{rO<$x>o)-45=><k5D4<ZI)_teKxx3jSS;$
zk%&|&HJ`KeTT7;RJZz0_^%vQ_VW%&Da)ka3x1dY37=gk8Lrz&#-FWT~XtI~!gfU{#
zAvKga;8O5US^&3`=QV+zKkU@H>%X_NyUF4o!P+MuI(xb_EHyCxn1v2a7=1(|4cRYr
z*|%t9$MO5p<dH}VANv<wawzgir|bLfUYjmdg58az0{gQ!KTZVgKr4lWgI$fOL&|MA
z5;=(w>@xj|P#s2<@+H@d9G^mkC2cz5ro<B)1*S_u)6JZ^QPFt3HxOceRy%@7w?$BM
zB#j*Lj`FM2<RG%OVA^6LE+=W6m;}ogfLkijBB&DslJ*^qNR3O0XB9wBj9%BS!{k!G
zx~<5!iFIkqc2s4G*Tna~Wgw&rrOW@dcK_@%xzJwxPw?^BoyHEzL+FQf<cji{R?8aV
z=^&UjjN^!H$QBCGTY{eWCw$e(prPSg(pk4y(Olx~><M_U8b*a56mi8LH*flua33O<
z%FCz3rvbQi$nQR16DoGxai|?>)JfjZE6gV1ltc+EBYglfwSh2Wel!;h;2Ds4@Gw*Y
zG}(Wrz?j5H#yZP4mY<ET!Zg*Vq%ASShfv&xcQx>s7aNtG;TKY3&=jVTmDye-LbH)t
zD0RP!ggzT4WjgF)$?26@%yK15I#e*nbVx#1$a8EaC$9yI`Jo*mXGoU$;x2O0F^)IL
zZslYj7L`P~Lw`u2Cw2K@S-qJqxWR`YuHgR&u;9JfT&P{JFS@ptT6^2|v+f@;V~4V9
zrn@qBnd9}^85Y@2!-#G8Sb^WQq-$2l>E!$e)#o@f`gS~+sj!fa4Zdyb8Gh3BC9ac$
zS5P-d`R=|<byZl$r~sqDD%P(DMNWgQ7ry*>!E3`+^#BF_0g4I6hi-*nhcrg&Lh)|T
zY~lE26mrfSq61kEXAIqi=S_Oy3q}PIhww?Mj2?-HIs0-(F~+vbQ|=D3ZNxLsey2#e
zk^4jFuQ(z^tqBZ~Ue=Ux*>gICO-EQ?EcGi$J(Ky+GW+)_yAALEwh8^mA+7N3ROB}O
zXeqNcA|#9CUcG)Vfu|LDx+@m9kl+VuX%7T6^`8&<LB1FKg)-O(^go&c_%8A`(l+P^
zh>I_?37zVdBDaMXAgFH2;6p~o9w}RL8Xai#cB<whJ22TIzTRSc7pH-}{0dNfh%u>f
zXZ+VUMu;NW!xRT-A`CYbr8Bt^KKm;UH(bi2;IH_K>B&n7etD7?Ep+8H3Z$#oH@;1}
z(jB@fXh{IA?C&aso4!h-@*nOj+aR!_*`nbGwZI6i1DNr?Vq!z1*JmYcGTTg_5oJ*(
z(FKvs%T*AMWcTiV$b+`zVFPXuJs`zJq&cO3HN{3Z<a0zJU4L%u#6$YBtmU3tKk9|u
z6nJQZv*n7jh3IN3UWSKgtFD^=KbvD-Rri%6@HOvn>4xBIgeRyADX;=4BcvYUBRRqO
zlRm&*D1i;OBqJQyAb|>;#h$mU?UBwS`VkVZf3jsIzvu0U3_N|LCRb(2Rr07gD&W6R
ze=%HZX@7DS#kAn7e_Ab&bMOXK4|E{=Wadox_KA*o?jL=x0MYL*s|!G0x#X5oED~l}
zhjxzwmbEL~0GBe4eO<K)4{UuKvRk~I$+R-}xWndVS`vFf72Z7S>`A3E_cl>ht5j@(
z&Zt~GJ*tPl9>5CdRefa#Q!);@)kR(<K}j-kdV6d!@1w7Riy7`)ndNe~G*Rysj%k6C
zCGY=Iyu^&3S;A%wV3{U4kFiTg*I6rO2@Qr4q{xw(UzA9Wc2Bkc7T&azTJLo~TTUxL
z{mn%M6;Kx7&l-SHMwW54&-##ijEoebM7u^Ym_oDD`j>`phXZnvH-anGUZ&(Hp-uB0
zN3WJvx$L4X7GHL_a)sQ~XlRR^r{Hw`0e5F`4`dKMsjL#^+JQL~?hU&4`#%kvAj7Yy
z@+FF`x?I^$EoJyl^7zBvOc^b`ze0SYXl&D6`PY1Hh4JM;7N+vqY>HZT4C!|66_P=!
zD<qK&oIu=RzsP#$s){%+-ru}|H87{?DFSn?17MddbHRGPyo79JyS_ynD~%ObAXh-*
zHLlki7;c0ofSWVVkR5<)8hL15e3*Lz2WAtb?-X_V6kxdX)bJ3`*Dh-OadFBC3FOWz
zID!xxhX}GGf0VyLBW1+R{8(&M{P$)#6f-0<bTtGvs0w5UI<l?vMj9ZwT>~g~!@VrR
zEKn8E(1(8ey^t3}I#$B3>1e&n^Kw}R`$<_)B868Ti+|U*4_Qw0$pTl5<A>_%PPsFZ
zM3i|xkj1oxr63{sKcaBcIs+8~{b>3Wr9T*E(zZ^&5qu)|R2@pSPp#|$@QSK>p3rX@
zbx(B(LPoPbXmW>QNNXu9UOLQ3eP3!1tMJ!o<Z>ofm0SZzz{!(~fMFWj2*RnbI&>#h
z^<?8jq1NAfXm;g?T^jHNnN&otb}8RQO6gd);iL3fFfFo)Yv0O#N=0MKiDabK%9&IP
z{lF<7=eUXbH=(QJ#rrKN<BQ|(yW$0amc=bb^ZzzNG>*<c0&@D^?L1cY9-RIK&B8jM
zIzT)8JEB0Ge2f?VNh3%na3^RdkSzaVA`yi#+Ta8Z<IewsCjMXbV4I}!mg-w!8iO}U
z8V^A|OXX9ynMxqLK`keB)>EZsCetRgMv1Q$vHFAqLp<=U4(rZh%`#uQ2&N>&JlH&B
zI|Ms8CHLyoYO(<3T;t9#sOWt8LIl4J!W-ejg*0DuYCD+;XphK2Gx!&9jO=?dRBI&A
zO3|-PSZ3khBERPc?dAjH!rJbGaw@7)ojY*ck;0kYOBj=v+8A3CdQx)|TEl_{tEacD
z2MenQy9~Sh!X-q^uIiiUNY8UBJg85-P~=zeJvLW;wT~n>5zq5)zieH#dQq{IHj=e8
zpC#=T>xOc}-j==rj-LNG*142(dO}IStmSg=pUePwlX0cTg`++mVl%e|8X$AO+5`{c
zLa54S$Jg%$d)(!jK`fYmW|%+wkyQ{YfF<Usyu4-t;o8Os0_J4C9h#@piBwLMw*#no
z<TzOotRcp+>F0OsWtOn|+85(6Qx{{@>I@4WOp;$eKZB2n>2XgNhU+;se7~YNeZaVQ
za(5j+r%M*`tF;me#4Hls2Pf1F6J40r5#Dox_o4Y@YTSPL*It@T8GJarOF`qahGkMl
z2Nn)ahZbE_zc-__xmiZ(ZS+@@Y*B}*6Sw9;_Q8u#_0Y!XU1}3bg9~9y<8v49C>MHQ
zcTgU{Fo0p|SHUl*+n9DIrQ*4`WP?2MM}P(kb^npz6^hro81-A1%J-pzED1y+4EI@6
zsRM@#dgM)kg^3~N%b!U_^kva*HadR*RsSNU^T4tbk5eT{#t=XRf5ZpQ3tVtD0FldL
zZ6SP<&Ijf?OOO$`cV{NEAeP#E(gH81aQ%Q|^>o|JfcW!Qr62XzJL&8Uwdmf&Puu$5
zsEAy02(%L&qewnsXB87$_ynavDdifzU-0%BT+b8nSZVSl3d~xHk)QOBXD-#ws2`Kn
zvI7f<#{(|S+n473o0lmYF##~%V~<_!^(Z_r*>se~UexqRNqvaVBC)3*%gBjeOVcsy
z;N2Jr^W=Y@Go9&L+8PSZlU9*a?Ii^N?~iYA2I!wH<b+JGszi-wwsG`}AQrtEam?2R
zj8>ZGeKtGjuu_hg-G;Fm&gxOSCYE$qwGEPKtPeFDihMd?p8I8YTE?K7`yMZir?)D$
z2Nu58-__t)<py=j6~OJcE}hDbZe{4xiW;WY;8|(H&jg*0poXc7s7t5|o5}FLVcZ1W
zVIjf(M+|61J<r){L!R*1sQ-wSPhLa<j8#eeBBzw7WND-`Y+CWb_6tM)3Zf#+3_GCn
zh~g1WA0Q!9|4{1|6R*q{`%%^@%;q^GCraUQ3~ExVw^NlLWjLIv8&zaSGk#Y574k1;
z>o)i{<OfI^^dG16`z_&4P|jOGwwSUwx~SfT){JI(;`*w#^mIHIl&I41tXje}i-4zW
z`4ld@IREvRWau{^0L8XJofJ882q6}vs5MeSz&9B7%PI8l=X~5*mt1dj2O#95<Lftw
zw`CmqVAD)GmA!)fXxR%^cgkp~lz!_bV{e0WuR517=vh_5v=gtQioOLvt4_-<1T(Q)
zFuvPuT`7L#Cl$zU3o0m?8Zy3PjA*SN3q;CN1%h!mWvVbQYBPQML}E2PbC?Gx_u6(L
zD1aqTDy%_;mxACaAo2rDPgI6c<9Gj;AcYb5_O##YxM8*M4I|5tYNHZjOC78zo)Cn2
zRp^T$WhB4d?;dj~Y5&kUwFCU2b08T>uB2g|2)$IisKcK*f0@9)*Yavj(iHGMJ0v!_
zsRJ{aF?SpJkk;Xs$i1~2{eQ1#YlxNkyR!3?>7a-tNWE-Fi`0>ngvBNZ20By{_`L8F
z_Xnys3Up}qkY>e_DA9iTW0mo!pBGNf{bz1KK-MxFEm`J%Y-bSb7c5ST(2f?a7n8R-
zJNiD-Da^=J?3Eu7?57KFpx9(QV@$)8-Y6By^!JuDo}bA^PwtN&!M>a3y*z38<yH|$
zo5RB~b2Db5{$VmXhUw%D{@BbyZ*YW3Vvrxlv8k%dezuJ_2w{*&*A1$AGw4H_fJlp8
zrAjDiX`R-YzB}2ln!MPz_c*j|7sg!w!q&PPpvb3X05JYqD-n(kT?bEwwhAE}iX+*r
zZRr?=CwkDJ%B)~;cHr<kT!yN+WYvhCKqb|EeF@2jTbv9#309xoJ@g(X$goP=;*}ud
z`;PecrW?Ks6}DJYW9y!QPO2dJcRU|O`^eI0ogq%XVJf~4N&tV~68w*YH--!TLNnR9
z6s;1&f$$slDs&xL%Y5P7YU$8c?0mZD6oakw=sUqE8}*}NBOzoys_<~_o$vebdQLE(
zk>%_5ePHWO&TdYb!U{lPmTqma`4EfohkA>+9uh#6Vd>)zm(kMJMvJOKQ?-oLBX(;R
zbC9V*O|`lW2NQ;`Dp=dKGE4z?kRg8I_C0rwwRA#g`#ta8XD=Y=X7kadhkifb@4WqQ
zd*{qX`6uGnXCaN99@LrBlv=BeDsC4(r$`kiOCs8Wu$x!Q3r}*w*F8<n^y0U<)uBSs
z1tE^<PCsgwBuA98mUWJeA3}s@o!$i-V%#X?4v(>w-n58pe;*V-FW#wqKE9R4eR&=Z
z3Ueksh~4WAbOrln0#Q%97yDjn7nM&pqT}!3Kzj#8i$j^K-8BAJzzl3Oh>+rdmcs1(
z(;NwJ*F=xz1Q@x)gg*@4idHTRuZ$!4d=@!8vx=uh1U7@P26PvGpNW0DMQ?g$f7tF#
zYv7cTO;8rhsR(L>qR63!<yyIjF610A!;fxLYBH~qeez%I?+ydNKgq82USj6AArX>1
zb-^T?#Sv+MREf^SEh6X$df@LO556*wh{33C7Y;-@Y_NTCK}oeN8Pen(>2C_qXrF_#
z<@ogJn7QLDCT_Ai<E>=o@ziEy&9!mn5m`$@W`8^#m7qh2ol|f)A})fww>R)0l#5^b
z^+JMwvmbpE#>54I{-J=R50N+!VOW>@1}EP2ZQ7i_S0Z5(R6fO#oA`c35dZangQS02
z&G%wjO%SgFIsEWb)g@_3&In9A3TgTA`#aeXNAC|)iQyw}mEb8;5&s8Mk(~mxg=f_6
z=SHP&Y=tQ!e0#kdKk}xEw!*HpIMK7q%NggRZuqQ?<Lbpz>WV4%ajED$*XXHnW@dlS
zkgPNF_f1qxQI+Y{wc%a&PBiYO&rg3TM%RXUycy$1mlidN;N^m>B8+$;%HhI+1tILX
zCZEQiw8`a&Sh}-;3xoU1CdfE8TqN2AfI$iOPlFX4tRw)|qw6CL{HJfOixh`vqHG1r
zi}z2m9lcFB!v4gZaEQ*qEdP3qxdD%?KC;8K7k>Z|SETLhv@OHp^b~P;;5zrs^^}Cz
znuORn*^|%4^i+CpXn@GZBFDjFZ|I%R`3t85_vIyz8+eXe=io06f35`~O*fhp0nzFC
z1ErQ@_9scF!cUS2d&kaU>SW;O=-EPcb8!=%3)3|}luOrv9<y3IiTiH+Ws7J9Mra{L
zKd~p@iiY<q^xye`+lKclo|&Rt7Mc7W)AlGtoJZY6b&&5WVIkj1K1+$lJdkW%N3v72
znCL$|O&NY@wo^DH<O8pMM63i5{0cCV!E!_Ud*yBO;9yZd@dw!gcvJteb~<=~ur)5a
z{v@qD#C?<Q{S{UIWkWU0e=6?2{QjU6^XdIXyWU(k*Z7M+?&Y_F;(6zERK0ux@3^Ca
zT1b={m9DtZ4GCdZVxT*+7v;?qMz}dufRp(5879w5;LQE9&BFaND6afM1Y`7`V>*Ei
zi=mGG!AX)dv*h^x`SM~@*qCA8T@}B8__)B!<={h*LMZB-fT|Zf`{;m1?3U*DzSp)H
zqfV!@(NLPO==}(yD_`IEnj)A8?pji1e+UZd!$Y^UJu%l4%;mQIIHooMfK4*!h?LAt
znu4FDuK>P?lzbB9r(>5{)PA|@h!iVy`Zz-6Xj0`Xa^<HG6iO)+Qn(v;Qo_mGC6~H9
z3Au+0nK_r1UWu9RdL*O3FTDhQy<P>UmR%%gv(k*OmK1gMnR&g@mxp2%Cz$vPKc@T%
zWK7zmd3<H@v7vuI1+l$!Dti&uAAZbVyIp#<tXu@{r|k)2ae>BQ%7gW7h3*X(jRKCT
z3J$Ah#m?<dK?l9tkhA2Swwveur7y1u3Xi@A{YlX1`tK#KwP@-)&p^*0=UwUw6--eX
zuqytm<L17uY){*gxcmUP3=mRwt*{&vAl=mS={?lU>oL~*Ns0Y6@zrHWG%(HoA*OT)
zIlcmw#rW=VW}FfQ+N{FAji=(e-5qk{{lox~uj~m2#k_WMpX$0gAgKK*6d4T!12G%5
zNkcx)U!}4k(of!qKr)HTBb&WsBF-v0bK}S^bI(y&l3;aMt^_PpReY4mph6*2k{SFl
z{yvHp`9=~=FvNfJYcWuiI+}-4`e{c#(YfW$(Ug<!7;Zds295j<*^F?Pnrf@qPaswl
zPo@uq`alp!wnZ=iMgGO!|BU$}fU349WkcYl?Wl6|r)n5FJ{n4dZ+MEoFHK?*F=rGn
z#qr`M8T_!Cw<Y)95qNFJ+k)J-7bvjNBN!{^L{t}O9_rd%f3@)Z!fkOc-$QjSBi9K}
zdpmV*>#x#n#7{W0I6_2!=fp+IbOl*pV|1e4;HJ0$RxF&nPqS?kgK3@<toXD_mCASH
zgq1r#=*J3w46>FG>uC>uF8>ncV1fsF7ZrtbwgioP!?EqQGr(KKIN99YFc;!}d!pEq
zh^!4mEuETwrei(L34)RdGMtOJy7BtngO+UC<aPikJ%d8)5sj~oNRC~Wj$@2N6Z(Vn
z^~Q3NfF)aWLAg%NoD;?90ut|fx?vM$9#-EQqkM?0_eN}`8W|uQem0Ex@g+OeFb!W#
zo4c1zcdZ)bM1x1A1)}rZCTJV>7dU@PizCkL41A}WjX=q`_;vE8Jjm@jy$?^&iH<2I
zej@%taEY=-A6Z}wpfi(MddK`qCCtKs;-ULcJ+|KuewKJ2l=7kL`#G>LzR$T4uu>N1
zRwq_hfI3uYl04?+ZME`1tpXP`m(4r2OVQR-%cpeTKX>uUw~+;$nGReoFemE7tV9@z
ze4oGlCCJ_KEd29;5<!jcz_9^3x)bEGVB+#E^DTiuFCYZY+=Xtye}E$r8xt9mo)Rwx
ze~k^$Y1%s7LvV)T`ml$%(G46TIhk~0JJH0C#?R{K{M|u>{0a(}=&6R|>p~reD2aqK
z0u8bi5q<irZJuo(Ab#x={`)&rjRYER9cI+lgMRQgh-1hjh+OFAFX_GH3+T5kRtM-K
z_Zx{PLWIGs@@T84uqD3cjVj5$Jpt-BQ?)m53U7Y2Q@3e`d(SiP+z;}a1{+CO+v+d+
zK1Ex6g<Hp%#2EF`U2v`?-j_<!&=Edg_A-%Ibntz<J*VwW)`qU|g1*A=Qr=q)9AnhW
zboJ67ygAnC0aea#^ygk9tcM?@2W^JyLy`MeLX(Lxoo|vhoC~JlqpqJtwZW_zulTYx
z!}Y+Fq@iy^dSUclu{z*I-;HsOJp8(8hg(Fp<^3AVjWV@un1Wf(!cj+pxf~2<y!ZK>
zpDony1^y4u^&W%?c86lwTv$DHC_a3iOV`y(TNfpZcox4<{$lR@HQRKi1P;f;5f<$Y
zki7p)*m+wJ8*7D%<8rz<w4=|dJ6X%R-U#^C&W?U*ml@R0Jkjl*At3{neKJ?~XG0C6
zH+5ljZ!^6o$M;_>1dBb3R`6?H1Oypgl=PPhKMj|9pcT{~zHB2)TEk%@F7lugtVzHI
z-3`M&8@{33BcgTdOw&BENuz4PCckAe`Ik{YXFN$nps)5vMBu&+_eT?n8eeeq{0wl`
zxb~4Hy5}^)AUMH6dPRrRweFGSEHlcC%>!?W;hO?YKZQ*Oy9b<~wdCO^em%s!YeS)x
z@C0(_e)lRxtEK(;xW9IOZH6YG<HrKTbn7F46?2QQHy!Zj^#ckifo-yM?-xDnDTmXq
zqM6*w6iP?sQ4<$CRHs2YZUHTPjjwWH9wy$KqiB~V!q9HC2p^YJ$gnfKW`C#KM*pW%
zv9QDI^-g0&eC5hl%ZJ2;gJ%+i`0-~?$(%s?HWHqOCX@|Pd;p=&qoVC*#5p#S%k~*4
z072rIE%{A%?Y7<U$&vF$d-^TdzvHw%f}P@KaP1zG!n<C;Y^3w|gCcZdaHopMt0!IT
zyjlFloyw`=24S9p)gCR^HMy5e#>B+O<9Bl_I-r$jNSy5-W6n?PgqiQ<D2kcDIDxab
zeRuU0g`vJufl38;^^83L+iy9e0o`D!$A3M!T=D+*r&<G;*!?A50UJ3?Vq4)@Cu5<W
zt=8l<Y&1lnrEkyywoQ05xz=S=`=Q5?xp{MaHqVAb_|%=H=zZ@etT)KUMaJ#i9Pbsr
z@^bjC+Fo_YDAJ31J#1;qJmSXr_~Y=I4}$;75~+Bz_9W`UuKcb)YQo;sEqm-2g?rLN
zx^(nomi{q6uJfYeFI((NK;%93nY902!Md^cF!(kIJ^KBm4%EE=+3Qv24(drF$i~~w
zqb$w@JT#kxfAT(h5x`y%#NKXu!<>8Wrz6@bTljn=s#4;A_q-J`6{9hv_Byj1CMWjk
zMKyX7hYyx32+aMpAR%IAm^yOG4AIwV+UtF2%mZ6sPsZPAh_Bm4pF;Gf7TVmw@mKfL
z&u5v&y7V{9i(!4_68>ai-Xv?!828UMs;AdBrtj69-S7raXIFDscbjq7ub9_-jx{7B
z1N5rvDgC=eRPbzZiqYg3m!S#8PvqyM5sP&wlii1kX|4fNK`8Tv&xQLK8`s$Z%z&X=
zx<}=krHmhfbMfme2c2%C{C$9IL5#Hgubl*!OpSr9LpKe0BKPI14opYgyMT8lW{U&t
zJ8Zix>j4vtsE>yKkEj$MyetBuY)T4GFU))VM%+2VYS>a}8}j9wLjB2$^}0|4rn?8%
zmP%jGw*17K=aXP+JGn}`NXP@+)@6_jY2m3jB<aW--IhU9ki?X$_}%%bfbv@m{cG8F
z%e&bCVI&u(_2_%Kb5TUzRYrdPQ-9i4AWKIlW_`xH(AoZ);8Kfdu$eOms{!`1skiKT
zmNoHR!%Hz1<ivvSO0%VriRp8Y{{iiX8(n{W@v{8#j!6n%)dAzmOGTm*B@j4YdN`^u
zmy+ShVzknD^S&Bi+P8@v(-Gt&^HSP<^4{X#-kkAT%oXZl#l81%n$fYZuy$Q~_NadU
z@@{zlvSD!F`A5v;sNmgN=LD?}WvFv_AB^J{`Jl3%Pec%LTx2lp^UTpbcV}^H|Gh?V
z5`$`><}NfvsyshgYgoWT5HwnHE$D)D;7^>(>4L>+wFlt9aayDNUV%V)?7(QtNN7u_
zEu`wLu7vQRT*J7Y|E`!TKhgpxKEbtEQ>WkFjK{A`LQNA#IdGCG*S3goN&P*Oo*!u#
zOB~9Cnr2uz(ns+&4f%O%0z;hMMUrg{ky301rI?yPaLMgLEHMp99L%WxaZ#h3Cc!id
z6N*HjgpwoFNh+r>s)iKlo3n#;bq^-h`Ycz|RV)7Gt_kd^b(UX3QNLNQbnr%p;u4GG
zatQ<SOLXFedbdC}ZO3FV{|ULT6}pjN77T<J=rMqKc<?CP5PP+~rD}2&q(oBZBK3~O
z<fF1usUI<rY`R=zLb<;_T63?Xl*#)nkc1{Y#{}8K3PmD<Z2`20m{fZDR2|Af8pDaX
zpFYvRBnvxRj|ep;fea!giO-eYC=~l8`z1dU>a0)_>=UG)dFw=_9FDQ=lUNX*{U}1@
zeUbwC6QeaAW@5+$U&<k?gu*!sQYAuj=T*^|6dh}!@$+cDY-Fs{E~1+HFQ|jKzPY2R
zk-yuBkFh6HP-A&_tnL;b@aRsXWL5z=76PCEVFdBRESRE`;f8cgh_^wsWC6l9)*82#
zQ0@s(GjedjSjbi1!_+WCq#9zT?Sucs?#&2PqMi_{_mwtOnX-tr7KSC3>~kXgm?BC{
zrN95L(5{eFVrEemH4Ll%yspsIpJbnUHN|wkxP>|8Ra2~G-koYqHX^ChLiL0SS+6O@
z=t$^xlH&TnTCl0eLJANgrTXaVw`8?J!6toW>{x5|Q-*9GMih4M4=$&H3p6Up`?{u7
zA`MAPa(&|u^ZkJ#eUr7lFsn}>*u5Mo|BKO@p8%LTLuZGvlJuA3z>Dt@Cx}^1A&bGW
zSG*7=KB8d)8zNx}IyW9?8>+4_*uO9I`#m%0^)m{k$}A!aSd9yOX!h`pDt%&S%ZCZ}
z>tdMDSa_*sC>B9zvRM2+(ivT+Ca7l_Xc-^A%89!ARZf?05qgU9&*;WXo)Khb_~oMj
zCM^Y$E?t5ts*)zuASMcb8Qg^h514pH789{OL!c2&{L!0K)$9rqdPpKt#f+#mJ=kyF
zQa6Jmzn(T!dA7-GDr;!R%=YDjUeA=9{R0NV`z$Cy3Ud)o$E9*Wfw>mes&N6M9e%e{
z69vs6@>JAR_9h4eB+Ar+=~uR``deH$*yUg+Dd@HyBc$6#6a{C5^rKMDM1SO?qK`k{
z5*GVdu#0bJA=yb7nC{#PJ_Bi{vO|pJ5cJ<Q8uso^<llZboTT|W+S7yMeKxU+l-{Jl
z1|Q8&>vgA|E_HuSd2vk1!YU%=T8e~~3*(eSdJ!^;F=c=PUXOV)iKcCcptKMQ;lsk&
ziEynT9FX}m>0IJB50xm4{CD#^bFdo~{wj9E8=lT*dF!#>H395Eo{HYrH53=-M#I`T
z7?xAV7$#76F_z1y|MU_%$;aZ;AB}fLFx!CV74PPs;)3O{`R}>r!}WAK)^|^mk=B(Y
z2OBgHmPqiawcGoZf!2Okpi?7s9*+>0$?TEa1)!_Olpfd9YGo!hc4O+K$rP^5$Ox1;
zolEy=+D{k{Hy2Sbs&3C&B(&{gJh?W*NP$N%Jsq^uXT$iL3fo|I+~5g4*=1)45^K1w
zUpSwz7^SWu>+{d648{UEh{XZhAy;;YrZ6p=K{=34wsdVh!zPQ!`!xyogJJ~NTgog7
z8|G&(sMos}{9qLFAK8l^1+(x#Px6m0<4^%736c<kQIXn(#2qN{$=lMrh2VO+ni={e
zYaTO-yRff)X9ApWaI}>2Z}=xO#%9b{SfiY@ZTqI@m5R`-{E+%5gjdnRgd%)!fv?(-
zsWKUXqE=+22`|Sa7_GU8!9pDQWRia!Vt*34=y2ZIi%YFL09)ViR1klPD#vSKU-3WA
ze*fjCE|o7Sy~CPQMWG|}b(wh&>FBXU0kLvF=PJZ{f<Sgg=6Z7xKLe_4NjVA$ixaA0
z1t!x1qRXBGOwSR#p#@>3BdSwH!KVy;->n<AmFRv`rBR$EZT`F(4cvL-s(G_8*KV0F
zc$xR+TrSYXgW|Q!Q(XUT)Sit&YWv$&Sv^r4NTnjvkuE@gC_5<*Vnoi;haIh47m<-6
zY5(lQH0+!gpPE_6w3viyFP2+Kz5Il}cMz%d-b(`O!$hKf!@U3$TGEK|*m-J3r)Q8w
zM*c>xwj@HY-R8tJz-n<;DaBc2$NQa3=dIR=uBLD)+<fv(7yiX<u3oK3ygvN=H&j;j
zGON4Cj%i=3C#+sNeD`M}bk}D=B!-^&kcX*!$i|KU-0z+8aH%~BBxw~C>SQ+k=zhk;
z9qjd?COx^rOlmTdETm~|d4})_?HK2rg)CVpK;WJz%QDla@lP3QV%E~3JNV2L;WIx~
zSbZhi>LCIHcs#=A6~(Z6U$v#r97rF#j0vl$H+DjY&d~1-$|+_w86p4#4#6v9!#c+!
zHBuWZ-)P#9rboiU`Pl9a_En^-C=*&NlrHY+TP{*Yk=(e1`m3myCsS9>zss3Z<fo*+
zSIs8fj%VqUE@wfXt)+mB8cB9w_;XVN_lw|O*LCF4Z&m~z3tP?2Kd+#2Q5rTvnGqaA
zn5@ZW(FWKrj)0sYisKn>7a3xkHo_1%#%cr$9pd2LIDEm*)v&FCD67jqK>;ud<Bf(4
zIwng+>6MKea!HWDQ6}pkdSQ+%jG!x0KTe-&2Whks56R%~7}g+5q`rkO4kocsc`B2t
zLrjr|@MoR)0iv%$lp$Z3op=DHlW4Rr&o3#Xd?OU4Zx;KC45u5_5Uq<)fqJQqT8XdU
z4E6?)5{osz8j#2?@j{9}VxBGurRkElm(L5jy`%iKL~{F!GExaWUP$B4^`*5|15(Qh
z)bicg)x!)Q^6L#J=^m3Q!`B}ieS5%qFT#f=p8LSO{Y~bbAM5qXkicZHk$f?A>j>B$
zSJ*_-0|4Ix46$yHjCV-s*D(w@Uo<%aD=3I&GhpIg@)u*6%L!ld&qhU)D2-BSUn&1V
zFr(e-nxQFJZSkgROlH+6Oa82`DUyMc((xb#2xZA_2*pX+YbH`xR9|GF;<4z>7Q~Xx
z_fS=r8k%ei=O2aKz6B(Cll+yXCZy*{k-qx6R0{}g);Xn7zEV291w?t!Hz(5VxTcuT
zkyF+JY%c@1C{2ElQaBP+e;&|wD+my?rDrbhkzL_PEg9JMPHU$2Of0!e0bn2IjciB>
z$9u`acL>RP_sPx1^>|Vb#sKx@q}BpwB?flMlgY$W*9IiSH8&E;+-x2<<j|KJxA<ly
z<m<q;%#Y&(uYk1J?201&6%MZNc86y#2vy}NF_7q^tePtBT=ZD1Mk)E9iRFy#n7$=_
zHmCcBm9WiuL=#6_QkmkP#hov${+=qQsq(6^r;aO7rYEVj6QRX?poV3kEA#6HKR`q)
ziEF&RNL#(IGhSL<(2VVu`uLdRA7$Lq)FoTf!W_Jm!OIv~4n)15kxPsKWrg*rwv@fO
z=5QlT1!N*Jfd18wD@=XashzWu!5im66%Aay#8qXjoo9e~bEa}dU`k7}J>EIJryZh)
zhR`XZ%ba?uw)__z+&|miIV+XJmyBDB&2WdFPcNYbm3d@Jo0&-Z2J9TTH|a|lWl73t
zji2HeiZBHf4pFOM=wiJ|1Qf9Y`h#$`%dqJZ%vVRudr2Bi&uEH>KjA6RwWTqhHvjM?
z*;N#}<*&1dS5Gh}oeN2J9N2D)hg=<7lJ)A-E{iFX|NZ{~u0T=0Ob^{$bvxswtE*ZV
zFWp_$!nD)vGd`t95p&U3E@>=zm^n&2vf7vqdNk`5ri0!cewsN-*NyobbCj;H_>O6!
zN3<M!l%5!`WbMpodnlXFSR@mBls=Xf!xl1`b28aN#^cCk3z^qf<g;V3P8BkHbBoz{
z#^adHjwQ!5*D*zymLg2!Si(E1*;&NnxQ3lY?pobUW|8`pH?l`5yLvlYMm&y1w5ZP)
zp9=WGnkZ64=5EL$MI>ZH6q!ZVCV(`MQ;BjaQBEbwDI;sw1AdvbpDiMvtgNR;>2c-L
zYz4h3{V?J&R!e6q-(;(a$MFGM!|WdYDZ2*U74)9i?-Avklle9zn5&>Y@@TG!IV~^X
zT9_sFMO+J0S6j=qFkfWUat#>U&BWt)jB8>1^AB*_kkZ05#C^_bse9SaoR;3ZlHtKE
z@~zDDcn#mmfF3-Ia77UB>2rUp1b1&uk4p>Xoy;vEX1<MiP~)cUjBo`Y)_O*1P3Ak8
z%foGa2Qwko#skI9w;@j}<8h4QJ<QdShgmJHt)IYa>E7}Qd@D0EatiNZK3-FdIGfLB
zK3-GKcQQvps`zf^ru5akm+9o4yqCG9WE1aY&KCkgh+Za|fcxp}O?(gIT(X6y>~q3R
zyvRN$Y~i)^NJum9Whxil&U=~3OYY;n%$T%?c`u`!zmIn^;qwphpvhNwDE}X@R{Ey)
z9bU_VWIelOeHS0edK{ng@hr4gR&?80&_h0ZKIKhXO3X8xiIx4%_%*L*J&x~qJ$u#q
zpAe~_Wu&#Dumek1DO(<56k5mwmS*B2Wg`JIjnP6WQu5hXlHa5*GD(pjxX9zq6d|8{
zt(!=8k~0apf{S=U3j`PWHMBr*lJbZ`!Ab7Mw#)0clhm*t$8@2K{#rF#sA79tvvyON
z;3T&)WrCB9wCp4<R%WRb8d;B{T5z)08OPHq_L<N%!cOvjXs+O9yA$dKH~MvvPcKg=
zF7i}mGif0=#B35;$l@4?ZS}}z;v`iuTLc%G8FRDHNM^>=Qzw}<7wCT*ze8wcSBE~1
z_=4bO-RfrIX2(^%EV$VTC9eyh$#k-dT;q2gV`YC%eNSj(V^h0?U1Yc4cxq)oGLEM^
zh}-XL-p>4L{7l$Ew)@@4?jVmEz!#vEos|GMHUaViY8l|WB%VzPY9_5@eBFN1K_6D0
z6I$r&K|c$2>PHl^c6zV2nRFnw(>1w%vJS*{x-(cO>p-;Ar-H&{Ue@Etk@a9az3iT#
z*)lK7E?pq&Vt>l6l0i!tMJlm&+o=-E@Ui*{d>A<ra)qp&J~L*W>?op}dM0g@sjzJn
zIcN_>4q7%XcWTlNGLh@Zx=SW<(2nW3ak7VH9rQWnlQKI~Q+HTqXSVviA%h;_U0Ede
zdGbfHZsy12v$8$dJ_G(J+e4loN97&#y<C;Ni=CklkXx`Nv0%Gor-y<JayxxFFrCDc
z+?Y**lT5Tk%I$RF;&{28Ze9vGn^gsQ`q0R1xr=-@d!*b&7SEd?caayTEs$5SZ`7=k
zSFs_h>*ZDK<gh0BKH_ogk?$iRs~?x|BkK}hknbTe4X?@fk=api%lD8YAz#Q{oX7Ev
zypi)bev<DaZ_lQpiyRJaCZ*(ba5K@<BXg9Zi!@uBNfQV4tBHFwz)f9bQKG+i0Audv
zOsQtEg?l_dS&XE2PMJ$vxeAdI7r8xVC)r1ST9qO0BR@?ZC3?7H_2WekS6e?`Jb?M)
zBICwS7p<JIpj>p3x8s+Ht>n3>PO+8Doe1chxSt##`_^469>V$v7)y?FbE=!fSIL~}
z{o*0CuezBaLp?o&{kxr}Pdg%dxT{SkMHlJCM$>zulRdD$OLVdytp7~x;#76bq=)-4
z@hh>j4@1j(L>HNyDkxlJHq<`yO|(kULbj<v^AD;)^Py$_3K!WCy-5)H&@zL<Md~o8
z>S8Pk7l9h;B8_Iy-u+{miIxv7OH^oiv?6%Z@?6CUOf_IE;#7r;IL&huE;6|Qd;z-1
z@)6|<Cn+9Lu5gh_E0-u*NY)IX--&hkvKdg9bu++in6X7@Asf=**K6?CtJAg!PLh#W
zt!N?FjDxh?m?tQl<gszJibkR<s8=+SN5*YZG?Ft@Zc?-obIh%ZQu3#8kPtiyB$OB5
zqkz`w0mW(5`3cnU335#Hq~Zkm^U7xxr%90EHHC|S&OIc^@Rq_u^z<#o2{JqF9mNR}
zRso!4Yk?;!zn&hzat<2%Kq2zq&ig_U&wo3cQ99YY8nx2SdmI5uJ1>+Oly*LRlo>Hq
zna^j~>S;bdEia1{^E*f9DxJ)@(KD21vCX&h;-Y0rJMR^1l@<JhapP$P@>lT(SJWx1
zc+j)RPYb?A36y)4cD^n@i#S<D^n=POK0m*iRPk@60=7p#p>(nnM;=hRScr*>Ei@if
zx>zVPF1EY)b>(?%E1*8^BqHBYT#H(LPwC_{W1u9svOiYZ`KRK(QC9KkY0bpW?@H}a
zR`ApEh|0w$&EQp4d>4lG1mda&z}Hs--jdo(x;fSep%)qzsz!dK$xqe9&k50~TCfhf
z$bp&RDi^5@gAxMh<{@7?IY5zrPhnQI@E%8&O61!WxvCblh}_)rhH0u_(Cxtz=s{m?
z=x#%I3%RCYfeLUr;s%wAyfzZhIqy%ZDmH8Ny(*4Q%X>=I&3_|*Ugbr<Jv{WP-T_P}
z-KcFZ|J&v1gbE(VODa(Sx>kryJf_kLA^C5p^hl3Hx|i=+xsH1I@5Y`|dHKyX@2ld4
z%))M!Rk*S6dzDqtmH>X9`HRZS=gg;SFMo2ZpW4eWuL)J#1+5sXwhC8d+0|BoW{pu>
zh3AVVsP~bmxl<A6sH^z7`DbNzK69=?>EepUL5|p>u2w@Uw~c7&J^9zE_4N8Az(ew_
zY8Tg%(WGwV_LeuP_4KI`x2g5?*XkC;-D*9J%zRi~D70zzshc<$BXsf}$3b;Frrm?N
zVCM@Ky{@iep@dWj+vk0t1{5V1yX~?-$wiLF$4OO!Jvu|G61p@aq(=S`V>78@KhPCQ
z`^aOuS<*gohj}NlavsM*sSsthAvW?by4gq0)r=Agx!U@*l9jt>-Zheydo<!YsY>uT
zwn|k3@L0Kyq-Lp+_c*@ht=t3Uw@EEr=-Onlm3)(Wr_|2Br`s)c^6%;PN)^JMnfs(R
z4qCQC?pXa=sY(c1bwJ|ioV-Ppqu*yl5f#OeEd6N}P`;k}n$*cdE8WTeTKSgL$v-^$
zUCGLAK|EFYmSp7~j5{M)xzY5D)F^lyUr3F@nCkB&J9n;<XaM~*jl%a!$`w_@;nV}D
zjcARX|E=7h45SBF*ffFE;}|6dQfTcDkZF0NHJ$v4m`y?_50X21sE;6dyrxm;iiY<2
zo^gVrlmA?|SF&;kXH3&rx!eT{G*<5LluAvD;BhQRtkJXzM^oxG?ZT!oH*FWR$v0`*
zg)^4{E>C`twhMQKxv7<#j(%gKHwjg2slAz4Ik2Xz++Dh6QYCC3vqNL$x}rA;R?bE5
z&{(-g3R*Oc0$>~Wo4T2_3b!oZt#J`u^leg$0PzW<&{A0tA$8AbT7(HpU(&P+*IoWM
zO{eg<pPRM_ZI_?dv<Q=Rj9;seak=Q%Ep#X7{kjE@!|Ycj9MHx4x%s6*FR40t$Wu2T
z82OT_hj8}ah{%i6GyU9LdB{jVH+M2&JmO40H$SQLFzXdOj)i_nIHm)PB~%7^N@Z8)
zuJNNXv%TKWE4;h%T0bfS%gQVK8hN81m30}w@5ibgepIHKqmxnDTEks_RA#X6^79Jb
z$OrwBD2#TKD2#TKu*@V;7;7g{=qZvY^ukm&FSpIlE8J83yk84BunyX>cI=^EShq#+
z3j0^4lVZLy?XX`l|IX<5{hZ88qrdb6Eq%bYkiF&}KNs0+{@u?-a--y0Ev-w{YW4Ig
ziw-ebtEb<R%e1+4_mySZv9uv$sTQmtr?!fHzh;YeAIY89thMu|c?PAE{BF8KTZ(aL
zVcInJYW4KHY7gR*S{FGK^PIMYEW}>^=z55!I^mesMS4rZq-dB|u}4GyeusIJ;39`+
zcWPZ^#=O62tJs4z-)Z-e^|OD|?jw)SmizA`*Uy&w+xeZdp)ZSEWbiMQc^qc{LYc>r
z;h!&qyl|1mV$j3vIivgwWl*Q=G)OnWzfcCYN~sLWd8zCf^CrR0Z%*w|HVV&}cM?0j
zE@Os&3#qN2;qM~qsKaa(Ylu3`x`-iSi%`YJM9uYgl9;GP{xCXQ?(ZUC>sGP0sKacj
z>`%!FLaD4Gxz@i%R*_uiZ|65AZ}NA_pgnhDtXhd;-JkqRW#FrkgHdfae<0oM?_?ed
zd4<=~hpd0~_wq4U?(z5X!Z^TNY99Bu3#m!Z`&)(ONw4@@g|8ieZ(zH9{h~Mhz5JQ6
zr~SSB`kK#xQ~sU5RTwSj1FS+-krdz+nu3D@im-eF#*!i|OGQ|gim)uXWME?yVTrN|
z&p8qT$}q>vs6$f}U=<oNN(0L1-twvdtKgr%CZJK)5Vt9yk|xF76;O$smGtlxW!fTY
zN=+wL@@muw0`5HlZmy>8v4Bz%WC8o<=XK4*&7HM98&FF87B>^CaAje8Ks6nIWtp~`
z5=~b?HQihOLqMV6pU(uYp)ekApr>L-1r`boaZ>^tkh6g<yP{0HnZlgjW}Jtag{j+&
zIE(HrUl{0;?JZv(*d(jlaAn|F>eZ|bbP=f6ULnc8AutK!3AiT!^6@swD(ooQ80ZzY
z8a4!4(WbR>P(rL6Sf^GFEK;znZU_WxvpLYpfyLz_U#;5}Sj7UiaT9WziJiVNwKdSn
z{ifX?DDuB)4+LuY-?WDVMg9}*8;G5OF7{-^Cx~YQw^10mILTvkNl=w=YNj@*MdooB
zf~th<@lio7GU#hW{>qTJAV7PNi<Bvv36*7xnH<zA3!FAR$jM{}%nyP&kQ@dmOM^VJ
zjS1_6YM8H9Z4J^2zXpSCa4iqWPuRz6g)8}Esx@R>$ZbJuNO40m@yI-mzXt7~#mV5t
znF=hc9$9tdvq2rQ$C3{Rb;!c~-U#ZD)s25Us6)2fb}py`IXh+D2|oonnc^C`ZYQ=X
zoibghS+|Qmo<BmT6|SittJ4a*MF@TJsIj_TG<59<omX}wz)gE(mj$}1S5}fSN!QKD
zv?aQ3CP+J9rxg;lOLTjv$5F4_hk2@%f0+cF*CcM$Masu7k0M^#T`O+a>E#|ri>^@U
zPIwsc1zinOQrD^5Lrdzu)Olqkb>|_hSXHoBc4%T!uqgj+&ctA^Y-8;F;CQ)L;|xAP
zvvg%z(8l)Q4%zVqw+DB~njH5BcgPmcc`Vo?TNm|g@EQX36y{D}3iinC(XR)$$vln^
zf?H*5%HM<AWHqK{(kkmQgL`&hGij4SyU{AkjrlFOO}02n71Am@R|520vyJaS)Y1lQ
zX%`jxhv=yb+gq0<TH7P5Of3!Qku{|HhX5KvdSt)NNe#)DZ(r>U?vZ&lV?$bHZ<YQQ
z+{G=7ogY#t_c)e^ba5~y0?O);L-ZQItszzNYy5VGScMKhu-~pM+#O;SY$cwM7Up@w
z;SeVg*PjZZGX0znL#S+nR8OrOwqt@V>eCRwuR^MX-%aO3Ud0+mWq!+{Y_F;g*K6q`
znX!79c}vyTFi(xJ>pkSP@JV_q+h~}kw{qty-;(Tn`l1rOo%1*<^e(hT?eu!7R&VFD
zF`ERh5HqJiUxd9|5%zAgD2#MYV2wV3HQI*xexi4#6o0j24DIx}m0R_8nv(IL-pb8g
z@6lViW0&nDRl?l$PwJiWP3sQo58*8FA)F;XL=u-B(VwOs$NT!zly`LN&!GDZg;~cl
z6lNU{5wN{&*lu()d&_^<yX6LZJv~EVHbX^rtbbCWBG6`fh00RU!@3gAKxMIG42D8x
z!kh?$Tkdg08K|snezJkeY8Pf0wDkBin8Aw_?FNthmH;>P$gyS#m6zuk+T|X{L_@oL
zOm&IjsC+{JCEeVy`YR0GTy6aoh7S4truBw)`BKM5#On?1a<G5e<zN?e$tO>{$pE;=
z&?WacUNv;d$5ela_=TZM-lm8mU2-zbYXJP!&?P@Vg$?bJpEWB&yX0eIw4q({=%pc{
zUGghe0?(aGp|4z80KM?if}Ny_T}*b8F1gk6tHDLIOJhTwWUV?jv`hX$Tykia{GBE5
zl1N%zmk|o{oTEeAAT6O@xyLahv{MfG)q~h2UodTMD8z74D8y}1C>48W%VB2Nf-}Pw
zoEf&@%rF&gGp`60MI6P89!G7cSFWqB5B18UH$)MyT&k`Q)rwyxT^p(u4Jq|hD?X;G
zr(St&%JrdIu`;Kb06)0*mfsxel^>Bs5h$g%gu=Yg2W+I+F=|(+lX*1pk<fT?Qr@$n
zFcy0e@mQ#<clAd|A8{hIN_c^eklN(B>i0vf9E>&E<hGfgg+dI!3AKtIM^C6$WNl2C
zR+J_(VMhhUI(b;Us8xZ?4|Liv7fBcy8s;K<$EJsY-$`NMw>Yeo2<zsAIf;LHMOZ0`
zUA!y|La9ccwa8N+c2qcNb%lB4d$n#FFCJO^Y-qdu=Y*TW+T{yNu9Lj-^ULdLoBXKm
z*06Rt)Cek0%eyDcf|h)t=yBW^R*ZV~$~UFdQ<yK>6XumaweYbpuYB#ggZeJ{ymbfl
zF7_r}TNvQWVQ1-)kPpME<h%Vo537>HTw=a>I{T}zDgj1ME}}?mCi!Bj)Dz|;sS*tb
ztO&~&W5&zE0RzLE=muSM_)$T3c~W@1cxzHtcnjGalpF3Mn}Z6%!DgEh-Xy??$tnJB
zstk9D9>*2oO*o#)mmRBb2+x<*);ENMHm(mZlz~lHDC^h!pTb?@O%d*Jr|5Cq9S&N$
zKfFowI35Wv6z7e9D!fqKx$wpCcDcK}nG}kz#2wTZif3295?(0U^4|=1iV%uRd^qX-
za4P%C@RI5%*<1d%aIbK>pgSB|*K^^}x^fZFx&}mOg>x&8sl3AW$>s<x_JdlPHz*|n
zFgwC4{8W&K?y-oIBeb%Q!e>NiWovWhMZl`WkFsvYQdJq@Wlr&R5niUb<WCV=p*`>J
zh#r~Ve^-Q8z!EO=2JMT`$^yn@M`&d*qp}9)EwwUjP87*!N3VMZLq8NzO%ASj1tpIX
zVYdG;>t${&c_%_EL$?qf`F@03bVh#?;Ue>*!EzQxH50d36Kzqru{Np55zSc)>wJV;
zzSdwc93o)<0PYEBA>ZhGB3vYABsEsCFY2kWg}kqq8LQaidW}(qoPc`*&iAg<(f87$
zjauqRk2W6V0@4zVt>Qy#YL%@RmRG1#<{E!NPOtEI%|X3aIGlc%<rt4+rm>Yg8oZwb
zGB8h-L;(Yt=f_=X<d~G2^+q?BQnT4;VT!8nHCk}}!oqwv?OtP8-`dLA;Qb_wNvYXu
z3}fPJo;RK)<3e6BhA|rp-Zq9YBa1&ahB2c?oi&Cr?@j>s9q10N`MWU*XIH?|qb3!}
zpD&n_80ZCT4D<pn(r>NBn7~@ARdkChWvM2wI9FyffqR6>%TzI=O<tyA%50NX*f-;t
z%F8eb3r$|;iISzJ9_G3wbtYI<sWW+*?TfB5L5|;OqHMo}?WQCOJy9Trn~UKVA!RI5
zicmjeQ8PuTnX#yuBGgP711(r3YNir3Q;C|XM$J^CPO4ESWen(~8g){QI;lpTRHII+
zQ76@?lQn&D0L`edmu$e8G+?+YoJ-t{A#TPHH)Dv~FvM*b;tr;$+H2Z@zq-kvrawY<
z;;%apMaA#MY^11wUw7ep;x0xA4~*Q!5T!YC7qer<Ws!P?$59x$ixHQ%Q@sMlAiJ0+
zm(PgY#gtr85xIwn9kVG?uh?6@B~nxrtYIT}F$K#P(anrlvpsS%6JOI38Ac(!o0*LT
z`yxBZxtPO|o0*ZtuSRO=N&82Uo0)efd>W~x4^IPkXwCM>R%S%JhA$>t;=hY5CQq;J
ziEQP*iYHOU<hm6jNHKXb2Joge-$mLL-3hWNy8`C2ipjfcwNd#B)pEO`mH9Fb)&V(O
z4K&AVc&M8>Of}B)SEH@i%8ZXPM8S&QODe#~C=U~+jE#a47^`n%jCHUk2<TygXWIBe
zMc@@SzJ@6eO^wpi6NPz*lcS0ihes@o>XDU)E<>z|f*!3t3iubAw1Q>&F_ni=C}Tl>
zY%^(NR+qbJ8|FwG^V4c@$0T1L)yDjuv@OcRq{TK94|8+mjwr40?h5dm7<p$@sUk6Q
zSJWC3)37JX!?Z;1kMc0}Vm<XRo5h1s6^gP|N1`eePeg+I<;XXpDiqu2@8c^J@6X-G
zhoR-Hr#Fv#C(0|{I_~4B3dLQDeY}U+8g-cUFe_s}i}El_$M@p7s8YqP=|4t!n8)<*
zl2*nZIfeHMJqE_SueZMAy6^!8)`bsX`8>dYg=QlUE;pEM<i_PUvUa*4DAH`FvH<wC
zcfD!l(sbgMgB|O{^5#@P33MuUs$$J9#op*tvrADo!ESC+Y%M7;yOE~}%AUDV;c@(G
zXjLRRXPDcN-iCgg6mRea<|f4qd4bt2SIsFmyX9+g4F<OytUjk=ovPC8QdHU2nq7)C
zzn%!E;{Bp}GvHRUOR-LMhgsx8OuNiYiU~51QyKx7JqoZX3GkXAzz;E$Rk8xJofb@a
z)a+%yU(#mwviAhNXtvWQtB;!9@_D%igPq<v_N3WP6Q*>V?ezYd@6C4lagagoq%j#k
zo1NI+!fuC`R7Vva2enktRY7u#msyt=Y^h;3<iSXA4<BoRb_q&OT>V&G1-(s_TMjWW
zV+O0enU)G#lvHGCVji8ikN1jSrO&o_#oy8wSdJ>L3W_v42liAfwK#EKgq@xVa8oyZ
zbkRDCTk&A}^%l3{v&iihJzZpp*21`ZhXv-A@3SPK{hWk*MUrr(qk=+xPr|jN4yJp-
zBbE*<1D%RbCq8ZIRNxG-VtV;@OPAuw{4#B~VygNDi&wER;bn_g0b@h2;;MwVEMCP8
z`R`f03K-}1C_Ii&EPCarG2dB4<+1voEuylv{%4DpOma@)Bb6qz$VVz4xD2o?fRBz>
zM$I~=idW7kJf@0NMvsu9VXa?^t|sF`!lGYgVEzFpY0*|?XIVkCRe91_7+tE&Tsl9x
zROuJAD!Nqpy>5MUq%ziK<Kva{8~A7~4Xe01T2I?8o1*pfDa)qlNTqfJ{5sZ;kFHRj
zNU`x%N{{2_=nCcAk+(%xDU}=QX_fLw$eV0Fvr=(iw4GTzvsP(mX3Q+pRw?srQKU+_
zd-Nk1t5=L*4?G!N!!)EGiLPPxmY;~$(yVcxMAtB9>}R8^lu#qu*@yFgigqfy6Lc~8
z%mhPNOgp>8WRA&amYA|);+4b?;u93|AkAl*60>63aaGra>kH0433GB_?fzZ=X41}n
zWUi<A%tz))G3{)<t=!zsj%Lcu`OHgeiesQfDvN1U)~%?HX=jxZ@PAXWA*NAT9kDSc
zpP6F1F{YheVQeP(jMI2~Oc;S#XxLFON^~o`>+X(mD}P^hR_0OG&7{PtFspV2hT&Rd
zK09mi{+L$o4XG`rmFtq)Vv5P^q;E)}_)AJUIl)|4eIwhZgqX(@ptzMgC%qig$~`Tm
zlhe$>74OBIhCLOcTdA)4Jf>BdweVa_r?RN}`<PB8mNfL+s$5?7bIchAW<Oe$pOz_O
z&-S@rDEm34RryV+GPYG&HYPOod>?)Dg3#Dj<>uhSY^RbEkm+$G#<nUaFHDbZRd!c3
zlP+aZbxv#-hSJp+$_vGLvA^_7PRs+&9FX%v8OXnNL1=8JGNyKFtXKJP{+w8^@|9)F
zW4+4cbv3c4ndH$MV?E@7loqCx{5hqWP}PHR`}i8>sZ6`RNBK@&O{}QuPH2qPsy?W@
zEmp7cICjNqRoDxwx)VIHdR2z4+<ck=J5#SxI-iY&cKfy<QT6BCmt#fMbDGXrQPo-o
zGV4-5j@8q;)OVsH#otGL7wcs9OTWa5Dnqa=E>hez$`Hq~uxCcadK_7CqH0{|m^e4r
zl3Aub&5R2vj02rJ;zZT$L1l5B%5O^RX&Af0e^Xo-?i&fjl4e0nVm*$QxG;3La6eCY
zI4+RQykdWx3tKZ6wl*$oXG&GKt{p*2RmYc)Aa>lVAgaoo2je2eXGXmhC#v=ao{p<f
zotpnyT!rdN9bi_<xws0|0>s;FKq*DskO{bO1<+re|3h4bs?i2mh`22Chd5ESd;ZUH
z6)JPevakwOA!5;rWnrQ!dV^oQU3F-cA>OXK%?7w|MO3_9m6ZaxASEikLRG2zA<m9*
zuw#6xRLtCjcv1EB-1PVw%#mEwMlNc@hH1}5v|-xEvfT+K@kOl1u`+%v(#Nu3WsODt
zS-sjr`^SRzj|HuoBKBO&#`qdl8?z<eu6klsJ+-SEZS}N<xp~~ju{L(`xSQi`tRel@
zcnb@A_LA65&O75R>^n|yPukE-lGuP$aO)b<Nu$c+xG%m8LoCA(-Ky;~9*cLYJdWq$
zD_PjF=2CeaZ^nx%kE1ibN9l2V72k@f^Qgemt43e#Dv#s0_)g{WvT}2W%H!Y@MAcua
zl?kHij8mT=s($c?@(Fh48WzS)qH5Es)C5s=ZD?MCT~(L@zAj5IH@C9;rO63Zs%f)}
z6GWA2#he7Ys%S;ISyaV^E=|y?E~~3f*n=&$UbSCZpU|cHG5OkrFdR?q!PZh#Et_;h
z!e-R`W=vND#&9!Y18QDW?asJ6p#gQ(fV$d-oZFB`RQ(wEc!FJJPANCrF_%TvuXRuk
zM}!<m5LMe&9ZAS%&(UWhL=~5JBEiYLyzZlf)6BNa^9egJbvxLsb=QhJSh}K~?qDI+
zUX{neCIYGwsTxB;>{fXkx<oCycVV1&VN7=R?h!)ViE-XT-pIX<(bG3_6B9-DMd7TB
zsxPa{N~G#1V@D@;tM*GpiQTHDs{wBcX(n3rTti8sRy}vp(nPJgN2*DzVNzDDPpo0W
zR~?Dg)3+=-?H<;vxh1h%b=_)+NlH~Z0Uf>)0kbHhM6YVUbblgMmn?la(X0B*A9xy8
z15avUI*Fv$k5GzQ^{R1CBx=<$OP)=P6h9yJuuQAAE_pdot6p3BY+}3`(h{$JY{_eh
z@#>cl?^^O&qE-Eupf?k(>Tk=viB|Q!i9(W9{fpC-WL2*Zj!CkrUr9(x+Q&i<xQ~U=
z5V*sl_pvx?R-d|jRFYPG&$5yvC<(6^53sOLQmY<2cX`qw*tx`juODTvve5gy%0gPS
z>Q#Q%CTZ1)6PuE>>XeBsNm{i$cz=>sZC~<Cl2(0ZMthQ0tqp!PNvqDuNhezMZvST!
zwd%+H!PoVr>4d6dlIkhw`ToQj=6v0Wq!Sp*3HIQMFOxb|9>*_9R1N(pRWDBfUBQm5
z2KJ!}d2%V{Zv|?jLLGQznYKbbI{YS02g8oE@%hZ<;hN+QCIjiW7L;kLkiS%IumvZ#
za+Ok<wnp8HAfZORG}}#U)Ss)%w8dmMj&7>gd>7fu=_ZwF^O<kgL?pYA)1^*aACv4-
z(}^+3RVWSi*1k!#7|)$p{&!;eKaHjCbnlKYj5(y`UDBaCrdgWM${y2LlS|c>i8;wt
zh@Gkj>++I&l%Fr2kQ|093r*_3FT6Y%cEe6pxYZuV70GUO&&>K{x0-isOm?fm!UszR
zdYp#TccRX)U@_|H18e`1>{j2fvNhSQu3wqJG^vl2JeJ&~z9Icka+7+l;k9I#=ZCS<
z-z_j!`nzRvl%9TNnH=R6J2sq7203d30dGkJX&)z_#Z;Wd6g8>8T`Q#YD38n!ND<kG
zR@}rlsn@Q0DY!)qZPzbY<9<QT^XTiB-X2OlJ2P24kM*ua?H=)xN=pxnv!=AD?+mQh
ztsw`-jYw%xTM7@eE$SnyABk>JLyb6(`aF;N<Zx#fhx-kBl<(9}NwEqU33F0Z9Q3DW
zS=i-umWA2Tvn<Sxo@HTn^ehXrqi0#Lhypq2wF5cajj6t3t~14|)-Sm=rAPVg{J*Az
zabUjz#*#1&Z0sK8g4D-T01u{E@Yg0aTX-U+Ree>$2Pv)UYVmA}M}2O^Sy`L<o3x&k
zFb-zU!#J2Z597cxZ&yE*a8_pFAZ`{8;?Sei%DB`XWz1@IYKPk62ubZx8fDESiGw=T
zse)3}qVzbDQ@e0H)um94v88rm>Frd%H8(f4Q$5dYi0@Qy3Llr+r7riMlG>$yENnq)
z7nV<3uYS}gQbv$2b(?)kDwQ72ccyl!)0b{d?NlF~duwW^dWN~4x|Oq*-;vs)+@7;L
zwMRK)+1}J1<@<}(sXfZBsC}vJs&@a^g(ME<McdSy);^sY$tCB$klM}MIxdTJsQ1k}
zmfE4_9mi8U)Z24TrFN)|YwKx`@`~lBQ`=Q+?CV00@^wu*X;sCUn@PR|am$y`mQz)a
z`&(+hbcFnv>QOzrBApaV8Rp+pJ*tOe`81DeRRT~d0|8xu&BUVuzr|AH40T$uw0(vl
ztyBUn^(fc*r;|4It)Ve#oyr%=%FR8>gLT%l9%cK4dRifQ9Jy%~(!*)*k_zca+V|!P
z>GZ-VQX%~`8gS%_r3pRCob?maDx_=UW~Eg~-;M@fCl&%epLS4RC3zgJ$vw*8jIy*I
z<r}rj(t6M$ty29x{OMFZ&8VqK>ruM=*QfO;A6hn>?NLUo*p$|zyw(4vv>xTNwRflG
zaxenwQPw!0NNZ9bUiea4g>-)!q-cIZJq64nZR&5FpQnkc(7bQcL{(xQXKhoToDgj7
zRF;itCdF!xBi?G4JdR9jr}ERXdfKM8Z78tTNFK*TE2Oc+>XbZ=`PL#1>Rl1mk+E0?
ziV(+gP~$q4n-?^bE_HN8z11!KwRWr3E<x*Iml8wLNsV-ETokF1)N4R9>NTK^H*$4}
z6;e=9Iw@8|`&_KntcoIbDYppt-$*;CuaV9ytfw{7U-ALJS_r>BAl+iMOD89S<c8Fb
zqwLbUy82|h<gNvZYuWF5r}XvmbmElGt&Ad0>9h@eEnA;X?9zwG)3xdjt6f?#`u;?_
z^iJBnR=X6h+i$f?g==51wyAB)j#+16eRoR7G+kDw1eSnHdMn=$?~?Yc0?e}k&NF{&
zbx9{p;EvJ%Vs%MJ3x#x-ls9Qys!Ou3HN@McX?{|=U8-LhobHqsj1EsP<DmB`<G|*r
z#8$#7O&^`WIHgx@P`0y1ConzA@UUA`dz2Yrx2CqKGs1Gx+a-@<RC<@18M7c=OE=^l
zX4|EG<xA2#klrEj4se6EJEZ!R)#)zjWmx-`UdUaY?vg_F+tOXq40Ch3OZw|7pu;G`
zB|TSoTe?e1o77BP(kmvQ#ILQVU6RMKGrd#tI6Uc{(w9kX>0Q!+^uuhI^kq^4qoucG
zPvE<yjD+XYyQTXJpHGj+{b}*S^sJZD<Asc@*V8+t<!kF{w{*&JB0XL(WR(U~(%SmZ
z(yO`JdXmv29XI%Atl{>S$7NLFjs+@t9BCO;TAeW}qf32k(S(dn^}6t8B5FL2Jpm0^
z#x^5vL)_83-%lf7vNB^EwtL$+$fIo>w8=a1*PWax^_q-r9FzgOR8q4!qfPyx>CYLF
znkN?Do)M|JD&fA2NR5JcG9ooh{u3Ep>T7GC%V?LT<-L*7E;XcP5m9qZ-l+^xvo!s~
zj0R2}`dLN;hSGqc?7~oXVJHn4im0jD@GcQG_avOkh}ZnS{>O|i>Def`txK91p|#~}
zni7I-cFpw(;WoP_uiRp@Ydns4n^p5@l+|X{?2fw3X4lxt%gt5|ocOS6iYC=lQ3G`i
zDEY__IJSJE&92cGo|V}(pUS4$>>8=?CSKHdgJ#=A%~aW`jAG59@Flh`>8gZvwk~P+
z2$yX$YH2gZe>28^55|8F#(#5P{Ig}JGIk*64&>Z{ocoY-A9C(M&PdJDC2z%bNs3u_
z*g%t@&mUs`YKzo7o&1okg?oSG<2E~!XP-#&nPBM|TaENYS~Jw>+;mbQrK~77Yt_1d
z7j1TF+cL<V#R&<FU0UGxvdu1?RG+ljr4Q$QYO_m<kox2%^~$wx#n~n2XqwrjJ`twK
zEY<Yo{;GP~r8ed0GP~5<^`V(I?#rYb*$PcTa&#t~rqN{{;J~Upz(FtHrT!p4GgH*u
z9+aOcYM^ftHRl&k%@j3n&nV5@#*NK@J^Z0TP{y$JK+QY*!g4RG%yer0MqHT<+_N?)
z1Hj+V$9YV+DRUdroto=q?##{T-i$n(`*=R#@5|hQ^c_gwfpm(!43%`tpv41sG1_l6
z(kF{RSBu9%I|ewG11n`L2Uf}<Y=IA9zPyU=cGZ0Bt?Z@gq?KK8#fzC>`yI{fQvVWm
zJhNLpa@jkXUFt9LKg{e>=jVKu*`;pLpUt#0Q|zB*+L_PtZjZ@l9x{BN=~gaJ_$9Li
z=a+hVXPH!B7569)hC#0i6wd&@OGI=Bq6HO*7Ssuh&k2m19)EQ!qn4?%TpEufB+I2a
zlJULSt=wO0%yMZKS(}MVqh59_)unkR<DkA#^L$E5R+nU{vS)>%wbs?!YH2i?QN*QL
zZGD%xG{4%wuBfgZm*vvTt(~6b#yoOq7S)zyxixR(&d+jdO6Nxrx2AS}6lu|nl%BD<
zHODkdv)r1`%hQQl^GileR+|#%qf~&0xVy-0(l!>5Lw6avPoVoWx+~e(fM!z3!Yp?e
z{Uq?S%(2{tyk^qD2v?SAJD7E{nB-DbW8BSI`E28a9f-GQ9mTk{X*`a5v)VKzW##5J
z&6cuqvxP03^<Y*Kdy})Cp5<VU<tzuScM^NX`BGM+>ar`2XPw8M{VZ3%@}sQt9Gtp3
z%Yi=g*$-0Qq;?i!-oQc}8rb<#J&ng*=%wlnd1te#5YOYUHpD>0oru3+9)Y!)PAq+H
zT=B>HZsBmnp97n=N)=koXTvV#FLfLb@lo;6Ge(NK(NWo*nw*Hl>`u)_ZBBLz_g=~P
z>@JO^YI1hBrnS16c$r-#^RnSgQ=Q2rdrnxM?Pb<3x-z?kE6CfB9f;DrO!R!1$G#))
z=Im~b$MNUvZq1Lm?(A;O-U$W+NVpSy?alTo=cKk}cPb-l(__8L8MOzqy&5*9BfCra
zPE|9Blst})vLmIyg<oZNDIY5~7`l{CBm&-LJ)a#ZwHSWNj+72rRXJM8;|RzJ<G~V+
zl)xg5l-^%#&WV)3A`Rog7S&2%d1@uzk&>g8nkLzDBBd*qUzXD(c^m~fU1%eLbySkm
zrF<y|<`Tj3>Ct!`i*tH3?=3x@+=P8`la%S7PMW0cQ=>?eR8j=)6~Tb!BKY;P;1xMN
zny;6y&2dVvmjlo4*;nN_rT5CO%jwZf&H<T;h~t-S%jwbFReF0)kESZ%p`0Gg>$4*a
zJ(|FIfN!p<r%h7+lE-qIq?>};a+;*n)R%Iar0*xbn$sl32fvlmqq!sN-JB-rK>kNL
zPRV7R%{EB~{U9b_nKVhym4~NCN-#zc{jN&*B1iPwvE+vw(Qob&&TiMdn3*ivHB03C
zc)P|ahaTrG**?BUQ(5k3@6jyNLRz4`vf-%Nf_vj5u{Dd7phdD_`GnTnZ0}O<&rP<A
z8u+yV%kyT$ZHPM%^<*YVXQnbG%vH?&%tUrRyN=z--p{_xo@2Lgw{xesV8JH5C3t1K
z<e}mg@gZ@%;t|D5iVEdPWr^xx)r(TH<`K=4nrgqt{2bbHZD@cwU|hgo0^SV>3(N^D
z3+xHp7Zk3u>8{jm)@=#CHbkwzPXCtvd;QyCVa9RBBI5$%65}n#oko9Cm}!UU4%05v
zL#D?~Pn+6JFPq*lb(*?N-KL*Sib!Xq((G?evcyI|A9Esxiw%sm#7>Ac$0fzp#BGSX
zDef<E`SBCur^PRgcg8;ye=Poo_?U$9gxeDKB>a*Po@hzDIWZ?`QPSF^hNLq|3CVv-
zKA&t(Nk|!=vLvN8Wlzd$DVEfl)Q8g+S*xw@SYy-E(tFY)GiGFzW|U_v&8W-pW;EJ%
z*pf0mnNMf3S#?>PvYyF0mDQ7_&JNDLKHHEJhUdVC{@K(QQuN~h6+RT6yaJb9_1$~b
z|F>-FaN5b_;WT9|pq2c8?Y(VmB-fcPcB-1yUENJ~R~1c*6SK#ys}=4}b~RTs`mhB{
zLV7qHsaL}xhvbYbFN9G|cac+fnpHhj)x)9T#T_=;<P{c**GLA2e+U=KUg5$D{6k3e
zL&z$Du@C}dVO$7~urL<77y2PU0-^u{q8N+7NbtPxIaSppN8UxexB(J<be;D-r%s*E
z_xl{aCAP&|Vpm+%?umPvt6kMP+EvZdu4>!bZzg`Iy(NC3UDf_ZyQ+PlUDbX?|KHQT
z)ZP*W{Vmbb-x5F5?`d!ApO${8-P3l(J?-!Gx5P*KTS6<K-nYa*FZ|o`FAFbJ|9#=p
z(qj{E2~WGH{pG|x?UwPD_@9gqte+bnSbuH2CH}qfp#6dIsQoKr!TwvLZ+~Lk(_Sdv
z)3%FGPXDXoE7QBhC#Ofn*QU3Ne>45BivQd6Zt-uXN5#`$`)`ZCnYd-#)1D~Je*LM^
zRjpmRs=ZLUsx6kTYD=Y0OD~qLYS&8lG`Dn5>y)l)8zu38Upn!?&60Q^EX5D}o6>{!
z8>L6>zbrjy|GUydvp*}X&HhSzOZ;`|p7tx_x3hn1eC@<XrK{S1EM3*!Gw*4CZGKw%
z#Q4p`R(WmqhuT%`)$*sMAC<3a|5X|JSG70GSGC6`zW&XR%Kx_f*hK4_zbRvEJ}r6L
zr=>rtT-6?{T-BbcT-AP4ZhiBITI-vhhB9x7-&C$@e_#2{#Q$0O?mzp>(r+fT>e}pM
z6Zf<~uO2+~=hYuS^yk%2OMhOyr~MDrtJ-_jtJ?ouy{i39^}-)`+J!&(W%a7|LG`Nk
ztLjzllj@`PcP1aSpP78n{?o~;+N+cIw9?c)?LU_8X%9`^(@stOX5!S;!9#DB|LPA<
zO?_H=v;1l4y{UWJtCN5Ahd<Q*>JL9EVLpHS(3|CZ+P7-=wC~jJX>XPf9{N`8;Gt`^
zds<w(rwwZNw5{4b?TymjAAM5Y`=e7+t#9s%gNI(7Jb37b+QCB~*Y0WU`aSJWC+}(h
zri60)k9<<ye`E=``aSLC`aSJheg6@+zW<0{NBgd74_Kd;{)P3Hc(Xh>^XlZ_%n!A}
znLoAv!`YYZ|8TZr|7PMt`_s~|?H@n%clM7T`pEwALm%2de(2ZsUp)SI_Fp{yq5T(+
zx1D=h+xfKAc7FU&+xd&fADbAQd2Hg#C!Z*ZZ=IU@i^u<T`kwYHt@TZJ`kwYT+CA;o
z^gS(}Mjuh`(~=P4>G@t5c+dWUSPr+&JSv`U2Y%waJ^%aOv)8X(JM-wH*B%v5Uug%)
zV`taG^Im5)i7tfE3qiOQtZur!-lf6jbuW5$<Jz_P$a52~6?Es_&JB<6n)|^M^!{^R
z@|+iVk>6R{?tACGbst{|19}amWp0)uU(8yw){D;#Iyb!}ZUx=7$lu)bgAHop85CRy
z;z8uC-f$zYdogsoUKe>!P~N$L-y`s`vj8u;ancUD-kqiOt8Q=Lp-E`Ss=wK7Z}xjX
zc<M3P=I7n`#(dbN+#L8~7~S-uADnpt#WuX;+N!@1xXB=*f*0NIZ}U*3=pUS=qR)1&
zT|4i`{hqr$-*e;mF~ZJ=oBaWe+m(LTO}ut+JM6d^g9|-(BSw|&_`Dyxy<WKGb<b_D
zc<X5L51x8bHgh!@TyL*m@;vmKo0><-=05%{6mRu<sNK5~`03DgTT$e0<4u)&$=f2F
zeDz!3I<EO=zb(Ii!S8t&y<j7`A-|p>=0o(J3a&-l7s6=MO|Y1rd>lm&p;mk0mMr|7
zmn??eK~D`m1F9!n-;F5TYOkLk^m{(qybvVO_9b`Ii!s%YidGzZo7a237hhYr)A4#M
zp4;`J(`eCmuALE2Kf8VHT07|Zfk$0^?3FX(s@F-v=*h>^<k=^lOw(u1e*2X(;=&;4
zymCgo=(#snymc?~f{ypf8L{YL7qo-*ke2f+XT+sJujgLxA=zFC2Af_aA-wwB{PS+m
zCGdP0B$vDmHv!O!w}Z~bu;cb#IU{&6Q{$Gy5Eyh}Dd=sl_T2!bJ6I*JoDo<;Zsf-V
ztajX<8{xCOHD5U+F8Xmon}DF_qHqgsx#TAPZSUM*eVx#&?z+dVT6ClMhTH2Ax=jsO
z4Ws0Fuh-`ac(WeOkh`iCY_E9npqDJVeVM^6%)gz(WX;bZ+Y7e_ZqHA)kG^_L&eHXN
z>2;E0GSt{7VU*4!I_tSn=LT*6_?0sPJA2hjFs9TgZ)4L70Mg1?z2SKY#t<(iQ5bBT
z3-2Ivv!86!3%R*j^fto?h_>n|76dI$AmbNr_=&gLcRSuiH}M0YWTMr*?e_i0&Wabj
zDDZlZofYjM@uI-(oqo{|9y=>mx8uayJl(#Mtk2(Yqo*Z|^s}eu-8fkbnNW*#V=*{J
z0ngrVXYhLX&b70=$j_!TMJxKOm=A+4(Pp=YHM~aa`K*}tA`D+5K_;n#J^}d!n_E?9
zd6>sAFL>MZ>ay!ofw<%Q=-JpzofYl#KCOB;+J5D%xEOAn743LA+&a|B$G*Cg%NyZZ
z<obaZedpR^`6fRmmfa}!&bx_s=BY;?7ohI#I0Y4f5UqaS3%VD2p_@GUxZrV5(VSMZ
zH6I4Iy(sao_q@|<A?KmmHNSInJ{%A{*7nEqZI`tyNB(U$@rZg|^sj&C+T;0FKQ5LB
zm}+msi@5Uh?snV`7Q-O9@z|43q^PwpMg8t?9Hp91h_%QK;!fE0*1{{v`k5!ii+<M&
zXtERrLviLwan4Ut8hW%zPabX3lmEyjspa~lxDvQMe<Sd^G@L25<~6hyKJVShaQN(%
zwF}=Cyg!~B_}w(~O0xd#Lp}Vqc+N{!+%1-7&bx`*iqXMui>D=j5>LxULUiyzHi&nh
z_Y&9d#m|ZhZk#NKz20;4*p;-pXj7i2rd*tFpBL@UfM~u4?zI*YPL*A_<93qsYB5~`
zE%Q6^X-V79xv@7+2HNo@_fop{mc;VP()_~e>e9-!OIH@pEvyJ)o9Enad(++UFrIx9
zHNxom6|r!2;nLc*3+;<*3oF;oFRae5w3pYGR>bPU{FRmV+Dq43Yild*b63_DR%O}t
zr3*{f<}bEZR|U&F?I2FvpyMsAugT4$7$Go_4F<j5vYXsMUtbi5*Vt*9UhUlQHeIR#
z1&Oh&g|hpY2GQzv>B*m6j>5hdCEH8U1>fs&&U0RJ96B9sf{2RcDw-ekAhD?m^5DuK
zNc>H2eh??&W-Cb||N0=|EUqwHBu7>ahTU_!R4%Rih8qMPgIE118MwU_FAjSHT0c~1
zp1BF+3PRA5xZw8^FCth{&>Uth+QtyBcpHA4MBBNX=e*=-KVS5d8|~n>8~JX)+002H
zbFH{rgrP|QZ|?QH4$-l-UQ7g>+u$WP!Y++tYjDT!`EJA+auKe0>-1h2oL=-2x65q_
zz>~ccfp08F;cdU`MMp|4-1dTGtmwjRw>O}Dwwkz|o9De=_Ps+iL%bOI_)r|X8y?S^
zSP8f2YU}&0zVG(p>uS2Wdzb;p)R2Nj;BB4W^sjdWlc4#qH`okT`(B6Vrxi;=woN#>
z3%oe-y32#>J->sg;C+(#)Cq~^k~v^L38OJYJH8Yq5?0$@PD>cXrzOLN2pG(Jz22I;
zp-_<bA?tQ|A+CZ-sXE615<z)EuXv;nFu+MAkubF4K`BvhvT7H11U^j(!gqNeMUfX^
zKX$x04x@Hg&Z8G3?XFnyHpAQA1wV?DR<zMxU-5cw;&mb5-u9F2c2|(b;jeE$@3|;W
zKQS~7(Ejgx5qFD6jlU%^nFcwIzY@?xEmEHB)9nCTHYO4aeUN#>)Auix^0=qhp8eys
zXHP@-{5@5A=IpogmC|6Ut$HaW+yy`AE`*&fwtcJH6-TvTaYz{ytZSqozp-#9@q(_`
zU5>nU|4y3Oju+iK=e>S%13QIK&v^;v8EUY4NwniE$r`}9aF7RAy;};i7HyyRz+O>9
zS6qm~%|$nGH@vQx5Bu9|p@NWeCD@eET9~EfI!zMDrCo8}>-o3A3KIe^xlt5uktnhj
zk_2!~jqJM59grhV{kY+EZsOZa6eYA4ZA+;Qtx(v1Fb~dNUklaCX!N;WNNL(cGM!55
zP}{t&fNZi5bi%G5Y^-{OYR3x!sH^Jv`R%~ngaU;@-0b_v0i{^#dx0EA`cf(uiFSOL
zX~E7y87jr3Z0WWa^`Nw&8Zt}Jp5$rF@_5ml3pc^w7;{80JB{J(GDYMhSxRVW3am|;
z#L6Y9dAaBMfkeu6?6Y#}b;UVv!w*)IP`-gaDu~Sh^Sv;Z;~<kfSQ6k0FNKMOmGQuj
z`?<m?D6`k1K>*W2y5^*LM6H*+dV`e$QD@DIHvNDKwPOf6D`7})NCI{xxHTXIHz_xn
ztAl<&jIysCo7Ik6{eEwoO+|;_V7lRdpE={9%tbHpqFhBOT|AN{xx%qU$4f1{Sj2Ld
zAI?-vFP$RDg}oj%ZpFJb;7mD9$L2{bi}pvN7Sp^JB$3-Y??=?z?F;^$Y&5;N6Z!ol
zjN+`(T|t|0%;KfmM0z=-6;Rfm-xaOMQ^{3W{9q4h#R|oZO$($Jlka&^xD+k=!604=
zy!Kdms2Czv2_@Gv5YmGzW?ru=*1S6^6>XDB$P6vq+;ju3M5R}~psUj7LzP+z=EER~
zAQD6wj<~D>c}&G~^Dp>8SAd;T0xIsBzv&Us>UNbd2J;Ew)cPfWMZ)9)h&pLFi=iZI
z{m4tOB5sE_y=yExQE8csvn1_bxyB_5BI+1|$6LxU64&Z>Ws1L&y*ux+rjcP_IZT1o
z6j=2lS_ib;o*TFkQ=}Keh{-1<u(`ooSG*3uR<|ozj6|rJT=k*&NhHhLhp4U0BN`^t
zm%KX(Hue?(-bryxK&#t*!P`#pi}+?M*j6~KEu~@6fUmn9Pm!k%bcn;)44%Jn6IP-O
zk+(*PcKqGV9w!%qZVb&}*^B(JyA(0@yq9>Lge<HCgF{4K9DCi>p07S98^>F2-VMgJ
z!c_Sf8=o{67BD=Y^O97*NUf~EUJ3)y*kwN;jyRTg6geMmwzk~J8#C6D0FVM?O_yob
zIopAPiC=|-sN>PHl}Xmf&TS{2L_pdlTa1KT-7al72{Jd7B1b+WHSFe*_$F}~aNEf5
zGUh_$c_{*f?Mm!LV<nVKMlDT&L$Z!U<<pnKV8so(;U<Wp@^2s`O)vH7aV7BYz^uPW
z`MvOZx_=0>>PfkJA&SC?P%P#tsR^X*^p(IT99q28@2K|5WUJeiDH;)(PVF(QhF~bf
zYA5V_Ym@>JxfpJF(Ul-}*Qx0XY=)5tCO)M7N$SJt=e&d}M8_4b)$Ojh!3I9M4T9kZ
z8$C~Am|xH<AevsZG)R`#$1+ovl*`IY;%$ud25%b|B6sIT{^eyC;$nEwjWQfdL&T%f
zEMf?de3`lAOtd1WT`^+ZBd0W4ntwv%bR&Xc@M4=q_62T39xI(&NAN^!ArUi3${XzN
z@+~(`vRd0Q?YxWrO}WCusN)@BAX(PJrk_Y$CQ*{jL9BSmAd-S3V~BHdvK8md6WqcK
z#9HE%Bui)>Bi14q=);W-KiHtv$b6nNc}uH;SSe)DTL^CZQ5azDU4@n=zjz#)_@}gs
z(W*>=ahsW7$zQCw8;~(GKN9TVkX0#-5n*I}&QG@d*n=a44DyoQlYq)%6xWwuUvds%
zJB1C?9mKHlh;|H99mxF(*gPbCTDoKb%Ji1=;UF6a2|yx{NibpQ>>_$|NX@tqMyuOF
zM;4&zhWsO8xnKb<KGDJRs7#g^FEfsV8SVBsE)&)$30jt~l8m`I1Qyu%7jl@iBl%MN
z%^c=3<dLxwJ<p95M2bjO-<6>2MZIl5*x;HEe@Vi;G_uTG+n|8R3}}Kfc^)(-3I{RK
zbnbqd!v0s~Jgk#+p$pavb4#B_O_>#Q14T}-w1;jN11rAUi?LR)ZV2Z6MM<e#kkFJH
z`dnuuf`;!tnPfIdvt){>RkAI26sOpC!)eIcOgymqCC*Dg^svfPV>53^B%bpm7gA7W
zre{Y&>_z9jb$8Iq=b+AGGw9=x{4iZ<CDIa0a67&Vy&;dfgk8qws|?9bu{<WTRVy%W
zXlHRu<*d0er<pih^lp2!&w2mJO|Pop*TW!Aq5(^PyeQF%e$P)1ef`{aI#zHxGelC2
zw22Zz$<AX)+ICyvMK4LbsJ*&G6p3B>;=H@f))vgX(p41EQQ*Rzz8iFxBc#drj|6#H
z{B;kDhZd+8rQo;)PUI!|r9sjOspp&5{Xi|-^Px;$LgGr`#T~cr38}P@SdvnYR1_Oy
zCJ<=}x#-?hQ7;6KsX8e}8qd8hVKDHd8K?O~8VO?NMWrOYRj**%QCe*~l`#(SE+VKE
zd8=?mrLD-QOlAS@cJt_QS_BYwF-l(wgE2cn8gwI$i^LhzWe#IAIIR>4uj>c7tW4x$
z_tr5lWks^g904EGveM6=_c}cntWx#x2x1}V^ul-yG1$x~``Gx6(R`jkSnSouvOHd-
zszyBFjKDrf3$KMYy?|Gh^pa#4UPTa*Qjn!I0*SyYT|X_b>_+Y;Y(jD{lsIxBWK1j0
zH-|JHmbn#rK8*4h)cL#{A1ZVRgq`dVYS|@&J$DRk22D|!>=OjQN;lcXvMxx^pDMue
zsuI4%f**Umi{7RmK~TLl!1J&-h}dJ!0hr?2oxx%B@p7KZVvUQ_%nvA1i0e};@nRU>
z9P|lEaV#+<Q#p&E7hRtdXl5(9=s~C+uZF<iw^xJItlzs^gKK5Wozxz}XnPqp1z?o)
z=TQtDvv(Cymx=OYC>q>&43z<gIQEscoWz_ObZquGKhN+vU(+};_0r^OxD*D@&9kEo
zgpuXqad@ep_@swFH=lRX9m%Gujw`_fLQrl?<gi$Zx%Xm)eBQfr_$`7-Pmj9rv9&jX
zF!JVs<<*%(D3T@x+)U<F2pTC8cv%pUcJ@>ZAZO1~3yfUa=GH<9vWP;-b_~TX@!=bn
zItCI;LC1Rzi4{*q0;UaOv6BWblIbkmP70;xy&i+`g~;UMpqKa^d?3qQ9Yj&c>C|=W
z-PeQsJ->gt9jwEPDMxh~gVpN{2(=vcIiZ3-;itl+<V9ua$j19Ul<Rqk$KGrj(93Wm
z@X*G$8OT|ZQsbIfj=e!QJY;fXiESL!4ze`Wl!53KOkPBkLm$Jt7E0F;S-L5cEk3Fo
z2NJa66>nXkB$c8UFNGX7M0qj;e1_nhS#F8mzD9gHjcds(h9IS<F$~8R$=vt3GH{!6
zN*a1d17-}_kzwXt-SQI|cqWUr`h6lW?am;dspt+vlGo+mON;Sal8~g>!|;l`Me?>A
zNSxwjX`Sc&+mg${@)cu5Z+qee&+E6~3q8ggr!;<A`hek_kx41|NGCivEj^jueqS!J
z%+?E3d=$k(OXq00BS`7HLf{6$pj_^q43;BE3S@u<4J5CoBWPvG&lB-XWfCh=WAzZT
zu3`lQ+*D{!ifDDaFn6zbF(BT798MfcoE$!QQlr+E>nDD&adBN_+WivpRtMKRaFZ;p
zi~0CAP~AI7yTO&%8<RZqqOasqm_@`WdFxWxO+l5<YdI^B!71_2GG(B>3Mzp_2k>Io
z>v@~7s%K;xqP({*u+Q*RD|W?OUy86Lfm}`S-b(J<kjG^4wXN{Hzu_k_s=$UP`JbZo
z0py~rrGS^!Lpxo3&+pTCBYic58xVS!+ik_?wj)_~AzY{RgeTx@o=lt@a0Z@~aec6k
zT|!YXZV(23$L+~*7`52JIS^hi7X9m;`7l`bH>k~F*z?>#A|xp}@4Fj87=vM+hAQU=
z8^`&(0U=8nyou2QA=mS=7Z4bagYe7wNh|J1I3EDO{Z@dqyArJe!%Q;}tr06bIkj%n
zCudkI=(6ZfYc$umoN(qvVSm+&Zu=cCKCL2hQS^5ly^xB<rt1fQ7Q318IOV^qgX<C_
z&5#U$bt_l8L^11F3ne%vCrg}CZD2A?OUV=u&7vFl>t3votAp#YeASQRteEub12G=x
zk;?#wSoLlpR9^M<Vn|=)V0VnJ3Ri+-%<bIZHL=hSJ2&KxzY_Sj2JlW?@~>a-d2F;H
z*B^Nj5p_=PJ&`h6Wf+op_#!!_$hW)cE&A~$;fO$YB1*@(^lB3JxA-mQZp3xOm7wo-
zZa(jC+z>0?4L81lPWrK|2h{hRcf-Byhl6N&5Yx-_Ty&Egd3zEM2A%Gp&&nh%)jLV#
z=CblIlPH?O43ixcNv&_W*K?r!z8at0J0LkZkSJHKjy%ktz-G-M<UY*3GL8XN*iO7u
zBZ4VC%R<1<eX^AOFZ&d>x)&%+d<2sUO{<9;<zHNM??^~_W(5`DWG=8;v{-<O+X0^h
zXhkerA_HyxT^Ub4eoO{;FwNi!j_3th=97=#C-Z1*7AvxSpExNcc!H2x9wg`7&P{}Y
zo_(%^9e16<WYvpfKMeS|jYKOWMv7pP5?xR*k;@z`^Px4k9pXxdiyoK7v_<lKjy_Fg
zlRQo`Qw653IksZ1_C2pls!+D~ufPS#IM%R^4C19w9;%{3<7e`&T?%u@@wmjef^#Wc
z^*VzH$73irjlYCZ1!l+iVu){(5%t`5i(<&I3c?O2*P?AiNieVw$ON2dY5tmfQv&R!
z3|2jl%EpiagYKVf_RsZhj<XJ_LeJkA1e}9YUf09$CcFsOQ=m=cHJ^7U1=u===mf<R
zLC!G+OA!K!-AFblzRktPv&fUT=*BmNTv(JQ!x|E?O0>FNdeW#-N=C>&&kk`K3ze4k
zTn1Ke`0L4vzi}hE7;Zou5$)`#m&k?iN(L;W3=|{-Hz))LF~z>yV`suDLZzUJ^7rJ5
zQC2PmjxDGAs;r7>A1y$i`l<q?l;#Q?_1hiJ%Dd*WyrXWrG*8;$vo?_7((h-OBj)ln
z=Qx!v&6Mg+zOdqSDeg}~KgbtQN@XsDJD+{ujP&5##sEYmPV*2yrb7KCO8RCnux>AZ
zbi~^Lf@i)%p5ETk(A4Zm-BO=Vzs1Th$LDkY_*h8Fzt5fy``4Z$>JhEoaD%0YKO?1(
zV{)W<o=-9G0^uFUXB>FC6u<(+ZLcTg2c(!1QIdUhuHTaZUJ=CED~Zo9wt77w?MFzi
zg^=tK(N9m<O2qkd&{{}_ql6NkkOtlO?j~2Yy1jWl?0tpp_S&T|jnc`@`)0qFkE2m=
z-iJ)MoWFwLaTB;KLJAP2$87O3R~lQ?CsJlXM}uV<YN9HkYy||L^EVa;J#o?B^b^Fb
z!SEM(?xv8YDG9BG$l}O3tU-x}7n!s&3BMS*{XD!Jg&UE(DbD-1SG-LD>E{})gT&jU
znWY4;EV1fsy8Rnr<gNC6E(=9MMR-QxCOQ(wFxJA+0K|QcJA!ueamTMJl^u$dm1Fjo
zB05OfO2SQXDeRNVv>ryAV?HPNY$Sq`G9Wz{f!+>;+$bWq75-715Y7AJW77Ezc+rbv
zsu;7w-2S4UBt35-==u_U6ic-D_`)ok9g9Bm<PkInaEzg8)AUt>gGT^L%~a)ZG@OF4
zFA0#*yAoQx>G#2X2YmwB+rwU`xD^vFXE%@-Wkbx0=Dweg#vXrnEJvy@N_QEvqpf)X
zpJ>F!^pY)4=8w76QcocPc|I>~E}X$jj??+@X2xXREdp6nqu7A7)@wbqGKuim>cn_p
zONvE55R0xKNd4_R4zf!90tb<#VnIoYgpz3pCo-8ow?t%;BibZ__asyck_90U@w9po
zrQ=+B)k{>8BzP&6kQ62TaNfE{Mo(o0L=F>44sN;>CjL6?_M9QDT4Ov^nNY@&t5^)!
zz6>52V;QU>3-kUOi(Hfk=#L&$LtT8H`a&4x(6q2KX$@zVbI=hFes-Hhj`<(TSoS+N
zm;Kve(h4wmNm_i-y+f-vUiP9agT-nx(2(IGAnYQ%U`NqJ-$3W-R1KL%j?0yYD~~C{
zij6uIkscNmN`T4Y9FOK<@gK!zm_wE*jxfQI?C!!HuR~`bvy(5-ljX3aELh^yav@0}
zD@R&z29hQ_o=f2+<0bN_!>0*hNEEoO1W(eSRNR~*@&X4J{K$)s$$$|KvagawD0p`e
zj4{2nFqP`00KXPu2yPAh+is6Y1sSZ=+EfQ&)<ShsKlO)*#cq~9;w=#?NtPZ9t{*F(
zL!I-3?pl~b<b>e$@Tj*@l_Bwn>g){0Y<iO5DSHl~^1(o|Ocpnz;vVGn7AYuQteg%v
z)rWHy0+O3J7FA)cT}#&?!Nd~i5(caS9>DZM52doCJcp1htc{`6`Ct_*6*4+I)F8dC
z+zlpPbmT)7%OCemzpCUp)z0O}>-gx~QUt9*-V$=5=O!>#CO78YK1pg~b<6F4m46Z^
zIyU<x$oiXJoB%k+6d3kN`3U=H5iGYC!?4d5UOaPwGS@Eg<tH4-ka-NQvB~sMcK*#)
zuze_3YP?4?q*4*lv3^z6p%{vsY=Lne^py-pMl+dzalN&UqZ$#*CG8+tipZ3<7QW=U
z5w7L%+&(3hSsH=VJs|Gq1x3SD4Bz<(ES3=5JW8`EO~ouJA1Gzr$3IGWhh6U1co)bx
zVysjdMNG*fG3QqT&={{P^MB`UPRE_tl{u0V=RTT2WQI|Jdg>%Pixxb{x#;=(txT!L
zQxejSOwPx*Wr_*Ma^ywQv*&eFTYyrYvP%INl=J?47~V{AZ4RqRVRf8hObg4*42RIk
z);Qw0RwY|$_Va`F^-VV*LzBFSC$)r-)~JxmH;Uz^a4b%bp;%H=kmB45R)kc+px(4B
zNa>SyPqFAl8+87kWg=Js+W{HH#B$_;{qX6_)b_xEkz`rpj6(;4ayfJ^^jx@^Ly=g0
zAsj@h*FTmwhO~k%DJ^TEEXro$wJpvj)-BD&_bG~Me|OoHaO<k?Z7Il$DNuq*13Ghk
zu(2_=dpIhCyf&C~V$wA27s3ca5giAk&60ztKn~_B8~BJXOn2)(Bbjk5hF!+M?8N8j
zDEOq`1M=LUcXKhkO|wLOIp;<ZGStC%aLAi-(?}6W3PgzCQJ7R>;QO=apbc~*VyaA>
zWsdY&@IegtVb$pX7T6=45IOTCqq5t3a_2^J$T8cp_^La2grtWw$O!$C<dj@-@ZwUL
z`1UHX)j{O;6!I{Sx$jA5nVmb>Br(T~g|h8PC=DRXau0nY%Sc1gGL#Gri85rX-$#e(
z1R(s(5)F%^Odd4|rx|&}u0*o*B?0CX3drJtDAZq8!l#19Z|_oA)hEhM2bFdL2WDTv
zm0seAZ$e$UrE-8<^@7-EO;cv39@`_u6|8&~v<_43*fBM(;qYBw<8L0xy^m3wmaa@H
zVN`;7aa5v|8GxyDL?Tvd4$TKKfeyJHAji)?UI?RB5GFUgNQ&JlAsE*lGqgHQI9?EU
z9>As-Wo`|HAb+t(;UBy(!~%9RxCnNX<Tp}$QTNW^!Y{grM51K?$|3ApIG(Q{xJ#sL
zt5BJ`j~ff6vPG<j^~(sr^WL2d;NyBKT!-dG9sG_cG&+OE)}u5MD>-?Uk@GIaJb<aI
z=zM9l$>uplVElX+J1#}Fg4kaR>0qG}dD5#!h(5r;a3RFkV_fbP22x_?J@3W|>yLCC
z5<=)<6bX_*GN>*(VAJaSAd16C9UTp~B-{=<y+PM&byy-hw6@fqNn{&v{YNCjEKu0%
z^;(_IU=x9ds4S-2rsQn}VI;1^UVJ`8P`khB_EsSQ$b#v)#tbR#?b+peUvVAH>D>K?
zPk%+R{0(qVuf5=H|M42Z&pvxvhSJMV-PePa-PZT?SC?4{x3c;USAR?q0S|zho$(yG
zy4n}zZAD=!+2v6X?sH%&Rw{~;WhrS3wm|G6#-@iU#c9lhINhPg;oH})v3_w>Uy%5(
zh{60FML^Ng+7Z@)(9VwUOB9SxE8coe_Z5p_;L8eCY?`{9A*E_L6kUzCoX`M_D<}%{
z<l}jaL_F`^0RntWjBBo<bv-_8lV=5&Z>fl{1lMsuO)kH*?9ssW!#8nCT6au**x0oa
z?5yXTb7C>yrHd-a@Dis1z=uHT?vq%oGMOYJ@1erdiW74n4W&3<ELVm{o{Hp>$KFrC
zZ_9fIVp8o=fK9?FNYQ7QzZA0;j>CK=maiFzDHsnL0j(&kB#I+*eb_7MZh`oB1g0Ie
z7Sg>pQJPQW6k>8X$WHgi_rG3_WTIFgCR3%ecsC_OWYSaC0I4;^>NIDD;21GFQ7*4B
z$>%)p#`$;MZtixMnD4`(RmCtLx{nnzmp5>wawGe(vsSg2POrky?QQrTjlDV#DtnS$
ztf<0?WWXgb>aLp*7T|4#g}>ELkWx!Ya#*0SFms^vGIaS!bgaaACCn&~YE0hQ)xmW-
zgB%~a-Sl*JKsOePekTg!a6LID4<^qeM{>Diq>84YV~oq4icI@@%$>o~wgyWW?;<+c
z$6d|N+{Mx^$Z0h)oKMjiUbY+O-JnYnS8n%><CM&j!?HEF6~|!*=L@(k=|;r}dcAHA
z=4x{Yv@8dzo8WS&R=0a-|8p;oAdeCXY#1qq=5ewcIg~tQ7RrbrDEn&Vt%Zr(J1ic`
zJ>qZN$lgK#ZG0o_<qF_BmQ)=Zt2KX;oiiw~Oh&`0QW%L0F(2PPf=eTr$&!HZ<0CnY
zQZ9zf;i-151Xz=mK>iY2x_?<F&-u8>7R!$Gq#P0PNIZ*)6;p3WF#Vq2fAVnzzRNbb
z8?lN;+F%p~2GADZR9=f=47=!X`dI}*^P8{|A##ckDrjsBDeVcZNW#kMkh`s1{Epkq
zQ{kJX`FuSf20Vf3^o%2O^cYe;;gnXBBH*{(@B;*vEv;wqHhJ<cZ$i3A{^7J+P<9YM
zL?|U$BSQ^EnhCQPq-Iaj-0d_cSJTq<e+h5%{cFn?I9g*qH-CK-pUcU<#iBXIkbwJL
zz`gAoy!f#eSp<m>X$s`MTD#$6U8*ou72ueWWl|k3@db7<$B@W0Ej=G8juD^(*db%2
zy*OuaW$uP}9_Weu_LbPX)Vn`>{%%h#3SS=S<KxXN)}~PfoMP#PVcZEB-S%>sF6k+}
z={N<O2S@%$Mh23mWISGLq}^qFj7{0J0om{xi$jEw?mvW6CKlOA$Q+WXS`Hzve}zwi
zJyoCu35SVrHAnO$Wz>e3GxAcG@Db@Wmvh7=EV)z9!(l>zV>S<kRGUh{^3smJ7o@L+
zxv9&Lsg+)#_~uq=o>oX=Y0`i>R`4(~Juk-|g{Ae>Ye)UaL2T&t?%)i%WaS}KK|Cp#
zqAwAYkoIg27Km^7{o}YD_*%x!&wJ}BLY=0`5RwHlLdB)BH!9BiTZpa5An6=Jd8kFE
z)i6xMjCIT7iv5+k7{)vhvA6`&HW~cW)x%bWSo)t+h=nIM?#1#VY*0^ykwzh9#8zln
zPSclgqMEc}h2i5(AX*BeY;Ou4x34LzQoj@|l`92ic1x^>I8AfB%b1**1qF!<2swe#
zkUE~r7z;BxCY)%z-g#-xqLP;eo2eNO3xeb9*N-U-N2xLvscow^K`Y4V!SR?Elmy7J
zSYH}uHung&e@Z|Z2`+|l+yjE{lOr7*9d32Ikga5xmggmk>vMWO#4#5pbxZ5(F>sf>
zt#O2s)6e+{7SOui>rrw!?9=mNxJ6G2_r8D>Z$c#|Q8;)CKx(5XANWQHLl(h&`g!k8
z_NGkHf`-RC>_XET^c3!*pY-4y%%Qm93bjfTMpPq}7-jIKq(CYNm#9Jp9TTPtkvRj_
zqHRSWGbC}w3{(Yp%Vqf7tvabwQBITBTjzywU0pea#ovjj$*qX*XNt#fF9)et<oS@f
znr4vg99gudn+zbON+u&=`156wIA*w&DYr<I7ZwR=9!MEZBHfU!gg88L_g3;dtaFMs
zo~E_fO60AG;Z`dF_lDTO054LKWLCVs=O$y98zbHUq$23Lk-Q*Oh2NmP^0EqG>8sdB
z5|)FZpqPB$5?XZoG9@pYVIaMOfk|2?QSqWUUj~r3_}B%b96F^gXeR+pqL#xL7i_^b
zAu)9Nos;vCkCW%Ulztq23Bes8fij2BT~UA*(Tp5=HSpKhrDa=*)ML2ZT_n<jEqlhd
z9<6$+Ysa1;mwz;ctUF#pr!{C&m9oM>&L~SuiBo6^B@mCzDOPBr4KGQz56id`DI<m$
zz_;Pp#i>Mu;iYMLnArb5W;nyi6x|uleZ0u@g3nEGGCLdUN=&OOuPM$IhG$iR@i>?&
zZ}Nh`tk6*`U*I8u%;riU4J=NKfQp^-lT8;Smm3e4M2xFUfx&ekBJ5v7IGo?%^uisP
z9`lkcMMP1_n2+btyZI4hpDqXja-nK@;g~c5dFMCEf<udiJ3jYcsuSafi1D`?GCVIX
zs4IsHFR4p5Xr+LPWf)$V3Q8jb&uyob4E!!r|I|+h@m`|9Q)Lpw>JmgSN>O6$)(#;Z
zKQw$9b`e(%QT(Y`@q$D;tkNY(j9uQLCM2hU8;l9~@BKy=J__M)(3yqb`^_xlwJ#AL
z83aCT+>7{2WGW|jZX&fKLdx@Qdl7BoL##B<Nu_m;qKr6ZS*BavZhIYn=OFT8z<k*^
zdyRvHKg)_R2W=4VWmtyoQ<_xJ3{Ct~#zrHRj{;3K+B7RwqEbv6A1W<{GAxQw{}i(;
z*U<0t1LG4s_5sQI)9$YJ!sN(JTB$~yVep6P=-^1#cT->Jauja%shUhykuDevY<58d
zL29on*1Q%H^gX{%PZ^UK@#Jwz8GAE)1`&;hP|9FCrXvTG#*q`1+UC{@>4666i^8}M
zYIxg&jUaRFN+^j!N)gpqy@6!@Y(RSxyMzc09l+-hJ)&!f>`5(#3Lph9pF?Ax&&?3H
z?OSOOhZKrbK}D!dW@%PXX1gZLF+pG1A8C*wvsp#z%B}RuSNV6)@+vRE7u+5~KmvT>
z$Z?sa0q<cv&wFtah1;v0a6sF*9rOnY`2{$Y9?4-4!B0?a^0x>dQf?VX8yJZ+cwD+l
za?v(u^`B7u0YR9?c4u&3d38R%t%N2f8}aS?9*u+o+3R^dl%YQvA>T#38K0Lx0zHvI
zX!11v#c(V80|+bOR_5|g<zf=AZu)%~1@K)e#TD@_1wIYqi+<2m81GgJv!Ns0N)h+F
zGZcS&QAyZH9=)<kp^xB>k0GHfx<QRjt>)_-zk_O<)?ZfpeRHL8kN;-O`S_eiuSEPF
zB>dcIkaO}%(uF(YcS$gOd~EB&9kJqVfEvBvZ7<vri|!pM7<4^Ou^7Z~d<b5PwrSVr
zP?!vyfy*jjg^A(s`F&2LHf(G!My+}f%UEb-%#lCGL2kb6k4j~8B8M!?A0J8?wJC`|
z|G^h=F1#b)4!`qNCfPf*v?;*~bmVS}`~N-BympbQ;GA;~$Hcc~kQv8Du&ad;hYXsz
zUUL2#pUPBP7~}YcCVn50%<VuzM3&MoWq-3#zP|c>hE(KH{?A;|Q5}})I`sC1h!1FN
zD|-qWdM@m4kDqHMOm-m~Ahi(*keW2>LxbxoiP=M1aap9*jk`!o|BG@G@GMBRU-pK{
zeTvL>dy1lKbyJ8u(J=J}vWiS2NKwm?*X1Zm=}V0%i~c?W{yJT6`*1LSPH@OY^0TQ3
zoB&=LgkHGO_F-zy9<kJImHoBHoKI0wNeSd;g02N-th`1oLtubq5|@HgLOSLp#7juM
zPdk;#`vsSxpEyRBlR1K~P)avUqou@)Ztv#dzgD7d!pUxS=Re{^DRSUphvTdsqmKR+
z(foCGIc$2rx&*UJtYpX1mtlg5L2DSJR+v0n)^|I8vdtV%0n8UtP`c81%2KQx%oHZ!
zV=D#OO+&N};E}_!Dq{1<QQ5Hr>i0dZu3rB~R1AXi$H%4rpH=%0IokVARBb!(RK>J%
zullin9dR7nxj$r^LsB$1M|u$OZI!<2MgBV7MX-SjL)gd!%9%e)zZ5Y_ovmg_s$eo_
zVSSw?>fUxfTM3VOK~f0ujSC_ak=PWjNW@j)iAco47oiA*D4h|f#iK$POClDc{-W?j
zAi5$HTY$?g5s8ktAw=npcv3trM14gJL?9C3i%sDPQJ<%}JuxqOA`;?ETLdB&iHO92
zN}w#h%ilXsX;-Y$ZzK{S9{Gp8u|Vw-4=sp0q9Z)f6Dz_KuIN&KP7BqJ?+EeF?^ouM
ztoJsT`_4b4+_KmZp;!}<aA|B%;yXh8i&e2rt@gyGI4zb%MCI|Gmut;M;fw1ifB7F*
z{vXiGE5Dx_4~>Zs;(z(O|NX}w{2xDC`q6)9X@B3m@rfu1p_xDUUq^rYKmNPz|FR+q
zTD@MV*9)dO<4oy};TRK5O*1P^T{CAKTbmYzrqCvunrTi5%`{6w%-9XhG=x4oJ3Aq?
zYPmS$Jghl}DFhPJq9ioSsN0ViO<~zj6aiVYMWJbR`w@l=LugKG)@W*4T`M$&ZZt*R
zeq^F4oR(>6n%%ZeiiwKmpx~TyxhV9xx;9r7sAA3(8d_GHGn*QxCWLT&v|BHWf_-<V
zVV*dFFPRO~zz63_qF`DIX_;lATlU?NWtyfa=ygrE+lJ6;^@1TZlYVFGg$be6W(`Xd
z_QFI{*w3J~P78VVGliy@ty)?^vrY=@q&QKiXa!RgsBb4qO<kK7(^{oj(DAhI-oyCS
z3Qb`eP0cdPMNuf1%T?3T^b_)RqacJ{6uMrsbVKM`tu`Sv9Y1q5z;m@Cel6W>>iV>>
zrnOR2v!=CaF(EW<uGXw-<x<Iz|DXx>-M4F#%?Wzici(B$OrhC#-?8t$Q*IUr+o+X=
zuG@Ftw(q`O6*|V`ZTxQt;oN<{)TEg<4EilLb*-+MMpM`3W=)|vcR#T2zFnGe?tZ8_
zMj4C8zWcUg)S9|B<J|qV=G=YVzWY(JscG`z-2E8EKgX;#HEmj;%4wmOgg!fG-~F<P
zN`E_tZqJow>>W*WjEc}^DLE}{QPS%6-M3AnQmNZJQ+3U1mQZQkP^e<Fpdr~TGG3ys
zrl4ld*gLjv@66~ZH#a+5Z|a(}bHbubduL`sXtT41(CXTWnkZ;yCCw=c&E9#qiWOEa
z3axDKJZ!2wLkN54VT_Au*2ce6#t815(x!z;PkU#kLQD4UhnTmfm==>lPir#E>6<kw
zpMof=RhtFfwCtTntcFo&idw0u*J{qrnTe*b3dI?F=LxNVdAFv8i7jF`v_g$0ui!kY
z6?7_bQdlPEjG@daOT${0h=xE`t1x5lENDjl*S`C<{!PkV)Q{%!Z=LcNv?~9aUz6~7
zMMtW5;69(kYQ;91)=!{U>a9}lH(#5?*DOs(=>_eisGk&tidHI$LakP-6-7a-nb=gd
zS`ABm=L-G4R1yWPF*iF`=CNp;6h%?cYc(B|0Oj?XjsbRdUcwgDYqf$9Tu<2)6K1Up
zGRg@JQ}E55TUMb~Y-*UMvY4ouCQX>oYGn{p{FKY3rl5iqOVjJr*fI!%R<55EM7?xL
zbB&s%(X`T}o)nX6&HyOtgZ1g`yf%vkIjdvE&eG=F`BAZn3@jTw^eJJO&d!f&rfE4l
zKf<W}6g$(>#7Qhod!f)2bH<|pOEb>S+nQq(g*GjmmeCZ>&O61XHj7=`)HKU}26Sq+
zgipWcwD4>>JMWc{=j^;!YzoWS`2}VF(rJOrUp9oMQ&slP2PZ{Qb6VCngf>^#th$Dj
zHb=jfVd;~WRv<Eqe@mh;XU)yc8BJ{tRcRU#i(gBs!o*XbD+$cgPiCv&6+55kwOYfd
zf$Z%(B4HEVxcfS_;4}LD{2NVEb9TP4?|x+3J74Pd&S&<{=d$?8W?8d$zLb!2_jOrN
zmLfX0^CfR@DpC+)&g7|`7UgEaw1--q$cJ<HgWA_cVYc>-a!JdmS6!=Xbuo@H1$Ggp
zzFE+Tmht{K#e_E7Fif*zX-J(ECOEP-TPtDdoD{V}MFYduO{NTn*(_)cPzGuuP}8C)
zbhBZYV9n0m*Lj)zJxyNSeq>5aGz{l5x@r$+FhIix%T2A}3?H_Kr@r1S&e+38G-vp5
z&9sN7?BSV)b6K}VQL~4qteS4&UwimOrKvZZ;R$>AL~Z6#ZK82fSToM>Dea^H${s%B
zJc=PBjLIp|(=oV3?@TrejcHY!fto#h!X7?T#>SwoIL!&5xv!iF@q<PlBWe$yAP#1j
z+=mnPumy%{87E9pu!pB~T`zHuj53DM!k8LDH%+tJENGVeD4Num7T}xC@Fi#XQe8~w
zRGl0G8mLo_Fmz}5GGS!~ZBR%tMpIxSz%fmG=sK2Ouuf_KPl}Tm1-)3Iobrq_^eJVF
zf;CM=h!6@(pArRUxQQlQ=Gk$E1KOAGQF@zxZ&kBW`lKi{Qov|xx@_xCsi`;SoXZfM
z8gov|Y3W#_EvIFP0zc(UZ(_Ke;cJ@H!VJBJp^_5Vv?w(-=Q8)dK~j?Dv_NrMAP2gx
zp7w&hP!_s<cLym*UwG;m&$|6c-F~DbbZP|A75>nVcyH_Y2+2OC#I}s4W|9D8f*x3=
zSrrqFIcMiR({x%7h@!?#Cydk58K?-oVGn--91Vb6`0tru;g&so1M_VU-=y@UC~C8&
zX_<A?Zr3bbvP{rjvslsX;m=HP8pTL~rL<XT7BtgB9dAQG!zQzb@0bq>y!4J`4_|k7
z-m{1AI4xZ^(sEjsGkn*=@SFDVooch-Ts9kORPEuLM5TUSZ5Hfj%!d6;!+wUg?#_F}
z5J2a3XZYTfDCk+OW>d3=Z`(uAYkT;%InmS%bD}Bgn$gtkXH1AM!}qZjXj$lUy6%V)
zDz#>3t(v8ySr}c-sv*PPdEc6ywTB;Ay4|+hMN0#t#DqW&M4N{n*Qm|)=0uuq*uzg|
znnl3a9mCI3tkay3%Zsu=M3`iJjtyU)v4>xfR#I$gSoz@8!!JShNj@%sLl+8#VpBKk
z1+&_mz{A-!EG&h3p<Xbpie(msexhDDfj7#vrp^)&(~3&dz$<mb)T?RIGHp?`cOR5c
zy<pW1Qxs0r3w48PsWR=TGBNqw9=0BCg7UST7IrDifzI%A`i3s&!Wn{1*uw=VC1xGE
z&51fXrUNGmI%yAv(8`uk6ndEe{lp0p&Svc0Q!L6<n-iJ|{`!uk*O3Otw09rDQv1)v
zq-GCaM>ZDIi6j4md=p_lRRL`{K_#cfggty8TY%OP{Zs@9nA5U{?-NI`hwo2;P`;0n
zt%lR8G}8i8m~~EqpwmdaPc5`}pR$Li=9pYQ><k~q65f4^eu<Vk!*^+IzdzB`^trMq
zSaXfJSu9TB3?Bvo8J>WKfY)hbIKy|#GtTZav?wr+&?7{{*=>=u-O!v}5>R#*u%Dgb
zyG{#AP+c?a-L^e^zYa3E+d{_hC1-cxYr+_VEoZl-vj8)Ew@4Kl5F+e`HVwLMG$GD|
zo7OQ4wWguX@sgf{Ac>AG()TZO_fC|l880`SmMtc<hSRd_-IuI}z5B8y^*zuA9Rq;}
zZ}l^fU*??Q%aCoJ04wB`L{xEFG@3<f(Hvp<SI4f}xdQGh3@nJ3EN9nuhA->-RI@NA
zi`v6e#il+tSD&qm303MAN<r$icL&x<bP;P?Ow7&I>zcE>fC&I=Fik9qMdz|PDJGC;
znRT;n*1+_4-leo|x2eOse`XJ7O2p%skJ~$+(PMW65xVB=?vz1uc3-u3J}WmTkb*dl
z@q3MaQLbk1j%vjjXZJ_YJcYe`4@}&-T&q~RZZQ?ER`eNr_a_?G!xRzdhNRC^M3^BQ
z12Vv%YGzY+E`!j39oMXyRfB2{*}GtpglQHkTCrm33M^Oj;*7ofI*<j0tXB#WNg75`
zJ_>@!Kk$&?!Ow+RVJ)Os6B8^Nv0PLJk!yj*nV=ypdkC@F9xga7-tJ0s0hJ(naKbW9
zR3TSfwuh%`daWi(kU>~>sp&+DcHgjvr|QiD)0^El&{L+TyKfRbr9yAo!<J1<F5~XI
zZ%Y2R`_p>Uz;5}e{S0>S@D%u=v-1wxc&a3{hI83z!Eog4ZsQZQJ1;wz&8A+nYWD8i
zP<ZU!w?WZrHGB7+iKaHESH#2|D3kq+KG~e85m~nEoexZ*ld%Ylsz#!2Srlq@!*qsU
z5>+>tsvD-WYco|hh(b%MZk#A{cD-N{EvFRIa!RJOoT0j5)nTeRQ8(&^6GX-fWhhIv
zDlOM4_8JykwQA`T8cJCwPSmi-QkAsC^KDF$KDwYyi~6)ETAHS3^KDd`Bo-jIW|1no
zsGrmz;FT>MB6|I#R+iP4WR0aMq35b3qk>LDJzR8#i)NuIPLzeL*Pur2o<gH`Pf?=)
zP@{HXbf`~rYk=j}5IWPM@mB6P)uJ;zH4q6|yKJDUUMks&Ga0b|Rar=beM8f$(36Wr
zuuKRSS`Cw?Sw^`+!shUV)6#9~--(=@Infl2xhljMDc=^GSYnV+A!|D=-6W21!f6qT
zq&wOglrljk?cFEL$z}l$DJl^GoV8$#XlSzy`x!>SmbLp!usPVwhVMf@hZrV`5F3dN
zKoT-xf3kPphtR`t8&ZfdDGaAoFF3<nx;|T$W|w-Q4m8_dC}&y}oZXKIff4;!vv)tC
znIb`?p%uza$zx3H%<+O|nrQ0I?nk->Laf`npI9cz)VrUU4+w)0^dj4>XpdB2Um~17
z1yy+W3;De|tx1qdCXo{ry-*}MvS?ZKZAmz-lL8y!OBgt5ULl0(dZADSiIc_$EPnH(
zkW|kyDN(Rait3EBr|I^dVegg6T#Ij`zAv<bTs`z1dv6LWqi&d!Fd(u~XV11X$wyMe
zSt9CrjC|OZ#$7!rsQQz_Y--&1DpBsDiLX>E1$%FX8#HMdFf4F}Q!&gmXU5(;p%uSj
z6$-f>##=ycGcsyrn@|3##u@ovqoUb+<(k}=5?SO=RGKt|5Glw4E9WYg#uUnQq14oL
z%h_v~f@x);PRokLP1D(HJkTs@HD|Bk?0$shMpEeRN2W>InX~&5B(=-*YR%dG2rGTB
zLALQi!8D2K6^oLizOEJRy$8p;DMz5LW<~aesm$wIak4p~s@HY4{tR!`g`wGd4>Q`d
z+vbeD_lWKovlh)XI?qbH2B(8m;ZrJC8n+%w>s}qUcRBGepqr2-TF&qmiyEI7g;s<7
zCbXJ8d>@AI;R1xe9N$Jq<U>)(A~e(8*X&)gl0o`-r_AJ{P&2J;xyv16X@UeYd-t_e
z+uM7}hV^-O0ldz%_nvZwFPTEqEeM&A8lBx&t2H8&Cd^(IsSCB#7%+U;+1+t=w?Xts
z+J(gI?6n|{?>$4}EU2SVg-v^Jf$RZgO5yb?spD)VKnZ)VElVJU5+KUv3<N~=Nr+--
zoL*=O*p;i5W=S*QL@+Cmx%NmR-Ma!avr!hh6e_2hhQ_*`GaTq&Z<fLHpR$K%7)MxA
z>z(1i84f^YcixjmioHz;_IsP47|z};XE;#r$^Yd4-xTFE+dL*8ng(+B25BxPLZVpy
z9+31RbIFBsnPo_56S}?g0k4=3U>wX<O=b*~Zy5TdFu;IK{BM$T%NZ`huH@{w4Z|dp
z@bF<6e7UtO@uLl}Pc+yWv-cV`$liOk&=f^Ry$Y0W@4cEcA;9cZVJQGsJIJsy4ar=j
zTG7X~G88aUnoS60(7y0xd+$}Wrm366Ad#?lpRk{Sct;7E&ev(j>}@)ishWpT&DWuz
zQ_2~B#zre>=nphY%E~u}FE+70Pv8MA3m2XJ2qaYvi9%D9>63e}(m0xIt+Ah}iV6BK
z6cg~Xy*Hf8b2MZ-?>T!|pmRKRdoLS8uT(0e-tGOY29@JoXXm|I!*KR~%1X!kwT5AW
zC6{LGy?1oOFa_yH<Xx#7uzykg_U;qV>F)l5OjC2D6Y6uco$S4LEiliv4fW98dDq^1
zmzU1NwAx8I!ocsofq~zBg9e^O>#xJTHY7ejo0p`S-t4w($lq<VDm*+z+hO+&XZH;?
zQM+%@MD4!GrtrP@xaaTFtnIxgXAOx;v(PZW(ZTaI6C*<AHOs7!4PX}kl8)3iK)Y%N
z+(Wf->M8XUVnsQBjnX$HT!Cf?eawWO%L(ims{r?(X~Lu7?7mvyhiN{l;R$}rguF1_
zoZ#hLkj^G&=gb3^R@BWDOg&FE2pi=ToDf=}To)6jRm8vCApTGdLIt)55nX5ZRTjTt
z{l$C>t%j{w1NDXh^RjbUN}}*yYXxXmdmpfVz4w8H$joT(eE=3c{E10cEPMD9jGbv(
ztYl`ESy0|;p`ulbR1gpFT{imf{TfzKCdD<ApAPMPSbHbIAb|Y{=35x;$!1Ro60r6@
z)=WG;(M&S4?tKQIC(A<UqI|WgNW-)+tB@TyX;uVe9Ri?NTksH*m6}r(ksAHM0cy-X
zK2O=l=VVR+n_z1jbT={uPYA6tS8Qq(_FGkquUnd-SC33%Md&P7@)Q;<6sr`>{KT5o
zNlTkx7gv?S2@3eBlrhbxcz7110(SR94f+`18cXgN?Y&R<@i88Fr^>t!O-AWYG=6?8
zpTC8Pnnv@tJUJscm5ZV<J2yL9p0P(|-5yQN)|z@_#va);9H#zt0lTpTvy2)jf36%%
zK=vcEvo&~8GV}vNKkjWfcSkmT4xF@1lz%j3XY)DZjAr1;5G2{qv`UmsLVUgu_F=6y
zEhY}VOkN<fR-4RK!XXe)yez}ii$c`x5wu8q)UfQ)gD`~HqXu#`XXgs&hE{{c$Ju$Q
zrek|bsT%)c0@(&~QkavLo&n_w{3pAwYb9t0r4sz0R-sTZ%k)aISTrkwmq?A8q+7KT
zSqQ8eSqh{^4;upE$(Kr^7QEyWH5PblypmvaFl+Yc3F+uI%rd@b;6E62u<vU2=&737
zEYv7b7KTm^T1GiLS9IRR21LqJ>}|qs0e!gpb_tvxJ{U4?Sk7nx48P`Fc18<e1|v2v
zUbaV<Nv|5cq|e!-E6(LYQ&g;GsbQG4O1W(BzSgiu;C#AOu43EQjj~lHe{{Jj3<m2)
zxlqw6CVYH`RW4VXrP(rGuNzRBoRRD7d;#+&dltzJ@MX0*p)2p>bhD_-r2O5zhkR$`
zl8+K{Ps5<F4&pHO$cM<GlstRnF%QTIw?Zq+-D{6Li#fy-#38VsK`%!htY!vg-y#Lj
z$P_>W@hE1osNzxTSY&tKuBpfn6V65O7x+eMR%)`4k8;y6YbJb?uoGY@)F~=Qs~2Dx
ztrzNA1q=AkXibn-WRL!=+|+feX4#`17EVW_nmu}z<u7M6D$!hyM$TviiJV@Y5(u?W
zI(Vg-Z5lF#IELwnLaqe;7(#0pwP{gwc0R7zqu1@x8}{f;d-T%^93&aW1d620(NE#1
zu}5!!_>!?vm)1q)j4ezOApiljNAHxyMA<5ot-`Df!YS0130gLAGShZX3QMrQ&dsxT
z-=VMVzB48C9R3@kbfm#-SQxzvFVN^cY`?Nqc7$=b;55H$+M_q?_UPyK=yekjU8b}1
zlL{Q5J0F{MtqiR!C&rpnqF_2ZA4^9ImhI@LP_ah8aCSbf)F}YrCuGd4+oNB=NHjYm
zCa7D6X*r`0Wb-~O2vH{4_lh)yj6Q^DH~JXT-{`~Qj6M29TE0e~usi^N+vqcL@{c~J
z9s4=SC%YeO6{vk5W4|#>HrtOiQ^92L#RFo-=yR&#3##G^RRrog9_6O?&C!>dGy1}&
z_HaY&(Pz#GIw+b@6S_0{EoZ1kU?PFvH&T36XwH6Fc7)hIW$fEkD(CE%ozds8;(@t*
zq8YSj_Gcz4l}d#NOlX|2a)uBY8UnSsp&1oRlSsn>E#7Gr)Y}!SVhZSqs7d9N(=Wj1
z#4$M2aJgxO(&cDFIxJ{&ruj8ta8tR74Woh%&p7)hG<&~+#Dho>N8W!B`+UaPe^`nh
z&i*M%O_DUV|1fdQqCh(;#U=?+pgQ{vOE5<=tcJbcz!ymNK_`S}@1LP$i6^EcpXEYR
zl)fe=#`<iU_Wl`?mQax?i>hY@l*V*MpCcAbb_m6a)E|00$RgWsH50SJLWX3-$bLqN
zh6*#%P`hrD4Goes>5h$Qm=Q$7-fwXx+^xDcH-|df8tg)n!RT|<W|l6^*!!1Nl*Djx
zx@lx9sKIR|wQ3*B3w6CLm-N1e`YW}mrf%<V@^aYsC!0(x42$N9DF1$=)|{~SH-U2Y
z{aR&`oJJBbgjTUCyc}w!rdB}?4-W;AR$$MmC^xHa$|UxA#cEE-)ruJf>!<OQOJCx7
z01R+is+){u=w78VDY)$f(cal+V4C^b=o5-3vG@NB@gz-sj=ureFq;z^VrTSn)8K?0
zmmO|A0$TSU)XJdKa3q~LDN;HO4>u2vf%m1*ZCK5cz5f~%G*hSFa&v+c#Ct7sGGn(V
zMY*CIGxq+Eh>YMto0+Ws@=<CQ!2L`LNi%qZnI=3ra&#c&l+6ht8f9oi)C%6c_$d?r
zdO|DdmiaX?k!2|S31M)5D2slGM3DSgF7t1>s-(!WDZ?7dUvC<!1@cWAipl1LS(dw!
zI`ulHobA|XK7W<lR%@2z(9mzaS+w`xpd|fF6KuiD178guWkYCH_{;TbwG8c)Gs`3k
zAW3{@|4qer(117Ps1k)Dcv{fzk^2KW<^Inwz~!1%AaUFoE|%bYxA)&G2vOnHS1t;@
zVpYJsVE+O2Mg<QDs0=$TNSFKXr{imoFh~|Xg4BG`4;H=wF1Y_oUIDwWGb4FjGi>RA
zq<B8EZYyiKVY3O6>rkYg>xb$g(U=BE-o|)UY#LW#sjUJitiAufbUko&b?l{IW-#vp
zSn2m4B*%nQ=A}oABFAWK3Pf<Z_e$2_Dkk$EBUEWlnD<$7Ws2LOj+mxtmW9^fs)}Tz
z)N6|1D=M!*sVKtCC^1t4mIqp%mRXpTauGo=qjP<*)G@vSnR@>d&EEeE9L^d2*2Hw0
z3ds_{$0ZEV=QY!0&d>m{LqfM8!i+vJ8}|O^re*Jc>4;K>APi!a_WxdU3|kbltcv9v
zXcbY=`OO+E3$-f5rO^kb<s48%*XUy`(t{ZiV)k9c_nA<q3PePp1~>;N=(j<|e@n$1
z=GPvjA~Vjx!`Xwo@>>Xc2d7{dsn`dnCY!o_@CcQdo2xb_?1M*~y*K7`@;O$VeV=3w
zwP`9arE=1&Rhxx|=^UJK_IKC<y1!#m2MC1-MIC8q9a_mEvWcvNClGy)cskQEO`D{U
zMcqtatI616!Zb)X15j%g<?AMbvHqDT=GXn9?IFF$I`Ju^W;YFI|EH2`fuC2LW>I2f
zA8Qp`0OjoOC<KW-4A&}Cyf~cw9gG?j(8?5S&-*)O&D8CKQ$(K;QmW&@63;<PN<0TG
z2rdV$Iy{sICuqtWrd1=~<-rNlB8~3ga;aI+LF{b-0*QXozxKfu?6ZR_+^?oVoB`4`
z2Wgw8*)WN)Q`%~lv5oA5mrVQM<tZIH1{SM*@KTz3SuWryXz8ep$kKr;Lujb!Bmf+=
zXph<lt)kExwT5|8MxNLQtwRIes5u87)N=d4<qrAuyLqB%*ax?cD^2+?)9*`#rkMI#
z(?m0wp6I5@Rbou-gIiSW7KKR_V2KpEUM2T(xr{x*Smk{$*+h==EVVdeA8f0PgKf&7
z2Q*=l6%Mw^l{w=a>}Vx8Rw1V$zy~wdFe{j>QWG%}`(IXIaz7X$2QR!z#OmNx=oWZT
zEw5@*a0nAjh}Sf*?b%t>spiu($?DP2nLrV>nu70JYC%&ILYq>jZl++V#&<3Iz-^ei
z1xq<b1&2Z```{LwZj@kw1$qX5*g%{rm2h^>SoXnB@CFdClWk(k5c<><OhER*>-c14
z3gcd}56GB(@DuysbvpQP@H&ekW>FNX5Ma4sWj;=TuAUV7Nl~}7+~-b;%A=Ytlch&B
z4cafat5T?FQ=FWlFsPj~rkK#HrfyBix~nBos8*|1wIp=JNFxAG(<kN1<q;!8m?ZSr
zF#lPKIP!}X)PT-e1%>#sf#HN1VwUZ$qnC72ZRebWchn|$7ex==<)V`qk9Sd(b1>rb
zDJn^G<{XUXEUlo>R3klUY%H_d<RxJ^2P2g>bLmPhJ%tYvt7U2e>+}IU7;Gy82`wQ=
z-rh$XzJ2hn1P|WD7|qg&tb>O&^amqH8vE!2S>t{q$8dg5{NVrxUrguV=TfSr@Byqf
z3m!)q{3_AT!Ot!G;1|Sye#vkDvW!Oj0xv+c#_=kMuE3cU(&?b&%vENbgAX}L?C96@
z`w=a)kL&|*J<U1zgpTbTe8#6>q@nuYL(&m(vdSdOHlkSPtT{e8gDi4;?qnufP{Lmq
zDp2Y%eELL1H^_(t)>f8Q9>=Jp0*h`6ZHk2$QP8JUmmyhHl(bJ~>k771RblLdFUgfr
z&0D;y)$CA5wJKR#wOXw*U#nIpgl1I1H41RO7HHd4Gov|<n5Fh|0W$;Xqq=ioE5pGT
zWMB9q1#`B8(H9gRJo<uU*DpzqM25^B;>49sVOAJ#TS`3#<y0y<DAVk=>DPuO@}O-W
zoN}5I*(aQR*FHD}N0*We?1NM2k%5Cd_P^G^$4YRnLY-;izyYY1XxIlWnCUFTs>**w
zp*j{e0ZLP?R*RTyvsx7s*aVo*mk|$yg9}t0lq2ZU_-M5X{)m4pb26o;_QC6uN-#uD
zj=UncOnqOvbs&I(FgOPz>?S<L|GWON4#EF=SV+_V4bsiy-}|p~<%GC4A4cbUJ^CxT
zn{g+MJnwY3*Q31u>tWISFa9Z-{{PK??iR$P5aPc-`=7cY|NlSYKfyo$H&9Cf0u%rg
z000080HTOUU6t^>U{wJD003wM01N;C0000000000000000001PWp^%ZX<}n8WNd6u
YO9ci1000010096x0001g0RaF20D6_dtpET3

literal 65834
zcmZ6yV|1la*DM+v9ox2T+jcs(ZKs0{c5K^bCp)&CPA9u#+r0g~_dWNVbAPQdp0URB
zYt31+W>u*wKtf@Hfq}t+{S1^fq72$*YXk!a12csLL;CmC$<mwI(bmkI*}}o$JP<k+
zYi#v_Xy|XT(BQPDd3X;D(Uwtoj{p?vH*X$vS@GP?9yA)|tv^D(H@&_4Cf43sYgN_K
z_=i(DFKgyaj~)dE#w%162}s1je&kHavZXZWG5uf4l$Y{QUkDg)pB;S3vYO~mn(|xP
zj~n{lWk`PQtCd}M+Rq9ZELkl9o8-Zxts`+6wf7Zsw;3eu>jfR_S6m*Y{WcTRdNcIe
zj5<2yY_;CxY_wEd$$)HWDPaE-27G^je4M12nLc?k{yed6LAva7DqUJTtB*4Bq|(>m
z_;1hLR>{9?F_M<=Yr#Vz&mAs-`ew(*3|Z-wq6dZr>ElYn&qp-qmh1L-BFV>N+c|Z)
zZB~}#$vz%owKz2l3TAdK2QAplS;?Y!s@@13S(~C?42qO~lqlCbUUqAes_n~?(#131
zt707S=wdJ#wk|zwkFNqh`~!UD$(uZUjmeu@3r&56{G12{y^D{w2kuP$@*|F<V<g+K
zEz!?1CIZUS<Wm{eg@|||J8?UqIte==I?+3cJBu`nw{E3khSifX+de4N(PI?ZwlL(>
zbovP8S?X5e#&P5pBEOb1`U&xSeaM4fMl{F&M7QkUS&naFHjDOgipKuA@FDQ*CB$nc
zl&WEY^ke+he!sY?{8v`<>R6~$V-_U{DU1YB5XDFE8Y)k;J=mQ*d3?A-vTXK|M2-@D
z5cd0%8eL4P8LUkOVa*nKMFeI5ID^mi?BvD8UV&`vff&tOA`Lpc3T0q+G1UpP+@>5Q
zMMelF1H~6!p36Zh>EA6(itlz$A=>2G+s=9Dt2X(yYThl<WOT+FMD-ZLV$=bxIoAs}
z7{Uum2gA=*xoFrbD#$cu<h*!3^w*r+HB4!3U5vPD#RUO7WHRf}f7h=iagy&l&YHq#
z*;AI1ulX4NZoBp24_nK!CEenZn@BHARW|mLpOBQfmrOfbHn5l6>0!HJW2Olu*G}Y1
z3G^T{TQpTqB=OPeD)@WZ+9KVY#7NGV!DbR!>9tJNX0}X;_xxlQ$1!d&m=sZX@|3~X
zUDCjSf7qxbBcs^)G0p?-46_Z<i{(Rb?FAwN3WR!tU%_lc_Tu=EoYkK;_t?eU)J_Ff
zixX+Z-jJV|n4#q5cy2gb@7)KLet}(!ft2%fhzVldJf$_XTC%(Kr^_!*N3Oon^f5k5
z(4G$gWkM1mNFaq#0w6jOpDFDJo0}I9Sb>P=3Bj?@GiEE;?@RywQ84O&pD=<Wsm_`D
z;8Z2eOfWw;^>X2><QGYN22HlJYT-A${FL0auATzbioQbsi4!25Apx?D&*}(qhTH)U
znu?M}_AjqhL+6HU4%=z6t*bH~IzdBJ!BILZwh8BQY%HEh&^7Is(fELShkxd{##!|_
z*zndGQU>W@yEMKw^~lD;yMd|P+*N_evCZit2TMrzLw?Pu<55y1l)jHvY93q0%I{>z
zy-yTZNwtazv&100kXYPh^njTUV)|-tpqCAW(Eq8<l&;={uQ*OB?iZSTB`9%#N8aCs
zIbK0-P9R`aPG~=jP0}W(-zykDgyWLeP|$d)XzHsrebR~quu>fV%{;NK53RT6ulbJU
z4_~YPZeJ-zDaE9>;<qluh03GYTwkVZL=_Gm&bQ{2>c$8%?fDIh^Cc}-r>)1KX&HZv
z-)+~WJ>#YzI}&kzAno7_Z(Mzy;dEO@<EP}>_qqfd+`WBe$mA`3zeWs0tj~y%2|W#S
z*!Wj%_0wt+`%6v*@;O`^x*Hd(Gby|8IZQV8rP(^8_&y%FO#|J-(<?pXR2DljGkmcj
z)%on&E7PcJD1OpNast!jn_QE!wl!V?1}HewkTl8c7O<XC^QhZZ_SERe&`3S<%2;SU
zcW-?2mC8oO-Hy23Nr`FrC<?g>d2kV%%0u5AMvlV+$FP{KC3$Nn$<yx%lfWJw5%E?j
z-nxJaQ~afHz0Ho~@*N-Uly}D@H4U$IV0S6qQbR2Yk1Xm3C9jBGtqQ<(6Hg&+nw@4`
z%n>R2wQPnlI#!CDPP!750ZT<#{hS%J(M+nSo>c|WZk<JSkeKz#OrwBlCX9l;T?c^f
zN%$3qLLLK~=2oQG1zEivS!QC&VgNm=O82Spy;FdxMz6Ct1D|+EYY#(1ms?ziQ=G-r
z<PYWsyOYv_vUl|ni4K4KI;t8B7%T)VIBd(K1E~hzaD{@}pAWOVZ~v;cM1V@8oIhfu
zo(A$sROh}$9ED3+?Us|g`lQYf*9~`)i;!1*Og$qS>pgm^#N{^W>Lr}j?StYz3dOJ?
z?ZFWRm-i(DcAvq+@||a?Hp%Sg4mVNObb7?-XFA4EJ7G-oPl$w7s?=P`zi)f^<juXw
z5AQ_CL!Eni0-69c!C(z^G(XwFzn`-PqPTeI^);dF`4h2$iguZ&5tS+dL97?FFcn`~
z`~{YR{YLt@!R)8(Lq=>;QfhjXQXE)E08`V-?S~V9G3AI2S5n0!ly!IQH^aS2Ix&kE
zIx$<#j@6rWFo&w3i`r4lo=P-|m4;?d!QQEO>n8rnzXI4s41iBhKgQn3rbdMQC(kj|
zn;LHD3nrpgY*%2EP>%RMO18wKkk+q!+1KbuPPXAIL-+-6{l8W*rNPnV7vjgIUv<=4
z<)&E2)GS=3N+n~KWy!lzRnoDoXI+exF=Roz<ENPMK^ilQ98?bJ8^<6%U{`Gn%;fXk
zJB$rt6Ycqif3=#Qfrr36zUaoHR2ISmPI@Q^K^xGAxT#N4eocEg4w#m}JCsp`#S;3J
z>q|~I#3K3}IV%Y|_)(g4mp`_FZ^vZ3FI_bujGD|e#I*61vK9Q{(CD3nr5}oIFjB3x
zw5_qi2%jU7jHz@U#zRL2trH&&PWu4n^{$Gs9db>+K~zCZQjr=mQ;tSmQ10U#JLkR@
zMrnX3$ZWKn$zv?y<#`$N%HCCnyZxJ7TQJeFnPy(mvnW4YSj$_VQ>cov=SQjTAVej)
ziRNb4PpMtE4u;h?5$Key1#L6=bGu*iwgL)OHJjTl{HJ@TRA?OJPz|@m#t66flf>`E
z%rEwFjLdau6&YG8a9L|*HiJ{~?hQ!lI+Rj~+6M`zu-&o(Dji4ZaJDhc<zV5J3@yJy
z&+B1~_p~uMe9hA<&`WVaO%!8rUQOYu_L|&$|DN*6q>^DzG}_=*?+E2tv7fr)=n!4E
z)N!(`bq^tO(k@j%s6o*g`RkO3FfT)GMr0;S2TW>KJxBkR7Mb0tzmT6%g*SPM<qrkJ
zMdpnAJcUU`PuT;`suoI5FNp<{n#>yYJg-iUVj@BN^~shL+&BZNwkbRX5v5cXjq8+N
zqUmCsN4__liS4as9dvl8?-<q&Geb!<Ih6aZS>;9(W+p>@1PES<8=)%MPtWwLIhV9u
zhy@!$wLjVQdMX_Qh2lRS&ok<|kKXjsCAqL0$-aUH=d`8${`@jV+xy6krM<B2M%P)`
zOXnxuxgs7ho+lG2l@Uo&E9BFs)}Oh`!MSwWaY>BnT6a1#uR03WAw&8)BrcC?Vprk+
zrdoq@+$3Z;*_Z4>be8c&nfong=G#$rgUT7@mlE_ADIlnuc(1sIakr=Y$9p!tzw^`F
z6_IEzs-ZR@8cVWnwu>D^1Cy9grn@44gZOlZY4kFqC_{}y_^zJwwHW`knDj+16(uD@
zZ~VNP7Wh`o5Twq)bdwDzo+sWgxhi_ovI_6CXdR3ECb`(38CW@t)iv?~)&KouY85R|
zwN=cECpfO*K>+jwB-v`p{aGUG`R1Vh>-j2@>)I7JR;O?f&k{}nTmf<lYzkruoB@IX
zJOwxjqz6`8diWzUGp~_3I3;8DtthNac2X2LH*NaFgM&8#k{^Yu`I{TS??ZGb(SKej
zzzSCyzz$}AS9#@(k`(w_Xr%f0qi2bJ5KE)_7g6tTxVQFWptFPcM(#-E3+D?rvUA)8
zOt~VW*V=cXGM}9M?fV}O&)*(qmx8rtcM|OvIRN(&O#;910P95hf-kPIvXqlc%t1yS
zpkjEt&0!RMR4yh{w9VVAyxmqNvK@b)hEe*VIX|uQZXQ!`&!J=gu<I1ZAJTSE4oD6V
z4hRmTfaDy(FDSdF`s_9Y2<{GQleod>E1ONF`_5`)FQOH7#apI<?K2a2iI4>J3(Ltl
z-zeF<{QI1iFzxgq@+tG$%>ZG8>d6jKDgy`uaDx^PaWsza=h#E#_8Ox?-Y?-0C{3G^
zM{cgVcnwT(G%6kW!2vEhlr%CdGDe(5nirwboq_b-F@{06Gb=T<x+f=bP7-b-1yx<k
zL{psx-wHTKbo0)8=0QUF_qSjSpCOP*#+RC-dZRV|@p&O`Q;m6gzck<C2F^iFxlR_P
z%#46;nca7EzwO~irm?1%sszQ79Odx2nzVD5NX7=`fy6F{q5WX$tD97WP1VYX2)x7Q
z*@wBJa>82FNBZXA5)_qwibAZ2&!`KEsa2w(Ivj?gqDQHvA5~8ersT=$f}z<}Ra}qR
zql7)NUtADeSJpgI{pib>3>TioJl)+Ycu%uUziM;SuMk+)hSmfBurya&&*aYDRFX8G
z&oyhhBI5p5w`LECB&3!|czj0ALg4#Ghw9cZ%4ad-h9rGV#`v)5wYJLq{daiLX#Jn+
z_$nW@cm{I@O?a82Qy&BaMzM!s8>ITC_cvC{>04y97M$b06R9v7IAhiVV^&-3q>n<W
zkH#k(D?|H^4TYe{4@sUNuq)~_;n_SadP`eh(*;h2y9r60ua7<t<XW$kaZ#f0R?ix+
zAeoWOS<dH0(DEw}@-P>B{(-dV+qa~9H*2}p82REf#`B`%%A4~cHHTEIjra7vk+F3Q
zIv7Kal?4oPdV9v_SP6DDSj`M1ODPT^mKgnf?6yZq4m?Ld!l<*=6Iq2j@`K?Gw0-c(
zc3)!lbhpIM?5JF|$>Ax;DvP#6?4L+g824|1mlp$pH_oVio*LkEpTb`9SzmKbV-@K!
z76AG~i}cDl8Lz-{kE(17e0zX)F8s!dm5b8Y6F(#`1}`G7z%FPs?VI2o|6ld4kFx#+
zvSYY2oZTAK`~ykRE%&|3Q_Hy0uc!psr_5CB56dNNc*@PAIlkKY+f~VFgnJjyto&6u
z4AdPCpBK2Bw3k=pDLEx~cRl65xn8fNiuI@W$7~dscB|Ps)T>z49b*id{X^J_g@2jo
zF_drLnQ$U#I$r!iWKk8p*aeZ_aSG3HAaKBOATt^{t2-V17cd#Et=NW0xEZCWx|fBZ
zV-r44_IwRugo!bt@K0z00GQ}|L(sIc#uM}2w-_cmZS|#s5<Zi67#K}fwx9SnD4AU_
z3vxfREztsCxnW~xKUWTrtit><o^JE|KMZ@FEu_fq7*}Pwat})SwiTHp6|x@pai*4Z
z!xZm^`g<ArvfLkJ%d<5qVL7Xe<jKVf)O}}eCW^-#r_k``*nc4_h%Lh4Cs9O9dgx0|
zy30v;Qg$DdGf>xTGwA+W381dN^KY0zmZz%aaxhKhgGhuYT|_l3M8{c=!A||w|2Z7d
zs*&1karQ&u5N~jNV17L}F-dpMLxGi=$trP}uPa^nR<_#fI|{joBj7Gg+D&w@*K_I3
z=30c4FAshFg?L=<&*bp>UHmqJ(?~F)c&yMPE`lZ>+zN2H?xCYYiONkuDQepEyLpl?
zYHX=Ux>5er;JgV}LrkfN79x)J6Nb=KHEJ-`nfF5;>XUbFxN{lB-cUq1v2@t$ZAR$3
z)Spb18(W29mD*7Biy}4rw$H|v!Ho-6BjUEToA;UD?9alj^&$^$c9AaSb~DVjk~BN0
zL0T(Wc@5Am1L%1K%=QB6T75OSOmze1k0$-RjJw%F=Rqq9e?oQ!oq{(jH4#XVH1y)+
z{E1wITp+JqK++&;kQE3GND(R{6;RvPACEX_C-+){c7O|l2V#WMfU7X?O`@%tPP*ia
zv^wY>YLK^AzN`-%{5D9}(3^Ktb3mW1KrzpYV$XvYMD*dl&SkI14HIGd=A}&oC35!A
zSa?Lf>I-BVoz;lS<AZa>vbXH~`VC)R`;Nj?9w-dx0_();MD`)OCI^iGFMtXm84xUx
z#!iM~5f5`mOBMUko8kgyVeP!TBD60h7&G2q#zImHo8<I(aq-blYttLI@I;Z*_&(*n
zkZtsap}Quq0n0>>E9*|tI&e6CcDJ}g?X3fGhIGR=!3IR;vABCzo3l8MP0LIA4*C6e
z&5bI=?&a`v&aUvgQEO%F$9uFN7?#CSH_JwW0-uWmDvYv6Zg)%Xl8A|L(No<1ijNW5
z=Ge~yi9^Fkp{b-u>2)(Y88qw<m~p4hBE&@|3l<KhIq^gKK<<{$$&g|3Aey&0Tgu8%
zV0~uu0e@11TpMLo3bki?>1_707Qio4A>P=var2vPF||_B*vv}R!aH7eZv-(-f)w&~
z?PDOgZ5)bkq~aZ8%07+oFv^Xemp8S<qKQyLc~x=~;-3%7>k}add@S$P;2uZb;(Rur
z;@hVul>vG6n7MQLjF|kf36k=qDT`0`-}sRYl3RRu0`I5cL&d%N)atBE1tvF<>Zg7m
z5AWRJH_#q&&C?YKx7j`OF9oQQy{gTjaUOJ`wKnOB>i}<PjOxbXKdG{u%<F+I=~k*0
zXyahh8{rP|s}a}l*aOPX4(^<nF5ZnD$BNIZ^CJARAis~c{W55ZW5EoMD23vFZS9UC
z?T)J=ZGgt{OG)+hT{`aA6ZGDrcJME*$M=?sh`rqmI5w~y=j7x;ewF11j1Hae`Vz&V
z1-KGNtRv>v?^jFTB&gJMw9eL!g_2G+zCtZ@Q+KWdKZsqyf6jz&Rvo+uXcr<ctHs8d
z;Ps-MG3QC*$9Pmw|DlmXwOuR$+*eXx04SOCLQB0*zRfKlY$OaHOp~q1s<74Nnqxf9
zN$NXFqdQT~QE9o#VHqyQWP7A@5cmaM-ZnmbiJpDIzt8pgG)<~6n81DVu&SlAmN{4i
zM-x<MwDp<VZP>Wuyr6wwO7h{4BkMT)d@a;JRaQcZdd<aNN2|dUi`jS3gz|MjO@)Pp
z0${M5DhC>Q2?#h&O_NrAPtFX9LSI<!HW;{YNn+}uL!qcRb)uI_)PZF$v-nb*A*ACE
z-KLX<Fe~yEHMwFggOm0~Wnjd2_3g0TETiw*aB|bJUF51|U9-8JxtHAoJTob_TNIrS
z$2T*h*2dyuW&2@ht&@>8!j^C!nx!h1Xm0#cnEgF{!E8v_D)RQ7+TWOoLDUT{T`-KV
zBD%%XRy%&Y#wfN!$(z&GKU1Fs&K35z>JfoqHETsOBh3ihtW{0#_~<WV$hYE#(1EY*
zy}XrRqD;yXy0bdw5}6YiRRuGu<wgLJ8z*%P8yd2<fpMXMW2#P=lbghpthmZ#+X^Y(
zSrAq+akb5Q3?dv=#jHHLCz$;9LcRPLz%65D<$T#RPjj^`1#H913AC62#T+Kk<xp(6
zAetJlJT9z;gM)aj#$-{ZMU!!Q9C7M3LVFPQCyrd&LV1EDna|4+r=)#q>+o+K9lqI1
zmA$?EDihhNqk)^2w^I_GPa+L;`98)xMASE3QCe{6KFnYqGnO#48PvT4r5L9ni)rDJ
zE=%d0N$Jf9<dI+RVi-;R8n6x`O)IRs#fy9p;ST}n`jzen!QakfhHCKqbm%M4-r5EI
zm&$7Eo?{XxsW~MK8SgRh4$#pax0$`xY!i1pu&?bypg*%uqc#$uKkG+GX)nJZ5QM{j
zv3|%Lfd%mG-qvs-xH2I&z5Hl=<v9tXhw+4tU$MY+7RcpwmNwrhrl@IgeKEz=9dPzU
zRURL<655WkaJK%blYf<8vwpHYAkGaS%ega{Z6CM7Ji4Ma+NFE8?aJHFqa8E?_Jls2
z7hOBnb`>j4cNM2#^=nK&7gbvVEjapz(QYsqQepCOciGGvmms#gvTlbn=~VWRa`gg4
z=i1fti8v0RbAvnQ@#UZR1?*#ogakoc#wj|@-L>k|&-xUq>9@l1jc=i-U?fnNP{L3F
zxX*CcY9Mombp<^nLupW^=bbSN{a`K$OV3Vu|L0kGX$jcH$#3W<1=#_tFDvL@wT*9w
z@b|aOpcG(5hzexEccF?)fU0kscjS7o-XmZr7|t>;wcB<0adxK*x*5?9%?VJ^(D+O6
zQ6jkiQn6Okj`$&ZX0WF@Z{5W5&TyD9yLB39{hQk+UnbJK1-;rih$+%!YByn5#N#i^
zWaomuRw_=?X&mFqwY-C|sdmhi!+l~WuPWWI{d!Ge>pRY|W(I&+^`xmo(tsJZZcLpt
zt2HMB^YpDH<|kIhFWhr|@$XfGq!e68x0s=KiP;8AdUu&i8?p?a<B&=20ck51j0P2a
z)^1EUzk}uunCP-!bKbP%Gp!!za!0mDnViH^%acrKa_xIjIjfkR=7jT=$#lvxeLId5
znXvL#h!OU-NJ>T|vtMH>Na>e03LkPRAN3oG&Wyc9pk%9E{>F&(*kJk7bc+6VheWFW
zbEuj&4hm%yfCu=Ni)ID8vDE!cyzPY!Ab3W(HUjwrpY)z00xq9maV6mO=-a%o`@~XJ
z>-+g=FpJ-kpsmbMeASlH`m5zKCuA6j*9z1PB?h>Q1{8d#I7BOMT_x2FUJ{{=(6&Fu
zpH#^Yj2zW3F<R#<(6+**Rby9j)aOj>f)akdzqS2roJ*QLvNU?ghUi!RrgGBr{Ir5t
z5*TV@0?`i<MD!=W$O(NP?X8g{`<f)x;Uqu>kqTdfAxKr*f+wrmYGB$^Mj!yw5BpA~
zc&rEFR`1OMui!AM^XJb$-^KXPPr*mSk^X9r8$`RUfuC5*(btKb;k!W;_Sb^-)8u}e
z@hnwN5CkJ%ah14VD=n&*CHwX0A(2}lr=zgAVpVGI38x-Kh5pf&{=>OgWw{8<2~vcO
zmSey&0K?g$Qtg2$jxeYtBavMgA#EWM*HZ*M*y?6^qp6|Qw_S(AX2d(C9rfSQ0SYAQ
zAUQ7HDXy<1A8wtI5@I<l7u72li{s*wL3(G!#*`I_r+5OjNzMu-g&%C6-1q1W9<Zfx
zwg%KW6{#h>4HZHZVa9hyg<1n*fOKfg1UaPX%{7a|=7Z-xw!<db>t&gf>Zu*!#dJNq
z2$Va^WPZOaPmkSn-gWRSeAX~ms1{AK_xX5kx@9@kRyKfLKwsbsFcK&QEGyf>0}FGk
z>(t{LS=2Y1Ofm0?&e7G8weO$~WR|;MV?JR|-DL&Yf$%~4AbwE4>C3(~hy`d8+7BKK
z`w9NebIoF<78Q5Hc|-^hzZ)UUjbsxcsUjjR7gzKMbMy!bD?;l`S#KY~S@#NLloy#v
zH~BE=U^(j0wwf#1xKn@ZMfHD2RU?bV5OfG>ZgbR^+`!)<pG<q*Bc(%Le~gyGZt;Y`
zcP^Bvq#c1L<`N~^Q?%qy+MRi1$&40LnHb1q`Z9Y@51w)G)lim3y^+isC!4jj!|5p|
zFl+1TZ^y0&mOkDBZF16AVyhbw$}BC4(xu6QS4u^6$NQ)6QP_ymt5gHm&5Ba}G)NiK
z5ESF;dG5N~FrMVL&Q@pt<WzpeQ9&W0jJgWbUPjBto;-Tm^KUxFGd$DZ3R$h>8tLzL
z{S-oLcWoPel3)=$jjmk#b(VN$(pLN`+&cQws4Xr(@4u*}8HDH}oVs@fLv*GsZM9l?
zX<=b?#!6UM(Nis$|BrQoy}d?PxV6Csszl~@2cmkVpGs%CT9(jMHZZQG|ER*}+>W%F
z+(nG4%`h==qRy&fo|ffli!^;DD36?Q;jnHSIHGDm-ge<a3G&P-Q;e0UzT~%nq1)z{
zsnQ#|M?qTpuWEzXOY&S;a{)OA>4!m$Ke6v6Ez3gCD;qrJO6Gk^R{F_$jRw;2Z=}ZI
zPq_P7DikVIPWptL8QjmeOimjfW&gU*j_L@r{LJ1arFHDF9MG!73PAtzWDeFVcN6~n
z%X)OQrSJcFi6<-f$C3F~F$JU5>GxSj_o9o|yi_{w@V+hg^S<ONyEdDrRi$qSLEQ_)
zwG>DJZFBzfGFnaYt^3FlTRR50c1wW7RyzB^F2N~-qqjAF&d}WA$L&p42nBchjuPr7
zQF-2IUU;Za-eq7;^)!vZ(WR!}{FYP6mNhoEKV0@5<edEE4ZI2!0lWI4mA#jdS+-Hf
z@vNh1Yj?YNzZe=Ux&5z1VcJcRvXi(F8T<gY3{gO1VgZUh2gUNuX=FMjK{Ao0Tz%14
zo;Hh4ef5p<(|X%=eoD_o*1<LO-b!uYs+zbo^eT8`wdHfO9pO+0`x5tfy?KPLSv&6R
zCG4;ZUQvp_0IeT@w*#H?+u3v=!ezYR-De*6VOBZ&$id_<7IPJiJN+5O0meVp-4v6Y
zLPZfVY(_0z?CXXMxW2r6;!Ex0riyfom=ag<qo?R(ax0kB&26-3?}<K9B<QrU{^f(b
zDCK{Y2r!F#rt1ubxfD4TqUFYwA5@SXkfW^R-^M%ts4WtQHln=!7_!IC#J3hF5#}D}
zi<-7&LC0h2D{RPX$}N<R-sIwMwOAP!;W8tgSAp*FhkTPniM<>xq&1l&#H7#jr+^h-
z3q+0R(**7!K8hZ9Uxlik+gl((wTb`F^*8V<f%(~Ul`KpX-jG?wN3Pg&#n&p+Com9j
zyrH}1Myo&HDQJa0FB-+ek3<ogvCjo;$-k*VZU0_b1nZm_g0P!p$^Rk#_$1J$6}>!N
zE#t3rqu}&KDT2)<6Qq;HiqQ3JEPTX!)I4=|PuW4SM=|_HGn}Ihtxn?70wPBUM`%mP
z9eJdcge!ODojX<rNQn4%OZ^|UyDqry4WcfpNFK(T=FQ}CnKZtRp$-{B9KAnXZ^ZJ=
zykb6~BMm}5*pc^zB}iQ`<}OSwMji_IkP%kW?h)^6Si(;zn~eCgs)od-y}`l(4?nQI
zkPT8B@#VELL8-W!u?&b)v9OdW98FBZ)?xN-s>W`Vbz``jV1k65$ulV>osL8Y*yh#!
zcQgQW<Un8pTb=@x{Bg`ZyJkU@;x~^s+wbi%<TWKBGLVU`s0(g{91G(wUKw*N-;J0z
z$~yt@^@k5VJK$$NK%%zH_rkQwYB!32=Jr)A6zSXaX9_(NYhN37zS4vdR{sA8*xaSB
z>=yxt)cmrHt|Wv@?9o=AZ#m){zcDC0bQ#<?5WmWE8!>6fjx-Fr20>Qrspd}F9Pw`S
z#ku7rv}_N`LA#FY1G(cPR;d<0zCP5xqkR=pq9@@o<k4G>e$K*S?5Cri2vB*g?qo-d
z$%ii4S{=p+8=a;17EL)&?1dHCRM63ZsSC=1TUE2pwVAM~0S@gKt>o+u0joBP)N=Yq
z*ltGe;!cb34XN-X=JEvq+E%W4u~?q@f`yk}+B;u`l<kz#xj(;aNyw5PFvv!Smn`PP
zM<wM4u>{YkC+#uf|Mu~4flow4Ol@%1y6?MU4N9ytsgYv%92+y*Rn`Ppq=GZ1xlBj-
zo1wMjuVU_LP>z7$OmZc<SZ0$I1ypj*M42r^EJF`M4)prAa#btI-AX_88Azq2OsP!K
zb@6neb<@f!9H`nrOe+i52Ac-dM##xEkoI6grqry^=|#;qxsbJ0Eo#x32*vamBf|=n
zKbYMoq_zZ2g;goHeBDTw7Nlu9jt-UdZ&V*%SlV7#<XKz#D+m7=aVE~A-eM$Mugss=
z7t%BY+gOY=L}o9;tb(sXuR>yjok0?S5kL@t6F}yG<xm?EMfMV2rf?~AaO01*E3C$s
zeWT}4LP$84NArZ#`ISAvqO<ng5{A|%cA)b!hTrkqiUsqG+9ozI9r&*s0l9(gKri4U
z5T(|k+8x^z-CU;?@%@I*Fny>Xh1fxRpQ^H-+vkYA$^#tnFY5*IgS}rVUe2X8mv49c
zd%`2FoOW!FjfTx<GwEVs(mrYi%#!j-DG^{;{6k8v9)Vl!h-1mFlmM*{M*c76Z~AX5
zfDv7bzIs-ZD)`zU5h$iDv~~DQJD<%Kq@@fF%6*0uovdBN=2#=ux_Y1!a8R<9s66&@
zD?MtX1{SfNGOZD>1l-JFT2Mr&k+)Je==o#`v`?e)M54}JrQ4c_Lspi7M|Y-UpgZ>z
zPNtonrz~6mtIj7~Tw{=YFK{a54Ss(H^m%BoAiEkwM!YMfN4dGvVA@L^*h?xWUE{#<
z{;DIr*Ep2kl}d+=Osd<!__@P?=2)QA#W{n+#TsK^T~0hIMxOK9`5dM$Xy#d2ZSy6|
zm1~5DOvKe)^TWclYGygjp+t^|N-mMihXuDzBHsI=6dgV$Ggk5GTV!tTPKoW@(%z8R
z{ASf`Jw~Zd&uo-my%Up=;gSg#f~9fWmTDI@JlTQI#m}3~=)jLt-JRdT%p^Olo1IGc
zA_$c52SsCdBD7fLOE@R@kdLtC=EitGj>LciZ=2Jej5y^yP;5~U(csaLGGH<gGT<^a
zxqEtg&MFl>s>QxY3<{QgY4A_HlWscq6@)&yEk59dX|*cP89(ga)o-f@DAmSm+AT9l
zU<7RSd64hk5FxTC4x<Uk@A(EI<`$>T;8`J4c^xtqQoeY(E5!v^kjb|UN$_2TucOn)
z*0A{34Y7I|d@l$Y%QxjpGRKkcRsP~@V@MHrl@6$!D%+9ki6IjiC{Fwpz9_Smbu2EB
zEVPIj+cU@k%Z1B@%0<eB$VJG7$wkRUbFFqHgp)YiNa|H#Vtq9HS!JDr(du&OYpt)j
z*}HzPKDKia`v?rEO*R+h2Pt;(V*X5V;Mj2{DxvZzRqeM$k6A#kiXpCY-14-`rF`(@
z!yz3pkZ4V_{94ECTz#BdF1@piVO}j|ppv_)danbNA}9E5$S<M%5k}-C;DzPI;YH;w
zK#t9og?_5yD=IvOI8rEjG5pO67{De!kOGbXseolbOW*+zi}7i73nc({3ZN35nI4b|
zekqn!u1JJOQ<fgx9yjq9f{r*kE=Fm4rfq5_6kNSGbU>N~FSNr0TO`?+jiKFwe}l6q
z-eWZ9@ox;2z|Ac%mRf$7MZo;Ak$l3~D27-7sS}|SzZ0etyA$P~s|nnP*M-6b!-eA-
z4wMZ1PyYue&T%<Mi|Hd?`lNWVX_D=$B~Rp+$r@bbD`yME;Fa@Mk==DyA;|VpT$k}?
z<2byRb(DV$T9MY~2D!$-3FRtU5uLe=#&Zy|fN;Kabvhn=GTKDB)M}wK?(1v%6pAW|
zf>tR31T&m%$j59;-{_FfJO#VYp+GUfln@$774UonL1Z8PYa~z>uqDJAat=HnQ4qBg
z+DG^r!WxF$TRuuHjIeJ-^IVPVM+bSDBM>nZ2b=}Q3Dy{*7t;st+6{ySWC+y(_XcZ#
zF^25L_943V10e$mLh;rkGa%Aowh>+(fxkn&!LFdTp?e8@P_K<m@rHkq%>DmqK5)zv
zk)G)T!4Q0!1b<vX4ugc)gD2IRu0P<qWOt$sGqU;nRIzMN(#U_=J-9Gp0LrtV3(qw)
zC=QsB3kk)qrH3>AU1++@BaFoDBJJ3+^abHs3uF&m3v~wDf$IA|*lZ{Xm<Uu56k~;+
zj_;N}h|IyEJqFa{UmVW(-M9631sV>VT%v903vz3C`CO7Gv}7&ZJ9?_T&nLp131mNb
z5aK(^v(Pmxs9(4I?@PR4*U@kF1rhRh6<|SVKUgsIC(JuhrX=3y&m)o0FYr(3cY;h=
zvfB8hDj#LYa!8JlvXHXS{~}T-RtQ#TTF3;cr74!FmT4QNk%nb)X}RTMIgY=uE@C7_
zC-xjwy%6-_dNMRBP1Px_2XZ0oG?dke-9GDC<`yA>@t)iaZJe{PQOqQ|1w}uhsgfx(
zD{3YxrWi*Ff&Jeu?nabG=0@U1FkO+6Hb@HkSPL6(`NKb?BYX*=k>C6hip#X39Dk(#
z7la^kz;hrCzzoVI4b-%j6jlVi_|Gz}Cn%w>0%}-OxZ$vC*-V|8On@v<Y2vdXf`QI7
zQAbS%KZlx?7Ep3mIxWTyKV}RLgK?kOdAClZv~3#yi%WF%@@UhA?JcDpn<IqLTb-`g
z#4LTyknDUZz7W}26S+9csap1lu^wQ=5a)2`Q0GYJ5a$Tz>F8BH!as;See+w~9=0(>
z4sE8w%rIsIa+XKi%1<CPuo}N@c)>n`JwiP~Ji<JJKSDqLYo{n+C{QR6D9SO1!FL?m
z<$<HIrl-=JerS0mk5`=~&Sc_m>|f{bHgMVQv@W<Vye?2KlrESq9*xhYPJ{%EV&?#c
z%_)*5Y)lyhwb6?6Gn@QObv>!9Ldc_Ay_5}|xr02B2t+X1`t&0lFZf?RS~7oWn%OIV
z{m>n)6P^TdeG34fFneQmzG+pvYH@57=TMm|Tj?R~Zna`>&0g_-#_>bfSImZqbr!aa
zI}~~{(^P0|l;2fNQN_T^(j`n_a=tI8!pT^8^jTQFNkUVx5DD>J*GU;iV2*ZXZ<>bd
z0?f0k!|j2Kw%pMv#I~c)#wk%#;M31F7G8@SczQ!rRW)+OhB)?%>Ugn+>y;8^lnW-F
z_o?yK8&1PsP6;@+i(YtYZ{0T}8Kp;@Cs=ZmOC6Lm2P1NhN_LELGh9_2lz%L!6Ac_P
zI2C0|Wyoh%OOXMs3%zvJRkA1*>=2K_drDp$0!k^yfKrb5_m3n@38S?7QIA3Isfa7j
z2B2u{Sef4<(+!oA@myz7zWdpO;k)0jVvNrY#b<>MW0TPaoHDDr@uiJa(!kMBl9VdG
zd!M5>h==WsfFlzA7sxrzyzM+PIhHO&(znb049Y;{E1finp6VKdJp1e)<D5SQD*0!D
z`#dQtoPI^*3<T_xjNbNYkuRsC@fAUpGAzh?SE|6M1fMbC9vaTs`9B=K0hAO3_>CN}
z;IcREDQ9}sS&VBj>2h0BMrjVW&en1fePnVZ_KO*S`!ebeYPpZC-_S|B$b0!t^g??T
zgWRf|2ma-3dlXc*O$yl;fIc&ChTFK01*ZMP8$`X;_sbS6+qq_mH~FThe8cQ{WD9$J
zHI1LU8qAKIRV9>x4RVoXVe+4c$_k_-HTyVDgJJtEnZugCQhQh;>8FGQkD9T@w$gM^
zwnv_<w(D6rl&|9H-9=XRi)i<<P8l&7&RSDCt>F!;A}}5q753iIm_t3lT0PlV9(3X#
zHU+Tq#%}?IzmKf_1lf*1`Z>GIx~V(hEa5*+@Z3NLIh=MmvD9>NQP$G3_<&^D{ePk%
z`4F7ckoyn0V%3Jz)~NCQ0v9=+uF^O~bgJN70=s&xk~Z>_xoMXk>{h@^TaBl=)8sq}
zH^mMO!Cy_K?oi?e#C@UJ1e@rV3oqUTH^x3uNU~yloU~p$!AgM>wGC%y`$ZGLa-pWI
z9UYC&>(pTY7YYJbmkQkl5!T!-7#+?}`0Q430Jq&@6Z45vmOEVsYb~}NIKN8tCi&84
zxtz|Fs<+*u5x^rOi$W?uH-$K*$e8J%aqQolBK}>65u`)?o|1E|a)U8Tdr=CZ-m6L9
zQ>B?uAV0JCor)kGg?>XdWm931%*i-<c&<j3Mo^3Tz0PTm3~*mhJ(EJYia|1!e_XPJ
z&nWTWj<~@RL<V~n;XfWBljh}xN;>jeh!F{6^vvud)(HPiEC1GN&-8yy5ky#BJqx1t
zG~2E<LITT?Pu3}dR))^)=v_HX@Q5F&qLRv80+Uv1)_0QDHQ9`!T{tj2_8?s=h>VbC
z%ub~L*U;>P>w@LN<%0Z=X6Cuuk6gh)ywy(%*L<0)qK$xZne$$+YeE$FQcu2HHyAbf
zmlJsP3On=xC=f^SuIEr!wPdR%%#tv(WM41ZID?e*I4{MC65Hs*1@*>e)v^~VKVd+B
zfj@yt18G#*PjE-Oi+5w5#h4P-j6q$hlZ*te2^QfDoFfZ~d|ldsewgh1_&!K+l+gI3
zYY=xS;fhB@r~0%3JEnY3^D`Ga405P;=o_O`99#<|sg#G1a9KKR2Rgyz`hnR^To(*d
zOX|G&l?|F+8isjSf?l>N=~q%DXOQO@caWMo2`#)Gf$UExtck|yx^=;Xn;$;^OYF6x
zLJj0ikXe{nv>IV#%Fxxp*Y|XQ(f9`gf9EOSIVhJ#&DFboP8<#v`K*|WMyd3d747Aw
zTUT{6NEGc2lH0pV&t^8l*jmT=J5J~s<6D>Fp$^F0`5@@F-AePWKo15y3(k8qlfo2!
zAM<s_<RfHkt~^p^UU<h`8Zvf_5}d1)Zs*|!@I1DTw_8K()cyGy*J-)`-{cdD2~$4Q
zvXOyF&uq!ARy!z)v4UyH=8^em&M5asgAFDDQc|7Jsp|aP#ot=yeLK`H%4x;j5buV^
zFnL6U6W(FEFk(xUGLkapRdj89D<l-t8B%-U+@G8O*3$ksjl-cZAj2b;+A*cW;5X-q
zl{U_d>AfhRWS=lT+&%ONyaV^Hx{TfSb#qI4tn=S`FNQi*WX;PZUp-!olA~_dI-OBj
zsWUHZ2h~a(Kiw6v_NA2cFko>qc89(lx4(<qE3S*1_`J#@Uh9*MZAxToGT3MO9mn8>
zB_Zp}km0Kfc6WU;_fjlY2eA#qIcJbrbmj!F)Mx1~#%V(|R!8Cx^L~+>i_$aPV1i&*
z=hm)+QHP|EKSnRTXD`Dt!yw)0W=fs&t%qexvyV5^sMsXt3VbFa_-6qtcZL-`>4-w)
zq{W|ooS)XPxY|5pkg_+Ukbx|#8G&JMTwE?sV?Vdf2}b7nx)^SkXO%jQ-Xr|aB48&Y
z-a6r*VhUKx%6a|R|B4+FyZ^8+Jq~bqW(ISDc7im9>xJ`Sa}l^k2bDR5kN=e7?$Gu>
zcqx`he|$Z2eE~{j**I3-xMxv3l2J{}td#3ddluJW^*c^K8`VA=nT?W=o(aYqM@?j)
z<&wce1{*>N_#|e`#0vQm7K{bs0`IP-6{x8+1Z$z1Wte3eOu&25eXv|$ukHSr1oULv
zUTHrmd`3O_U@7EQOoIQovoM&+B5L6ayj*QgPt&c-jERH=h1@x;IxT`PE61SaF;@&N
zA!9d8qUOg#3TM_M6_{Shvy#XjzN4!5zI-|Iq;>37+;&t6IwsTBxqOG0oiVifk$q4<
z!29ce56l1T^{eJtJ@k|)Oqu)f4E5zT2H$S9LH{P_jeFgJ)N4$v$En@<AY=*+x+RBe
znO&Y|jqdK{lkZ2crE64j9G{SSXgq*JsWYP_z0QI?9OXCygBo{Q6Cc>@Pi4@5R6DRM
z=xx}4i{Jm4@j(*6=+Hzk5@=!Uz!x(cBt0Qy4g0sX6<Em2dAK}q4e(RlC9S;7B`j}R
zqTaDM7SGFr)2ag0NA~YOu!3c$pMQ0s*2QR>VVF~MhifsuGKce>s$(qf;p(b@d4m@~
z2}1|qKO<f1f!u*dp*^82U?v_^78A7ePxL;C+1*YZ)BO>g^%*G&30>wx#GBOLgt>Uy
z|Fz)tPg7-Dl1`_R%v`s{gLWD!15Fc_*Eowxsd7xZO{mqrX?Vm^AB<H3{(}Zft9zZm
z{L}?RrzC4d04>Ydl)~{vM(95~!WwiBm4eWV7F00uGygSmd$(9J{Wt;w6Q{*;J&+yU
z!*(Ga5R4>?GD_szFiPS(EmCi3lvAJf<GzH!c&4`RJ({bwU2vZc(3c}lS!5N>v!Le;
zzGL;P&gs6V>J7tk8p8k!?<Ef|k3MlDqSC==JQ>&bxLP-beP#x$t{)R2$eRnE`)3*+
z9ft+#Q?7p)wGq7>PB+Q#$QzM%1<%38>o;#wKbIEj9kM%r#gu$2vYoa4xs9JO?WY6*
zy#r0FUs(!#$LYaqE0sgchIwHXRpvLja7KGi^S`ekMZkjK-r=6vt}#rNw$=|IL|_jP
zK^ee?kpG*Mgor={Lwq8=Lq9WI^MI~^A|YQepYZQ0_XBgkDxMp1X14@HqvyAvHRHPw
zd39MR<k6D4Hc_@RaMR<?^tzVgvf|hY#pd#sNqgyVQ;p8!gv0yQ#2rdLBVAv3Sd*(o
zWDbAzQa?fEIA8p=Ecrn^@X+qW<mpC2xV4no)0L_@$%2&$qX=sS_P_0-Q;-Z`|A%E1
zXa_t6;)|kY!cRjSes>xla91*Q5`{g4gr0|8g;<4I{a(kNSu?KOJQh9C(3#;^{0zYn
z$f=_IN+#jZRR9-n#GDbq6-&x>BJ@xX(4CdaPOtf{ii51n!X;jjm5aZU@|QrC&5~`v
zX#rk3ZneA_#{`5P-4BCYUHh%oa*SjF8^UhWx|@c6>XBa5e+8Bsj2ns@f*Xb#oZHfI
z6Ht@xy~{F5Z$RS2*rY<;5tKX;B$m5@%~64OYmedp?(mX$@CV_gP1zGEHP!sLe=_7!
z8Q-H-|IY-gAA<Y8$x%_&VX=8wb?a0QYR8b<=y!%6mMd1%J!8@H?12%d9zCt*WD=0d
z;Ybq8pJ}%3Fb*IknI6bTnemT3IHgxbr`!{e4V6dwDqFWC;J5+n6n}~Tm5m?jL%g($
z*)}t+m7Tx1rb<!j#fE>!DG7z2^0{xC7Od<mf;w3Mc@C*;OVp7wyix%+w`son+&E!4
z69khz!9i4F!$_FNEs3L%sf87qm-?*@a1y*PhUd_&pzmn8xytD)=fxz2x|?Z(pY?5=
zLlGW|;?R!+PJfC@$R;`UyI;T-Q8*UvnLEuNw3k(!924=r^?9D}!aL@49n+QeIFBE6
z-e{~9Gfph*9E2zB=?NoFU#KVKAi<1b!e&}`lr%#`R3k1rikYVCLRrTL*i}7%@<M4J
zpw+mCom3+>h>M6)stUnwkpke6t>8C9^-(2f+Z<N1NTi<V(E`=Bl!wmxF~Y{4egqKq
zj0@_?`D3Z=CDXZ4r{Z1BK1wB&bjkT5<fQLhA&~bTO%VGjuO5jcfZ5sj$>0Q^zgTJn
zkfcxroGPGetoIrLU@UlT>%1lEyd?hA%X#;dHd=C?*vk10Q(d_IlR00XyPM~fyE{W^
zXuV{>ysbE!=nBe6S<~Bf5#J>J%yD={5p4preDaCeQm8+!IJ4@{B<pW6fYUax+1%5?
zY1wF<cwhRLr|!Z+=xfWI%MFC;OfD2E9&(<wKPKx0tZKwfy-gE;{1nvb&Z3%ZPIGRl
zS-mNACp-LNmRk?VbYMx^ZTdAH)v?j>>CevsfEYbyZK+U)WwM1rWGLRo$;Lu_FgW&R
zo6pUTo~Z5qw<YT`JzOkpN%bVuFw2s)=Q`n(+pLt6VVDr+U|Not;K#sGjc1R)_qkqn
z$xbV}-3fKNgg!?;hdf6-hdsYyM}r8TQ-FA)nBGJfZ#+yIcC4b5K#o3l&T&}N#w;*7
z^in}(3>`O*+>v{Iv!&npJ^3V<9%3EjGH&Mq@;ee@s5vBuFF>(VFLO(vFi*~2)hvHz
zO2MGP!Ha^2nKQxFOxCkIK4OezRR(1hO_ouizgXC;Z#^2PTD2Bh>vOAG7V}p!Untdh
zbo*v3#{5b-4f1|84#!-o-GMc@qSz2<>O-}>S~>8+3qfQ1#tX-r`4ff8U;(%j;Qa!{
zalbya)5Q?(dNu+RJZ2E(O(()uXeWMEEo3;7!)_C~jQW5SPG?4;*^S^?I56pyM!m2c
z2kC>%gS&SyWMlM~K~wR|f#?<?)@XKpIritLrPxWmi-v{TM2X4qhD!7#8`Hi}Y(T$s
zA84!w`(Hv)iZj;C779gd3Kbd!QCDwWIT3g#3!(+tfN(*&Al_9I<SwyiX>9X0wdt&N
z^i!$0-|D}<XviO()W|&yGJ^p8twCjS9;Z^FS-tdm0Vf85BTDhDW_q-WgK3KR&{M8*
z4@T-!zfRaAi`MyaF%{L;e;kB<Ry()XHhcaEB0<ds`t{qPAz-@|eLIM1NVbG<Z*hch
z52orJHHai2X>lp3doD2_b*3Tk)$3GZ^@PzLUdGdPNV9gGW<eHz7E4x6rT~0aJBCs&
zeB|l5D7=Th4y6aJ&oRS$3{Izd5$nn~bkY6tGNt=<Ret{&T6Ul1#Gn0*-N^Mh2~)(i
z99!;DTgZKttfM%q{0*#(X@>h>3DR;isFDngC-~<esrQm`4=7oRziXCvRVl_5#HNE#
zU~et6TQvafc8g2^k2pL8_d{iFG3{iGeM!ZiDIqDL8X+1R78^@_mB)I6t@EQTc=~+r
znNXg=UG{ecrLU>xkEB+hBk1!ZLM!jA?SU1~Iakt=GmF6C5r!;BPA13*SeG=G1*#J=
zxkW(LciMK%Csp&pgc_>(q1!T<^012;B%7~mE9orYh|j-uG<Yt2E_80*sk}rH#n@)J
zm&4YrPJ+g#KSll{v982@p%zTPj=$o)HCH|Q!G<9t4hAkq{^k0y>_lE)3VBeUZQ--9
zT=yI&T}<X&)?tX4f1J^uD&ef~_5#FQ*nbHPFhe*)C_^N}Vt=_mh6ikSgi39$r)5<O
zD3S=B3QeQcf_Ij+mgAOuF3>Ji*Q_A=|FKbU8>fP2^u0_U-I_kzYiIP7G-n0_Ty(my
z<?77k=uWETeYd_usolG@Q|$egH4m%SD9Vt5L!ktE)ejrE<?O2>Nh&UL7>UPYD=x1F
z0xh4gHs(jFv*P=J#?LA@V>A4h-}|P^+?0Zbb5n;K5!4$<f)GBG*R-Gopn1qxvy}!p
zu_vg#i<<*9kmpHP!yvG=v=GiL*VBybCEEdQ_^sXGH7dD(VLy1Gq!l=%yaj3G-yJ)g
zy9khTG&HhNZ@|n`V&Q0>l(rA^C8aZ`x2fC<r2$ic%7+r%=<+@^3*XE+q=O6mmt_T=
z069XeA?6_Rkp*FWn6Cvv*q|36Vu*o;Q4R3Es0Oc)A0rvTDkS@T@yYaHpv<FveSC!f
zc%)y|8`sDY{X{O~zMA?M-B=5@`r~a{3O7+qCSWa#(vl*G0DoT`Bn6BM{T-SC#sX~&
z(<{iO4#V;VrUZRnmR4<$qV@opjQU&QRgU4q0xhF}fj&z40FtNCYV<`aw+Y>{u$4ep
zqHRE=c9>S{L-10(71jV@&}a<{*GLDV0pb$O7`Ye5hv}Lh^Z+CX;el|5*hcD&3<RAD
zTpnSG`OB86%dYyB7YNI#8(%_rGSgj6tv}LJFFkhuj0~Xl``(SU(v9rnKP+5`@@P9b
zzXEYCd+=SnHsTrL{lb>vA$xRs`KphCON|-f9ibyI=|{1YnC8%TrgmlKicyg+!$N|e
z%Tf}M5K*mgIUj;*a@?T2(04N34)49JQ`N>dV$d((TgVe6379b47JLBQ^Z%GON`PY_
ziI4?gmk`460SM2W*La{7;8DmNq&K7qSRY&f{4@L6vG|*hn$0vmbZMMwfEXWllfzh;
zc5!u)Bxh4aX_Hsogfe?aj#>6Ga2HqyuPKmXhTlVteRl7KO;Z6!10ti#myS6I7oZ$b
zuoN*gg<WAcG)-xOSc7g)BQD$Ps&80nzD5v^(9xinj<o#P$wCzP&50xJZ7OBWe7-7_
zjY!c2qd<MBC+D{sf8XVcbgg(72YQ3{gtMUXkX_LHGm{k#QR)*u$fISU&{aN|Sz)_d
zksY8VS$t+(lPu6v`VZiU=@?{!wQ8C++pTmaBmpJIT=B*K_kQ1$i4mhM)H8%6>=W(U
zoEtywpTTHjE7hKxXODjB8h$qjp*D{5tm~4y#wv?Eg1`c?b*1AFQ5}-wn&wp1;J}ks
zqe*~_l&-?ZWo+o2_4%kYyW`Eks6z~K|KSAvPkHJU`v<}a#odF;-2?621Js??8yrF(
z)SYL|%WGy37UI8nl}Scw@5K-7$%_P}C2_ex4joH**ho69A6d_ot$SE=g3%`teUfV{
zGHZc9kDNnxn*XY%)BUn_{^dZg=4Fv-iwF2Q!F@q7Un}lFCah!817j<xj(s73x$h4`
z1;WrCCi;B-C!P#y0PckROCbM0Y@KCL9BsR;fkA@1yF(xl+?f#EEx|oF1b26LclY2B
zTn2Y{celYE4(}&>pE`A_tE;EFdwxw#*Lv1{t<?~3gb%b}AgELABX~Zo)_{(qEJ|*#
z&#8Gct7XBQESgqkeA5|gMKNZpO<&verpSen|5a|;^-l7cEXq4!=En)$SB{1`Wwy6~
zl*@y%Ggp$jdFfVlMWHNNBes3|zuD~O&9n8UEH%xm9_Iw%fQH{y2dD-l3S3XoqNh{e
z7=+T)i~2b)M|vSfFl@iniPAOw#rRXVO28IkZrJuGQ~-G`4rLS~>0=g@1epYr1W1BY
zflz@~fuiwE^!@4c(|68i&X>c7<SS-MVKBg%>Wg?#$#7qhz?Tels=H6(b@feqq(;*N
zY#zR@2Hd5etDXB2#>Hgqd^miYLH~^4Aw2cI=>66s*3;G#=A288oc>{5JP*BQx-{>?
zb$a`9-?#pOax7HQlWdG{J8XhXt9jp^jW+lOqsprI%4qKI)f08?X6suUeWU(5+n4us
zy5~D4EQ=n|arAOchI~N{t2*~aI!HH9ROz_=j=rKre={i3j1{UqNgwQeS}9~E`xP?G
zm~|Vk$TWUSOQ1wy!EE|_>U^pOW7VXRvr-LNpGnfStZL#857(>-(^1Ti;*2cmvO;Q+
z;sV}d9BpcNok^ML0j49@WQVHsom(ceR+_&O_Ef4r136pv(hlOpig||a9VHjcFgOqp
zVvU_9*sNk&%gMNkc?8s$)`m`CxSkDLlv~}>e*6p~IE|CDmlSX2skD=f*P6CxI{KXK
z5GwuDPu*TB*-39}o}7@jm5_y@_Yo_wn%+>S;-P1k3!j{^7`VNeEm#r>4(P4ui!#7{
z%1_XXp^05ncd9G&E5Wq2xhEa{?&TJyPcJ^18%Lt{V^WQqwNiPe4eMv1%PN&Ve_9$O
zpW)ygQ)y>v#k&KU;lwJiGDm#+jCC*MCzQ-IY3<-WEF*If*qKK_1rY;O$3p##n?l~D
zR4Y;Ioo3)>z0VX<Q1K_reyVY<DSxJaHAheR{4O_A06MK$)Z)_<^>^V(HLl2tm<swu
zDA}dBiUgQ>Df&RVmx`<Swj~akf%&$&8R8xOVMZ*%#nd?Vbw`f1G3xdT$qUKp;<TGc
zs@ML4xI#Eugx`s8g0jnu!fRV`;|})xOUN9G%-_xIIxeu|dTrcrOXc8ewWjxf6u-{5
z<a$Xt9?MuIpCPnRH5hQkgzuHG7uRUC7ATp?X}~8te5n5z<En@^!Z?RYY2IP#3R_7A
z?de=IIo+2EN!MDfvm4fLj+9Dk4t4Hc&X{T0=j_6?$s%ip96c(s8v6klfWu6z<nq&V
z`(KG8HWEkpa=i>|3M*?0w8q?`y617mtp(&v^i>JMpNl046U4Q+wu_mL+L36tF}NO6
z3o{U89qozE#E8y=czcoO2C1=|&;tq0{f~;#va6+em#L?8EugIWigX;K)M-530vEoH
znBt-#AV=J37Tf$%F-WC)I5<+rr8$!98lmdJ`*cQz+(R~eAxX#5ILZs&%sb5|!#oq9
zwgECVLN}j>z0vZC4B`I)&GGt9;NnPe%2<@k{Py|nd**ZIOFaFiSjCgq)o}p={i$c}
za^lKEoB{X)TG)l@!?x!m%1*UX=e|6u8uOed;+GAdkB9(_c%Xh&P*y90lqWqnDwU2~
z5jsUMjAa3r-ybW?6@}$v7w5}Jo-ta;4k|(YO`~+Z_L%%!Fn7>}xYb<MsMXdQ1=LJ^
z446DJ4BCXBj|L2GtGV+9-t<?_wBi|DqH%Qzf&%aBeJCx);ZJ^{Xzd3^8glYex9V#E
zIybH$)J#9Wz2=xMyZtILTFU0=V7-Qp{N!k$e#A1v=TbVPW4C0_iArUZ!;i71cG@U2
zHz8mOd*9CZ)Og>oWu3;b*=U3AG&u)B;*-n$&x!<(n~Hm&@2P;IgN`V6=^)@<z(ZO%
zcJHg6y$4Uv<tl}OVc+%OrVR8j9e-o@H6DL7Oca0wfe1C@|K%kvJFUx2J6Q^eetQ~+
zy@b1mb7K;-{4dHt+Vss?Mba5jWj;-Qq(4J`j)sG|NsblskDZ<h3t;89|CvQv7j?NA
zt{SXl%7U)Zo{|b)ckS{XEWr$LCczDykY@SKO*D?ghPsL*gxR$a+1<a{^va|=)SVpm
zonq5q6Jt|pv$kH~;d8m#ZU+J-gT9vOPe${1zgTqwQtv+h_lJA>ysnprTy^_Xr}0NP
zDTRV8K)U8-`apztHHq7b=H<#jM3rSYQf(3A4`Z9rVTpHXgD@j&z2e{2dfpi6d2)Yz
zKSi&f$~Ow0>^*p>R!<~{fBLZ}91(Evhh!CP<(F$9!Qx(hwQ{UOZ2hy@;Zj%Ew8S5B
zl{|73K&8Q0E{e#K#yK_J9<N1Ea22j6S)h*snqNc3{N3D~Is#%Xfv6fl3sGxej}<Lt
z{*$Zi-j)qgBbm_IG8+sg3olw1tG!zE4=xB)I4fu?C@WYJNK0ZDvw>?xP`>W~L^KQu
z9RIq27Hpiwa6tnQqc35M-h4+J=MdVfhr&Oe4W4O)+CM8~RSqf(i67>ldY1o6T7$wr
zy<#GicWrTwS%M>*#g6l^Sf2@sK&|tX{`QXhbpv&G#l2G331_gx-%suh7Nn@+GEB%*
z&d8QQewkI015>{y``?JzwpsQW>IUAcwJuUoBL?P>^JqL7C2x}Ni%#R}rg{$`CL&|%
zHg{~l-m?!}Y{Ay4e?v;bhKHfUtrlkBFSZ@}fvq;Iu~(97M<P`Z<KhJp>a|%X0Ha@e
zkY_PN=^(A5v_ZSjgKK?u@W_)arDIE1etDr(WtM8MNzh1ug*RkqP%=vc<NCx}W~hsm
z<|nPAF`Pff@T<OY+Q@A*oANB`%w}w2H)A_)bFLcXpV?hKh_`i6+sHR<$X~}nOdw6D
zam=jN8Z8ZiID1xcH~jvf3?8na`whyuwM0j^_?`#q1DZAF-x^Gc<Q(2;OR=sL_BIc|
z!w}%G*0qe}G0y4F25EA0cR2HP;tA)iN2^T%kh|}FvtMh8*_XT3@W!aC7p@o`*jfeU
zrdum|DLP{t>qrLvFET{X>0RFH=$E1E(cc9jJkXl#Q5n3Z_umC}83niCitqd?nhAcX
z(tO9}-0c~>{+Bpbd&6!Dgyf+P&vG}#%h!pftf2L2RSPr!y&Es(`<Ziv!vJ?B_2kL*
z{k|c`*uGQMT-w)NQDB|0h`Ss`)NPCdwx}YMEYo-YMDN~0t*{eT=}(TrfY~&D9Q1sX
zYa2BE`lVf?dYbCk!h-gNbau;<7XfhPV$`F4fmQ}aL~3qf$7naxGx7(mMa;I*nlLTD
z2#w6PZ8`glLkJIRubuOgE5^<f{pJkF#AgC38*ukY?G2;@!UgmL)AI^ZG6$?~6%h83
zAr=Pr8Q2EDp``HlplDAzTZOn93v@12WPQIs*?>v*WpKEa&l8UeV;`bogiLo*HCvuz
zJd`&UR6S8hoOUeXyUl!CyIKYYswY^AFxAeCrbNR~_tw1_OW4TV4UU+usQO7`*WX#V
zco9Fqf@L=~L5=?5xB(t;6Bo7WpObG#Y<TEpl!H7|8!9P|9?2C<=n`OxbCTL4R<!t<
z$mqGm=|-MGUcNNASwJW+q!;K1dNAAO0qE^{mPn)Cc`O&E7EPC|8FKJVn%^7dh2TNf
zM$tzX4zd$&?*pg#U+3B)%|h=A?cC0WOjG_6-=&C?H}%|?ESN?+$)@)?B>G^3e9Xq2
z^+y#Z4B5t@TP%B;gxlb#*ly~=MMBKLumBp*Ak8!K+_S*%PV5}i?cv94pVyy0Om}l%
zv2yz2JT1QUsC868zgGT%CI<6M)uY_BR-)8X5htMBkUrqNA-`ZgkZ$UNI(<VOx)W|*
zu{Igs77&gPmr}D)aNL7NW$7p`(<o<mHh#wqvSMcMZa(EI+B=LJt5TIPk0=mdC}Qp7
zal0USFxX~l8-=E*M^NKpq!`KWY^4^#2H273MUuLIesna}_@2@sa%7UGZIVWnqC}!U
zl^_%`d-M7uPO^wfDU2oIVMNlZ_yN(;V4<K&$&v(L!f?;51RuS@TsFL4w^`*fRAgl8
zJ6C(ERj(w|(I;8naRDXIJ&i@xTsd3&wtoKB)$NwXW((^LxM}pcwTX~vuimk9v&IbO
z=7Q+ew}<XmDxe)@$ClWORQzEEjWOQ$l`Tj*<QZq)uK+a!H3Bs;@3QwgfHLbD=s`Ep
z-dRZ5gu9h&?@v|0MS$_RgVT3=6OtFX5=OybJJ1yf0Tgx$DDBr?r+2Cc)?lY`&<>N5
zoEi@jeI{?Gs%EW5sQz3{P|aHnI|(p8e%V@|UElZb$1U73ePZtTHlr!RA^6#~2%>}Y
zPi(%#b4j0IhY#~Dm<ltUr>JzyvYGH#?%-0?o=`ATbNL8U*kLj<)ks|h^Kpxh)`mvN
zZuMCA*N>he2n#5CU)R&?67oQ@BX%ZpI{Lwv_Sc!B*z4E~h$oQ7QKfjCrKSP-LXsMH
zOzU;d(VS6uifCw54J&@#d%k^DDpKP#v5rWfu3=$oiRm;l_ZP8g$WjRn%BD*W<<4<A
zf%t|Ucfa-`ukdtU3DFtW7z{+g{537^E<;a$tmxa<ru5;ROJ&!tiWfvt)klWW;e#@s
zp;7RNTKJ3(+slaTYgHa0J+@NDtkCDQ+3VHW>oBI<Agg2KaHd<~)qhT2WYf#VU(=3E
ztTDP~WfV&8;xR991LElE-W?hfidPCp^PbM(?=*&Ejbmpcy?-+*J4Rr~d{JKggw+;C
zppx_UteJ8+ZXg9e9E@+j4Y73LF|*629UX9;Ti9VFJx!vuM8Ox#awwSi0SP_-VOfZ0
zJNWStp()i~{n64ZU)Y!~b>VMUoQH&SV<(xZjZw!@trMrxQgEB*fMttY!gVC1{q3hh
z*7ha(?ElLy{}&sB(yWm$Yo?}~d;uBa_MPT|$*?u_k${MGghF8pkq#`>E2);dSZhxc
zjOQ@`(FvP^!%#7)FIZpJ#Tp;h)wBBE)SM=t@VpXG?<j1_X_uE8BhIAMMx6c{J5Sxd
zJDH<er|Ii>1~`K76-D4`hg4eP!|AluT|&C{S&Qonj*~4AX!k#3X6}o7o4rK8@pC0!
zZx?rK@$-+iv!}vu5CZk>V253<lIUd0TABQ?m{C~|e--`%l9Zk7RW)d#TeS26=ykdy
zM=e4d_AP+dj!o%%;0N__j{D(}wf3v4yp<`^6P(Az2hsU^o~~*qOaW%EyoKgcEnHwC
z-`bD!h-?J5&*DitAvclgCdS7_%4O`>VDT`?d|7pOHljP<(jpHP0j@!4;s96(d_!Yb
z;gHdCN{P$kk}>e+tqa%G&M%tJ_l&=5Ow8acCoa<d;tyzbgmLY>*{0jV;J5-QjHgFD
z9&1BJV5_>PekXdY_&8eox5J<N<PrTBn(J<;^Kg!{xR66J_^bH$xL*`$KYs66A&Ey7
zr-1=s4q5HfDavVASSi&JO|_VxWxg8v@2li9&LMT$bJ`^<`@k#Zs0=sAj|d3FGt@KW
zGXU=2eN}*95u!!`?twUi?Yy@vnRr)&rfCf>H>ywSfzL%J<SpIo{$T?FW8#GSW=4KJ
z3JqHzbWkiv5i|v20o8zPLBhT}zL-9kzVUuf=J-M!X(RSrDq4gVU+wRAA6t2YR-fr5
z%*`hqWDXUUpRr{5D{glm6WxnSLT1p7U~On@aBMhjP;8iNNNfacAZ^HP&}~?3;BDw_
z@NIZ(0!Mbl+pkjd*$VxIXtw82rSuu=u?2loi(-z&_N_d%M~6-h+e=5?b0t0O1wVdW
zLCv)v-@<?ll_KFJuv#!$$XfphM>s9i)qkQJ=-gNodFkLbd>3f2#OA-`p@_$~>a0Il
zJugEVU7KnmJpamD5Nnsh?wgZ_<t0rk3vb4&>8xHRD&4A!|8`0|XTq4M?X5p|CdxW$
zel|3;LjeESGy~1}nm|lIXTk6jx}boyHb0sRK-a#w5RK<YP=7lAe!5}K<0IPxJMvKT
z_6!^L1MPHp!QEAL)7q*cT-a1BmcN}p9uH^dYgWf(*vQwfLR^k9VMRt+PCrp~oK5l<
zb|%c2n@iiUfQim)!=0KAiJg7r9+j+%MjwqPQ@7Oda=9bfA)3W8SXG&|t3PVDi?6)h
z!)Lo>i3{?Y2{X2fP?V-Tw(D+l!yk5=iw?Ivk^?(bf;5hBER3c&=;QrXsn`sQ_qB{L
z7f0W(C|a<TNd#-gwLi6mR5%4|q*n?5s+B5MyDaXF=v)lz<TidmR(U~Y0n&`E_-|U$
z)tGn{eqbU^i>Ex{qee?VD?8?X@2?pYmHIh$Qej7y_bFFW9R56?+gFz(7q*A3^~UZb
zJGK7Z!!wK4$^8^Z&HP3@qGOJQK(8|K>!8OrHKG%;oy*AM8cAJe5FNI_ok&)c=tA=R
z^utc(PYS6oELf!ate8mYH8I}@-#wzT6t%STfsuele3AiG5IXQ}2u%PN4lu#yU(kuq
z0>Bz#y<~;&W=GMNhjWZ&6nSuaHK2qGU=6vB(1z^72S(Y<1hp>K4~*f_?Zo7<s$rh)
zQ;~sD-eaEr9+DX-)FVj6kF@g;)9_BGq2JNH4q~eu8pmbU`K1pBeRU+{Wyo8^iZt}0
z3JnT56dCR*Vq~@h+-t0e6qbPL@US3+o>GKBAj5f?(A3|oe-+Q|)jwnH=)9sh{#a^t
z&Yw7kMCmcR7v$eS^?-OFvoQfp38e(9k($_hdiIH$i7;0*PkU-wY2*|WAQC5j24Z+q
z>EV)x4}f2|!J!`z(xUVSi81_NIVni`H5JW{D@*qio?K2_z`+MBaTsRPLqTlm4pT*O
z^Fc{BZzqqq5)7YxDaZbeJkZy5n9M0El2t-G;|-wig!e#v-~<zIwu0_`{zD>!IQG9=
zmf{3v4qWG-@n>Bux|Y+oUi@<Cr3K0RW<vtuydYoV9B1BT=9LI_(g~JE<3`ieZxYY=
zaY(_crV~}Z8xRA&Z^RZ`{mal%CSOc9D2GwcRWpXl*Bg*TEEc6rDyewZSZ5sL_{KrX
zEcSv}eJ{9I@8}Ph;DZ|hm%qF7%ypJ0$%gzzG<v$}yo&Mkc?!H7%{WpK4o%2^aU$T?
zMx;6yAd7%QtO{K8MZPWStDlC67;1P}Fg30EbV=CW#CXU;Y~?P}%WpXQe!xs4xzwy@
ztaL-(AreYlr<kf7G91!5w`Cotkox~@G2(yv&Q>m^NnJd;9@;WWp@`R1al1b0RyDF-
zmw(3h9yYQ2!CH*ReHm6_#om+Vu(~LQd8cNOPOrdZNZ2uRC8Sef@VhE0;iq}?wH!EU
z%^S4TZy4FBygCNA$FxKdMXbztS<*>Bz3aJ6!zr(VcDT&9`c0vV>VZ=t|6#}nCwCM>
z5ytDB=8mt`M!its@P=SntS9vK3R9KBbz15`me!;lxYf=n>=j1%_`vDaY<y#}1fZIB
zyrow=<wc;r#sX{2pL4ZJ7ReYKW3it)aa~T$RKLq)xLiJ4C@~xG8n;e>a{j!;03e}f
zJcH@1)ga~xY8j)YUh3k+&Ey|g4O>vm79?e`C2iuCmQe`omt%zvQm2YgIFTxo8$Wig
zF9`ATw5E)&$%{CVOD_3pTVq1szDEu@MU?l7L~KPM5!Cz#eOLcgVsW4oqp?k(WI(Rz
zg@Q|n6wfFmUQ*p0!g$RT%s>2ZV8rNDc!bqmo**f#IZlK(k&Qx~amn4J=JXf+_CS{T
zY3d4R&ea}?3yyi>W-U>Py>vL{5^KXl9e(G8(8Ct-NT5-_I(&3^DwybmvfS_O4?;O?
zIZ8&r)N##aZd&ko+VCt%3Ub1!!rf!M>eS)VH#uE{+FQZlwDkr)n!u**nfADw6pJ5P
z(i*~W!)!k|1sDPt-E$@igkLm+B_xXAUjHtC!Tc~IGa?#>KM<BpESjs_(X0?qVi@P~
zf(m-eby8x(r#c(G*wj7pDUY0gBq(SZ#0zQxx#2(8%uF~qJpt~TT^pPqQ^%RS-={;C
zw@ftnUN!~1mfu&_NLSB0AcRW<tA+X@FZ|dZnee=dyT5#0pVvf`6gK3>&You1qf{XH
zCpz|T`PI8vynE`I9!K0RZ5HaGapnpacV_jicI`FzzzSG9wkF=t`dA&;?^S&6^_ySh
zH?@3Fk!7S*J!At+1E3*#*%6$1!KgU0Xgka5OvK~SldDk<h!ccf{0Md}Hiy7sicm&S
zCQ>a5mm$_>`r;gh9aw?>ff-Qs<n@^Kto2CsboGGqQd^N?f?RWDS|sET5S!mN$u{*i
z(KZ#5QZUe|J3LLNqtg~<PBpd6-Hhu@YEB?2{;=(S-Tg|$4aJSYJ-lWHhka=IQ;*#*
zI<$m&<GCikV-d|<<}i<*6GRymV@~E@5qxaT8o(L3nR@ai3OHJg?zLXjNqOaO{v?ci
z!iwXFkIN!tSc^@kypo61t1i6qw9Luk0#hyNpab2AycA)wR1Gs2+&x8QRp5Ld5FyfR
zfK()*rr_&H{RisJmgbr`xxA>RiQz}|v1ehhv!?{=D7lKs%m(9owO&t=VI15;cJ(ze
zEL38S-hF|dF5W53(sWl6(N`-V5<>sz+;{ur)!<O71fLs`5$0z)k}}G;F8gmmi?fS9
zHDmMHQa84zD1#(*oOYsmY1qJzA{aIRTkU8x#rMI<M@C2ldJ7;&4|dBbgd<`~cLVG!
zD2^lNd*zEnH7Y)X9SVEx;}0EK&OvsEw;MfpgUI~R@h9&}F_EE8f0zZC8B1=$fgnF_
zm^}ojW6zAo@g@=WF;Q*oQIShyNE5&T!~xU+<N*K|;y-m<5Xn%<kjVg52vsOlKqXWq
zY$aqROyx{ukNnH<J?z3~)A*r`)Tm+h$|-;Ov{9xWqw;3Vlu!W><EG^%(WY2}p0a|8
zld*Cd;)`35Ro1Kaz7)HNH}B3MEb3D8bOCeX5rZtRN}N>lT`OFgIiHb32>kS$J&f^%
zdR$NezP5}Z!$*&T+v}&<`~Qfne|vBwE>K{RO-WEZB`4Ob%956M4$89-!5nUWEuQc%
z-qxKf?(js*?&}rb$kV(YjGJx-`1k6PA|abkIQr3>WvZ-jbyTqlMp85a43eWetyk|O
zj7eog@l5n{kq`FW<eo=yi$AKS-R7x`@JW8~&%_B@N}+S1k*HT#Z(-eRmV#z{iUAW4
zS^ut^BHC;QUHfSI99)EZp5WdgBnKl>;6=`f`nobpGej*ll`L5ELN~{A3Csq_idorF
zAK6IeVN1)7Pz6dlFp%RQo@o9Qj+`K6^haJO=%Ff&l<aP{L|2Beq=<V{Vi>iF?FBGE
z-%`H*TrpYF(VXgC@xg`qzsx$;&AqPr$kH<ee%=3%V8Iih{)33Td}GMEKy04?ITo(n
zLClu-Nr(nNE>-s-Al6wtr34UJR~kjOZ*>V1djp*O`|LA!E-qUno>r~AdT~wT&@~3q
z^l3D1dMkC4zP9adAS9QGa<Ac%rb}DGHdX2VT#X9A?CXRAP>!Om2gN%7M+f;h11=!f
z5!+B*fMCc?e^4eU*ax-Fb~RP{jQ(#=)}xy+gsS@TMnrAWU?nVxt*GhT9H`xjuAwr%
ztyaxiYPn;$LzzZMa^$ZgJw&bqe%x=sF`FH#?0MH9m)RAI9k%{{_||~TeB2|uyFWEJ
zil(?wDt*iT)~!~JrbR7YMRJ-zwmV<OCZC3s`lGK(kR(L%w8hyqz_IWmjGZ8?rmJrY
z`VXzJ3gfy_Z8R(`3Zq{13F9oXq2v1%sH1XQ>e2HC-T~4;pbMeDVlW~Me8&=tcnv~p
z$3YNU`{}HeGvv%xJMX~$xdt)Og_Zkju0lAJnUX>ltRTPx=Ya_9x@qNHcHcAz*M|L^
zq_v3{@<aiq-W&m``cy&b0y<DU01q_aFPke}p(uS?P#)3PB4@{%F(KB28Ux`^rP%Qy
zpWud`C2j$m!CgG)X5K^@IG1f7ZRZc_Hpacz`o0#}3LQ{h$S<%DU%>yW;q+rOuFvPw
zln#-oxS1@L|1|KM*gTxdY=il&22zqS`GR)Dx%BqKGT5*$r!sEB|H2;a7CyF+xPQWX
zJy&~fQ~u~y`{-8m*wW`gTqz&EH|-y{HYgWParFMXqoaUwHIBqmkAzJU>zG7VgBmqA
zzFwN5#4V+Ya3+&|-&{#sGB3NlVmkWpCff%H@U~rQrvS#gGBMuBJQ@uS-iFZI7ptND
zVoha*C8iFO10JYc2mC>fex7JGQRO8}GZ7Ja(h7bM3(}Jjh`TB#@mNQO0rVFs+Qw{4
zVoaZLG9W9{ke#@23paZKdDCLWPSAF=XWYUZDrjQkxsblgy6LFYJC?Eec=hExB0unf
zQ8|5Pv8DqVFiT3_#lZgx)fML3k$Qz8W2`2!!S}1YbjvQG@Fa{B{&w<g(4mk_Ga`~}
z3{`45gtKOkbQL)r?#%rDMnOnTniP?O7jl>fy)30TQUEpMa|A-tqt`Rj!&iA4UWI3F
zlvnh9&pB28T4Tn~aQ=cOzforUZfj6>rltW8!(?*ZY7%<7wLRp~KJMYU>alkoE8E3q
z<a+4N2F-^!ebTx5iDL{6c}%so*-RAAASgwzL(YzJl28}8infqW&SWR7#y?HChGyMV
zAU`SrOsmR1`UD*L<b90hI-CpvtHh({st2R@zp->|HDonnHNYVxoAg=Fwiq32Y9M$C
zM1&)~G;owr0hg>MD_L%QHMUgrbc`d(D;z%_Pi1p^yGs<;R4_`wyB1ho6{@je9yC3b
z&{?k6P_8RG%ZQr-HwuT4bJ2h)_@xgxY)nJK^2||ZT%{pl%+cU!aaSEVLmHv0hyr*T
zai+5h;nSLaM3G!dLfD|yxX7%a!fR}7v1oA&r~1tz&9#I)wMMO-BPlO2EytD_yoR=0
zt{kV6@X<!GZ)M&1=oTFH_3M|z8)6#xXI)thvEVEMiVwFlz58w7;+mZ{wuOmaGrmLd
zp44nS=1(|_BB~lhIjUt2TzZQI;{a}%&Z=^wR5^Lxf5==IP5>ud1KnTdF2mcgMv;fV
zz7fb-D-bJCE08MyJ_uAuCuk=qCs-#)Cm1IH4pb|^9l{;T{eQfSg<L8CnE&4+J7{h!
zZX|9Z?z|rbZh5ROd(L?HS-%Go!gi5VYpELsD7OCPSY)QSr-;*%KkT+A(<2EW<{m)c
zLa0J=9X)6XL{t6bU$Flr5!NWVfP1qTso84h(w0j<0`}VRrIPN%Hxhtq%31>kt(P@!
zq<?=d6HW+6HDD&m)ABGhGTA#YF`9XQd3iZ~DKCFXTUt_o{MeS39v{`0|L_#)p2xV=
zay(msKs@j;JVv_GS?@Cu)v&>JN~-&LqT%I4;}PeR2&d}i3L(Z_drk^_o9go}K&MJ2
z(dAz&%C>mzj4{k-0$&97)UP?0e)ZNDOV)36`Hngo&S%hwud#HsGMbGGzJ(U(YED#~
z(JA4^_6j!z<47(>Cg{U9(NGDniTuPjD54Q4%;;z?pyZIOWy14@zy!vY&6E?}iGW)+
zGPjcFXFOziu4i;rJamI|68$9t-H|T;Fed2Oy%18D28+h!pEE`rMn2bqXqN}U2e9!2
zf?w{YhGfKeP!$^>m?5kp)qo#W0XBJA?G5BFA4_wo=JIgfYO1BtS}Ipj`d~H$#6TrF
z(r8|0x1oB${y#B0D4TO23!eq3D!@A0sO+;P@6Titw737{3)I`6Y{o5sClSlc`}mF&
z*;WZR$A;ryGA*0MRFdONn(E&1FHO8@c>A5NrB;1-x?qLB<N9Oac4OwLN2u=L=4WK3
z43EgSw$c1dqI$AG_M>Du==70uLw~>k8*MUxRDG*zm>6kS8gN!+hk7DuXYo%Row4{Z
z-gDcGlG_J0)8OK(C#@60;@C8^Yk+pf)=3|<XusZIYV4Vw@VE?y$|6w`*JH<UxmSnc
zb0b~$M=b)cI7}mIVV-E8ebaYi>5nFs#vjqqc0c#R`)8kDtv=rm$nO~}yiKVDQ;Ag*
ze9OItv3JH_hG!>MZ`-07AEgMyynB9V_y_|G3NrkSh~XG4JU#i*AG$C(LNIbZU3y;p
zgs$|4_W%!8-ZTMC`07G*LVNu)YC#4EhqxAF@EsntydZ8x8-@R*E0G_j$$WTgj$a0S
z(`6O^fs6f7>#qF+SKaS!RAgj{nLv3ht<1H_wER-#*9&pAfb@lhMP^BSDJRZA&GM-y
zp<)X=cS+%z;0<$dv|PnOiJDP}B8eKL8oC;M3gfGHyWz9PP>^GZx5t=RCAHO*Aj$Qw
z#A#7}V0VEhd^Xu@UK&~YU_)hCbneG&01RFK7JAx4)XSACT|V(ka&$s?*>)$aC70`K
z2QEc;+_^`3G)367dv#6Lm~@%fP!ShLKv_wGN5Kz7H9|EwHC(liCy3=I%YU~yKY0uK
zzgW+Bf4d%##OtC3r04#T)6Z{?l*#$R0tHJ|<1lN)E}cfqdQ7!J7N;jDQ7a!^3~R_g
z^7qgluVx2+)7As6wn}c($SomvW7bf}<mFz<UrRpw9&U1n&*&RT(NO%Mty9dWEF*e9
z^UG5(x2QD6U%E4`-KW;ic`V<Z5)B~o;WcZfbf%JE%S|N!Iuc?!;mluSvpl>!dwQcp
zw5P)1RYP@Z>E-%Tcq1c=VzdRv(FRcoFC2Qgd)iOczp-HTjAQO#Azpe<3&1h0?Eo=L
z9Q)$Hmv5RFf^-$9cjFKJEs%(rk*K(QH!qJBJ*I0*;-x`WzX#_`RqDhMgmdp>b!7Cu
z$pm+NQda0{m1zxbeeZ@zST6EEQwi5JHaBFGa!Xnt@C-p%B*eY|oTBnuWS<Ukjhqms
zPd_WoxR7%p@#7ptuN=?^it?}@&kA*lXYh{q!vSrxsaq-xQeLPMOcBEK?wY!18rb=#
zw1R+e>N0a%_K$BVN1tu0MD>e>m44b5yl4r)P9UFR<b0ixzIbhk5Y-$V)?U}a8&0kc
z^i5y7Jw@!ip8Pfvmbcc!o}AyTdd!Zj9qh5vG|8dw%gma+-HD^Ew6zG7QKcLy6H|dN
z>o>m{N}I0aD$yu_qCVDaJhwpi`ly@@r$#OQiql(YJm-#l(w=e4^vGaPX;Si&FvA7g
zsrhz&z~cZmJmGB)7VF`Es%gt9q~w3H|GK-^YybX*;rC%-J_j~QXh4*mbDG{4TPs&e
zhW)7!R~Zp>m)6m{je#gN{GV8_A-brSLh8>aN4DnG_r|zO%rgp9)K8761Qp~l1c$f`
zw8C^_wxAt<Hr9VHW&G`7!9P^2j6Rh@l;b%*uOM5mS$Yc<H=jiGAuFpyP0*R|55A`i
zFkL^4>d``dxWiE^r;d`@tVE-EWg0T*UWj0i`3lE}Vl0imF{Ac56+8Pe=545?pk--}
zK00&r=sd*Oqdp->3K86w(k|J!FYPv>H)&N-{>^Utm}9T+1MA5?;y(@FRn}JSoi=o=
zit8Mvms;Y_Pc5A1lh7p80Q&HgzTbQTs3$Y410Zsd*`@(>At>=kykd$G{e}1<lw`0%
z$WTy~kUuDzL=@pfYx<1xN-p?lHG{$Ld|uY;&-?ErkAhx5vNavcj%Q2Dl%Lbi$ErEj
z<HtGL<HuVz9!|V>a@?bS9dj&n-&h)6bfCamg@c#<qV8cprJKGBeVc-2+-uW7aF9RH
zMdYtHU-6d0M0uC=YXPPJ)u4oR9_to*>RZ=!G01(}=WI@bEd!}nVx($`%D3~~NFA>T
zg<nAb0exiPWHx?YZ#%ZWVWSv5!)9N&ij(n#HabXcE9r?3?!w-sDf`9+RdNQ%KHcLL
zne(PNp|}a{O#X;muoczuMvUoljOTrShA`E&AARzDqSr(NI8b9b5o&02^OK@|Sz-Ai
z*vLKYMDn%X6fgdk&T7Z8e<!GzGtab=jj9uOtm*mV$o29IaIA4rvRZBCnVs7D$_udP
z=Vg01L=M|ctK)i#=?b>)h9&KQZ`=PEs#_Cvbd8Wz@_6QFbAlft*9E~ZvXh`|E+N3g
z#^Kw_HCNZi2WV8HTsRb>+#T0Ti=e|2Bb^=lo^ZP;B%=Hi*yt($w?dYdt%u?B)ao}D
zPNxDLz%957;J9XuGV4B(BM>Hg{8}Q2s#T@$NmNYgcENb0+(eAGEmVcpp0v(G_j<0d
zX2mQf;G15V@BHLZMXUO`ozn}SME`x{4|&^q*3#6@$caW~wEKt5l{Y`Vobx7(655zi
zIewP(HiBDYh0p}U31;}pf7WHIacc>ty0fTiDR#Yd%U*;=KrT$0ln)2^?w!m9xxUsv
z3JA3yf3IRBIix*1yxim1a;pq3I9n(Lb-BB-NGTlr>z4JT`*;;!u0#F|oeKPddaF&W
z1dGjy71*~n`^||?l$RxL@IjO>kQD!+u2i?ide6-bmUyAcRB%lj`Si;r0!RHtu|Ca4
z9jeXOp;>u1Vsp;=Wz{EqAxiF0QqV#+DF}MxHrb0Q+Fqb+mQ>36xD@t_+I^PTs{aGp
ze3^;^&?D2c&{X~A_vf>>sTtA0w?=Q%+neS6<&DK3PpdwP+aQ)IK|N5;eYDN{y*I&)
z(JmRn725W72s2qn$fDD)iW8uH#Y?qn7t-WQfrWgXyX)+Y199k~{Up->rN0S9t80-~
z&-G#F_%&YH)JVucyWcHR#!V?6<JK}k0vMPJ>q?4uF?JD32)KE_Zf%vz<8AkQ_`H3h
zQ#NOjgshf!=pJ<3xc`2u?B>zoA2C6mm5j1p9!QAlM*FD;+<{QVfTrIRrroA`b*tk(
z;?{Am?TFBM`;=9((IWwDlPhRS+HAkCw+^f1Iu-X9zkUL`5l{4q_m8flP7JtsOSX;=
z$In}^E#B&sy}N+T6T0TuOph-AWUn-qmOk?lalv3@v=QJzzhB5cmiy{(-n*!?r?6Xn
z&0p;*=<R}hg^N$=qN-9(YcEjtmwbkcCn1n&`Tf<bPjC9BtKg-p;N$8>R{`lDgwi62
z<y%!%GTgJ9TXoeLK+?@tuj|h31gNw6nl!m;f%R*bqthLU`Bkf3u}X}oomcNvu?|s<
zLGYE?-0k5n$159ibWfFbHi2M{cW4mjD-ich+oa{D@n(?7N~>ufimfTmebWf($?k#-
z{9=D^TX?>~jhXyM^`x$?Xw|nX9uN(_i}l)gMc6>yzk0nmxS9hUP&{YVyj8*e)fkMu
z|Fhh#ors%HBIJ_kCaiwb5cvL$`t`*voNntiJ?1HGoVnorHMM75<@Iyz?>mC?n`P}5
z$mb2WR|X^h4f;7<d#Vp3sg^cE4%QZ$GH4Js-A|)x1ra<qkwtCe8J28tXi=}Tko-RN
zJVIL4{2AiOn=BJw=883((tUT0<KYP5y{m)bS@M@V$LwyR%*CCZOEjFr&7@3w{pA8(
zU%>mZo3G$yVBTi8VQ0;4Zeu_<oGZ~ozeN>Lpq7J7%q3CE$GPUtQf->n?AcMqI*@eU
zLJ9w<kK&~zo%=>-U(92p{T|Po$v|-X6SEjYyWE>QFk*gX$ePqc;`XddS>bg8`z|uD
z1vb9TjcPNO_^bc?z{x=u<TIS2iz0iH`FrG)%LB2Q?>hBHD{F*$B`KqqXIsa-rpsTQ
zY*<UpBkbM$!6TO5f%XUO3zRBW8Tt2@%=u?U)28o$+P(7$`t$c8Viy6p<w6%^qs}WY
zPVm9P!oyolHsuN>-@^uj$a^2Oi?iGYG4H}H<kc)nf<@KWRl1<e5N~mZ`$iibu029_
z1#UfDpM0*0BwsH#_v-9t$*+CfHf4(Lk*L`uq~1gl(<VoAK|gp8Z|Hlcl(`>Ely!`y
zqI7<LB59HX=tKZ^g7W1SB=l+JOa($8y~{LlBwPvB+|iuL_aIub54{ZW)>@}t`CItV
zHg1*5AXSHN_}vS$O+&u)9vvH8G$y+ZkXLpwv*M93pQa}YIuoA*V81^=I9W&QKa4zd
z#2m0VUXXW0KR|8=hmewcMYwG7&LO!suaj;C@mX~dJ-B%P{O~*P-X`5~6)W|-ERi_Z
z+-ICFiY$8URCP6gNAg0<w1xMek?JFLz1e5kUk^`&hN~+vgenAJ=L;jJAn)U67w<6F
z7o<yCkyHq}PwRvdZ78k2OL`<W%d$*pkLd^y)IJE`pcU??p4xA`6_Al=NFN|yU#)HK
zNLaQ5{XG{1yC&szcN0JU6goUlxH1d)>lr3)_Dr{LQ_to%N?4i`Jb+h<m%lg5=zgdO
zI{t^@pHjoUW+wj7xs7m7^SS4@oy@rOuxb^&Zg_q9d%#bia|E__5%}wVte=A%S+FtC
zcLGK1(gLYU0n29f@)|*UX!4?Z5j+XY>a}~%=4Jjhx!4Ps9Mwfx8MOiIbk7CG+l-m(
zUhu_SnsjE@EEHDQG|q$g8j$?%wXVJ?k{#WLc3XVUbuMHwtUe;<<gTpVAXVMf>*@MK
zI)2rmK6nDDCd@qcoLAzm_wtgBSS{m}X(`jfNf?Q?3B(0$Uoht&>XlF<dklOs1Jj-6
z1I!d+#Npz>PCdT20LjiOuQtw<%XEKy$|L9bLtksX8}_%g^Eb^^uwOiBrE(kaWr9J6
z*Cv;wj^?a5w4L1-KSR6Vbz-=3p#!>s%Od8&f|(X9u1OA|$e`stV7~DiP0xE*_t!m~
z!DP-`jz9w}iCkFgyxLUmg<daOuR`zFsuFip8AG?u&3OTV8TaS!9nMNODlZ({%T3*}
zbtF@peVxwTCY&}IYuEW0_g_>{Tp(%&5~ix=<<EgnrMiBd=Iy9e_x#Ysa|3rei3ix)
zaSJHDS(u-mSagz%-V0!hW<yLd-sYr{^C!LQli$~$f#UgUZWB%@eY(G3`GJCm*cW*E
z;5A~J8}pWV3(L+0l5C;%1C?h1KVRZk<5g>oe76H+`<oyhw;rN){iyY?;&AEtL5geX
zg;g~Y?sv%>U!|<^3g1!j3opAnU2<&jzrM@+3;Hube#sVL9w}aUL*&dbfgP>5GZHA>
zaNf}I>C>r_+S0O_xFqPQ3W(9G@{|IvoCL|f+Eo?eyllN<plSuJJLisrAgSZLHhiW}
zBK@2PL5S(@lvin@Pv+n-2l?gpjkxDRKKBRji<0_a=nnT@%+*%4h-taE-+VI%L7A>S
z<8AsT>(y-5i>V8#cL5wbgfm%OMFQ^|S$6?28;4xVR*bQCnl@ZX64s2d>uMB%4ZHmq
zN1dh&o0Wrv(gh#q-?JOAStnHnZ)&lhaJKTQcsg=hjqBpi?@tMjLYWZrN3gw41pltz
z{(Wt7y;ASp>h9ces!|uoKqZ?H4hek68E-$ypP-z;Mbj1GkKlgXz!>pc7tSBN{<N*w
z+f28@+KbRD8WN74?8<D0l7dcX^S;oj7Bv#swLtE=u~<6MFMGVSV3nv#t977OwsrYz
z(^38I8V~n$XRyv<I;_CFsZ_pkOJa69lb)<dft+%^qa)7hX2c7Js(NdEeD2khe-F*$
zb?Vs-<7z3~hInb!+v&Pj;JjdQPvf^9j{D2U$nU=4y}%;gb;41ln`1rMxeI5%LmPh3
zGvmG)WD)(i7B1O}YRk9%8ba%JJ={Ms-9ZGTdzps`ttM^1m<?O6;<_v9YMvsPC&mp~
zXcubdqn&Bn5IYu_vUagWIe3jKUbw|SeETJzqp!1)dl|eysQIMdKIHnT&dUz$o6%u$
z^em@z7hu|t7ERXSM{r~AeW-I=hd201cl#E>$CsamS|`4mvnL!U%Ox>NKlA4@!|FiH
z<4#DGK9-fkg~&^5GW1U!dDOd(oEguO;^M?ff^{vpr9;`2D*daLj_<31FIjk_s4z>;
z%KOI=9cWeV@MZVS+loP>=kCgGPSfVdd^7G@y!dp@Tu%Tv*X*BXsiO-E1W`a=NcS)W
z3vP>^4S{6YqhP!w+<WT1s~lvmMWwrzxgemii}n6IA#$Av)s4=UkxM5~S2v%EKV*Z<
zD|!(|;zh~G(1@(7lgoLN0Unitlbn-M&}|1f_kENBXI>w9+2?`s{o+u^U2{Kj(4I8w
z$Q||)xtHrbJREhV%4jlbU7kFvW85=wt+?qeup_VWgrD+N+w((jK7}=U?P&e77NgmL
z525I#4^c)h9(t?lnBH=1+Uf7nc>i7Kg7x#BrB~DFJt{p!`@62i6L)PpGKU`KcEnr%
zQ@>}jz=GM~yY_<FjmjIwX{|BE_;>z!&s2^U)m1vb_iIrF|2&=0CIs~HAEKR)$%NOZ
zT>DGbL=-KyA&2j+!Xh8`^uo)?Glw<N`(q>aXyguXA#){&a&pRge&aCP`euUb>45O{
z`rY}}{%P|KpLd;b?fQMsu6as8x6$1T)A;MUr#+5bjmi6doXrLI>N1yg_J+W3d6hP?
z!7DEO?+=IABsR5&vx>DZvhcjWH+LtS(KGmYHz13#G6HtxiIe5G$|$~v#G%#l3h;37
zeBl_ggh3E5`$Rs5`HAH%7A-q8z_5zCm)mg<;dxq=WAoRk<aZ_f?-329hGTyM9?-r=
z{IZ0hgeOneq3+#~3SsFqUuw%@XA78Q!Jxo242U5$BbbUiU)%zaLk~fbgC{?~?CW_#
z3Db1-$p)ZhY2o8%GSGVKKsLp1<j2Ls!f%qEedFQlEYXt7((B4>%drf~AnK`VJ`_Yp
z;1+?$1H#%sO;-i^d&k31mcfN_A}TaMbT^0r+MzuKxk+ut40BZF*7MWk#bjwj<XCC_
zNxy8<_5O*^vp<Oc6TfL8*zd0Tb16b|(41Bwt2!t9(dQWvvb6|eLZEB2?#I1$Sq7DX
z+}{wdK6qoEX80pED4$wAl%`G;7^0|~(w5uny#gz!rp_=pAgb&WlOvp~Cs8ln5aj!h
zgwZ8B@bw5cC>xCy6=t-%if7A}ZPzdv-9}fz;atAJi`_<T3~KKf?|Xp*Ks?0n$}Z<U
zbR+*M!je>W&}6qkCWo<Re=KI2kH^M4<yHHbZ}*DbrWHVzbTA;q`23a0lV_8H!R9S>
zKuIqeYeaG#%O+ZQ7>+f^lIT^WBLkWqqHmM->R{T@-pAyQ3Vhv%0kWng;u;wWgx+*Y
z0!X3t-|oKDV%ymf(Nhjz&?m*yW;)y3vF75$a1=}=#QXS2vhD4D-4__h;!~2_hu_Rj
zB;o>!d6xz?4O>n%Qx5)!ib3Bs{iHChsEI=$w>vTvTq4R5REtkJ2u=GSi3kIvp924t
ziP!Ur@Jd2Vh!*piSm-7f<2nXM5XB&|0Th7fV6@>f2d2&K=BZ``b0ITb(ABa7rXH`<
zk@zkSH!2-*K3S!A1neq5;#Y_@6O-&gQXxTo-=4L-O(#*z+UzKONK#fPPVBCQPqU-e
zH1f*BL&|>?%glT(!gG8t$Quu~<#sQ~?isq?*)7(QI8sC1-n60S$27q9z~Nne2XAdy
z7h9UmROnrw2Zs4ETy$B494a^{9UYX1;?JOge2Cyr0sNy)D#DDKs(`)lt&}Q7v>gqZ
zxj_RP)K2(G6C?!^*>9!BiDN0fhB=&q);zJm#NJX+JK8H!D#RfPDtB>uH^7QbUXz>_
z<+>gl$YQ~<`CccJLnKm8=cA@0de79G>Bt2$B1ztIpYJ|EQ4-BLyG}NH{6~!f6a7N;
zw>sO2$QyP)GtvVa-m|Y-j<`OPgT2ocm&{fLrTp%Mk(4=n>WBv`;mgDqNT9Tx+%B`h
zWAiuHc5v&q=&4XSu8IHV$^NC<4g#Oa;Lrjc@;XA3A%B6r+1Dmg(MOY9SSOYMOKLDt
zKn9VBwjCu?KfATK^D2=Hq0}2OV}3tTLK~KX4hqkg1m9Nu&mOnRzU~WHHl3kv94t`P
z(3(CbBVEMx5DGv-s=L3?U?RlZo6PSv-qB}<0-auO@~5?*zcbaTmcc)UW~M_NWl#W~
zLS1qqk|2z(4$X#jmkw$w1r!iD9C*D~GsuoAJ+DFs#>@oHz4baegd^h?vIbQ#jiJeZ
zQLUXN7UCHyaS^VlmFqJ6@?D9ZNn_aSt%R{8Lghx9G6lR?Qf!`4`V=G3d!xW2aY4y_
zhI~<k8ytfjP0MUEMt=r7gj_Dt<ybPpzCf;k&y+#0tn)X3{I2#4pw;?J{2P}Ez?0*6
z8j>+{phl~KEIZmxQQFamO-%R+w_0J|zNR-GZ3f+++Wm+5m8>9nvintsJ5PWe6;wx*
z*Jt#VYB;3L5o3vFM}+TK8HDcj`IZh=Q1q%kd?fA@i1a@B{old`bZ{~m3f-@_PH^pV
zMs;pP-WYk2UW*sWegl6YjG(JhdWBw*nnS+`W8@5qAIKfFoK!h=JD0jk{Kh7CA4CTz
zI7NkzW5W;0rqR*PPzn){$_U2l4piufND!-Lz<Cus#^m=efgK+yzQw%-k<q?4!P_K2
z#vsBHb)tbEO+ngwKDhe}NrOWLlAAga93goV%*pNKcxK!U6McBcnzDXN$udJXEYESg
zujf>{S2{eKFQaRc(URX)(ekJrmzsBWsj|bz=i-3O<HW_(S$5yN*5es=cjJd^@ij0K
z0SPO0s1?(3Si;7sNxkLfB>B{WEuCYN7|rL_Y`X=5NOtvb78{<YPmda`Tz_37GT3Vr
zoMk+gBJjLcMI<!chn^ml1nqcx*Lm)%e-5iE<-9{mb6RseT+DV7<99ntyZod9Yjy39
zO~yTMqiXI^(c`-La-&S&*-<H=90)%N7k?}3XAE{ZQ_A7zVy6?5lS73u`?PrNl&fhL
zTqPfgDm5ARBq{{2IV9%N7{p(VM+d({K5G)^9@Yq!XYyl@5Pob5hC2AW7t?(ozA)h(
z=N#cv6&*m85?L?&&3W0mPs2`iEztDKQZfLemHKq@GY^jd<PG@Huo@BxaahGP)cj5V
zPZE(j5?-%wKs-^f%43`icEZ%?D7&t19>Pi{6|J{1=BS39{#Y}%s*9sw!8P3Tz0?;L
zo-D0gYU#QzZ4Q*xJitR6?-%FQDx%pOUHAGMvIaYNSF*;6N6_zwA0hWP_yyn|GqjJl
zKp^3wYR)NrItebJ#`T*Yyq&It3^**b`=Wp&;`@$9{7_W_d0$Mv`R4Yy>Ehe(r8Iz>
zBM9NIOyH|r1Qr;}z2E^smn#cR*Di1^vw(VN3+?VOExN+)>c^J`&RDXu>UzW}yJ>ug
zbNuV<6rvtsH>HQbnwb1Nmd!fiipf@NAL2NHG6oNR|CV|vJKlMO54XhHdHT0fj6ZXY
zY+wsG5#wtyEV%SLX<f#sCSds|kEmUI#%LClk)bXUuZJmulnccsZLAOSWw5Q50Xl^K
zDl0w>eMpi6=%=Nj@I;j}{zIYV;oB`WTxSq)<@E#$wX>+Jh$N5NJE^;>cM0k33D*0}
zuXr#d$ugm<3Q?d_tozwdM3@Ah0fX9hkplgf1d;6`qlhGl)Hs##GzL#V%FtG7k0c5H
zUmHf2cz8@24DacmJn>kuc}<T68NCsuRH6l}f77sHuQ{$IKf0N<gkOg22&tVYWSRrH
zhqRwGhm5zY*MvAR>lVLp#+wLV(CitOdh*%EJzH2&-|pIYV3vvlBMnb>X+zU@nO4O$
z25Tn$3$T^<q7P~Qls`)lN~XVHnDwa1p#`7)oDN!)BdD;BMJaI3d6(O+ZkJx3T9fOD
zb`RI;t-_7n?ozO#s9X|n8DzUdmB2lU)1~?%lK+zC5NkegUl6|g^X+@fr`CXcD<xhh
zQd`U+HIBK-m10;$<ceX$V%}qAXcr0NJl@a75!3{{T^RCQ@t_2(V+!3M69rn^MXNly
zI9>h>-l5puDRw`vSoWynLtII=(m4M7EcwI&S66BQp^oW_B7&!+%Bath?K?Q;G`Y)>
z?0yX!?D1)4&vASui5=|z7!1^Jk@X?F{bRJEyQX6v28A(v$gZqsUTNYRe=I(}?YJga
zMo!9*RRA-aS(l76H4u)XKs_X7o-cLfwk@e4(pkYTx<+NYC1_A6_!c=U1-!H<pdPFU
z@GBoK?YTqws}y{u+*@VJF<s#>mXTeOD44*gKU|tCXE=N`okC{J#sQO>GB&8s_QaTb
zl5i<QXS-ON>h_dz@wF)S^FXu#!BjN7bZ<ame25hYZ&t=eSHe7Bc2=L^*K$cu!~Y@a
z8h|Tng7v=}CmY)v`)1>fv$1_+-PpF1jh!3Ywr$&XHnxqI_g>ZXoUR_$sAlGLe-pv^
zhp=%$n%iEM3TaIg+7=;B7HP-^#AOz;-0i4P_pUQ2bpJp(C{(nPmdws&HCl8BsgD#i
zO7c9=mV$n_Gp<sYv6=J?KPS5skYOS_P4Z04LS<_Hj9Hj@F(bZ=UT;_L-@webh{7Iy
zjf!{%*Gj^Y%AnVon%RT(3rQ16vwI$RP(xNDi}}lEm`48}POudh_gC|84rA!+z%xaY
zjoi+aE}Qj(+5$5~2dhkf&WWGRuC1Wom7G*q(%3B@%=Ko<Us6E;)Nv)?L+=ix6~&{t
z$VOP1nZD4=v!I4ezTK$%dP+(dGHl28ds&j0scDGGO{0fFSaMcW6A1B)m>(Gq&@_hq
zw!ExckY2cwTS+(q6ip^yq8Oo3-Ac-5=cjv<g@fl=Y(_-IQ<J4nJtff5fl6d%`bdQf
z;*0v`9A9JDOalFO^6D>`J7%_jS^tw{W_l*v2W)z@SMUSI+RuT-&dz*t!k0iJnHTs?
zODg&m0jjypf=dQ*Cw+YOC)v{IdWChq)p#bYK>7W6;5>O{#t4$s;VQ0>G#3m8-BOtM
zdPE<4gaxQjjKF|xUY;XpZaS=%DLqXhBDuTam!>KfiR|G`as}O3GtxoNPi~jklIrqp
zo^hJV5x3;ffm2T8IgS5dncS19zh7|IE;?vSI}T7r)xJJ+bNX#e+3d33^<+a&_61CI
zCEfn|)OvzF1PLm-I1n9(AL~qxv}?P^KuC1<`h9dwr5@j=)};qQO>(j4HO7VO5jOhR
z+R@jm8aryL#|RO<YTVFh2u{kG{WN|6zN@B3IW1S(a<O+lhzXBcBp<54zp>9(qAlX(
zAEt$j%?oIe>r-bJNAF6-fQQ(rGI9aTf<#ko;wdaCQ)G-5L*Vm0c~7KE(x%{uZSB4D
z7}WMSwLSz_D)qeJ##7#`^ZZn&Wy;$O$09E-8<RH8IuFEx_PF(l_#4>=v476H`uwbb
zZH_u5P0UNf!y_>z?luNPimnVEbZ{R>ZScR-C($3Lq}&G@A>s5|(*mjD>UZv)p?ji2
z<`Y8rA#r<RHoMy7OfOS!#$X(6u?%50^rPtL&B3;nYZ4C>-97vjXdr}{VVAmRx{aa4
z^(l||tYE4{!IbFWc%}sBP*W{=L7WYx&pocpgk_mG>xL-%i|2rPO4EJT^_qCb)cF~E
zEhmoPx73w<*Y0XpYJ_4V-%Ids6})MI^*zaRzFApfC9Q+BBZF`J*D5DMd$a7Vz&U|c
z)U~5w0%9|6eSB@q;)F&r4Kpu+;`u%<%avJxbW!jI&M)l~P*!O&*}0+aM6FZ~MFcrQ
zwX^0i6vUCO)dmhAo(HF1cvW<1zbY|Pz%svVs3MNG#tMUcng|}vbcGfCI=DfJNses7
z_Y;$RI_j9bWp-oMxmCAD*W9Rgi6BlRMI(zNf10eFE;6Q`!i&0NxSmQIe9`-WdzCe-
zZP-UmYf*%JKy8#^=|3rF+?&`Ra1Kt`Bu1gHo9+0(LKFL*yL2my1`3N&FL4K@k4sL3
zXB+bC{4i?uG)){AAxh^{J|Nwx8ywa$oXh8A=5A|rZyBE?s;G=xQCBkUuw=Abb{=^E
z=Ph^`dW_@;U>mg!AGa<UdPtb>ao1|^^<+;O0Ydv88Z7JjL9YspNpD76m|BKndJr@u
zuix=QqAJsJP_*)A=LJqE<hxEN*52_-!uQCZ;9;2dBf*u1dDG<TaY^LD({AX-icN-v
z0-@pa!ZuVMBL-u00UdjR*L?w45>^|gIU@SS_zVR7_I9YxM<f2~H@#=fJtCQ5Whm>0
z@4`jflrJ^DEe4OVfAc->vjWJ}h`$*O!@;Qn8QUeBOTBtg>#G3Fy2mF+sApRhcfp~I
z2n^ukpe9J{<3YC|2miQ+C1-e9XQ^`&!J_<zMn6Z1RrF2_F88bPazKxWG)?=uh@#9|
zXn1;v;%M5iD5m%a=!?ebbz8#eLp7!l)>G7b?6GNj!L(uQBifMW#o^;D{&%#u_#r{u
zEOdV=cc#O(b?Od>r}Qen8K6*&Y8!^x1+9yCiV9E*V7Hiwr>skm2E~tP?*&s}-ca5s
zp-vxyv_BePPi|UBZGGhHLv2Wvly*+V-?(_4&@ahH18CjQaXH~{m}!!dxFybu@t%$C
z0bR14DdhwWI-M!aRO>V@ab*fFV^Sf!KYpiAK_MxKAdluaxode78F@ofcm{o~^^E*N
zL5#fQ{BoVM9h5GpF>VOYk}evXf{u6fZ$Bhtc<K0sHfbTUdTFn2SFX6+QSJ%IA3C+R
zKln}^+z1{Yk0W|Vylb=ys_l`|vU*25e$lCc_W4HHNDHZNegit94(vW!Qu0ISh%@tS
znQwNKFp{b#n(TuQ8C29-rULOqIGgyKSsBDWovqdP@d7g-I1#igw;ABGdCIHpg>IQc
z<KCC+l|YA2?a=y%&ISK%;@^K2SQ<p6+^i-Z8Xh@MtkSGDjf>sZcH}hBw5%fFwJr;J
zagmD`f5I6Uho1Kbz0lYzzuNx3Mwjj^owUJEt%X0|k!F<hQ!CfeE|XN&><~#$OB1#4
z3rmy%N-K3%03bOTEOZv@-eS*E#P&pe%IOfJvJ&7lEutcWsMIPBqBe!qBZJwWCHaQY
z%wnHc8|tvkobcU6AT!TWFuYg+t=SoTL))q;525)>nXXlHW<wZlX;R@k7mAHat9YNh
zz*u<~_4(P*0x})NJpZHmzQ{%H8B_sGpR?U`nfuGMARxD%cm1OUOVBO&yjXGDuX0DC
zSE3-u$L0xNl5mzR=3<9PyEWCl*+i_f;?DNq<T2jvE!u#QcH%AH|1#eABOmcfU=Uak
zd>gNr5ZvaHA3fR!r4n3R-mVp*kn#*lQAtSQ&xoyJzQu<hDt-VvP@tol6rZK@U4rLF
zy?|)twi2v)*}}@PKFWXSTwrFV1Ksd}TwENeS2331qZB0)WvW(*%JB<jj*fFN9?D#;
zb)|6EObJms5?d9t+r$c&zy&G2i0K|q%V3~Y@*@^K6rGFH<|!>V0-oYzbjE!rygZ7w
z<+031Za5DHHr=Y*Rx#_$WLF^(sr3Q-F@8wKMim3fBbZ^;Y*(jtwmBo20%?t>=0CT_
zuW&ubx+KdgB1#PLA5LY$b@_&i47uvHoSu26hlGs`xfwA0#v_yc&~_|`)m{TB6#GVx
zAu`~9ba9XzoU!&@%Y)|&e3Z_%9u0CK`)|D^9s??H^_EcJ)mC6`27mimHgyiD<+dcC
zGaXAJ9z(45u4Z3gh2@&9=I>vX*1u~l+x5#m3qO2RS*0j{R_fZ~{d({>P5e=W-9ORZ
z_t4Uu(xv4lQZL!a_|sf~_}=&<CycozV=LAkr2w^{(f)PJAM?Xe-Kcdni_5YP(g(ic
z{m*U|x7J1vFKS2T<+iT_49q?1?`Rd917zVpukE%NjF;Q1^>QJ`BUVb3B@^IF<0*wS
z3QbCSd5&wOG>96F^8;eZN~Najf}F_u$WNYYSttCiN6Kzg32rldUHnz?2{aH=0ENP-
z8#lg*)lXwMH6>$-iblWXXS3(EdE*hk;`?^>-Q35otP{vm=hNJ}RYs6Yp?42%38PE2
z_iB%cYC?nW0u)V4q(frb4i{wJnlQx{tod9nhE9;YgXPGqc2&pURW|z5>La4lx>&`o
zT84?EmY%it2-)+ZGrFYk59fvvk$;z-ZD&j4w=g1#C46lp&U8b%JNRh&iWKw_@lNKb
zR|xs>>`LXxh7t)3c-#Bfr>Ibe9DSJrBy*%o9Q7w9iD};fZIeTNTa9;ee9G{N3Bf+x
zyUxV4yeL0FQ#4J_^2amB8Z-&AKfJqxB^ix4UR|H!P`SO(Xd;}^|Cba@zSstInmde8
z40jN%%&^)0^%X+6&XpPI!@_jbMi}orcp=Rdnct=)5W`MLDf$`1?h)B%YG`Dg?+t-C
zX7<$*y=7r}{~u`+p3l8qtgm>As8F~fD;^;OyBTU8E7uERi$t7I5d+;qL_Yc)mRUEv
zz4_VM`9d12$Crr!KC4QlfpK-O#3bIuT)ZA$YO>fovW4SaPbpUaJ05lm|BIUpdP-o&
z+lhwwVUZmb8(_8qZjd@z^*Yl3!>hoK_mb2nc{9fjb)Y<&&DmM~9&<wH>pBE`LPwEJ
z`=Bl9M;hR^!M^c$I;n%3ak)wOq#D-?As<OI)g}{Tv{!^uf9ssZAlb$b<0L-88}rv-
zlK_09WGKd6yKw77b7qr$ol+}C+OyT*dB0>)k<7IfX;3RoC*a1cpJ{PYC-nDV>u^G~
zOnb&Vn|@(c+#4R#7PhDfk}mc)&85jw(&!orMGr+DUD6JklEEeoccoc8T{=~8{pJ!)
z;KO=oiGAFA*~hLXX`p->#jnzi;SD3RJ11s*f1Mpx$G^`cy2vi>#{gaA$5HX_w-eq@
z6`jN<|Ed(?*r%|n6rXYE<$&{t>gOU)-gJ*WH(g|t(vR__(V@}Gr&PDHh+CH1k-*%n
zU>8W}C(K;$?}IUd^9BFsD3UNNBLwHES#&MJAL$0r7z^A^1o>I`nJW6L;#J~T-pAj#
z`&3`75?A$?UKz5r&LF%IrVqbs)a5HHiMN3n`lX3N2?V=4#;O$1IuFdc&~6e?&$5P8
zIbuXdZjXcCB!@|g?>*iBr0HUI)YdC2i7<v{cmwNm&tST~e`M@Ld`iOqyKcA}Nd|pD
zwKF*Te`?&dBtp~EELdj$Dr)+62r2|!u>X|J!!){m)1D1u4)*C_JvlJ?AUpOr0e%3!
z->>$4g1zc|NDI+zlZfO0@#dy5(r6uC?qEZ1o!N+{Ez*BOWRmLUVw377g&I3y_o-&b
zf15z7Zr0k{T$uQ9#;OLQCC>?zJFW>gb*bO97-w~LdsT8CRqgOC5!_-oJ5S(;5Pkrh
zU7n~ylHM+}f7#oCM^nhVCv7rH;Y`6?mObB`KTe8=eJN?~*uHbHQ?vg!jkit8?go)F
z>vIr^Y%9f0DT`#wEZVj5?H3Gq;y)t=f$)0rPWJ577MJJ5{}4Z&e=b8i5p0jlcyJ<i
zC3BZ(N%a1`fK!w3F0uH@@O7BZ@wH;*gIoWt<kz}NN{DGkovqzUajYiLrhMf_maWa@
zc*p(iT+!rZ-`DwWg@l*j)4(_G*{DUjjZiZI>3Cl+uQ8=^1V4A-D%6Rr0q^6_H~mLk
zcEvU6=qiHTd-2C7wpoB#y${*FxWU|@86&f*XIKL^ZfQ!z!j)et{5jyHdco{bKgHZo
z46WxdB7k8Pb_LUe{91fSb+c??grJeq>YLARZ;svYRr4V2xttA=6*gT{UPb4LCXML3
z9vq`=u~s)r{p_D>{05fUVj5^H+`nWWGFNe3V@ewe@L~oRyPb~@I3J-KrG{3B5G|8}
zrd+wIMYw2g<hLci-(wueMngA>d*$gMTPAQ>Uc$5%9L9Bi@lh<SC{1_qsOw~J_~K<4
ztB6gkKVOo%Rm`mOnTHv?+HsD)4LVj5DhOFE&kkZeK_4GUTiTeU=CXbv$<a`FYb$Do
z*`Vmz$|pH~M#N|Hs87P1=q26p-Vgt5x{Ctqe&?nT(l>^|9425FlP`iC6c$iNbqr8>
zv4pD~qxEWpNqH9H)9Wh0=D{*N=&EmkWMg`SBu20Yo2YaV3KtX=`k)9GVCoaHNmUd6
z1IA`SfAhvQJe<PoM0CfrAV?sp{c9Zz3_NC?Pe9H4o6>}#%~od?0$dU#Lc}l1n+0!6
zaMc;U`p@Miyz1-JOw!sdk2(SBMJgNv)$-~j`Jy$ZJf4sXs}?ZzFI7T1)>z@mGFa5|
zrt~6ZhwS<1c$LC*E0P82DzsWfObTY}Gq~!6HP&)jq%JzlxNB}_SKqmc=$-CC8>s0N
zeExO)V#6yUjHi=I!RNdiZZB{3;jIWqodTf6>+gZ;Lu8PamyVVk0A@_1t`j_?q}tOX
zDEK;DNw8|0ZYBA&vHMdsT8xln4SBL8<31D&_Af(GSKGXCQ239+S<JdP{}NU^9gXUs
zO*S~=D}N{p+wk%IC2>tdwYsP3mX;nX=3pyJ+q5%#BfBd&^*~|@Y>EaaDSt-EA7B2O
zQ4@~&-!((%HLiZmudm)`{YW?9B>q{tl?BIE)wXCH<iXag<lJ%t(LeQ<+emJVOrq%Q
zNLcRI_Eb+s?IN6|c+pw00?{lDLil2U<EShUGSG2UFv&m5E<C$Rn&4Z9?QY0<|0IBX
zO`=HJ`h{~@B(o|6&JJ8qnj9m$^0A!%<qw9rNI))BNFeyRP419X#3Z3akAu?CW=a0u
zoCu!9<5Erh@WYry_N$*j&JldH<Q)HzW^240z|u#Vj$7E9q?8x{`#owGD!78OpUk7A
z7SK<|y&pkNwBnH9M1r>?zMCb;+MAHiRf_siS)NCv4!Wrz!6RX5^YitwRgHh={7R&N
zCm|qp3Ge5Y^SA=La{-zlku`ScjU%!1=X#WfjTq1o<iXuN(RtrVAu$m=dkc3AS*G<U
zx#>WugB--GsAVkj#QIM2#??>%+fw_h$O=|UWwLalzJSc_$0~5(Ae=qL)q2%JK<n^+
zdW<}_I@2r~JZLCTa5-0=W2Meqv^cJvxrwJfAYHxsH->(RAb;7koc0l%chd^yDyhXh
z>+EmPey<RTRV~Z4OHkv8U>HXjk$PNSRO2Yo>?YwV<zKu%P@n5CLNcZ!*sw@zWH}<#
zCeh`rEm6ImGnMku<?fqvIYjDvCw;B5DVF!3jPQ!-#-Q&+$Q{DOKVE*$176Ff_yy0I
zlcmPdolU%O%@09$d!)oe95Fm3!e{VKV3gRPZ;8PNaJmuTpl>h13v(r_#ntF<_zq}&
zy8%X_DIgg`X93yd@Npy@RA~0KfNFOlQEAzoa?qb-Dcj}5fQ5gqv~n7nP3-h?=Ea)$
z(6h~K<pS{RAisLm8y`3aILw_$kZccV4Ha6^owZ!Yb~*D09m<cqEJQjK%Ud0Ii#Qn?
zi=R+}4rd^3zv<@PgzE1(7EdL=ivFu<4p>9mLdcsn=n+ex5*Jw+0ugnZ^$+|q)n*L-
zb4m*rytu%q)n`-1Q*w7TH;CWIwv23^PXz()`&QS>`-VVfKf{Y==h-Z}ipNf&MMfCM
zOGltW@d4)m{=y9NNako}+aWUcyw>eyd#h;S?rqCYw{d6=7DG(R{IQH*8JjsV2LGj$
zCu&47scD{1Y$5{Yc^CsufzHHw%Z6)5Rby^{eKUTIt|2m3yk4=5#MpRy40`Ov52R7Z
z3TP8|$55NB+GCFq1!=`gY=$&QNIVoXg0!}RI7TU<VPJ?!^gjQ)xUnFma@5`d+&CaD
ztgW1LmD-R_9p$@opDvc%OWwgXk6o@^IB~Tup%pAm8%o801nenF`foCftEuPN8fX!9
zYQ*Msh4Jxvs(*ER@D_-3Q1a_WwRBU49p-}U<HxuXg`$9uabK~KJDh{HTScdWz4bG6
zN9b{>r<zUgJp%geS$^<+4zC5B7{p_&{K5JS)m_f`+L-RNF6qvnsw1Hk1+vYVU}otV
zu@`w!<})x~{0bBFy3r9|=bMKY>13sEff%CXjRB2~xM4Q7xJfp)ZLE$3!|H#F8j)|g
z)#9o8SFlP2$I!OOOs+WGEbH5#Tq<b}Q`f`zI7ws&fOTe1A3dFp;gLQ)rp1ry(%Qjo
z(BS0f-*1v{&Jac(oR)0libtVuOq&D|O(-;Ev5Fx#xS?Pg;gJa85sX|zNnFz&tZc*o
zcct>oK<YT!cnKN^<`Tga<s9i!dCLEnV2&CZ$>9kwOP*0I=}Ru^w@ao=t@|>4-HmhT
zMY#N*TT8B#j0WL*Tah=8$brwFobYph@+<a>!rDKrMx2IDjKk!7piW39t>es$?*TV4
za^koxp-?BrSsvI+<N9#&Q`EPU(PqZ0rAEn|nUZc6#g6tcjnYUVpO@Gyg;{PJy!bY{
zdFnhZ`k@cb_hnFXFmBrXaM|>2gkd;|yy*2I`Y<~1a&n^8_#>9P&v0(d0)iH$zdv5@
zYm%);_@t-Ok?z~6l7<cE0<}@CM{0hfsSDF52#KRUOR;Xt&{YYm?FauWh*jYnH^Piv
zQ!yjG-K%i6s7~WVLpb%lB+-ckI>>X>rO>7yRtaj(OdOH@B?F0E7Nh+ltqp{e?-%xm
z9z4=WQMCZcpi~FCIY@G;{<JBRJS@ev5SPr4V#nGejf$oRZ}A%H7$(i*)#B7}p}E($
zieK?hW$!S`a+O$u)I_8W5pJ~|A<T@>M)Az(62<9mm*H(cQ(Y|#=^WUvqlU3WL(G0M
zjOT_}#o~Q5O2X2GHuKjC142!sv?OGg&ciH0)=|sYE4}3yC#DFuFgvz}Em~?H_J%E<
z7Ld(pq?;l1NzoY{NpwkDybg@mVTpB7vV>0Tvt;9V_X>tBZ#Fj_S_pMNZ*bOnBSN3)
zYXc<+HX@VAr1r+>KO?@NOpZ1wtOq&tzaQ?%L9q;WY}^wr1tK$713XdgZ+}8yX?)@L
z!Lk>|(GQ)MCm2Hs<5b**F?ycs*ubkBl0-6B8)OvQ$a0!yD|sg|4<3QH@DlVLM}nhj
z@J{#1!o_g#XXJQ~GVSWtL9d+443}yw1IuA|DnB$C`6nZPEshP1iQ?cJi4`T`;v11U
z`2WQ>(!1x}AB#tb06fRs0Y#H|=8NdoX?%*SCt;fhj=+pcn<g0KL|%0@I(%C2p7cAu
zst(@>Lw#Ak|2L&i?|clKmoQ4nV{})I46MiFEoa%L$V&hebAc@5DfS>?G>_Y3ZE!2@
z>~}=+5@ahrCQS>bpdiQ6?^MU+M5!8^s@HakZvxgqd4={GC_h=;l1W<p3eAnx01=SH
zJNnYo0KbEFr(1C=&I)Y9Lb4y@$vx&aK_%&;6j-SzDL{iqd!n6Wqt+3!c7qfHE)qth
zkY8M{56bk+oOZea37yAF;`k+AALdGVo*nxtN_lSsAr+K_6HFpzdg~n%kPc(fUlYY!
zw!eckw0TxRHm8$nS3{Beb~>F(=DZk!@TM!8SMMa|-;Zi7>NWF|_^JuIg}oZbop8#g
zJ<jWp5e7FI9)0F9p@fMK5puR`3ws4VQK#9x*rfg}X1Bdx_IJbK|F&4%_5$6ql6mZL
zpj<`>8^<U!1i_zm67utlb_)Kz@<SqK!^jqtwy0s1;(p=s<t=cw<yl;`vUb)d5=QBy
z)!X^Zg4Y`|e-x_Ge^Qr*1;B`ib&PhOLCRZ)G1K8meyKQPw%se`Nn#KK>BDFhwC=k&
zONFmn7cnt&jwGcHcQI}nPN)&R$}E-Qqc$yCStP|yWn4r>sJU$Xt4jDzitPu`M~>6A
zcd9qgft9YbyE)WtyXq!{4Rl05xCRcG!uRAv)l;rY*x>2%k~K<e=sai1LbVmx+A)>x
z!-&cQ8;i{c6K9El6Uy-&#05G0k?jP)iL(Z8Vk1=nFEay+8}b?1fgM*NM<N5*s3>cL
zU|ewSZ89imXT~l}%3OR()sNeZ=$|+a(MFI(CqT=~_Q5t}Dk$OIpc64a(u!?yhNp1h
zH$!V=MvRWJr9m)@(IAiUz^MAnv<^_%MnxD{`IRRH>61&6O~__B4yLz<BN4jQGS<dm
z)cn_u!Z@sxlPkWPfbEO}hmw`{Lg!zUwep#Ur^IURFS!D8j3sJ>fF>|QKJZ&f7}>V7
z6cHxF-VcM4)(k7<_-Jk-uS|6nH^2+eSqTarCJfdm*=j|zmN#ds&<yZd+cEe%8zN^j
z=HP5rF5|CXuRAJd)WCkN6FY7xpD<^-b&4>YCQ?#<@`E*^muXHCChLK-ZUf6;f3)r6
zYKs15Ot4!bPSdWn2gI?mBhYxrQJ+48x5kowG_qy2FNcYQW3a*%fd9k;gny%&fD1jA
zPuF2$8q6ymNkjdoP_BL!a!tLd4J35Pd^TQgO~%@lwAPmt2iimAjNaFHw3r_}{3xrG
zs<D%Cipb_6=;9R3TdzIH#L1WiSwziH*I=s<McIVT(6rn!|8s*rlg_wVVGGvJ-sq$f
zke{65BqF1BDdpCO+;3OhR*%0?h={@}NRNy_iTcro_Rlc2zl_QMCQJnnpJX{0YDiLT
znI+GVuyI`N4=xdyc#XPbgnA*}r1vkp{-1+JwLj|U@_1`Gwn_6d^3JW7FU#`l9J|r2
zhJw;xX$qI+9XTX)2<o^Ov)+r%b;}VnS+E<~0hT6`@nkB9Bow3kzk^WdE`TWU{<pT4
z0oB&a$7+98j(qqUwOX7WOltN=YcvF$ZuXb$jj(db2&v&h0&$-j(2np;K2bC)(-V+z
z{9Tm>k!$>GEg$5*VwXvT3ymejj`(Uv4dnRW#LrPpmX_-f5tsnEX1^^Y#QKi-s*l9l
z?T_ZH66;qaL(>%wReDyE^U2EdvCpBYMpA(P&JO=E%Qx6`K$&CudU&VrdcZEQyswef
zntWEQR?jF>_;aqcAow8~?wlB1gDvpv`pC&{VN}IfDILh^<3`v(Yf`W@V{Uv>9IZdQ
z@}%GsC1p~Td>O@3Q*FW+E910DY@*M>)${(h&X2q{3EcCpm=S2H!etrVpP(O6fMbwn
zzZzfk4=({}?bZ%KZMo(^k;}4Z7qXyl5p}7+cDXac!Qet8UhfzPDrPU}dyvu!?p4z;
zwp8V^)N0QrP%j9<j=z`HZqI&O#=b*88&9B*NP{#wxrulE!%0WZu~`}+9VG9a$efpE
zg*G&_mQZ^va_wKcz(lrLdS)Mw3q^sbj!~uHt)hw9g|KFrQ7cg%d8yn;^-jZwF{IR1
z&5IE)@y|MZ%NM-m`>YX8v+moBMZrj&VaC0?lv}=-TYe#s<&sVO$F0Xlt{v#cRx)ln
zpokUEz2r;u0z(*q9lyBGICNN(bnLL>f73tBaxH7TaDx1Aip7DsGjc1aWo^*A{Y0*p
z-MK06YvPkE5f$_eQvOGaUJP&Wr@h#5xgHMBk;5Q0?F&7#?Gcv5dWiLsbj_ZfnX8q7
zisX+T@=a2{^1Zs1@ps@mg|Ta|h*6wcvaP~#*Y|4DVn0)5vz`Gsyaey{T*$~1^ct?5
zRL-Vy_AkGsoL5rJC8a)9`^@8{4GlocK=+g45K9ww_$t9RSp=8THC|>n4^DXiu$r;0
zkof?`Z%5ZX)nvdx?vI760E-74EH*)7EuBL^rVxge`?1EbP`s(@%JU~r62KXcQsm#>
zUvi+*o`_PU;rF|9w*j)w+^xF=vhL*4DD#WA`krN~(vlG*TxV{t=a{R$K#-N(oD|4s
z&4`dkVk;(gZe%xKzRKmImMh8zva=&K?WKG9OMezOU+fLABPa69kopnuQgjEzdP!1M
z9}X7<p4=7*N1mKA-G|~WBrwT@;sJ}Cb#q1Uk9!Z%*h-DetiI%jtE%X1v~G=orpi9|
zyz$uz=U0L9eUkJ6rQR~dc|Q-u&`VPa*-X%;^yp2NjS_Upov8^M%R-f*cqxIAAu#Ga
zQRNM1{`TsMaEUgYl6hJSjbE3Am9v2xCDtZUhxra}($2|TB^l2s$91Cd=4VG;!cH^{
zzeX5R=o8ILfg7*{rNG5<QH_cd<plGvVJ?D=BNd%cTd7IRc=MZNLb|><t)saDt~M^N
zkpeDuO0JQpbv>JNn$jLeYq9sOs23lih6~TfC`M_{y?yQ3N>9-a>dgthJa(#tVnEc0
zY%Q5Hby3xb%!%T9gRQh8btV0LS!Oy12b^=CY&=IPK_i7kWNA^+A_ZG%W>zDhL;(tm
zZ<%)b-?HMQsE%Hb{=C9kY1dcaY*K3+9<WC0UyA!e>uyop3D78!Oya(@etQY5mq|P*
zX_Ks1eivlsnIA>O5*d95>(l=1iFT#FkL;@Y-S(CG80}ye?Vwnv!2mOBy+Dm)jZt0C
zM0s;$p^P+%7|~Mk&zcja#X9irnIWikbwj9Rml+&jQ?todawZf-%Qnw8n!cXDdZt^X
zEuobcM9xtHh~gb&FHxy9jWk#M6ZwR-|I9F|<j>tk-n^A9Ra0XvSev3cI3=zkna$tP
z-wUXcq92da(FZx-p&``eC8;G7cJ%x2|6}yiS=04zV*<{wWQ-Uu)C9UvxzK#@z2@x6
z!>O72GLb8PXLn8_r8AOa-rg}p_pVSSB=(?Osi2MW;a{oHpw^PKR<NpSC$|D-h@VR$
zC3KIw6+;?N3Q_2#G?lRT>w;6sW7y*$XQvBdq$p^#!{!!B<DC=wu;OP6V8QG$!f^8?
zNED_DalIfZ$>aWO<)U_8M&1I5h9)7Wq4D&1Bw#Dk?@A#c9y@J;67Yzdq(G^G!ckU|
z>cqso$x~U59GN7ebYc;XM!9^%q0q6EuXq_eoAWX^-loK*3^&NNTAUsAs+fwgzY<;G
zNaL-2CoGw?`w&<f4;b(p?x3+6rSjB0M5p-0xLPWy?evpE@a8rKTM58iCu#(CUI3d>
zDXjvh<UCjkw1JuL&XR2>3kgp3QmALYvt|o<h~K%k3VvrdqBMc=@WnG>&BoAY5|vWL
zywbr`oiZOOv$>AS8sf3VtRJbfx$O)=QdSCB{SZdA{M%@s(6hM#)grt7G^O*TcB}E*
z^Ju8~^99L=79<s=MkF&OgzzS2DK%0xmXVwdQg)}wTp9o_OU{!0U8|Byu>Ez<{AI-c
zuJ$ddM9WjJZTA#m_--3URyk3c24FHQBT)lzL5!4hkq+Z3cLK`Lc3fVU&<?9&C@9em
zYhVjkYMUl)pxc7wj>*j<22{zOE7D(A$eb&VtMO!<E4J^dWvv!G#a(`3;lqnfM9mYx
zMcB1s>`a;{o&uZ3xl=U&n_zg((TJ)%-;{iyQ`aqViT_Ps&Q?DBXjQP}ctxql5M(Mh
z2I`j?x%htdKuSe!Un1y2{*1aJucB1;5Z0mLs5+8Oh$wtQb_SGY1&9~upzG&iMsvzW
zvCD@v*9z7@N{5~;aqlXhT&I>TUD0n0n|4<dk%$RY4zJTElW1_wh9-B&hR&~H5KEH>
zbaHPBhAB_;VV58Q!pT))vHU-Wl#owL2VM^sX3T3?k*{XluAI_blU8Uqxv_q)De{HY
zhYhkhNvPO4BFclYKT93L9y#gzX{>eeB+_>;9APo#El5<Zk?w8}_a9R#^iQtD(989u
zPWp_?hE2Z&yN`6btWBj{*cq&HeJ>XnSqd(x8Ki380oR%B+rN|4Y6+&P2!CxnMXpd>
zu=~C)WtSNzJsp1E+(lcl%Tv_aEu#DTuY4DUct#)7APHI{J=e}Pxj^}Qhg=DyWhT_J
z<nICBo$ClC&!2>juSKA1>7?D)n6|IKSEJKyN*ch?X-lcJqiV!D$5NfiG=rIGP|MIV
zyPbr3U;*Lr`R?spH{z@{wn37Ly4G%nTg*WuCmlWDdM%rq9>CPItY;S*mk2>9iVLvw
z>fyyodeZ&_VHY|9o!#D18|55^wB{@od{o__#??<2T9GJw4H#o;RN?{SOqm|#mNTu3
zDBynj@8_ziU-?rYJr)gI$EFN1*zqJiw-yNf&;p7vhG|-v(A&KgM4)v+&C5Tg6iDh9
zlbLDfaxZgO73AmAvs-<;P|N-r5UHXAv1Wa<T*`61cp=%&%g)agBIm2Vt}x~s?2cb5
z@GPw^Ihyj9n$7H1_>F#R<Wedc!|ZVJtL$(`zCgn=8yO2AuSGMROi^Z+tw*Y?Ho>P_
zsw@MQ$E@Q?QZRqoVu@sl8&ieM-ISG_1-cbYim-h2IByzdaj+)W+@d5OVrOzA7H5^n
zq(y99_TuIn0Cj%ysm=`bM7u$CmTRDmY~@atiBv1a8pyrtH8*k6a{cGn_#WBe{@A#o
z&sZ{A$tFr#I$EhJd|aHPtSep9I6|q9Ci-`Su@)ibys6hWsCS4D9v9(O_4kiuDaE=M
zh~s9*x|h3UZq7em%zBco*+gW#X)4*B{N+3yO7u}xvX>YZ!R0bvMt{q`W}9DbI_^OE
zc%|O>Z8btS?b?FHd!gi=PIkySj8SGI21)U|dIxR?g?7=0#cbmp<%p0_Q;}-8rV_q*
zLo>sW;OKxu6my>Fz!O`MrpT#&jI*^Tj{)Y;bMsuq?rEvXY{f2bosMi%7%|Ku#X^~&
zN=8&eSW6$jqz$lpTp$lkp482Eo$Nw{-sl^0?kkdGmY7!e%QIUH6#Y1>^Q`k{)?AlS
z@IHHtv+>ldq6~MPG+u^sZaOx8eC&`c0eY0_Xt7EjW|8wUn0a*JWR}^Wg{!K5+*Cis
z>=-xnOlFeHUG)3Ebr!VZKcSW#4vK@u`zAmZmPvzCcTu#q`B*!h?^L>z;@P^x29H!(
zxhhzSomg|#i3}*GrUVy|00qP`?F^8Z^ib6rDmPFrU=zI4dk1^sHFjcJbdpxifSXY|
z(As5~FBL_;IccpDOu3Qvt;ny@P%Fk4==tZnie%BrPJ0Hff9sdc$&Wu@r{!#GjVDFu
zvu~5ejS}n;qtgF9@)yVy^ULtoMCiP^i^jbe-G~foj4V1%YhJD7dxw6K7~m_W&Nqp#
zj3XXxPEWwB6;s~7rnA@K9#4pWVjW|6h|+e}!)ln>V&_b#Gq8`tc!dx{Sut*l!>Or|
zQRu0k54g8tpPm67n`l^Sg5QmU0-Mzb(4;7r%T`h{N}B|OjdYZ~I!&dGi%v$`LsK$n
zyUw!axPcs}VJsEW$@hnjbaix1oLtc>C_Ef>3QVM(q;+s69j&d0o$-1jE;JViP*VR<
zGk84#P^ZtMRkHXsykMAkVVJDA-d2lU4Q9a7O{*XW<JN^pvn^bF%v<wCqt*q^1L$29
zVl_wRfr?I+^Xf_wFS(n=aoHNL>yDHhQ;@U1)TxR~p%_||d;7EYu1Z%dQe#Zz!Hjg1
zhQ=ItC8*$^%Io~ul%<l*m>XZ6%sDqVxV{A4L=236^84D=IPC@ZJ}t%Sq>vfGOsOmL
z!Mc#&d`28D8`9<H-vLt+O6e{M|FQ=(t%juS(hkTo#kL#Q0xEQ8Jf9q(efHD`!JRc~
zZwp9YrA-5!D0!i>ayGd(m3%FXL7njAVL)9y<7D?sn*(Hw9X;ajAYt(XaO~ard#sOq
zDl1`uJa%8jFp!i3`PQ3eTqJ3KGku}NdD(j8M45PWC3&Glhl%p*wIa(w`ABu5K+gTx
za-;z|I(jCefhsy@6K&-zIj;DHl4VnypQyQg59TTXPa1AwDn+@C)W4gRYS_M2FTR0P
z0$d%giquhe-w%9@&4h!`m*~-97A*r{Rg3~$Uj?0<zqo=>2oFUv|NCOptSqeb3e@l+
z+*-1JJuye;j-%=VLzmnP2rOA|=b~Mkm0!fLi{WDD)tE*e^J!Qaa-~Bb^*Rw(4KeO^
ztNr4Nj6oRw9)>@+`3L({ySk58i0-|jZY+yjHF2M4(yXVP!`4Pi>v&IoE#GE;a3Wld
z=CXZ7xdUs~@tUV?ZPoIgtQ7{sc+6K#K(-sX5msP#X*>xycc`IWi92^tOPP&SVk1X*
zvA5|Me%Bp-C{8jY8mq+CcB?Yx9!NPjw(MwLgHimxDAJ*(iDev$(lc4aH*jrZqLkGh
z7F|~oUB7#3S@%*ILEclINw+qZvOs4z{kNTVW6W(HWTg64Ei=4fg!wH;f@e{^jwqBI
z>q3JuXse|0QZl8`z?5MO79Tw#qruv`m4!3s2Zaa12j(^j`>H)FiJw`MSqHqc#_A!}
z5>IWvG(Pg*irclW6LZyCG@rrA`QC~hy4w4<_0cj)g>cs_FOfH|X<KdHIUg$@1s~cU
z9uU3t$E!xGh^sPwKJbdi>?g9PopT-Nc%{SzjPp}7sz;ZzHcPK~f{1HB9&u9<eK^jT
z2!7S$M&WP%a>U_6#75-D-9w#(4V+m@Hf0v;K=Go~K>J5*5Qd9x5Fry$5!J!@FuB|{
za4--VnTF9sJ&F7H*c@la-!C$hG_Zx<MfYLuspe0!GX=L2dW)_~Q7O|NgOhcaly4Ik
zF>*bU7e@!S0J~6hC0a_B$gX5?ZD|?tSwz+3YqZj%ni<Se7Ou=n&K(qS&Z-o6#eP_E
z#pR6RBq$`##OF*#j7N;Uk=N11O=!dpn8f|@ktnsGx$J{d5WW!E8AfgPEj<L3cE+H?
z%sEpb7HWq;v&LogOE`n?^OHBf^zruVlP8M?97z}oWncap(rrk{PV2wGGZdcJCua`&
zxXfH0eVSjs3z4<l@bqBEhK&zP)3A`vn@cT?p4=@aXSCujwQ2$6(i$g>N|g5rk|b#*
zfYy)tqY5b`K+6JBWz^ULMO|b~Ng9gr=`~ibz-waTsqxf;jyr$Ox8RoR4aC2kL51q$
z>9|1yZBNL5@fTr&ZrS=~)~}zvx57i>l`n7`v5_vcHgGRry%=@cv$nP_j|ml~w@?}0
z39lXA{T?bm+>VD<A*@t+rawA9qMn3(#7v>)U!$Ie0)2oVMmqy1U38v0T-*;)SM@Nf
zS&_Wc7dV$8pDRzpF9`q0P8lOz`ny<&8u*zrt3Owhn?47Z>-kxTOc}9=P1gpBs6O4U
z7e+RA=i>TyqbZxhyOQ4y2R^;*o1Vf)K-YI1A2QcV1}+gWt1Yv499cBlOREK^tKnZH
zc--2k_R@Z*c--oocPHQ=g<LQDCDK8Qekw>2vrg(K1JQWz=_V32Y|-+9KGlyEUUidX
zWk1{Nx!#vnxpx`A5_GY9v%GT*av1Y{W&B}q-1^}6EbuCIdpm0~ST)o*S~kbOSZPs}
zz|Z)e@2UN2hWotK&@{HxP-n39_CU4o1LWgge0iuE!%3Tx%6xD;MyCA=OE_I+`J$?^
z3Y$+g3$L{~`2)i1(^04MOWH1?*Dl(vS1})zm-}QD?F>Hd2Z7hQlb#X&icaqvxw5RJ
zkNOvZSK_jz2ISJEhR+6f?N^ce-AlLCfvs1g`_>1AFIrkST{T&tI(xnrJD2(wy}J42
zbYAoixqh}E;+#K`$drnT$h3&ko7dTVcYAMbpa1h+2|X)m6X2usqPOe!Fn9eWA-3@O
zc+HCcl~tAH+4d&znzssZ-qrxKy0-r}&PSR1w_DzWK)3~Rz4y6aBhVwe1GxJ7cdFFG
z$JRXe{#@J6_NM3`43$qgVftJBgMh^nvFYX$#JO&wy!GexROxFp<07%?XZ?qON5O|c
zo5GgQdc`IG#nMdY=_=XcVS$f+2iYdzaq7*n-REFP<8z$9;j=HUYWZ_#B<lUNrp}-$
zi-$Xi&GGO|?BTE=`g}?5Bl7)aq^m)f|2g)Hi9Y8x`5YA8%&6-s_SShhemX3GIP`l6
zKY=*!{_}Dl$4}_<z8Br_l`Qw=MMBQweb3L~@Jw##GX1?K$mJsazMk7;D(ZeJo$&SU
z*rDL_?ye-1+k{buZ~8;S!pj46<M)7Y?)Nad2XQ_~K3M1@3VVH~#rUKB&_|9wP}3w6
zWvUT^|9T_y6XNnYjl(+KZ8sEOF2tm&;qTsAT-gp(RUKFuyYFb==Q_L!`?}7hq|d)X
z>@RE4e}h_kEul;Btq#_Qi9;@f?^gsJJ|j{9H$Uv>jD>TVOaG>We{>*$s+{`q3H!Zp
zbqf`buUUH7nABg9-G=v!kMCVAE5q~G|M1nj3gL?0@Al7nbbErP^_~-Bu=P@2yF<Lo
zN@Se#^!)`xrM8QQ7qX0?kjh)6wTD67W1q?7D0|oTVADY_VE>>ysrRT6`~7O16GQV6
zj8FIBzD@Za0<YujQ#~ORo9pvLj_K9u@NW=`fAg$m&4HIAY6{I6u)cgY*Q~vE)*8Bm
zbP+^|ZD3n-SUFT&OQ?Hg(6ofm)PC`NZe)Wf^RdGsH)dQ({+@Q;K$jV8ZLf4oy|P~P
z0Xv}CL1g||3FXaIzoCNBvgWF^uXEi9OQrjs$In&yEaxre{h7OU3-IW1x0mwf6&epb
z;>Fa8Y-9|Y2};vr;(f;mBND8*>t#@X0w>W2Y<SBd@<NnSX>C<dubWqCAK5&3*1PeE
z=bqDD1YsMLW}#I4eqgtL@MP>{@~QfFpUB&EDpE9)d%5|WEYr*TbuiL-`W7O()%{_C
zWw&)nqW9>yXm&5|FjIEUB=c>u%%p$7d)n<j!ga*KhS9@9XAg?-a)Cv^rw?EXV?n}j
zs5%uw_pUS5u_9E<OMJ)CE-vVLKf8`#Jxy^Xh(oU0?!@tJI;`pM<bL(P2OVBA*L%f(
ziM=Q|jv%HZt18RZZ;~$6l3()bfc4>MIJM(uUXET9H;YbpQLTr60qn4U9GYHwtg1XZ
zyBbBW!rBh(9I)1@JNF;l1FYwgRC}r2dQPp-Brj(3aP7Gp{LhUTFCM{AE=tC>b2m1J
zztr0th9BNCI@fOF&hx5>;_6&)v)nTFl7FxrN#GPHg-p6z&$o!Y@_FA!bSLUuqy3<C
z8r9so`tDnAsABD=<KNR4E`b4kdf4YNyuK{mcpSK%Pw$Ekf)v(t!l3h0p@_MbYI^I}
zTyf;yG~&31$TrMf=s2~0G0DPUbXVBEpX8%i{j)3Lx5oVrCQkQKEVmpAZL(|iVo*<O
z+ZUaZ#5q2cn`*JE#bXY{I*!t}4WQ?Hu4b?ska=s{bg|(XDSI7pEHtIzr#a}&mJ(h$
z2VGar3VJJ!yP*a##{Qg}{h<8zoRF#sl)L#At*3L>c)UQdRP^0$=y9elHpN}Bp7E)E
zeZ%y1fofpi_FZBoDyg?ZD1+zqK0`|bS(R)Fx&5e(WAY%)Q-!`o;Y`~W{c@Z|j)y{E
zam@~%cJ!x4TAI#u$1=jk-f<CRv`5%MeQHI^ujW&cP@lTP3>`#H<b}$Yj5P;P)^=<o
ze}YY0xe?9HWoxLI;c2bUZ5v1CXwwT#&HRwE$Ei+#g05}TKj&%`=#h##xhyG#GEmsd
z`POeqz*OkMFygN4^1Vu*#mH(((SVfq5`t+h2DFgfftlT=oZ_xqy@VXG)$H77H)YBG
zOMNp|Gp`TtRV!;cP09gVJznSb#+dEXS;Ip37HT^`;Qrk@)r~>@bux#@TTJT)Y~&I?
zkc?ox+o<n&#l5ROlH6Zc8ykbm6N9L~irwCS?{R&*n~P5+1*&o}Luv!7U|WqM%*T&8
zoFn9J9HZAfb~maB^_JA$KCa8!|6wSk%Qo_+;$sMXapQOp9TDK}+|`j-+RRnc&`D3z
zRae*QwA)|peSS9j^LEp|W@XcSN;K#YXBhFz9i%?4o7Gk8{!jn)=H%@r65*E4VeGtM
zVZf+{ncu~#rQ_u$a`EKE{`IY4;TcoC(QAKqH?n1{A_23fSC%^jo#V(g+@j3>mKq86
zM}WU~Rns12)AUkO{|=k8MxiQKQ#)dkxxgQN`m&rezQRBCt=jH4CP}%rbK&6gfur2Z
z``?G)B!XaBv9zDL`YmAxFT5e<rT#q4>&R$6eQBpd63sJ`;Nh+nx!>V*<5(lHz`vl!
zbwGmDY3Dw)-_W)bzvPRx%}RKmPSzqaW~zbpcRzoWdUC)^M}IhMA_i-)dSoM0z}RLh
zG1ZJS;D3ucKa}#eFC$!cBHKdzoyJKMQ1R6hzgXe6Cpt2hNVpnT!$W-?@Z0xPmJ94G
z?=PQuw<3QF0eX#WA~zBK&LQaRI=3)<bFEDxy^1WLZa;PDI1(>;Zqtd0z{u!2eR!##
zQbB8Sc=cZz>vRb*4oM;<CJr-j+4!f9KDL9kA@g3n@Ytc_sU*YUg3R(C2yeFvw!LBw
z|6?Lb4~-T3;RU~Ev~X$X*=ztDV}&kz@tsk&{X+56c<NG*)-{Wq&q*-1#Skf3s@D{9
zCaNkRG+?1IX$}qg+H9nn<Q2+6r>g0sk`4pX3${gDCxk9rv2+sE*HBJpIv+Y;5LRf6
z2m=L}ywKcCcEu)%(mAF{71sWrX7#@TJDi3#`;+#cW-bG@O{kmqfER`I`rP}6)!HQo
z^eP0<LuHm_Q=5N1f{)cJ)Rc(bOK1+zcm1<FyqSte{*57Yq<%o*t-+VbT>IuN(;8;E
zfJp&(<UNj*>E&7yU%}h<@<v?A=Ytove_1@sBIiw|OM_UrnxQJ#t9|$P!gKjpzo@BI
z+fI1^GZ=%v$6W;e2LJXEjq%8RqhMI`_Oc-5+_k5}rDsjr8sva-0#4G)%(*E|66T%+
z)8Azwzq;8DwB`LOn|XjjCctEK92lTpSF?q1**Fbrv32lZQ%13`gu+MDK&-3RN|pGo
zP)`SN<^2RS>k4jTa)k9VfcaE}^j|pUhby1gzj5x)M{DXFvUg56$_tjwG-Aw8!w0^5
z)NP#IFUWU9h-O^|#uv(v&z0CBVNRUFhmhU=p*nl%c?lCMcIF}W%`VN<T}E0*Jd(!g
zkCY+i{D~Bvrt>p6wliK*Fqe?{K&iS!K1h=3UZed~g!jm-I7k|$p2`icjz@>}un+Ny
zb&w!-K-R#uO&XF@LIqVL^}B@<WsSXryv|9B_s>{+!q@U>cWt{(&Bwn9<ncDy(eU~S
zK9$&m_5@$gkVt*k+DZ5oTg{B|bZuN|3qN|cP)yt%5mU)&2Cr~RQ8lAiAkeCQpNq(!
zEqIPoJ7JGAix2kIM!2|x>ya6iIgs>mV2P-$B1~I|(o9S1uwq9b^!|Gs^a)`c6wLg!
zB8A&y7C2suCmKQyVG%Mk?CGP9X?y=xx^8g{`w9QxKHqF~DVxQz&q|m^g-N$c9I7Gh
zpc5l(ed$lEVAI6-@>n}__XUMwLkYq#iM)Vc4Io=&SfErKAj$TveR!)h70HyeAH#@O
z7w)_i+0n1xhIw~ox~fH^M#dEEr_I@Oh8A>>p&37Q8Yp#<E6BA{d`|WV#K*VpPAI+$
z!*&F|2o@`b_h{jeqpEqw?}QZ4#=yvHrFzUDw|;MrLz4%oz9UBasx*}aFeHn?7GcqS
zqraiR{?jAzR~?oDaV?@9a?XdN{d_}jB}8(}FrC7zZWM|^0p*Vv3eTpZXl%1e6P?mq
z!r2CA5?kmGh&Vm?^8D^F?3w(z)z*0zGD?2NK-4)&Nj<8+u>cQ3-wJEh8}v|lmX=+i
znmF;qBIH<=6fsDt!YbECw6k4?|Jto~lfNqSn%k7Ii+werQe9!IrYZS1_nWQ*cV?~#
z;Sp?b4K9z%DSNp9E~$+b+WC_QKCkQ~%mxnl6O8=~a$(XxgJQhqf=iKwgXRut|NYQP
z$E)il%O3T(l#U-^?p0#X#LQ;~px1KMxdAKth))!C>%c*v%v13HeBc1PU~pnv*Eg;Y
z<Ja_}HOYNrjvHe=jXxLY=}+(Vp1(F-86~&SI&4ChBmKDwt`O<1uufu6hfKMbcqYw?
z)v&x3_l)~`3e;lH1=oS;rXAxOtuw<zZY-MQe|d?8-6TDtxi`mjpz1T|4O<8dc}_q~
zY#}zsu^q$JWsgpmz;nlyajOq(-L3?QJ6~9Dh&=rq4Jusz`CUUd6@f;3^NPZG!pQ$N
zH!CS~#;T^;VYhrpf^73~g(AH0o_+Ja$ddoEc3$CBU5W^4@>7g6RS9wtqZ=GBB#KU}
zY)#wwual=EK4c&AqDN-`FNbVZ0oD%Fnk@RtNW;Q6s-%RJ_BEVir%iUi-sxn;+n5x<
zu<xoC-{?1%R|rXgdOym~17?Sj6g?5y1pWTvG8waS*3W=p8bQdu>;d-BGlcaZ9u@bB
zsO`{Y!8fBAR<`AZeNF3h!-htKRkx(~HT%F|g(2=<f!gwCME=-jX;1Prf3*j&H+g~Z
zAj;vMA>CvOadRMUNJBr3MB+4$Xu0UG?%>nYucJd*>@$zaO`-}^jpDFA2l4uS-mmV}
zHlze;@9W>J*K%f$xxkd~dF)I*`kiV{OC<8fNTkaxB*}_+WWB>r?OB%3H85f@xa$;c
zRA%u;l$DHKoqGhm?C|&nYtf)S)N`D|-!ZR7)ovm8^^POGaWpj8z259dXuiTf<MeuG
z!$s~6Vr1=@B2*gxM$rq*AwG-s+V>nNq|pCQ00Tb!!7*B96bCce-BDa7tWgrQEMFxV
zYjX%Ju+cB%Flk5frTCjU%vH!EBPDvC8!L#kj;y|GLD!3V+kUXlH6Q+xgn4OXnYp$>
z+mIPh`(*M0XiOCLW1{KY{WOLBugZB?C+R{LtOVwkK8>0(8|DUzoLp%S-7W@Je6JT{
ztzg{{%=?RyQj;K|DL3@F&PW6e-$OFVMv!L76j7^WTka@Mv2TXckhPh3VD(F!mw@PD
zm8ZsJ-jGOK@+22hP-cc_M?vgG7rZsM-^=Hq&SNv^<B<F?U1=rK(n@eUz7D-1kGg_g
z#<r>q$xg34CbLB=FmFg_aZKf`x-qAjI9&GbdbH1Z|H)0Ss^HhdAWot_OMkp5(TdHU
zpB(!7`R#P9;7w+Tq#9}SB!rTkN07Abw!+I^l6X;jWsxWn`|8C7cbiQsn0ckED59gl
z`Fopg&|Qj<CgVO5<VEq<JS-kspk9=Mqvke|m*f}wNhhS9Z`||)wQMhhGI<4wYk?Pc
z+)YnNrG><jlzOD1*a$O$NK42C_qGaWA$Ua9Niotm?sW-+fhRRM%_q`G5Hl|-CF!kt
z1>26&YTK!dQHXaDL9NJJfvYKPMMh;Zb8oksM~~7XfG~nl`brp#7zNU38gX2R&4?~@
z7@NUqrBHZXKgeZeA{V=_j(I67l4a%y_=uL3e*S{j>A7H)s)t7q^FgN<#v_RSMn>63
z#&3k?^9;fwuRfOL@gh|<;t6L1_CZ>BHN5QwysD%ZB*XA3f{2uYETs`h1YYU-X@Mm-
zayMWAl7pedk&7W?T5-NPr17xKt<ZB}l*gdX7u@(zp+g{yVuw&mE?MWfV`wvIippf4
z9{^Um$q1HpL3;L70hU*l@Ga*3*y~;PHv9;J>YYBGhrK<-9&--96xZ(b52KHl^HdgV
zT%2ZpKp{X}pIV8R!|-;0laLgr5>qmjvj}?0^*MoNwvx*pgzC|12>e~UFi6e%o%=Aj
zRyNZ~?IDb|mta!>MoE7j1;;UaSD|v5C_jRt!Hq{y8E}YWUu(-r%&9@gW{>jo44-o>
zjUrQ*Os<A2VQ^`V9cdtpEEkW$i<^m0dibTeyc6z7HdS?82_6uFa$6#Y#Zt_@7c1lo
z-o3+b5lnh|)P+N>y&i;-HwP@Q&KyFKG%4U_GN(e&NRhzHf`~M#r(ytkb{1P;<kB{`
z8cL8w6iT*ZD0Ybt-?!8;kXQ^l-X$cKJsIMcHi*Se8oWrRvp6~_lwR<948rjtlMDS`
z;&<?YEOVtFMIonC*R1zY5ApZ?&C~5*4K7PLs!JHGUZ+o}rErrIDykDsDNIUURF;lv
zyx&8)o|ky+t)>CJ3ZDTFZG4x3oFyqWu8F1C>vzLLCO4MYMp5k`OH)l5h+e_uMMOFD
zF}$mx^aGKln=;wrqsnohKr3GM))Y!oDSGir$YDX0Co{lj2+o=17U}I9#HZ7^mAqmI
zQhFN0aBPvxJ)bKBA1SA#p@%eJ#*iHuX5N)8KaqiDvRG?#lL$<^)6Zury2Fs<b@}(w
zV*HjQBq{bVyzFj~yzK@Or+8Uf=LP?+<Z`fl#Te1Mo_NvoHd}Cf9^-mb8b2+4!0^P#
zq!fIl#~qxOo=k6lAeUHX>jf%4iejOqbF|zMq;ymvFoR%FF85vr%Mm06GQffcl2_9a
zw6f&qiFl?miDjv=dI&~WfdK+ODYPd=w7OlGyO+Hf5br>a6AmR#4j<g6QESWf6F*qL
zye2a3ei3;q{hJ-QNfy_{TznU(?meX4;9BgBNS=AoS8^%LB4UudH7V?-pvvd9oE6C6
zl=x?vGJ;+OjX<IUc)9EKybV~@GcpZP-dhvcXLza=yX>tkM%a=-t|WMGIrnYIW3u?_
zR(Qc*_mdb^V8fIAPht1~a^cfbz{~2Poi4ubZ_;=peLaNF4|<r}ZN=xeBUyGnT%+}b
zC*T{NOq}m?2A-60v%iL2LQyVm5C(q7?a6Q#wb;Qq5H~Lt{F|M*Fj(`~sm)>7^V~op
zBq_PzyX!$1gJGVAD(465$2qqFAxjy&iO~Wf*YlDW5Ezew@XPs0EAB`*@9pP)D?r*^
ziB^GOrWpv$h?Sk3TDReoGprSKS@fqhnrmE6IP;=#bH$79`W-Jmts-tw^tYU;kc!2I
z>j!`qx|#7f<-aTan-U|<kPLuzE5Er!G3!_jB{(7{OPo?|U@}Zg$rKOGf*bg2UaXKS
z{hP6T)sN$>m~`O-F&fp8%K(R1@$OuT!Y$R;%OQP{gV`~<DmIB1!~AC0xh1#ywZOmA
zhg;%`fAeO~V`~lh{K$ofaB}kNiIl@Ci;%>_3CSr%x7`hI!H+ixN0hk}Q9910SCVjZ
zi{E0lM(jph3pU-(?HBy@TVmO}<;J(rJ3p57fb5?4Zn<~;upce;V|tmM3vO~NZ%E=%
zpz|8^S(&6YdM}CGTvi@t+C)>AVX~tiso5>}dJdG|SL2g=2ec*!63NQdk%##c*rhpy
z+<>`PMlm1<+liN|La?D{SqSTSNR~4EWuL+x_X359k6==1X(e%^{EG|jJqan7te_&C
z%tcI#7E4ZXJKzxiR>VRjGSJrFmhtpc$7FB^(+sZQh(eHMKK;}~GLJ@Ju?D;86APsT
zPY_Z|{p7scxsCYFCogrd)owDFtax$khXEg;k!WSTND)j+qKgV9I+=rIKGX%bL+t2q
z(c`k1s7PkdVWp{1lE+Cds=(AI$L7nGP0#C+4wUWvYw$fXj#aB8gLoyB$E2vx=qbA!
zSHj!@J1#M**<1-%yiPyDxfjY!qby-ffxR)l9OBz#Jw3nOqDV2Ug0REM)o2^x5e&=+
zG6C;dn!oDamH_)FgB8!CvN6QJp!>%go9BDCM|p<So#~tr<>1`b%`m(T_rc8+XcKwO
z=iN&IHp?L_K`}$naZJHtgh*jGk`0RQa<S1Ya^Wqw@oga&7NyCehD59qt!|f|G-`~&
z=)Aywa2g4fmS$WAR&M!g$+EwGE4du5Lkbb??C6%rMdnJrD}xIZB;z$G@&=*8zT0CT
z!V1Enpn>xD<a$xYEd`D&riW^(idP>kK%e@$0;G%P3LJIU9nQ*o<g&b@-nukTn%}cF
zkiF91%rHl+<Y~@vnp~PGwVZrm#phDoABTRBFQ9bETx51W`=J@>dARjHNJ^aMA#6-V
z@Jp0*$zWjJUj9Ugw+;l)e1{yoy`$l$*-5#@O+M5XD|;LtyZOUoAu0Age>&W}afxV0
zw0g@879;+QltGTkkyd#=oWKi&_ZuHw;OSBTiw}3bo|GPtVmd@gcFnndPsVjckYcYT
zKEK%N^~7ojDIU@J^n_hRTsRL6h2%9#D0vBKkc#hZ@cS#<8#lw=*Vt)qTnW>NoZMt@
zZ1(aoGYZc8iwT$WO%Ob4?v_PJ*`f4^-CgEN!;1Pu${*-_uPj4NR3(&MfZ+4~`a-`a
zF8dpPf*3Uz`6AEV5Yh}Kq16ys93_W^C(-a2lLjW?mm+sF4=+XGdgN}13;x|@Z$m)f
zxj~bkcpEgGl;GtgR=f>&^HvynD?OjfLTON;n^Cxdj>Itxvv4W^@sOj7AlH0!@#{)u
z2OMSPnEl0w4n?+-a6?=PH%UEO3!{w@{}TK&5<y8BX`Tx$ZwEr|4v|~`|Dc_R=KbL@
z>HMy{?8PxvjM-rZf7wrxo;M$KeThDbB?5eWVHU@ZMW1>42%3X6M$oirHdTTHMF2`I
zRON8wn}V<}36NpA5?Z<KZ-U|WHwk3V4ttp5R!q2@jX+|Qy)Y}9`+h#mdi33q9I3G=
zb!Eh6w(13ZIuRSwOSU|jKjK15y@CYfnY*;Fa0V|qPUqv68IyUk2xR4q;sDZGZ}ia0
zB*J5>6XSs`DHi-dEVzCkRkjN_lqyvU94eB!1SKizNv0u@$YlNu5|K%cUXuvklh7te
z{DTa{)9OW(j&tc1FHuPn+NCH$f|K;Qd21dSIF-c@IZPxukm*X8_-nAybB45FjWAAS
zE*V9xU@>6(GI(T+WnhXd%=>F3N>QGIKYHj4b@AEgi(!;Q)56X~G@L)qK}Wpx*_9MI
zj(;d)$?x1=^6!R8E5P6-Y4HX39<APZ$&0cKmZZrTLq>{#unX{b9Yqs;1D&ViGGqoh
zE>|9uJf;ZiGU~WPdhk;ysU?ePJer5ae-xWx4q2TzngqwIyYu(F4xMMrj<i5Emcx>=
zV2M-9g~Wrb94WpTNXqMIE`^eemdK+HpA3Z2P~gfDJV|L%F>;E?3!F&sBQHKC0|qw;
zyh;|KK;3>Y!t_?dRFsoa`)Y_GxYPIVx;-KlWSmlKQ=M>G4b`dp)b}A4x>@>&XGAO~
zS$ZUpex!U3b>0uUt6>h2lYH00qn<@ohQuSPv(q23-${a}OgMzf2mZ)1S&WQ|agcXZ
zq@Z-Cayr~lAI=#CNN(b|Q-!&4BVC6C6HA~A6|f3;0MlDJl%A6E973|NHiA-TeN|jk
z$mr|<gY>X+H<)<Q@eWlie{?tfs*>kaJC`D_<D+kj5mW_v)yKu2o4_!c+?sPYNm3Il
zTkhu9`66+8V`Gy9S%1Te69C6p|H4huIKoY|2v*w5VYtcGTs(6@F*mO84JI74ka-7g
zuzB=QcK*#)uze_3s<}rqq$Uy35q(wFp?Ha$Y=Lp^Zz>s%>|`?k@>**R$1)<8OWHxQ
z7?JgCHGJ7~BV4iJxto+!CTIjr_kehq#}f@x@p=~`uvkKH^C->MGZmkt{GF8b5ML<e
z9d@tZ;9VeNhOts*#4sg~#Ft+SKx4eF%>S)dG97mmSLR4gocm}7k>y1N<*8HUEL!j&
z=OX1FwlbyePDw~RGC3FDl_@41OOY2zFP_&;4FF1c$`1H5DChl!Fua}O+8jcY!s_V6
zh!&RF77n44tx?2rtxC4i>=*iLYa4Drwk3I+PHO%jtx+MB9~8??;aHp=L9wK!AjP>A
ztO%)sLA_~NkkThjonpa@*6A!i%S15zwF9z)iKWN``{84islkDRAjz1<8HW!4<Z|f1
z=lO6Wha$21V%U#T4}UCg|7ZnWQd(9+S(Giqt6Q8+tXo=$A5s+6{`RuV;nsEE+ftAh
zQ&0qx26X0Te|>#q_izLTIchNH#H4B3FNP6>B0Bm-n<WQPfgH@&FYwu2*z4AOMl$1A
z2)m4dt%=XfQJ~3Y56JWV-tC3(F3l44<-8k3$WSNV!69$UO(R7hDG(u6M`2QlfiJ<L
zLp9Kih^aDhmO0W*!G|v3b5$n+SYVHE8syB=jLL4}$(<3&AxF%~;_L3y5t1I#AS296
zl2dZK!DCBh;=3!vR{N3LQ^><S=AlQJWp?fmlf)b|7Rt6Gp)^=5%RTgsEF%p+%TO{5
zB+8Jj%}sQePW!>9EYUDC%H&ZiaGH^~=1L?>UlL$Wp@1y*hr;@0C42&C^d>HaRehrD
zbWmw0a1i!2T+bzrxFgi{St<v(6)%W=)-+{i>YY7OT*1msLF+KZjvPtj8V=vvHTvd}
z+=p1QY3a(O5=JGM7e^&ZnE{weM<imUHqd;)66lcI0dn-L<Hay)1z~c_i=^0{5`t0f
zF+;19gQEp;nE`BiQRc}|2yzj76zahXL(F40gNtBCNq!^67j=gWF7KjCMI>4Vn;gQf
zhNJlkf`>%PwhEQ0`?z*cDqF;gSig(_yx`r-06v<hLUU+d)QRqh!k{x~WIamDu#%Hk
z7%3%gX{pKPHbr2}d>6YcMYV$1Uk&Ntpb~S^dqapOz^HIB#1~^+&J_kyO6Gm;#tG|;
zbleew=V25Hk3cf0ZY^MQ>RdmH!$=(s4YwrR4m!Pl*K2iH3Olr()ILdM8*rCLB*Q3B
z*z5ILolbuPfrY3nrrV<A)dOK9uEkz_Aw<x+zv1>)!1ZOp^xR^Gls5M4a=fp(PUdv(
z;=*UYrda+4w`W&h^tS(SmEh-}KP^M$<)<F%s>*KLd-m(gEQecJeTS<*rig&mU(L>F
zj$B>s%ks9NFqP)=C<yd9Fcl>g70I%cga!K_b`E3H!;<1OW<s3q(Bts!X*XD>II1H^
z{MW=-{+1%3VrlJ&-azPP$M+=)2B&3jEvN5_g)s1Cg(~(;-L#NWvK)%8wp&VQ07jJ(
zg?aj^JVqj3@a_QtUL{7gRnfW`AGX7@Qp;CP#MgqGIDjUXUt0EPVEW-JG$nmICjM*W
zjtKV2^EEiJnCsH56J%_O(*WN?p!DlWELNFJl418yVQIOEIbMcR91oT&!y`{ca>--w
zAK<s;JpwVQb1A@P;1s0jGR$9!Sq(>FKJ&`g2*ea@2Q7eB6jl<&iMc*(lyrAM{96Lg
zj#>!m5}PQ^CvpnWIP7Pq_v43O4@YuPED&?4(pfy4k{dFKDQke#6k>H+Ged9;7@ZiG
zcar3DUU1|5yKXmkRZGm5+t8|Fm=D#*ih;}Pv{G4-9oAW^+KZ=GVBGfBeUHXoo%fVI
z$u34zQA0AI5*T%HO$e*+w!*@(>L*C4r6jp3P*|8bP<j@+eB?P+BD@k{lovH7kL*hS
zCY>>k58Y0BIy-<Hiv_<Eg>kr+9Fqq#=aD0~+%Zx=(+Dxf<xV}OeLd!~UujQ+^^12A
zo!sNDW@qYRX$$1E8X3-~Fbpr-jdO0$B`GVn`$lm}PRU`}0^Ew@u!Hjh+?I5sVg$Wj
zHwSaIIRsjk1JzA#IaI6LJ+%M1mq(CC2?aKc6g~4e*^L}Zo+1lnU=S31wenWO#O)mx
z3FRK~*KcKSAwV|174~ukaNSC(f{oOgKdH_c6h9_|-c%`!M247)?;gRWk;-H}KzQ+y
z97ZX(LgwUDyH*0My-FZ|39W!_RwmE;xQG_Zj&!3O5%EYoi-{FeZ%8oxzQ6hOQwVIA
zZF1LR6?C-DC<+FkEx@U~=E4|u%i(mh3UcN*VHrYz6d_b>*a%YE5L%Ihm8Btf&A9k2
z*N~^eH%svOdO!?#0@LXkMds)+BzwXsO(sRaSG(>9h#y;A%K~fi<Xzr$beVj@X}6%@
zAW(=<O0q_V8j3U%rY=a$o}{_kX-=-D#hd>O9_EMFmM?I$#(Zx6dL}-1lYNUtbBY@Q
z_q&J-*VlRRV=b}>5+BkO$YZs7%g4G@(WokpF(b>QI$Yt~=wgl=k!f0bK2jVPKnJWt
z#z-4+&dSQ%4S_q*4f*YBv3I5SaQ6JYo>~;XJhI2fmszY$BMCUg(hI}5;4!-E<uYB;
zQ+U&H3U&^T_K}PXBu&Y9yw*s&%lH_ZuW19au{9Ql2qRr)2uDmTvXhQEBvZ8<LSEkr
zKLmTHKnoHM4dH5z=t;_u4bNuerEcIO(rGT|h#OdPr=Ewyf&fSC915v6m4fA^9GhN{
zz82=DE<>i4d4=MeSEWf>A&I3)qvc4!!^reJ9D5NK*HTX%^&<zdao4+tGv<<&hfD?W
zqyUOdiJ*kEVRL{$e9PZFj@yB+W$gTdx0WK*X_*WmSs)`+_$hm!;=GTA*ousW&LNan
zT4Y)c!!*oTw>+-cU#VMR#Osi*7`7zD($AbiEHJSVFP4{AgJLR-H2x@KwL-%}n!bcn
z(xd?^3?Eqnp;8!SV^i>`9Zg}C%B5hbP$@98Pht(kX`16&Mr6w@_(xnsXbFsi)bU)#
zNI20kVMC+!&PlTsmAum5NX>Ov1RO%Yc1&S7M3sR^ZB@1KTR~3ujYqtlBs7i$^3pJ~
ziAS)VQv%8`a5;?Q9uRa#9O>QYaI4#eJSD@iJTFn4p3`$7j;=6yTU=X<fxF^ujUtq6
ze%?>8fY$t8kCIE_COt2QTlAzz?u$tA##5pZMS7<IBsGfWfe(Z*WckadU-0f_Z^{&D
z6Yy+@U1(SRp2A)BlOCLaITSZsp;l<Zh*G3dq71T>R7XYF5+%r>V`6Y2CTGBEw5^C@
zh9qv7fvNy+xeTAXDJOLv%4za?YrHUSs%xaM_&X6bxfSu9OY!K9;~?*fBp)(M(+sk0
zBa7;ElRhL<$yg)|zr9QnmkhTug%)Y@wjv=-0x6S8q`R?|5LYLT-b#LpMNZMf)3g>_
ziM;7B+-fD@*bo&M;6+N(%d)rWxyi`w#E5GEsR+7mByadsVK!*5ynq5&`YQI3gymo;
zC?+4bgcjUQnUWXCFp%D>z$C4csJKv^83V{$eB_2u4v|uqs*_MAQA=TrOS9mDkQh4A
z&dIsR$7%9jN<WUigdh%(K$*iwswfbPXhsgb68LLt(weQr=n-7*ei7-ZmObN}j8;6=
zwPVkP%Rh8N79B64gBUcaN<m>DXNaYx#3{6d5{SFz6e}^&x|gKehviy{l#xLU;M;KE
z;-n$M?b5V7AngADGo0aMiZ1=;K3-;e!G|I^nVt7^C8pJt_YCI>!-Fcpcoa+(HhJk^
zR_G{}FXfOxW@jak1{TLbK*i4c$%YG(%Z-N{BF6Qkz~G7x5pLc<*qh(s^!z=U9`S}O
zMnqA`fRE?V`}7e(pDqXjav^DXftaL!d1*Jwf<ue>dp`GHst}_GgYowjGCVIXs3?aE
zFRF_(Xr+LPWf)$V3Q8jY&u^!d^!+YV|I{A`kzS&}Q)Lpw>I%dzN>O6uCJrH;Jv4k7
zb^+H1QJkq*_JTw@rqU%zj9uP~CM2hUyNe0<@BEe(KIh=C)7gaI`E4tswJ#DM=?6aS
z+6(xzVJatgJ|eXpLdx^*dJ%2nL##B<Nu@=OqKP;*S*BavZhH-Xn;`OHz<gUbdxwLB
zKg-H52WJrPWmtyiQ<~Jy3{Ct~#y}&LkM>Np*fc9uoKj302P&<DGW>~A|0QNuuA$%M
z2Sz7&<O7oRr`=uYg~^fIu~IEK!{D#T(E*XJ@239Gr6}Ckq-ru*MY>%uu-T;x1gX8Q
zSo3N~(D(gKddk?th$oLz%D|i9Gl*z3gi;3EF&!<SG>(?2)Hb(PNKZ3JUlhihpoVun
z*ab3ou7r{(q!dw&m0L*W&j7SHuuF*0(4l$`#Ur|g2%gkRr~p#x@;Nm2`P>YF8@!bU
zaY&&^l~RP%WY%Q`W%g>q924A?{gnk78k<$5uF*=bag~3&EU)Gge9`S8)FZ$bjvR|w
z?DHPR^MV&AQMkR*3H!8-+ref(AzuKe(xW#FBFG7<P5x%!L&`1VXaggW28m1eNG_@d
zt^Q+*Gav}l*zWWnDzDDPca_k@WFx-&&~uMaAbUNphcfgxALP4;E8}w!NT4S&*i0U@
zzZ`C5f5Bim+{)bisa#Cr)op(hh5&q*N^wPe^MFso_>v!V6~?=h!ff0Kw^GEz?g7Og
zN>mayl1HzhQs^VN<6}iAi*7}uBdPg1NAH!|ruCQA{?J@$(BnV)av?tN(JK+Z2MIrS
z>f^k;W_14E==~53A0NXye@`rX>!3z2dfW5&#DaTI3I<(|Q!EBC93O&Lqix#tITR)X
zXWg<2SYcxL`~D^;QoA*_7o%1@h-ECaGUmwN(;(Mg_J^RdIgvw_<&O@fjLwwApZ{Wu
zI3L~<aDm_ZIy3A&TH2Ig1v+xK#l!#jXI{HVRdCKZj}zeAGMJ3xA=tgbh(kuqTrW9)
zl}}$PEsSw|>k_|@h~;)5AtFoZm$JXJC|_Us0YfUnDF3Ia=tvIBbRBy8V#EhAwv{~v
z4Lu)rw?_{x6DGT44UpQ11V~Mq^`ZVvmBj2Jt+*`G>K0w3rO!n<26z^v+An*<<UU1a
zyFEqGRk<ld-e;J116f6;5u~W4$m?>nr1YQ0ltq8@0Dn=gw|zKhKPNckBKFx-1Wo|Y
z48kqkX!|fVXD?Xls>=RCW6qB#siXvQGeKAVGFD!VmLV{}GKq`6DIuNl65=JK-lv_)
z<o%*c5l<Y8%gG$US16?$rV&!&CAW9`@Sht|x7%d5wew$Lq7*spu)}dCk5Nbe@@M{v
zx*RsWGhKq&#Z<Cm>B}&|#Go~dQ7cTIA=`92ezMIRPXWvqQc$|jc*;_&9Ly9Z;bSWW
z*)>D74&aePu_`k2$dTBQ)8`L8imqP&2UHA#^M}W!|MRN-`yAo@FH~(i@KnXLa<BWb
ze-p7A+qpkJn?q96Hb-|5@Ew)D?nV9@T{N(cyFl2;1j?B|Grt%yN}Zu*NUC5mXMSys
zCF<UGK3fToc|lT$Z(S6jh{T3)MIx>XPedXXz6eDiMCpt;EuIj<SQN1k^_PS%0?`$r
z*aBQ`iAZ$BEg?$x#M9y_A?nMbF9MMWUu+0Zi25AW?TI<j6Oj;S+9D9KNJJ$1R03u3
zUH;w$O1ol(ej||x@%Z2Gjd^O9I5{uwiH`6@Pb>>hxS~t_IW1H>zAMB(eps0+vfjH~
z?z?}Va!X=egkn`h!lki6iSG*WPgcY>wb~OK;<Q*25tYY#UamElg)eTR{MCP0`M*am
zul;UnJTxXki2v>1{~xb^^nd<*@hAU-rTty=)@Pz1gl7KmKMnupfBM(k|DqxaTD@MV
z*9)dO<xJ>~;TU60O*1P^T{EW~TbmSxrqITknrV&+%`{6wOxX?1G=x4qJv}D0YPmS&
zJf=B@DFhOeq9ioSsN0VlO<~#Rih!)?qR_Ou{WwF0AvC8oZ8SBlt`(X>H=3euKR(tJ
zPRq13&2C#K#8^dhP;l0{S`_+hU7IZmR55D`4K1t9noW&UV?sDS+O3yG!M?xKFlT1)
zC9`1~_~2|w6iiDYEwe0i%f3IfOw$wvy{_qY+Ynl<UND4a((iP=FebFxv|(w&o*!!p
z`#H4MX(7*kuFw?IRZA;q)(K&q5Hp2}Rxm|@`ZiN)>e{53)GEz_j;DS90miRZXbRJ4
zYL;0pibA<uu9}vn&&bz}f)IL9=z7i44WVnb+L+LE{LIz>&(@0gwRE$o>yyHo)Jjdw
zn$#x6n9#J@TC=K^OC>}8hbGwf->r=|$LML_f3Hz9g=XJ>&%Xa&xmh4=qgEEWZr^{`
zzW;7j=opiC@qa@I=l+MKCe5^A&~LG+Yjw>unz}YSZ3@k~|B-$F-O`kE|6|QD%2+)1
z{dXOs*3`8r=l<Vn&iyy-`=1n>nkFC4{ZCQ+3(RU$(<TL~oD_OV=+m?I{jZ9s^f$BU
z_H1d&-qAG2s0eMEl9R#~C9Q7Xf7diBmAbt%QP-?y36<6jg(@}+8j{T-<0aZ^3Toz*
zy<_Y4&XkUFv(wY{rmi_VGZtmqJ5ysqo1Qj=R@Y`~qM(_TG^Z#ud*`t#R#>?xw6eYP
zn5ps%A?%&UFfOK98~sihBe-))n-nHJ?VYI#E!q1YW8Ru#Qj7~dt;sB>Z`P=M3Zkf1
zZ5DLXvUeW08b+ZhYNe)Lt2sMo#+t$^6sPQ+b6NrOZcPdkTf}Z?g&Iv>!FfU}=v3l_
zuuRSwL75YlhP5ma4S}pyVanc_*NptHeg9qk+mySYAI;_8I_1x6RsJ=<A>q-Aj#Tl;
zLq3VsifuHh&!AW8ty1ncUz^0&EKNu0dF_O#pAdzLRw{}@tyZfQMM0~X*i^Mz4NHCJ
z8vVXp5(TX>J3U+Gv1ptSMN!aeH64@y<@K750d{s?#un9UwSo{_PuUb>W~~e|$_Wiq
z@a>&DR-smGYM7?77^|5kO_<PXWe`*Rl*^^2pn?@k)9cjOG6;iKuAdM@y>v-)jhdy=
zw9=%W5aVjj04VB%_37;VXc`N0TE~i=rp>qWlVTGYST=a*6T&c^ouAZ9({grxf>HY!
zcBZ9?6Ihz|e4#03jVAz>rktI3HOD9lZBjTbqbZ!7_liwz8oRcsX_oyQ=+txxpZ>sU
z;n{L_J}4p2+4-Q@6qd8|SCsurrv);9)exFaRoOcqoe)LMX<6SA+H763>KanoEd5%B
zrH@-$fygZWl|*6Inw_0Bn%XR?(ljC#e=Dg96Hk4%Brs2JOjp4xc0SW<wT4jx+1q(s
z!X~<L|4nMauju!SZ#7NL+4<7G|A}eue5Knvzp{6}ki}0l%bLCOm4ux8Z_0wQ6w$ez
zuXuY?k%ADjCQt38C^rkHJ<#ezKAig>)xIeT)3tAvOIk*~>RMf^i&2azu!}JD&4Ny}
zjQ77O#<b~%VVV_7L+XSu!I8D;S_w<%gs2rN8W^^2GG#E#W<hI!GEftNniNH$n+?MR
zYj*Cx$;;&LX!7dz;}c@6VK`UOReLan0UA77ZfXr@@R&U~_048+${swfIfKV)rad@i
z56(24tGX?UnmssW)pQI0?7_K8Q*Stf8GCT9HuZ!y);J-oDQEDEc0vGU51w<Lz>pC}
z<&@~@7~G=w#+!x4q$<up%^sYy2hWwUF{mp}a|~$iD`!IdppnOj+Jke%!3>l8Fk=r|
zV5pWcV~T=3IHl`)iF;&}F@zSz)DXI9n$>1Ov*bt7q{gHG-*g5qJA;?&Voay%<Pgw6
zopOYsJA+pUD>G<=LW(h(0uup_Y1#wVvGjs<LIZe0oWLmP#R}z=r<{RLDO(h*Nh(5w
zP+0neC^&-+G~p`Gjx*@fzWjjF+w^;<nw8SWMWK-bMpM&eTX#xLy)o-th3M3nby`kK
z#~N)pElU*mDQ9{E!|e=yq&Y3j(2p=wQUaS4rKaXw<^DHFO46JbC{7FHK-bmNp10@A
zLbvblAO-0QPaWe~w;!+DkC%i_jUc+hANmRJZ5<yW*~gUFmeJHq5`aw51Isk4VyrRi
z?0jIFPU{g-)VS${aauY96`?om!5hHQ0LX>^fe99F*@L$*-}c~bN{@@8Hf@@gSvT!=
z&C(^y1l=`@72O{E+ytjlj1*W(o0VokGcDBdE(A1eGJEizc~an|_bhwxrnB>bJ$TP)
z>9UcQ)3Thw`xb`Zv<L51n+4~p*-)cu58fs!^%vD<!G6wc*v~cW=V<Hhd_W8VbY6D`
zA54gXp4DnLHGA-`JpjG72k)9=P0cXJnxd{5P0fDJg!nS}5L<zkg+8n6jwqp0YkJzM
zSvs19(bcRPGVGlXt?6ld@R6n4ZM$8xG%!j`2;@MtdGKkC+FWmrrRjz}_-v|K1dQD=
z_*IH^nqzW#Q5J{@lZ-F0;mcF@;7ig<icJkGADnvd705ox#|3ccLZMJ>>Sn!QR-0pZ
zIJ<_0rBE-_3#L`E%%ad|>V+A+QLZ(0mVlU6RGJ1}sT-zVO_P>si=w^zsD$bTt8SR0
zFjFto4XUNew4=(z<O_SydaMb`*K%6er7Q<JgD>bCx||DV05)L{=Ao3Bb?7!Tb#zPz
zP84*~9t@$CEu$#(G6DL`3<+mb_U<VbWvb0F%>;ja&(iBigJasek7KF**J50=2X7)9
zi)rS_|3SWqFrTV`Hq21TNik**KExKFbwocE0RrZ<?7@e`5$wT-6CjiyqGYS#v?|TC
zzyxNUlOX6c5+70v?cHbW!Kqm$mybDv$FPKVpP^r(rOx1eTH7CvH8p*<EDF|aV|E&g
zQ#gaiKtKjF&=BxCZ477detF8-eU26d#u0jiXgIqqlC~R~vr7WX?mYIhGkD)=K?$mB
zroG#?2Ori!26tP?7`*K4&VNG~Be3P{wsaO?2JaWCLIXmC-OwgMw~Z#md2rJ@W}((J
zv{_!#vk)ZFu?716RqozQnVRuR!)e)KOlvqT%iew2YS_E4SW@2uZO}0gc<@#~1Nmjv
z8N347<{VfduOy<1lcLcqQj2B@%fC8y)y_3=UtwTDylgqUzB715*C(2VSy|K`oGLc;
z+1dJZU5u$xcTfsauf5y1PN0ie+hS~XwqDnq-FZv^Sc7R|Q7kxD&2ce?M9Zw3b+ZPh
zzw<t&b-PU+-u)AMFjXQR$9&x0`4v5OhY+D_&hAbbG-vlUd*@f><`_~C$1#3CqF<D&
z*}KD9amv~K2{cb(?>+z%cdphdmabb&g{u{P%HDlL!+Mw?0^N}Gd4dQtgkwMk7*x${
z>dsXV8nEM<RkLbP%^`aiOp-9oLPaZ9EM0-+ie8+uci#lEppf-SK_W@RD9T4c5cvll
z5<K|1Fe|Ku6l-FPMI)Ar${=zr&^Qw`q-75vHrs=Fr^VY{X)d4=L=R>xW2OqZ;;KD3
zRnu!VQGyJ@vP(@TQndS)Jvdcw7MR}bzJ;DLJ>7kq=qVL?+a9!RVsaUG-+f#1zulkJ
zn+A5v&+O;0g9oR;51pO&(8g0Gp*5VVP78)3XLlQ)pxt@ZxoS4`npLxR--W_s@4gF)
zR;$^&?~OIJS-m30W<i<k=k)RBSdGZCW$%1s3Z0BaU{o~{b<3hqs~e^>_=>2y!BpKa
zon4!$x<M3LQgvgd%-QvVNwl0&Ov@>m(sG9ChE<2DW~Oe`3o}H<3uP!vwJI&wD)t%{
zT(xTHV;V|XGcz?TvQ#B4@q8QOq>s*PlcGK;ik7D7*?b$7CW!^ety!dsF6bvT2zX^n
zhlpN3p_OH|C0S!>Lg=|F$*7>yP!ATI!Gc+6ikY&I^%~Tu-BW1P?kQ>%0BY1Oj1Kil
zZVj;98bW7UG~UYnrdo7{rv@S+YnKgF)k`H?aV7)yzbXr9uy1I36?$^92$l)qLaSlY
zG|MPgNZ1_AI4#|#{>|j%%(13u%vK@BNcpzd#1eyq3R&A}=_YZ68K*@klJ010P|5_E
zw0F;$<IMsdQdA-WIBmfg(a@$F_H&GYEo=9eU~{mU4L*c?4lzs=AvO{lfFxwX{$%fb
z2%(4JHlz?^To_KPUT_9?bbY!k%`Wvq9cZ?_P|l<%IJ=(^0wemVX77GRGev?(Lo1Y<
zlE;|XnWF{GG||+Z-A{B2gjlzCKeJ4dsdqm!9}xy2=tZ_$(H^P5zC<{E0;=%tm-2gc
zT9Y7^Od`iBdZ9>iWYMzd+mdivCj>UcS1@qWyg~@m^+KTv5+{uhSp4P*A*r5aQlem;
z5Y;JXPt)x^!`>^Cxfb6>eP3z?xq9e3_TB_mM%^&SVL)V~&Yo>&l8>Z_(?rzs82PX*
zjk|h6Q1vH-+0?l2RifNQ6JM!T3ijR<H)z~4U|8S`r(&3C&Xm13qZPkp6$-f>##=yc
zGcsyrn@|3##u@ovqoUb+<(k}=5?SO=RGKt|5Glw4E9WYg#uUnQq14oL%h_v~f@x);
zPRokLP1D(HJkl&_HD|Bk?0$mfMpEeRC#Ff-nX~%|B(<ybYR%dG1S@^7LALQi!8D2K
z6^oLizNr=My+=p8DMz5LW<~aesmz;NalAREs@HY4{tWKag`wGdk1^V`+vb$L_qgsD
z(-zG%I?qbH2B(8m;ZrJC8nqru>s}qUcRBGepqr2-TF&4OiyB`Pg;s<7CbXJ8_z;Hg
z!90Y&9N$Jq<U>)(A~e(8AKANPC4=<wUYW^7p=Mgya+f>C(gX=)_U?~TZEx=x8`kID
zdGI>Z-h0Lwyle_hw;*IfYIJsAtJa86nlO7=q%PD_W5D1sXLrZh-3HMkX%`Z+v)6(+
zzV{r7v!ISf6*ld?d9nwTDTUXoq>i(d0440bwk&}ZN`NSvQxFi<Cn1WVaeARCU{|hI
znkCJI6Tz%N=Gr5PbnhC>%tl%0QmCA08XD_%&Y-V<vsnhuf5sl1VH{yet#<}}XV3?g
z-T6QoDfTuX*zawCVmNzuoIzi`C;un^|7}rDv(01jp=ls@ub<{(A|#6C?><Q{GM8L9
zS6POHHlf=)AMuL$2*$x&)nvv%`G%p73j++;#Q#llZaISm*p-|;w_%uM5*|DTgD<z1
zC4RI4_K5~NWA=VT4YK!MD>OxsQLh1|+k3C&Ob9SLRagpu)ebVOOhYmksaEu9tqcW>
zlx7n`8MH5a+1`5%t!e5eF-Ror-E;PH5br2K)A=Utn7s|>Dpm6ss`(}qbV@mcU$M~&
z8u}y6lCtuR;EPSH&lx<xW#OW;ABUu>AyH_GGJSIIH5x~gtu^*@RWU{%hGGJKw)d8E
zb(V%~=L2UC3v`yJZtoRC=#@%^)VsZ(*PwE|@9ca~YZ%Vn&sgdBu+}h4u;kK|z4xAO
z7^Wcoh`cLx1NJYf-`+h3o$mf$k!fm{bV7ZWwv)a0z6IvlwxJ%{JMY_j@AJ}mj8;1-
zM;Q3sw=nR#Z_&WBX#GvN*9OGrr}L6D)0^FP4f(rmR)q(rXgln_<?OztCTjOBnyB5k
z*%ZF_0r&hvnzg+T<g6i4X%-p=I68Q~W@1Fhyk?mdvH?uvAL&SK1GKAVz&%tOrJhnx
zAy$<0*C>5M!WC$S(8o;ZxtzeBu?leinI=3M&hBdkewgMH8lK>{Ovnq9%`sli1?g;Z
zcFsIvX+_;k!PN6qgRoIf!7-r~%5^bjT1EWh2Jwe#5Gt@ei0C@Iud(<I>o4Y8Xf<rb
z8mKo6m{*;vQWAytS}Q=i+WUz0>%EU8L}o^N?<272!5b!7vFyPc7(3InSjo&Rv!J}y
zLPe_<sURNUyKMB|`&(E+nH1Mdemb=GVeK6Ug8=pum~UaUC!0MXNWj|rR5S7TOf$*M
zy7w#iJXsb(7v-x}MH(iBS%vJtNwXp#>kt6F+Jc9etkj&Uh}7s04p3wE@kPo$z94f7
z*aTbKpu3SNcuZ)O*<w?xu-~d;eAChly?SICD?(?vlBcj>p;)D0<|o#yj$7IoySS<p
zPEf#4rHpAl#ltf%6|nmsYtY94*I07LXzzW-k5BQyJ5}a=XfjHFrt$Mr`TPw`)HIsE
z;mH}osazC=>DlS&@{~O+>-KPBy4KViQ})oN;V|`Y3fPS$m}S&J`E%u90<s^Up02@*
zlA#|F`f+c=xjVG!bKs<9qWr@NJDblbXE+5<h9Jp?rd6VB65{iPun%jsNilZlW%2@<
zwc2>D5)OfY;$<18UKFBk51~cc!-i!KAB7>r9yXApIXl-tH?$foKF-d|H67biO4ay>
z31l0{31N;~dIpp$@Sp6ysg<A|luGb}T7^QvEYmB+V$rM!ULrMWl5W*XWFfF>WGRpu
zJ!}YsCtoUwTJVyO)mY%I@k)Zx!K~TCbJEdmm}Pv=!2e*-!M>~6!)Iz{vrwZ%Sr|Gw
zXc^_~T+?|M8xSc^v9}4k1@z(myCrab_+ZGmVL8KjF#MWx)fvu%84TIHc-0<WCB16+
zvOa4MuQ^u>O;NF$rG{bFD&?}h`=f?E1n1MOauwUYZj`Mu`J>BKVK7)X%7uznG2!Dg
zta7>9EKQg3dfkB1<P2SB=S!G3*|SJ)fUl~}F<p5dC!0lGCgtz$1LQkHmwc3vdm09X
zbr6TKhdx9OrR3Q|k9j~&xD{Gi?p}N7S<E5M5r@Ej2E815u$mc|eTx)8BU1nk#G{zS
zqKZeUW0Bo|x27UPOgI<8U*H?5S*giFKFUqQteNml!cKstP^YLItzIYyQ6@3y8cd}1
zLS3t1DgOzr4$_b8;h&V7x^C4hd$_}5>Tp=Ihp(|D<_w1=n$_XZ84e+v)2kB#K^ICJ
zuQapmLq-wDFdb3Im7pI(Xbqz_DT>a{r!{-{ragSi9=>f4e^!C3B*U0Mk-Rzl8C*8@
z@GX#GGCS(h&Zyk7g>fPYAf@*3y|Nf9TZOV!n3mx<g}O3E%La~TdhZEg3D(@XdG_vm
z^tIjhCWM~De@m2(G?+~c!}sA28h(I{ShmWJFb)@-<abSb_;%eM{)Ih!(?o2S>Fm5w
zfh%<9Q?ss>p`YahT601aOlRj)>2kpW9{vo<*6^>Kolh%u3PpH>%zAZu_*XC&O;3q2
z>Xu<z&hR7IypN?RWcV>eyWyvh{)QhHr|jWp((*O@jO79N+lId)C;#vZ+Oc1de6stg
zR)O00DfSz~WV8KLGZjn*UpydY48Nc%zN9L?R7Ie^<56yE-yVLYIm0h)Y7aNW9{$Q1
zLI*_?YC?C0zu^qk2uvUF`$med3eDLs%Z?D+r;L5OO68pWvNQYwRy;75&oqPf%>L9^
zrBbQzFbRzlR?ZM2Lqni8H#DPSX%cBTpv60_f_l4RRZIar5jClta{2}MoHzz&5-vB5
zP`Vs#NQVV&)-=B%3~nknv0+ru;VEZ-Mzi-DNIZ%Jape6+vCpTR{l}!};q0HH)Hq2~
z`;QUVEDE%vQf!hC1*)^(ump1?!)n<34Sa!QA9O-!_Wl`4mUv=H@>wo4Md=%2Y^2Yo
zY44vQX$cjXvZ#7iKwnH}_yuCYWQS0!Nd2M5qb#!hMl&%REM!PVjO^!>Xs9ql4Ylhg
z+0Y<KlkV7<gc(6J?EMyJ!riKCv$Lq9t-&rN8H_$#ZD#4xl)ZmdMM(@6CYwgKf*Rab
zQmgi{yinIGa!K!dsJ~L1XzKR<1}}$wf4s>g!mwzri1P0@YRxfwe*-9I->+51$!R13
zLueJN!posnYHAha@bFL&X$AJ2igL5+rc7dYSFGlkT&<W<uzng(x%4HT2fzTQrMk&j
zhVE4=<AU2x5bd391}2%W4L_rJ5_|to5Kq$7XZag|4YN6>A$CSDHw{k6aoOR<BcOHv
zQLPN>3`f$;36WA~c({3R47@LeZo_Jp?EN1>K{IvwEjPzFLA=*8$1`?&LX<1IF=g-n
zgvbaUw3*53FCV350o>1|kTiogm}$b3BS!~PPT3q2qEUuMM6KZ6i=Q%at#evQx6E&d
zu`EO3XN1B1p)C3#5<&7~xy--is*)nhrVMK+f3s<*7RWbgD8`#(W?Ak^>eQQ<a<*fm
z`TSLGTdi4=LqosyX3^e%i<0y+Nw5Vk4}3LvlntR(;V;*#)iShG&McDzfFyC7{kIjj
zK?B~Fqe>Kt;7LKdNA3^kl>0x&0GDf4fy8lVuuy{Y-QNG8AVh^%U%4psid6y6g8c{7
z8x=evpfc>VAYJZ%n2xVO!XR1n2vYM!KUnw%c;Egnc?Img$&BPp&9J2dlH&Qux~;6`
zhRr5Ou0xS}t{<w0L}MBtc^jiuv1wd|rM3#7u=f6k()GaA)v=d;nZdjZV5Q%GlpGUM
znU@|diX5Y{DG<Ts-YW@%s~FFJj8LUnVLoKZl__qAI%1lpSr%G@t16O>Qm-k3uc*8N
zrJ@Kkqr^-ISRQD3T4rHfN<##}jL!AJQpflTWa|CTG<*M7;Be0HHzuajR7jQpJ}qH@
zzNncdbA|?p9TK_)!DaZ7*|7J&FfDukD@T+v1Yr=XwEuUSW7wjYWmPQaK&yy?&TrOW
zS*TSZBn>|@E$4tDx`v-(kseHu5VP+hzR!d@RUje)HNZKTq2C4-{|yyynBRDUicC2N
zk7W<;%5Nav9h`z;q+%bO8gJ_M!Q)h7cDC9avkxA3_THM+$>&&c_I;8$)TXJxl*&o7
zR&5p<rgLz{+23Ic=>CpL9Uv4U6m_Jbb!a7v$R@H5&LR39@pPtTnl?!x3%Z%UR+F*C
zglUj&2B6j~%GXT<WBnsh%&+@H+e3Phb>dS-&2Adb{?8=W0za=f&7#D}KGrI>0Lt0l
zQ3w)w7_L<&cyT!UI~X-6pp^;Op7(dmnyK3dr-(iyq*TX)C7y$plz0wW5L^ygb$BQb
zW@ySArd1=~<-v?;kw$lLwbU%=AojKZfkZ#)pM7u*`|RKv_p50TXMjx2LE5HiHcTSy
zl(w2>Y$N;NWz#-*WkQE$fyHVcyqu<9kqdYNS~_YYvUK3e5E^Pa2>=Hz+N1VCt0=Ta
ztzn*!ktg;+>(GEVYR-WNwcI{%xkEnvZp<_d`{2%Tr78av`hB_36cgWQnrJ4|6Wuhq
zN{p#}aEFTBp)jceERjOjtK?oTm$4@ptGw?eo5)d~r52~`gKd>@uuU2CfF?|`!ofDV
zGN+t_9jye%D&#Z-_+Z8wW(AW~Y9dBr|0|SwjVRQ?Yfva)Nx<XaHIfMjAJgODHEp6$
z(Iyx(0rxPKFj1?TQPU*5M?+^4Mf7R{-fyY>OpFO_LY=#rfUUaW91Jb{z-^ei1zS1B
z1;;`x```}TZj@k=1)2szR4L2ZIb+!e4^R|{H^?k8VF-O<0@fe<;0=7MGJzql*avUH
zj(zaJK6r!9JRH2iQixd;g(_rMZc&*}5};ovgnmNQEiL!C6Qc5jrpsjM2~C5#OYu%S
zXG}4sS54iTkTq3HqEM|?ttyNH`nX)0JRoH0l9U`f;=f7}M}DzH8c-#%{n~0Dwjs@;
z;^_)$7ZA5+D^t$F&p1hh@#pmWF7^9e`v5VMnse|z9UwXQfX`z{lj*_FNL#@fACqjX
zh^L&jX88;Uvd96qlNk%KCx2cAS^BDh8HDX)nvK1~mvz#jXPtw;QakULD0=WqE;^1D
z5sP*XhI}Z7lCzdpP-&`$o-`GfS#9!iGn|8=N}IWK#W@(VWL8nAi4-*<jo}Ayn6POM
zLs~*iKGr{0-7h70@Jl-Tb?}&mP9Tn*ECR!iavber9!s38F`a{trPxgI30TS&T$(bv
zR-&DQk1hLvoYV*4gqm~kX&ImW1TU0?jt|X1hQ~QB$jHb;{Fb!r>0=e$D9}lO;TKS5
z$&TX~l~g#<O`%P&z#<Czg!($9h>DWz$wXbj9;zygeefl@Evk9zcD0%v;HXw58>?2U
zRpwz;tZJhQ4pD%cwLtr%ni<G(oGi7C3z!s0_tc#OTNw$yBwNClDVVbp48NpM;Nh1f
zr+!5;BQj+60H>>T3aP?4+ET(fD5nz8L74`+O}{p*jt6b~;FQxG%Rb@kyY|5;IJJ}%
zU>}@9j|?2ru@8O&o>hV)6{<@UhYLWTM8iI4!4PK|R#pBJh3ZI%1V~G@S}kHbnboQo
z!?wkac?GdQIHW+;K@o!9jE`2U;Dz|lGRITOX&<~Xu7p73<OnGO$<+6&Fo5rWh0P`Y
zU-h4L2>$Q>+d`WDw@5dSfA7D~l@sE|To_&G_2>`XZp581^1RdCUXSwr@5e;*zxmH=
z<YqyP3nBg&K4SX+|0n*x_22&kP)h*<6aW+e000O8jeSU6B!1p8umAx70AK?E3;+NC
z000000000000000003@fcP?#dVq-33Y-~_V1qJ{B000310RTDx007zm0RR91h0$94


From df3634cd5b5324ab78254b41a2d02dc74a0a59b3 Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 17:14:28 -0300
Subject: [PATCH 034/115] ci: run InflateBenchmark with the read group

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 tests/ExcelReader.Benchmarks/benchmark-groups.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/ExcelReader.Benchmarks/benchmark-groups.json b/tests/ExcelReader.Benchmarks/benchmark-groups.json
index 7baa980c..8bee3825 100644
--- a/tests/ExcelReader.Benchmarks/benchmark-groups.json
+++ b/tests/ExcelReader.Benchmarks/benchmark-groups.json
@@ -1,7 +1,7 @@
 [
   {
     "name": "read",
-    "filter": "ExcelReader.Benchmarks.ReadBenchmark.* ExcelReader.Benchmarks.XlsReadBenchmark.* ExcelReader.Benchmarks.CsvReadBenchmark.*",
+    "filter": "ExcelReader.Benchmarks.ReadBenchmark.* ExcelReader.Benchmarks.XlsReadBenchmark.* ExcelReader.Benchmarks.CsvReadBenchmark.* ExcelReader.Benchmarks.InflateBenchmark.*",
     "pagesArgs": "--warmupCount 3 --iterationCount 10",
     "prArgs": "--warmupCount 1 --iterationCount 5"
   },

From 7a08ec21c29fde3079cf64f21b36a00f99ee8e0a Mon Sep 17 00:00:00 2001
From: Gabriel Matte <gabrielandremarquez.matte@gmail.com>
Date: Thu, 8 Oct 2026 18:36:29 -0300
Subject: [PATCH 035/115] fix(generator): set required members in the generated
 factory

The generated factory was `new T()`, which fails with CS9035 when T or a base type declares a required member. It now sets every required member to default in the object initializer and lets the parse overwrite the ones it maps, matching FromAttributes, whose Activator.CreateInstance the runtime never checks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/guide/parsing.md                         |  2 +-
 .../ExcelRowMapGenerator.cs                   | 21 ++++++++++-
 .../Generator/GeneratorTests.cs               | 36 +++++++++++++++++++
 .../Parser/GeneratedMapParityTests.cs         | 28 +++++++++++++++
 4 files changed, 85 insertions(+), 2 deletions(-)

diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index 0f4214f3..fec416d3 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -29,7 +29,7 @@ foreach (var item in parser.Parse(workbook.FirstSheet))
 }
 ```
 
-Built-in property types: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, and `enum`s (matched by member name or numeric value). Each also works as a `Nullable<T>`. Empty cells leave the property at its default; an unparseable cell is skipped (keeps the default) unless the column is required. `T` needs no parameterless-constructor constraint, so models with `required` members are supported.
+Built-in property types: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, and `enum`s (matched by member name or numeric value). Each also works as a `Nullable<T>`. Empty cells leave the property at its default; an unparseable cell is skipped (keeps the default) unless the column is required. `T` needs no parameterless-constructor constraint, so models with `required` members are supported, through both `FromAttributes` and the source generator. `required` alone does not make a column mandatory; that is what `[ExcelRequired]` does.
 
 `Parse` also accepts the `IExcelSheet` of the `IExcelWorkbook` from `Excel.Open`, so you can parse without knowing the concrete format:
 
diff --git a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
index 80e68cfe..f6ac8f16 100644
--- a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
+++ b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
@@ -611,7 +611,7 @@ private static void AppendRowMap(StringBuilder sb, INamedTypeSymbol symbol, stri
                 && !symbol.Constructors.Any(static c => c.Parameters.Length == 0 && !c.IsImplicitlyDeclared);
             sb.AppendLine(useDefault
                 ? "        builder.Factory(null)"
-                : $"        builder.Factory(static () => new {qualifiedType}())");
+                : $"        builder.Factory(static () => new {qualifiedType}(){RequiredMembersInitializer(symbol)})");
             foreach (PropertyPlan p in properties)
             {
                 EmitReadFragment(sb, qualifiedType, p);
@@ -620,6 +620,25 @@ private static void AppendRowMap(StringBuilder sb, INamedTypeSymbol symbol, stri
             sb.AppendLine("    }");
         }
 
+        // C# requires every required member in the object initializer; the parse overwrites the ones it maps,
+        // and the rest stay default, as on the reflection path, which the runtime never checks.
+        private static string RequiredMembersInitializer(INamedTypeSymbol symbol)
+        {
+            var names = new List<string>();
+            var seen = new HashSet<string>(StringComparer.Ordinal);
+            for (INamedTypeSymbol? type = symbol; type is not null; type = type.BaseType)
+            {
+                foreach (ISymbol member in type.GetMembers())
+                {
+                    if (member is IPropertySymbol { IsRequired: true } or IFieldSymbol { IsRequired: true } && seen.Add(member.Name))
+                    {
+                        names.Add($"{Identifier(member.Name)} = default!");
+                    }
+                }
+            }
+            return names.Count == 0 ? "" : " { " + string.Join(", ", names) + " }";
+        }
+
         private static void EmitReadFragment(StringBuilder sb, string qualifiedType, PropertyPlan p)
         {
             string namesLiteral = string.Join(", ", p.HeaderNames.Select(Literal));
diff --git a/tests/ExcelReader.Tests/Generator/GeneratorTests.cs b/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
index 3f4a5850..4285abbd 100644
--- a/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
+++ b/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
@@ -644,6 +644,42 @@ public readonly ref partial struct RefModel
             Assert.Contains(".Column(\"Name\"", generated, StringComparison.Ordinal);
         }
 
+        [Fact]
+        public void RequiredMembersCompile()
+        {
+            const string source = """
+                using ExcelReader.Core.Parser;
+
+                namespace GeneratorTests.RequiredMembers
+                {
+                    public class Base
+                    {
+                        public required string Inherited { get; set; }
+                    }
+
+                    [ExcelSerializable]
+                    public partial class Model : Base
+                    {
+                        public required int Id { get; set; }
+                        [ExcelRequired]
+                        public required string Name { get; init; }
+                        public string? Note { get; set; }
+                    }
+
+                    [ExcelSerializable]
+                    public partial struct StructModel
+                    {
+                        public StructModel() { }
+                        public required int Id { get; set; }
+                    }
+                }
+                """;
+            (ImmutableCompilationResult result, ImmutableArray<Diagnostic> diagnostics) = RunGenerator(source);
+            Assert.Empty(diagnostics);
+            EmitResult emit = result.Emit();
+            Assert.True(emit.Success, string.Join(Environment.NewLine, emit.Diagnostics.Select(static d => d.ToString())));
+        }
+
         [Fact]
         public void RequiredPropertyWithoutPublicSetterReportsEXR009()
         {
diff --git a/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs b/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
index f9bd977a..3e2a8975 100644
--- a/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
+++ b/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
@@ -82,6 +82,20 @@ public partial class IgnoreModel
             public string Ignored { get; set; } = "default";
         }
 
+        public class RequiredMemberBaseRow
+        {
+            public required string Inherited { get; set; }
+        }
+
+        [ExcelSerializable]
+        public partial class RequiredMemberModel : RequiredMemberBaseRow
+        {
+            public required string Name { get; init; }
+            public required int Age { get; set; }
+            [ExcelIgnore]
+            public required string Skipped { get; set; }
+        }
+
         public class InheritedBaseRow
         {
             public string Inherited { get; set; } = "";
@@ -231,6 +245,20 @@ public async Task GeneratedMapMatchesReflectionForEverySetterShape()
             }
         }
 
+        [Fact]
+        public async Task GeneratedMapMatchesReflectionForRequiredMembers()
+        {
+            await using var ms = await TypedWorkbook.BuildAsync(["Name", "Age", "Inherited"], ["Alice", 30, "base"]);
+
+            RequiredMemberModel reflectionResult = await ParseFirstXlsxAsync(ms, static reader => ExcelParser.FromAttributes<RequiredMemberModel>().Parse(reader.FirstSheet));
+            RequiredMemberModel generatedResult = await ParseFirstXlsxAsync(ms, static reader => ExcelParser.Generated<RequiredMemberModel>().Parse(reader.FirstSheet));
+
+            Assert.Equal(("Alice", 30, "base"), (generatedResult.Name, generatedResult.Age, generatedResult.Inherited));
+            Assert.Equal((reflectionResult.Name, reflectionResult.Age, reflectionResult.Inherited), (generatedResult.Name, generatedResult.Age, generatedResult.Inherited));
+            Assert.Null(reflectionResult.Skipped);
+            Assert.Null(generatedResult.Skipped);
+        }
+
         [Fact]
         public async Task GeneratedMapMatchesReflectionForInitOnlyStructAndRecord()
         {

From 65945b47da0aba99cea0d2c1faab0fcbfba0d5bf Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Thu, 8 Oct 2026 23:03:51 -0300
Subject: [PATCH 036/115] feat(native): add support for auto-detecting CSV
 format and implement benchmarks for native open operations

---
 python/src/excelreader/sources.py             |   3 +-
 src/ExcelReader.Native/README.md              |   3 +-
 .../Reading/CallbackReadStream.cs             |  21 +++
 .../Reading/ReadApi.Sources.cs                |   8 +-
 .../Reading/StreamBuffer.cs                   |  41 +++--
 .../Native/NativeOpenBenchmark.cs             | 166 ++++++++++++++++++
 .../benchmark-groups.json                     |   2 +-
 .../Native/CallbackStreamTests.cs             |  14 ++
 8 files changed, 239 insertions(+), 19 deletions(-)
 create mode 100644 tests/ExcelReader.Benchmarks/Native/NativeOpenBenchmark.cs

diff --git a/python/src/excelreader/sources.py b/python/src/excelreader/sources.py
index ba6aab91..faf39835 100644
--- a/python/src/excelreader/sources.py
+++ b/python/src/excelreader/sources.py
@@ -101,7 +101,8 @@ def open_stream(
 ) -> Workbook:
     """Opens a workbook over a stream that cannot seek, such as `sys.stdin.buffer` or a socket.
 
-    A CSV (`format="csv"`) is read as it arrives, and can be read again from the start
+    A CSV (`format="csv"`, or no format and neither a ZIP nor an OLE2 signature) is read as it
+    arrives, and can be read again from the start
     (`infer_schema()`, then a read) until 16 MiB of it were read; an XLSX, XLSB or XLS is read whole
     before the workbook opens. `stream` needs `readinto` or `read`; the library never closes it.
     """
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index 27699d4c..546e1b6f 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -155,7 +155,8 @@ in parallel. By default the library asks for 4 MiB blocks and keeps 64 MiB of th
 `xl_open_stream` reads through a callback that copies the next bytes. A CSV is read as it arrives,
 by one cursor at a time, and its first 16 MiB are kept so that `xl_infer_schema` followed by a read
 works; an XLSX, XLSB or XLS is read whole first (`max_buffered_bytes` caps it), because
-those formats need random access.
+those formats need random access. With `XL_FORMAT_AUTO`, a stream that starts with neither a ZIP
+nor an OLE2 signature is read as a CSV.
 
 Both take ownership: `release` runs exactly once, when nothing needs the bytes any more. A failing
 callback calls `xl_set_source_error` and returns -1; that message is what `xl_last_error` reports.
diff --git a/src/ExcelReader.Native/Reading/CallbackReadStream.cs b/src/ExcelReader.Native/Reading/CallbackReadStream.cs
index 10f3d6d4..34cc01d6 100644
--- a/src/ExcelReader.Native/Reading/CallbackReadStream.cs
+++ b/src/ExcelReader.Native/Reading/CallbackReadStream.cs
@@ -7,6 +7,7 @@ internal sealed unsafe class CallbackReadStream : Stream
         private readonly delegate* unmanaged<void*, byte*, long, long> _read;
         private readonly delegate* unmanaged<void*, void> _release;
         private readonly void* _userData;
+        private ReadOnlyMemory<byte> _peeked;
         private int _released;
 
         private CallbackReadStream(in NativeStreamRaw raw)
@@ -51,6 +52,13 @@ public override int Read(Span<byte> buffer)
             {
                 return 0;
             }
+            if (!_peeked.IsEmpty)
+            {
+                int count = Math.Min(buffer.Length, _peeked.Length);
+                _peeked.Span[..count].CopyTo(buffer);
+                _peeked = _peeked[count..];
+                return count;
+            }
             SourceErrors.Clear();
             long got;
             fixed (byte* destination = buffer)
@@ -64,6 +72,19 @@ public override int Read(Span<byte> buffer)
             return (int)got;
         }
 
+        internal ReadOnlySpan<byte> Peek(int count)
+        {
+            byte[] head = new byte[count];
+            int filled = 0;
+            int read;
+            while (filled < count && (read = Read(head.AsSpan(filled))) > 0)
+            {
+                filled += read;
+            }
+            _peeked = head.AsMemory(0, filled);
+            return _peeked.Span;
+        }
+
         public override int Read(byte[] buffer, int offset, int count)
         {
             return Read(buffer.AsSpan(offset, count));
diff --git a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
index 555ba5c2..a7d51e28 100644
--- a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
+++ b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
@@ -1,5 +1,6 @@
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Sources;
+using ExcelReader.Core.Reader.Xls;
 
 namespace ExcelReader.Native.Reading
 {
@@ -71,7 +72,7 @@ internal static int OpenStream(CallbackReadStream stream, int format, NativeOpen
                 NativeOpenOptions options = decoded ?? default;
                 ExcelReaderOptions readerOptions = options.ToExcelReaderOptions();
                 IExcelWorkbook workbook;
-                if (format == NativeFormat.Csv)
+                if (format == NativeFormat.Csv || (format == NativeFormat.Auto && !IsWorkbookSignature(stream.Peek(8))))
                 {
                     workbook = Excel.FromCsv(stream, leaveOpen: false, readerOptions.Csv);
                 }
@@ -102,5 +103,10 @@ internal static int OpenStream(CallbackReadStream stream, int format, NativeOpen
                 }
             }
         }
+
+        private static bool IsWorkbookSignature(ReadOnlySpan<byte> head)
+        {
+            return head.StartsWith("PK\x03\x04"u8) || head.StartsWith(XlsCompoundFile.Signature);
+        }
     }
 }
diff --git a/src/ExcelReader.Native/Reading/StreamBuffer.cs b/src/ExcelReader.Native/Reading/StreamBuffer.cs
index 0cfd1391..84919564 100644
--- a/src/ExcelReader.Native/Reading/StreamBuffer.cs
+++ b/src/ExcelReader.Native/Reading/StreamBuffer.cs
@@ -1,33 +1,44 @@
-using System.Buffers;
 using ExcelReader.Core.Reader;
 
 namespace ExcelReader.Native.Reading
 {
     internal static class StreamBuffer
     {
+        private const int FirstSegmentBytes = 1024 * 1024;
+        private const int MaxSegmentBytes = 64 * 1024 * 1024;
+
         internal static ReadOnlyMemory<byte> ReadAll(Stream stream, long limit)
         {
             limit = Math.Min(limit, Array.MaxLength);
-            MemoryStream buffer = new();
-            byte[] chunk = ArrayPool<byte>.Shared.Rent(81_920);
-            try
+            List<byte[]> filledSegments = [];
+            byte[] segment = GC.AllocateUninitializedArray<byte>(FirstSegmentBytes);
+            int used = 0;
+            long total = 0;
+            int read;
+            while ((read = stream.Read(segment.AsSpan(used))) > 0)
             {
-                int read;
-                while ((read = stream.Read(chunk)) > 0)
+                used += read;
+                total += read;
+                if (total > limit)
+                {
+                    throw new ExcelLimitExceededException("MaxBufferedBytes", limit, total);
+                }
+                if (used == segment.Length)
                 {
-                    long total = buffer.Length + read;
-                    if (total > limit)
-                    {
-                        throw new ExcelLimitExceededException("MaxBufferedBytes", limit, total);
-                    }
-                    buffer.Write(chunk, 0, read);
+                    filledSegments.Add(segment);
+                    segment = GC.AllocateUninitializedArray<byte>(Math.Min(segment.Length * 2, MaxSegmentBytes));
+                    used = 0;
                 }
             }
-            finally
+            byte[] data = GC.AllocateUninitializedArray<byte>((int)total);
+            int offset = 0;
+            foreach (byte[] filled in filledSegments)
             {
-                ArrayPool<byte>.Shared.Return(chunk);
+                filled.CopyTo(data, offset);
+                offset += filled.Length;
             }
-            return buffer.GetBuffer().AsMemory(0, (int)buffer.Length);
+            segment.AsSpan(0, used).CopyTo(data.AsSpan(offset));
+            return data;
         }
     }
 }
diff --git a/tests/ExcelReader.Benchmarks/Native/NativeOpenBenchmark.cs b/tests/ExcelReader.Benchmarks/Native/NativeOpenBenchmark.cs
new file mode 100644
index 00000000..208d857d
--- /dev/null
+++ b/tests/ExcelReader.Benchmarks/Native/NativeOpenBenchmark.cs
@@ -0,0 +1,166 @@
+using System.Runtime.InteropServices;
+using System.Text;
+using BenchmarkDotNet.Attributes;
+using ExcelReader.Native;
+using ExcelReader.Native.Reading;
+
+namespace ExcelReader.Benchmarks
+{
+    // NOTE: the xl_source/xl_stream callbacks are [UnmanagedCallersOnly] methods called back into this
+    // process, so each one pays a managed->unmanaged->managed transition a native caller would not.
+    [MemoryDiagnoser]
+    public unsafe class NativeOpenBenchmark
+    {
+        private sealed class StreamState(byte[] bytes)
+        {
+            internal readonly byte[] Bytes = bytes;
+            internal int Position;
+        }
+
+        private byte[] _data = [];
+        private byte[] _utf8Path = [];
+        private int _format;
+        private int _expectedRows;
+
+        [Params("csv", "xlsx", "xlsb", "xls")]
+        public string Format { get; set; } = "";
+
+        [Params(false, true)]
+        public bool ReadRows { get; set; }
+
+        [GlobalSetup]
+        public void Setup()
+        {
+            string path = Path.Combine(AppContext.BaseDirectory, "Data", $"65K_Records_Data.{Format}");
+            _data = File.ReadAllBytes(path);
+            _utf8Path = Encoding.UTF8.GetBytes(path);
+            _format = Format switch
+            {
+                "csv" => NativeFormat.Csv,
+                "xlsx" => NativeFormat.Xlsx,
+                "xlsb" => NativeFormat.Xlsb,
+                _ => NativeFormat.Xls,
+            };
+            Verify(ReadApi.OpenMemory(_data, _format, out NativeHandle? handle), handle);
+            using (handle)
+            {
+                _expectedRows = CountRows(handle!);
+            }
+        }
+
+        [Benchmark(Baseline = true)]
+        public int OpenMemory()
+        {
+            return Consume(ReadApi.OpenMemory(_data, _format, out NativeHandle? handle), handle);
+        }
+
+        [Benchmark]
+        public int OpenFile()
+        {
+            return Consume(ReadApi.OpenFile(_utf8Path, _format, out NativeHandle? handle), handle);
+        }
+
+        [Benchmark]
+        public int OpenSource()
+        {
+            NativeSourceRaw raw = new()
+            {
+                StructSize = sizeof(NativeSourceRaw),
+                UserData = (void*)GCHandle.ToIntPtr(GCHandle.Alloc(_data)),
+                Length = _data.Length,
+                ReadAt = &ReadAt,
+                Release = &Release,
+            };
+            if (!CallbackByteSource.TryCreate(&raw, hasOutHandle: true, out CallbackByteSource? source, out string? error))
+            {
+                throw new InvalidOperationException(error);
+            }
+            return Consume(ReadApi.OpenSource(source, _format, null, out NativeHandle? handle), handle);
+        }
+
+        [Benchmark]
+        public int OpenStream()
+        {
+            NativeStreamRaw raw = new()
+            {
+                StructSize = sizeof(NativeStreamRaw),
+                UserData = (void*)GCHandle.ToIntPtr(GCHandle.Alloc(new StreamState(_data))),
+                Read = &Read,
+                Release = &Release,
+            };
+            if (!CallbackReadStream.TryCreate(&raw, hasOutHandle: true, out CallbackReadStream? stream, out string? error))
+            {
+                throw new InvalidOperationException(error);
+            }
+            return Consume(ReadApi.OpenStream(stream, _format, null, out NativeHandle? handle), handle);
+        }
+
+        [UnmanagedCallersOnly]
+        private static long ReadAt(void* userData, long offset, byte* buffer, long length)
+        {
+            byte[] bytes = (byte[])GCHandle.FromIntPtr((nint)userData).Target!;
+            int count = (int)Math.Min(length, bytes.Length - offset);
+            bytes.AsSpan((int)offset, count).CopyTo(new Span<byte>(buffer, count));
+            return count;
+        }
+
+        [UnmanagedCallersOnly]
+        private static long Read(void* userData, byte* buffer, long length)
+        {
+            StreamState state = (StreamState)GCHandle.FromIntPtr((nint)userData).Target!;
+            int count = (int)Math.Min(length, state.Bytes.Length - state.Position);
+            state.Bytes.AsSpan(state.Position, count).CopyTo(new Span<byte>(buffer, count));
+            state.Position += count;
+            return count;
+        }
+
+        [UnmanagedCallersOnly]
+        private static void Release(void* userData)
+        {
+            GCHandle.FromIntPtr((nint)userData).Free();
+        }
+
+        private int Consume(int status, NativeHandle? handle)
+        {
+            Verify(status, handle);
+            using (handle)
+            {
+                if (!ReadRows)
+                {
+                    return 0;
+                }
+                int rows = CountRows(handle!);
+                if (rows != _expectedRows)
+                {
+                    throw new InvalidOperationException($"expected {_expectedRows} rows, got {rows}.");
+                }
+                return rows;
+            }
+        }
+
+        private static int CountRows(NativeHandle handle)
+        {
+            ReadApi.OpenRows(handle, 0, out NativeRowCursor? opened);
+            using NativeRowCursor cursor = opened!;
+            int rows = 0;
+            int status;
+            while ((status = ReadApi.NextRowView(cursor, out _)) == NativeStatus.Ok)
+            {
+                rows++;
+            }
+            if (status != NativeStatus.Eof)
+            {
+                throw new InvalidOperationException($"native row read failed with status {status}: {NativeApi.LastErrorText()}");
+            }
+            return rows;
+        }
+
+        private static void Verify(int status, NativeHandle? handle)
+        {
+            if (status != NativeStatus.Ok || handle is null)
+            {
+                throw new InvalidOperationException($"open failed with status {status}: {NativeApi.LastErrorText()}");
+            }
+        }
+    }
+}
diff --git a/tests/ExcelReader.Benchmarks/benchmark-groups.json b/tests/ExcelReader.Benchmarks/benchmark-groups.json
index 8bee3825..3bce06d0 100644
--- a/tests/ExcelReader.Benchmarks/benchmark-groups.json
+++ b/tests/ExcelReader.Benchmarks/benchmark-groups.json
@@ -31,7 +31,7 @@
   },
   {
     "name": "native",
-    "filter": "ExcelReader.Benchmarks.NativeRowReadBenchmark.* ExcelReader.Benchmarks.NativeTypedParseBenchmark.* ExcelReader.Benchmarks.ChunkedParseBenchmark.*",
+    "filter": "ExcelReader.Benchmarks.NativeRowReadBenchmark.* ExcelReader.Benchmarks.NativeTypedParseBenchmark.* ExcelReader.Benchmarks.ChunkedParseBenchmark.* ExcelReader.Benchmarks.NativeOpenBenchmark.*",
     "pagesArgs": "--warmupCount 3 --iterationCount 10",
     "prArgs": "--warmupCount 1 --iterationCount 5"
   },
diff --git a/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
index 30a694a4..4fac787a 100644
--- a/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
+++ b/tests/ExcelReader.Tests/Native/CallbackStreamTests.cs
@@ -104,8 +104,22 @@ public void A_Csv_Streams_Through_One_Cursor_At_A_Time_And_Is_Released_On_Close(
             Assert.Equal(1, test.Releases);
         }
 
+        [Fact]
+        public void Auto_Streams_A_Csv_Instead_Of_Buffering_It()
+        {
+            TestStream test = new(Encoding.UTF8.GetBytes("a,b\n1,2\n3,4\n"));
+            using Pinned pinned = new(test);
+            Assert.Equal(NativeStatus.Ok, Open(pinned, NativeFormat.Auto, out NativeHandle? handle, Options() with { MaxBufferedBytes = 1 }));
+            using (handle)
+            {
+                Assert.Equal(3, CountRows(handle!, 0));
+            }
+            Assert.Equal(1, test.Releases);
+        }
+
         [Theory]
         [InlineData(ConcurrentSheetTests.Format.Xlsx, NativeFormat.Xlsx)]
+        [InlineData(ConcurrentSheetTests.Format.Xlsx, NativeFormat.Auto)]
         [InlineData(ConcurrentSheetTests.Format.Xls, NativeFormat.Auto)]
         public void An_Excel_Workbook_Is_Buffered_And_The_Stream_Released_Before_The_Open_Returns(
             ConcurrentSheetTests.Format format, int nativeFormat)

From 415d97f7a3a5a3cf86adc0423f424feefb1180e2 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 00:29:25 -0300
Subject: [PATCH 037/115] perf(docs): update benchmark results for improved
 performance metrics across C++, Python, and Rust implementations

---
 cpp/README.md                  | 56 ++++++++++++-------------
 docs/performance/benchmarks.md | 20 ++++-----
 python/README.md               | 77 +++++++++++++++++++++-------------
 rust/excelreader/README.md     | 27 ++++++------
 4 files changed, 100 insertions(+), 80 deletions(-)

diff --git a/cpp/README.md b/cpp/README.md
index e8c0d794..78a00821 100644
--- a/cpp/README.md
+++ b/cpp/README.md
@@ -368,15 +368,15 @@ on Windows 10 (22H2), 16 logical CPUs @ 3.39 GHz, MSVC 19.51 (Release), Google B
 
 | Benchmark | RealExcel.xlsb (100 rows) | 65K_Records_Data.xlsb (65,535 rows) |
 |---|---:|---:|
-| `open` (`open_memory`) | 20.0 µs | 1.24 ms |
-| `parse_sheet` (4 or 6 bound columns) | 50.3 µs | 27.3 ms |
-| `typed_reader`, batches of 1,000 / 10,000 rows | - | 26.1 ms / 26.5 ms |
-| `infer_schema` (sample 100 / 1,000 rows) | 73.7 µs | 605.7 µs |
+| `open` (`open_memory`) | 24.0 µs | 1.17 ms |
+| `parse_sheet` (4 or 6 bound columns) | 47.8 µs | 24.7 ms |
+| `typed_reader`, batches of 1,000 / 10,000 rows | - | 23.8 ms / 23.8 ms |
+| `infer_schema` (sample 100 / 1,000 rows) | 75.6 µs | 579.1 µs |
 
 `open` here is `open_memory`, which copies the caller's buffer before returning (the caller may free
-it afterwards), so it scales with file size: 1.24 ms is mostly copying the 3.7 MB fixture. Opening by
+it afterwards), so it scales with file size: 1.17 ms is mostly copying the 3.7 MB fixture. Opening by
 path reads only the package directory and stays nearly flat — see the Rust suite below.
-`parse_sheet` scales linearly with rows × columns, at roughly 420 ns/row here. Draining the same
+`parse_sheet` scales linearly with rows × columns, at roughly 380 ns/row here. Draining the same
 sheet through the batched typed reader costs the same as one whole-sheet `parse_sheet` while holding
 only one batch in memory at a time. `infer_schema` scales with its sample size, not the file's total
 row count.
@@ -391,12 +391,12 @@ sides decode every cell into an owned value (`std::string` for text, not the zer
 
 | Library | Mean |
 |---|---:|
-| ExcelReader (`parse_sheet<FullRow>`) | 73.7 ms |
-| DuckDB (`read_xlsx`, summing every column in SQL) | 433.6 ms |
-| xlsxio (`xlsxioread_sheet_next_cell_*`) | 505.0 ms |
-| xlnt (`worksheet::rows()` + `cell::to_string()`/`value<double>()`) | 2,494.2 ms |
+| ExcelReader (`parse_sheet<FullRow>`) | 62.9 ms |
+| DuckDB (`read_xlsx`, summing every column in SQL) | 410.8 ms |
+| xlsxio (`xlsxioread_sheet_next_cell_*`) | 512.9 ms |
+| xlnt (`worksheet::rows()` + `cell::to_string()`/`value<double>()`) | 2,394.1 ms |
 
-ExcelReader is ~5.9x faster than DuckDB, ~6.9x faster than xlsxio and ~34x faster than xlnt on this
+ExcelReader is ~6.5x faster than DuckDB, ~8.2x faster than xlsxio and ~38x faster than xlnt on this
 workload. xlsxio is a
 lean, purpose-built C streaming reader — the same abstraction level as ExcelReader's own native
 core — so it was the strongest of the two competitors tested, though still well behind.
@@ -436,11 +436,11 @@ Measured on the same machine as above, GCC 16.2.0 (MSYS2 UCRT64, `-O3 -mavx2` fo
 
 | Workload | ExcelReader | zsv `compat` | zsv `fast` |
 |---|---:|---:|---:|
-| Typed, 14 columns into `FullRow` | 30.4 ms | 25.7 ms | 22.7 ms |
-| Cells, byte count | 11.9 ms | 5.9 ms | 3.5 ms |
+| Typed, 14 columns into `FullRow` | 27.2 ms | 23.4 ms | 20.4 ms |
+| Cells, byte count | 11.8 ms | 6.5 ms | 3.6 ms |
 
 **zsv is faster on both.** Typed, it is ~1.2x (`compat`) and ~1.3x (`fast`) faster than ExcelReader.
-Counting cells, it is ~2.0x and ~3.4x faster.
+Counting cells, it is ~1.8x and ~3.3x faster.
 
 The cells gap is the C ABI, not the CSV parser. `xl_rows_next_view` copies every cell's value into a
 native row the cursor owns, one call per row, and that alone costs ~10.6 ms here (calling it without
@@ -477,11 +477,11 @@ is handed buffers that are already columnar, while `BM_WriteSheet` starts from a
 
 | Benchmark | Time | Rows/s |
 |---|---:|---:|
-| `BM_WriteColumns` (pre-transposed) | 44.2 ms | 1.48 M/s |
-| `BM_WriteSheet` (from `std::vector<Row>`) | 50.9 ms | 1.29 M/s |
+| `BM_WriteColumns` (pre-transposed) | 45.8 ms | 1.43 M/s |
+| `BM_WriteSheet` (from `std::vector<Row>`) | 52.2 ms | 1.27 M/s |
 
-The transpose costs ~15% here. It is not free, but it is not the dominant cost of producing the
-file — see the comparison below, where the same two cases over 14 columns land within ~15–17%.
+The transpose costs ~14% here. It is not free, but it is not the dominant cost of producing the
+file — see the comparison below, where the same two cases over 14 columns land within ~12%.
 
 `excelreader_cpp_write_compare_benchmarks` (under `-DEXCELREADER_BUILD_BENCHMARKS_COMPARE=ON`) puts
 that against xlnt, xlsxio and [DuckDB](https://github.com/duckdb/duckdb)'s `excel` extension, all
@@ -498,12 +498,12 @@ competitor.
 
 | Library | Wall | CPU |
 |---|---:|---:|
-| ExcelReader (`xl::write_columns`, pre-transposed) | 85.1–85.9 ms | 85.1–87.1 ms |
-| ExcelReader (`xl::write_sheet<FullRow>`) | 97.8–100.1 ms | 96.4–100.4 ms |
-| DuckDB (`COPY ... TO ... WITH (FORMAT xlsx)`) | 833.3–869.5 ms | 828.1–875.0 ms |
-| libxlsxwriter (`worksheet_write_string`/`_number`) | 1,183.8 ms | 1,187.5 ms |
-| xlsxio (`xlsxiowrite_add_cell_*`) | 2,453.8 ms | 843.8 ms |
-| xlnt (`worksheet::cell().value()` + `save()`) | 5,640.7 ms | 5,640.6 ms |
+| ExcelReader (`xl::write_columns`, pre-transposed) | 85.4–86.5 ms | 85.1–87.1 ms |
+| ExcelReader (`xl::write_sheet<FullRow>`) | 95.5–96.5 ms | 96.0–98.2 ms |
+| DuckDB (`COPY ... TO ... WITH (FORMAT xlsx)`) | 828.9–833.2 ms | 828.1 ms |
+| libxlsxwriter (`worksheet_write_string`/`_number`) | 1,193.9 ms | 1,203.1 ms |
+| xlsxio (`xlsxiowrite_add_cell_*`) | 2,433.2 ms | 953.1 ms |
+| xlnt (`worksheet::cell().value()` + `save()`) | 5,436.3 ms | 5,437.5 ms |
 
 Same machine as above; Google Benchmark's own iteration counts, no `--benchmark_repetitions` (each
 iteration writes a whole 65,535-row file, so the slower cases run once or a handful of times). xlnt
@@ -513,8 +513,8 @@ DuckDB rows appear in both, and the small ranges above are those two independent
 sampling within one run.
 
 `write_sheet` — the matched-work number, since it starts from the same `std::vector<FullRow>` every
-competitor is handed — is ~8.5–8.7x faster than DuckDB, ~12.1x faster than libxlsxwriter, ~25x
-faster than xlsxio, and ~56x faster than xlnt on wall time.
+competitor is handed — is ~8.6–8.7x faster than DuckDB, ~12.4x faster than libxlsxwriter, ~25x
+faster than xlsxio, and ~57x faster than xlnt on wall time.
 
 ### Known issue: xlsxio + libxlsxwriter cannot share a binary
 
@@ -551,10 +551,10 @@ Caveats, none of them optional when quoting these:
 
 - **xlsxio's CPU time is not stable across runs.** It read 843.8–906.3 ms before the fix (some
   runs missing the workbook.xml entry), 1,171.9 ms and 687.5 ms in the two runs after it,
-  1,015.6 ms in the next and 843.8 ms in this one, while its wall time stayed at ~2.4 s throughout. Its wall time is dominated by I/O wait —
+  1,015.6 ms and 843.8 ms in the next two and 953.1 ms in the latest, while its wall time stayed at ~2.4 s throughout. Its wall time is dominated by I/O wait —
   CPU is well under half of wall, against every other case here being CPU-bound (wall ≈ CPU) — so
   quote the wall-time ratio, which is what a caller waits. Against this run's CPU time the gap from
-  `write_sheet` to xlsxio is ~8.4x, not ~25x.
+  `write_sheet` to xlsxio is ~9.9x, not ~25x.
 - **ExcelReader does slightly more work here**, not less: it attaches a number format to the two
   date columns so Excel shows a date, while every competitor case writes those as bare serial
   numbers. That difference favours the competitors.
diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index e75b68cc..d6997ea4 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -332,24 +332,24 @@ zero-copy advantage the other can't take:
 
 | Comparison | Format | ExcelReader | Competitor | Ratio |
 |---|---|---:|---:|---:|
-| vs. [calamine](https://github.com/tafia/calamine) (Rust) | XLSX | 85.8 ms | 272.0 ms | ~3.2x faster |
-| vs. calamine (Rust) | XLSB | 53.0 ms | 86.8 ms | ~1.6x faster |
-| vs. [DuckDB](https://github.com/duckdb/duckdb) `read_xlsx` (C++) | XLSX | 73.7 ms | 433.6 ms | ~5.9x faster |
-| vs. [xlsxio](https://github.com/brechtsanders/xlsxio) (C) | XLSX | 73.7 ms | 505.0 ms | ~6.9x faster |
-| vs. [xlnt](https://github.com/tfussell/xlnt) (C++) | XLSX | 73.7 ms | 2,494.2 ms | ~34x faster |
-| vs. [zsv](https://github.com/liquidaty/zsv) `fast` engine (C) | CSV | 30.4 ms | 22.7 ms | ~1.3x **slower** |
+| vs. [calamine](https://github.com/tafia/calamine) (Rust) | XLSX | 79.1 ms | 279.7 ms | ~3.5x faster |
+| vs. calamine (Rust) | XLSB | 46.9 ms | 87.5 ms | ~1.9x faster |
+| vs. [DuckDB](https://github.com/duckdb/duckdb) `read_xlsx` (C++) | XLSX | 62.9 ms | 410.8 ms | ~6.5x faster |
+| vs. [xlsxio](https://github.com/brechtsanders/xlsxio) (C) | XLSX | 62.9 ms | 512.9 ms | ~8.2x faster |
+| vs. [xlnt](https://github.com/tfussell/xlnt) (C++) | XLSX | 62.9 ms | 2,394.1 ms | ~38x faster |
+| vs. [zsv](https://github.com/liquidaty/zsv) `fast` engine (C) | CSV | 27.2 ms | 20.4 ms | ~1.3x **slower** |
 
 Writing the same 14 columns × 65,535 rows from row-shaped data, the C++ suite measures
-`write_sheet` at 97.8–100.1 ms against DuckDB's 833–870 ms (~8.5–8.7x), libxlsxwriter's 1,184 ms (~12x),
-xlsxio's 2,454 ms (~25x) and xlnt's 5,641 ms (~56x). The Rust suite measures 53.3 ms against
-rust_xlsxwriter's 326.9 ms (~6.1x) over 7 columns. Caveats for both are in the binding READMEs.
+`write_sheet` at 95.5–96.5 ms against DuckDB's 829–833 ms (~8.6–8.7x), libxlsxwriter's 1,194 ms (~12x),
+xlsxio's 2,433 ms (~25x) and xlnt's 5,436 ms (~57x). The Rust suite measures 51.9 ms against
+rust_xlsxwriter's 328.3 ms (~6.3x) over 7 columns. Caveats for both are in the binding READMEs.
 
 DuckDB, xlsxio and xlnt do not read `.xlsb`, so those comparisons are XLSX-only. calamine is a fast,
 well-optimized reader in its own right — the gap there is real but not the order of magnitude seen
 against the C/C++ competitors.
 
 zsv is the one competitor ahead. The CSV row is the typed workload, where both sides build the same
-14-column rows with owned strings. Just counting cell bytes, zsv is ~4x faster, and that gap is
+14-column rows with owned strings. Just counting cell bytes, zsv is ~3.3x faster, and that gap is
 ExcelReader's C ABI, which serializes every row into a buffer, not its CSV parser. That suite is
 built with GCC (zsv does not compile under MSVC). Its caveats are in the C++ README.
 
diff --git a/python/README.md b/python/README.md
index a2bf19ce..aff81b8f 100644
--- a/python/README.md
+++ b/python/README.md
@@ -508,57 +508,74 @@ secret = encrypt_package_bytes(write_workbook_to_bytes(table, types, format="xls
 
 `benchmarks/bench_read.py` and `benchmarks/bench_write.py` over
 `tests/ExcelReader.Benchmarks/Data/65K_Records_Data.xlsb` (65,535 data rows, 14 columns), the same
-fixture the .NET, C++ and Rust suites use. Measured on Windows 10 (22H2), 16 logical CPUs
-@ 3.39 GHz, CPython 3.14.4, 10 runs each (medians shown; `min` is in the scripts' own output).
-Competitors: polars 1.44.1 (with fastexcel 0.21.0), pandas 3.0.5 (with openpyxl 3.1.5), xlsxwriter
-3.2.9.
+fixture the .NET, C++ and Rust suites use. Measured on Windows 10 (22H2), AMD Ryzen 7 5700X
+(16 logical CPUs @ 3.39 GHz), CPython 3.14.7, 10 runs each (medians shown; `min` is in the scripts' own
+output), against a library published from commit 65945b4. Competitors: polars 1.44.1 (with
+fastexcel 0.21.0), pandas 3.0.5 (with openpyxl 3.1.5), xlsxwriter 3.2.9.
 
 ### Reading
 
 | API | Median | What it produces |
 |---|---:|---|
-| `to_record_batch_reader()` | 35.8 ms | Arrow record batches, streamed |
-| `to_arrow()` | 36.1 ms | the same parse, handed to pyarrow zero-copy |
-| `parse_typed()` | 39.5 ms | typed columnar buffers, converted natively |
-| `iter_parse_typed()` | 38.4 ms | the same typed buffers, in batches |
-| `to_polars()` | 38.7 ms | typed columnar DataFrame, schema inferred |
-| `polars.read_excel()` | 124.3 ms | typed columnar DataFrame, types inferred |
-| `read_all_columnar()` | 471.7 ms | raw columnar cells, no per-cell Python objects |
-| `rows()` | 1,086.9 ms | one `Cell` object per cell, streamed per row |
-| `read_all()` | 1,656.5 ms | one `Cell` object per cell, all at once |
+| `to_record_batch_reader()` | 31.9 ms | Arrow record batches, streamed |
+| `to_arrow()` | 31.8 ms | the same parse, handed to pyarrow zero-copy |
+| `parse_typed()` | 33.5 ms | typed columnar buffers, converted natively |
+| `iter_parse_typed()` | 34.2 ms | the same typed buffers, in batches |
+| `to_polars()` | 34.6 ms | typed columnar DataFrame, schema inferred |
+| `polars.read_excel()` | 125.6 ms | typed columnar DataFrame, types inferred |
+| `read_all_columnar()` | 463.3 ms | raw columnar cells, no per-cell Python objects |
+| `rows()` | 1,034.6 ms | one `Cell` object per cell, streamed per row |
+| `read_all()` | 1,631.0 ms | one `Cell` object per cell, all at once |
 
 The batched readers cost the same as their whole-sheet counterparts and lower the peak memory:
-`to_record_batch_reader(batch_size=10000)` peaks at 20.2 MiB against 24.8 MiB for one whole-sheet
+`to_record_batch_reader(batch_size=10000)` peaks at 11.4 MiB against 18.8 MiB for one whole-sheet
 record batch on this file.
 
-Only the `to_polars()` / `polars.read_excel()` pair is a like-for-like comparison, and even that one
-is loose: both produce a typed columnar DataFrame with inferred types, but the inference rules are
-not identical. The rows above it produce different things and are listed to show what each API
-costs, not to rank them — `read_all()` is ~42x slower than `parse_typed()` because it materializes
+Only the `to_polars()` / `polars.read_excel()` pair is a like-for-like comparison (~3.6x), and even
+that one is loose: both produce a typed columnar DataFrame with inferred types, but the inference rules
+are not identical. The rows above it produce different things and are listed to show what each API
+costs, not to rank them — `read_all()` is ~49x slower than `parse_typed()` because it materializes
 917,504 Python objects, which is the price of that shape, not a slow parser.
 
+CSV, from `65K_Records_Data.csv` (8.2 MB), same 14 typed columns:
+
+| API | Median |
+|---|---:|
+| `parse_typed(parallelism=1)` | 23.6 ms |
+| `parse_typed(parallelism=0)` | 12.0 ms |
+| `to_polars(parallelism=1)` | 25.0 ms |
+| `to_polars(parallelism=0)` | 10.8 ms |
+| `polars.read_csv(try_parse_dates=True)` | 7.3 ms |
+| `pandas.read_csv`, pyarrow engine | 115.8 ms |
+| `pandas.read_csv`, C engine | 138.7 ms |
+
+polars' CSV reader is ahead (multithreaded, and it infers types from the text without our schema
+step); ExcelReader is ~10x faster than pandas on either engine. These include opening the file, so
+they are above the in-memory `xl_parse_typed` figures in [Reading a large CSV on several
+threads](#reading-a-large-csv-on-several-threads).
+
 ### Writing
 
 | API | Median | Output |
 |---|---:|---|
-| `write_workbook()` → csv | 35.7 ms | 8.2 MB |
-| `write_workbook()` → xls | 43.9 ms | 17.7 MB |
-| `write_workbook()` → xlsb | 71.9 ms | 5.1 MB |
-| `write_workbook()` → xlsx | 90.2 ms | 5.1 MB |
-| `write_polars()` → xlsx | 470.2 ms | 5.1 MB |
-| `write_pandas()` → xlsx | 468.5 ms | 5.1 MB |
-| `polars.DataFrame.write_excel()` | 4,707.2 ms | 5.6 MB |
-| `pandas.DataFrame.to_excel()` | 7,274.0 ms | 5.5 MB |
+| `write_workbook()` → csv | 35.1 ms | 8.2 MB |
+| `write_workbook()` → xls | 44.4 ms | 17.7 MB |
+| `write_workbook()` → xlsb | 71.5 ms | 5.1 MB |
+| `write_workbook()` → xlsx | 90.6 ms | 5.1 MB |
+| `write_polars()` → xlsx | 487.4 ms | 5.1 MB |
+| `write_pandas()` → xlsx | 493.8 ms | 5.1 MB |
+| `polars.DataFrame.write_excel()` | 4,670.4 ms | 5.6 MB |
+| `pandas.DataFrame.to_excel()` | 7,192.9 ms | 5.5 MB |
 
 The two DataFrame comparisons are matched work — same DataFrame in, xlsx out both times:
-`write_polars()` is ~10.0x faster than polars' own `write_excel()`, and `write_pandas()` ~15.5x
+`write_polars()` is ~9.6x faster than polars' own `write_excel()`, and `write_pandas()` ~14.6x
 faster than `to_excel()`. Both of ours pay a conversion the raw path does not: the DataFrame goes
 through Arrow and then a Python list before reaching the native columns, which is most of the gap
-between the 470 ms row and the 90 ms one. Handing `write_workbook()` buffers that are already
+between the ~490 ms rows and the 90 ms one. Handing `write_workbook()` buffers that are already
 columnar — what `parse_typed()` returns — skips all of it.
 
-`write_workbook(xlsx)` at 90.2 ms lands within ~5 ms of the C++ binding's
-`xl::write_columns` on the same 14 columns (85.1–85.9 ms), which is the expected result: both are thin wrappers
+`write_workbook(xlsx)` at 90.6 ms lands within ~5 ms of the C++ binding's
+`xl::write_columns` on the same 14 columns (85.4 ms), which is the expected result: both are thin wrappers
 over the same `xl_write_typed` call, and neither adds work per cell.
 
 `xls` being both the largest file and faster than xlsb and xlsx is not a paradox — BIFF8 writes
diff --git a/rust/excelreader/README.md b/rust/excelreader/README.md
index 80db3161..d00f2f6a 100644
--- a/rust/excelreader/README.md
+++ b/rust/excelreader/README.md
@@ -392,10 +392,10 @@ takes 20 samples instead — each of its iterations writes a whole 65,535-row fi
 
 | Benchmark | RealExcel.xlsb (100 rows) | 65K_Records_Data.xlsb (65,535 rows) |
 |---|---:|---:|
-| `open` | 83.4 µs | 96.2 µs |
-| `parse_sheet` (2 or 6 bound columns) | 60.0 µs | 29.1 ms |
-| typed chunks of 1,000 / 10,000 rows | - | 29.0 ms / 27.7 ms |
-| `infer_schema` (sample 100 / 1,000 rows) | 89.9 µs | 628.4 µs |
+| `open` | 85.8 µs | 98.9 µs |
+| `parse_sheet` (2 or 6 bound columns) | 58.7 µs | 24.6 ms |
+| typed chunks of 1,000 / 10,000 rows | - | 23.4 ms / 23.5 ms |
+| `infer_schema` (sample 100 / 1,000 rows) | 86.8 µs | 577.4 µs |
 
 `open` stays nearly flat across the 655x row-count jump (+15%) - XLSB's header carries its
 dimensions/index, so opening costs metadata, not row data. `parse_sheet` scales linearly with
@@ -410,10 +410,13 @@ zero-copy advantage the other can't take:
 
 | Format | ExcelReader (`parse_sheet::<FullRow>`) | calamine (`worksheet_range` + `Data` match) |
 |---|---:|---:|
-| XLSX | 85.8 ms | 272.0 ms |
-| XLSB | 53.0 ms | 86.8 ms |
+| XLSX | 79.1 ms | 279.7 ms |
+| XLSB | 46.9 ms | 87.5 ms |
 
-ExcelReader is ~3.2x faster than calamine for XLSX and ~1.6x faster for XLSB on this workload -
+The ExcelReader XLSX run was noisy (Criterion's interval is 76.0–83.0 ms; calamine's is 278.6–281.0 ms), so
+read its ratio as 3.4–3.7x.
+
+ExcelReader is ~3.5x faster than calamine for XLSX and ~1.9x faster for XLSB on this workload -
 calamine is a fast, well-optimized reader in its own right, so the gap is real but not the order
 of magnitude seen against slower libraries.
 
@@ -423,15 +426,15 @@ rows to `.xlsx`, all three starting from the same in-memory `Vec<Row>`:
 
 | Benchmark | Median |
 |---|---:|
-| `columns` (`write_columns`, pre-transposed) | 47.3 ms |
-| `sheet` (`write_sheet`, from `Vec<Row>`) | 53.3 ms |
-| `rust_xlsxwriter` (cell-at-a-time) | 326.9 ms |
+| `columns` (`write_columns`, pre-transposed) | 45.7 ms |
+| `sheet` (`write_sheet`, from `Vec<Row>`) | 51.9 ms |
+| `rust_xlsxwriter` (cell-at-a-time) | 328.3 ms |
 
 `sheet` is the matched-work number — it starts from the same shape `rust_xlsxwriter` is handed and
-pays the row-to-column transpose itself — and is ~6.1x faster. `columns` is a ceiling no
+pays the row-to-column transpose itself — and is ~6.3x faster. `columns` is a ceiling no
 cell-at-a-time API can reach, since it is handed buffers that are already columnar; read it only
 against `sheet`, as the cost of having row-shaped data in the first place. That cost turns out to be
-about 13%: not free, but a minority of the cost of producing the file.
+about 14%: not free, but a minority of the cost of producing the file.
 
 Two caveats, both running against the headline number rather than for it. ExcelReader does slightly
 *more* work here: it attaches a number format to the date column so Excel shows a date, and writes a

From 7e04748f84c53e67a4e99d709b1e1b015f916318 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 01:15:49 -0300
Subject: [PATCH 038/115] perf(docs): update benchmark results for XLSX, XLSM,
 XLSB, and CSV formats to reflect improved performance metrics

---
 docs/performance/benchmarks.md         | 84 +++++++++++++++-----------
 docs/performance/reader-performance.md |  8 ++-
 2 files changed, 54 insertions(+), 38 deletions(-)

diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index d6997ea4..7d3c6f24 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -97,13 +97,13 @@ This benchmark reads a real workbook exported in multiple formats.
 
 | Format | ExcelReader | ExcelReader, prefetch | Sylvan |
 |---|---:|---:|---:|
-| XLSX | 49.747 ms, 7.62 KB | 27.818 ms, 25.19 KB | 193.951 ms, 644.23 KB |
-| XLSM | 50.311 ms, 7.62 KB | 28.100 ms, 25.01 KB | 197.515 ms, 644.30 KB |
-| XLSB | 27.658 ms, 7.18 KB | 16.899 ms, 15.70 KB | 30.150 ms, 338.54 KB |
-| XLS | 10.919 ms, 12.02 KB | n/a | 18.306 ms, 185.90 KB |
-| CSV | 4.955 ms, 848 B | n/a | 4.491 ms, 40.26 KB |
+| XLSX | 43.792 ms, 7.23 KB | 29.544 ms, 23.39 KB | 201.558 ms, 644.23 KB |
+| XLSM | 44.486 ms, 7.23 KB | 29.169 ms, 23.42 KB | 207.288 ms, 644.30 KB |
+| XLSB | 25.704 ms, 6.79 KB | 17.403 ms, 17.01 KB | 30.864 ms, 338.54 KB |
+| XLS | 11.335 ms, 12.02 KB | n/a | 19.146 ms, 185.90 KB |
+| CSV | 5.284 ms, 840 B | n/a | 4.630 ms, 40.26 KB |
 
-On this real-data workload, ExcelReader is ~3.9x faster than Sylvan for XLSX and ~3.9x for XLSM, essentially tied for XLSB (~1.09x), and ~1.7x faster for XLS — allocating ~84x less for XLSX and XLSM, ~47x less for XLSB and ~15x less for XLS. On CSV, where both sides read text through spans, Sylvan.Data.Csv is ~10% faster, while ExcelReader allocates ~49x less. The prefetch column is the opt-in [`PrefetchDecompression`](../guide/reading.md#prefetch-decompression-xlsxxlsb) option; XLS and CSV are uncompressed, so it does not apply to them.
+On this real-data workload, ExcelReader is ~4.6x faster than Sylvan for XLSX and ~4.7x for XLSM, ~1.2x faster for XLSB, and ~1.7x faster for XLS — allocating ~89x less for XLSX and XLSM, ~51x less for XLSB and ~15x less for XLS. On CSV, where both sides read text through spans, Sylvan.Data.Csv is ~14% faster, while ExcelReader allocates ~49x less. The prefetch column is the opt-in [`PrefetchDecompression`](../guide/reading.md#prefetch-decompression-xlsxxlsb) option; XLS and CSV are uncompressed, so it does not apply to them.
 
 ### In-memory real-data reads
 
@@ -111,18 +111,18 @@ The real-data benchmark also measures the in-memory path for workbook content lo
 
 | Method | Mean | StdDev | Allocated |
 |---|---:|---:|---:|
-| Xlsx_ExcelReader_Memory | 49.968 ms | 0.156 ms | 7.38 KB |
-| Xlsx_ExcelReader_Memory_Prefetch | 28.667 ms | 0.090 ms | 25.19 KB |
-| Xlsm_ExcelReader_Memory | 50.871 ms | 0.172 ms | 7.38 KB |
-| Xlsm_ExcelReader_Memory_Prefetch | 28.844 ms | 0.081 ms | 25.07 KB |
-| Xlsb_ExcelReader_Memory | 29.321 ms | 0.070 ms | 8.88 KB |
-| Xlsb_ExcelReader_Memory_Prefetch | 15.741 ms | 0.027 ms | 19.11 KB |
-| Xls_ExcelReader_Memory | 10.514 ms | 0.033 ms | 11.88 KB |
-| Csv_ExcelReader_Memory | 4.745 ms | 0.004 ms | 576 B |
+| Xlsx_ExcelReader_Memory | 44.249 ms | 0.341 ms | 6.98 KB |
+| Xlsx_ExcelReader_Memory_Prefetch | 30.115 ms | 0.803 ms | 23.19 KB |
+| Xlsm_ExcelReader_Memory | 45.242 ms | 0.357 ms | 6.98 KB |
+| Xlsm_ExcelReader_Memory_Prefetch | 29.307 ms | 0.718 ms | 23.05 KB |
+| Xlsb_ExcelReader_Memory | 25.606 ms | 0.255 ms | 8.49 KB |
+| Xlsb_ExcelReader_Memory_Prefetch | 16.688 ms | 0.857 ms | 16.64 KB |
+| Xls_ExcelReader_Memory | 11.330 ms | 0.105 ms | 11.88 KB |
+| Csv_ExcelReader_Memory | 4.919 ms | 0.043 ms | 568 B |
 
-`Csv_ExcelReader_Memory` is both faster (4.745 ms vs. 4.955 ms for `Csv_ExcelReader`) and allocates less (576 B vs. 848 B) than its stream twin.
+`Csv_ExcelReader_Memory` is both faster (4.919 ms vs. 5.284 ms for `Csv_ExcelReader`) and allocates less (568 B vs. 840 B) than its stream twin.
 
-`Xls_ExcelReader_Memory` is ~4% faster than its stream twin (10.514 ms vs. 10.919 ms for `Xls_ExcelReader`), with near-identical allocation (11.88 KB vs. 12.02 KB). In earlier runs the in-memory path was ~33% faster, thanks to `BiffCursor` caching the enclosing contiguous sector run; the stream path has since caught up.
+`Xls_ExcelReader_Memory` matches its stream twin (11.330 ms vs. 11.335 ms for `Xls_ExcelReader`), with near-identical allocation (11.88 KB vs. 12.02 KB). In earlier runs the in-memory path was ~33% faster, thanks to `BiffCursor` caching the enclosing contiguous sector run; the stream path has since caught up.
 
 ### String-heavy reads
 
@@ -130,22 +130,34 @@ The real-data corpus above is mostly numbers and dates — its shared-string tab
 
 | Format | ExcelReader | ExcelReader, prefetch | Sylvan |
 |---|---:|---:|---:|
-| XLSX | 41.18 ms, 2.18 MB | 27.36 ms, 2.27 MB | 178.73 ms, 17.41 MB |
-| XLSB | 39.48 ms, 2.18 MB | 26.04 ms, 2.26 MB | 62.55 ms, 17.38 MB |
+| XLSX | 33.16 ms, 2.18 MB | 23.35 ms, 2.21 MB | 187.18 ms, 17.41 MB |
+| XLSB | 35.92 ms, 2.18 MB | 21.86 ms, 2.21 MB | 66.81 ms, 17.38 MB |
 
-Both formats handle this well: ~4.3x and ~1.6x faster than Sylvan for XLSX and XLSB respectively, at roughly ~8x less memory in both cases, with no garbage collections in either configuration. XLSB's shared-string path previously materialized its table eagerly (~27 MB here); `ParseSharedStreaming` brought it in line with the XLSX streaming/pooling path, cutting allocation by ~12x on this workload.
+Both formats handle this well: ~5.6x and ~1.9x faster than Sylvan for XLSX and XLSB respectively, at roughly ~8x less memory in both cases, with no garbage collections in either configuration. XLSB's shared-string path previously materialized its table eagerly (~27 MB here); `ParseSharedStreaming` brought it in line with the XLSX streaming/pooling path, cutting allocation by ~12x on this workload.
 
 `XlsxSharedStringHotPathBenchmark` splits the XLSX read into stages on the same workbook. The stored rows re-zip it without compression, so they show what parsing costs once inflate is gone:
 
 | Stage | Mean | Allocated |
 |---|---:|---:|
-| Whole read | 41.17 ms | 2.18 MB |
-| Whole read, prefetch | 28.21 ms | 2.27 MB |
-| Shared-string table only (open + first row) | 13.54 ms | 747 KB |
-| Whole read, stored | 19.82 ms | 2.18 MB |
-| Shared-string table only, stored | 3.11 ms | 746 KB |
+| Whole read | 33.79 ms | 2.18 MB |
+| Whole read, prefetch | 23.61 ms | 2.21 MB |
+| Shared-string table only (open + first row) | 9.72 ms | 747 KB |
+| Whole read, stored | 20.10 ms | 2.18 MB |
+| Shared-string table only, stored | 3.24 ms | 746 KB |
 
-About half of the default read is inflate: without it the whole read drops from 41.17 ms to 19.82 ms, and the shared-string table from 13.54 ms to 3.11 ms. What remains, ~17 ms, is the worksheet scan.
+About 40% of the default read is inflate: without it the whole read drops from 33.79 ms to 20.10 ms, and the shared-string table from 9.72 ms to 3.24 ms. What remains, ~17 ms, is the worksheet scan.
+
+### Inflate
+
+`InflateBenchmark` decompresses one ZIP entry per method with `System.IO.Compression.DeflateStream` and with the library's managed `InflateStream`, which every ZIP-based reader now uses:
+
+| Entry | `DeflateStream` | `InflateStream` | Ratio |
+|---|---:|---:|---:|
+| XLSX `sheet1.xml` (6.7 MB → 34.4 MB) | 23.433 ms, 280 B | 16.501 ms, 200 B | 0.70 |
+| XLSB `sheet1.bin` (3.7 MB → 15.9 MB) | 13.230 ms, 280 B | 10.259 ms, 200 B | 0.78 |
+| String-heavy `sharedStrings.xml` | 10.522 ms, 281 B | 6.659 ms, 200 B | 0.63 |
+
+Without prefetch a read is inflate plus parse, so the faster inflate converts directly; with prefetch the two overlap and the read is bounded by the slower stage, which is why the prefetch columns above moved little.
 
 ### Matched-work reads (`*_Materialized`)
 
@@ -157,11 +169,11 @@ Real-data workbook, per format:
 
 | Format | Mean | StdDev | Allocated |
 |---|---:|---:|---:|
-| XLSX | 52.42 ms | 0.05 ms | 17.09 KB |
-| XLSM | 51.33 ms | 0.07 ms | 17.09 KB |
-| XLSB | 30.97 ms | 0.09 ms | 16.65 KB |
-| XLS | 12.62 ms | 0.03 ms | 21.48 KB |
-| CSV | 18.42 ms | 0.09 ms | 35.71 MB |
+| XLSX | 46.53 ms | 0.19 ms | 16.70 KB |
+| XLSM | 46.16 ms | 0.48 ms | 16.70 KB |
+| XLSB | 28.46 ms | 0.58 ms | 16.26 KB |
+| XLS | 13.36 ms | 0.27 ms | 21.48 KB |
+| CSV | 19.38 ms | 0.10 ms | 35.71 MB |
 
 Generated 50,000-row XLSX workbook:
 
@@ -173,14 +185,14 @@ String-heavy workbook (65,536 rows, ~190,000 distinct shared strings):
 
 | Format | Mean | StdDev | Gen0 | Gen1 | Gen2 | Allocated |
 |---|---:|---:|---:|---:|---:|---:|
-| XLSX | 61.82 ms | 0.83 ms | 1,111.1 | 1,000.0 | 333.3 | 15.26 MB |
-| XLSB | 59.38 ms | 0.92 ms | 1,111.1 | 1,000.0 | 333.3 | 15.26 MB |
+| XLSX | 57.19 ms | 2.01 ms | 1,111.1 | 1,000.0 | 333.3 | 15.25 MB |
+| XLSB | 57.84 ms | 1.98 ms | 1,100.0 | 1,000.0 | 300.0 | 15.25 MB |
 
 Reading the allocation columns against the tables above gives the honest shape of the tradeoff:
 
-- **CSV real data:** 35.71 MB materialized against 848 B for the span-based read of the same file. Every CSV field is a distinct string, so nothing dedupes — this is where zero-copy reading earns its keep outright.
-- **XLSB real data:** 16.65 KB, essentially cheap. That corpus repeats a small set of values, so the shared-string table dedupes and the reader's string cache materializes each distinct value once.
-- **String-heavy XLSX:** 15.26 MB materialized, against **Sylvan's 17.41 MB on the same workload** — doing matched work here, ExcelReader allocates ~12% *less* than Sylvan, with 333 Gen2 collections, and is still ~2.9x faster (61.82 ms vs. 178.73 ms). The same allocation holds for XLSB (15.26 MB vs. Sylvan's 17.38 MB, also ~12% less, 333 Gen2 collections), where matched-work time is ~5% ahead of Sylvan (59.38 ms vs. 62.55 ms). This was previously an inversion (ExcelReader allocated ~1.75x *more* than Sylvan here): the per-reader shared-string dedup cache was an unpresized `Dictionary<int,string>`, and at ~190,000 distinct values its resize/rehash churn (several of the largest resizes landing on the LOH) accounted for the entire gap — the strings themselves were never the problem, since both readers retain the same ~190,000 distinct instances. Replacing the dictionary with a `string?[]` indexed by shared-string index (sized exactly from the table's known count, no resizing) cut the allocation in half and cut wall-clock time by 14-16% on this benchmark too, since the churn was costing cycles, not just memory.
+- **CSV real data:** 35.71 MB materialized against 840 B for the span-based read of the same file. Every CSV field is a distinct string, so nothing dedupes — this is where zero-copy reading earns its keep outright.
+- **XLSB real data:** 16.26 KB, essentially cheap. That corpus repeats a small set of values, so the shared-string table dedupes and the reader's string cache materializes each distinct value once.
+- **String-heavy XLSX:** 15.25 MB materialized, against **Sylvan's 17.41 MB on the same workload** — doing matched work here, ExcelReader allocates ~12% *less* than Sylvan, with 333 Gen2 collections, and is still ~3.3x faster (57.19 ms vs. 187.18 ms). The same allocation holds for XLSB (15.25 MB vs. Sylvan's 17.38 MB, also ~12% less, 300 Gen2 collections), where matched-work time is ~14% ahead of Sylvan (57.84 ms vs. 66.81 ms). This was previously an inversion (ExcelReader allocated ~1.75x *more* than Sylvan here): the per-reader shared-string dedup cache was an unpresized `Dictionary<int,string>`, and at ~190,000 distinct values its resize/rehash churn (several of the largest resizes landing on the LOH) accounted for the entire gap — the strings themselves were never the problem, since both readers retain the same ~190,000 distinct instances. Replacing the dictionary with a `string?[]` indexed by shared-string index (sized exactly from the table's known count, no resizing) cut the allocation in half and cut wall-clock time by 14-16% on this benchmark too, since the churn was costing cycles, not just memory.
 
 The takeaway is not that one column beats the other: it is that ExcelReader's headline read numbers come from a zero-copy path competitors do not expose, and when it does the same work as them, the gap narrows — and here, with the dedup cache fixed, no longer inverts even at high shared-string cardinality.
 
@@ -307,7 +319,7 @@ dotnet run --project tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj
 
 The allocation column is **managed memory only**. `MemoryDiagnoser` cannot see the native blocks that `xl_read_all_decoded`, `xl_parse_typed` and `xl_parse_arrow` return their data in.
 
-Row by row, `xl_next_row` costs ~1.4x the managed in-memory read of the same file (40.35 ms vs. 29.321 ms for `Xlsb_ExcelReader_Memory` under [In-memory real-data reads](#in-memory-real-data-reads); different benchmark class, same run). Every cell crosses the ABI as text, so each binary XLSB number is formatted to UTF-8 on the way out. `xl_read_all_blob` adds ~8% over it, because the whole sheet is buffered before it is copied out. `xl_read_all_decoded` adds ~35%, because it allocates a native block per row. `xl_parse_typed` and `xl_parse_arrow` cost about the same as a row-by-row read but return columnar native buffers with numbers still binary, so they are the path to use for bulk typed loads.
+Row by row, `xl_next_row` costs ~1.6x the managed in-memory read of the same file (40.35 ms vs. 25.606 ms for `Xlsb_ExcelReader_Memory` under [In-memory real-data reads](#in-memory-real-data-reads)). The managed figure is from a later run, after `InflateStream`; this native table has not been re-run since, so read the ratio as an upper bound. Every cell crosses the ABI as text, so each binary XLSB number is formatted to UTF-8 on the way out. `xl_read_all_blob` adds ~8% over it, because the whole sheet is buffered before it is copied out. `xl_read_all_decoded` adds ~35%, because it allocates a native block per row. `xl_parse_typed` and `xl_parse_arrow` cost about the same as a row-by-row read but return columnar native buffers with numbers still binary, so they are the path to use for bulk typed loads.
 
 `ChunkedParseBenchmark` compares `xl_parse_typed` on a whole sheet against draining the same sheet in batches through `xl_typed_reader_open`/`xl_typed_reader_next`. It uses the generated 50,000-row XLSX file, read from disk, with three nullable columns (string, int64, float64):
 
diff --git a/docs/performance/reader-performance.md b/docs/performance/reader-performance.md
index 2c00d4c1..a41568cb 100644
--- a/docs/performance/reader-performance.md
+++ b/docs/performance/reader-performance.md
@@ -1044,8 +1044,12 @@ used to yield a silent prefix of its rows. `InflateStream` throws `InvalidDataEx
 - `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The gap is
   undiagnosed. Next step: read the Tier1 disassembly of `InflateDecoder.FastLoop` for values the
   JIT keeps on the stack.
-- Every number in "Fourth round" is from the i7-1365U. `benchmarks.md` still shows `DeflateStream`
-  figures until the suite is re-run on the Ryzen 7 5700X.
+- "Fourth round" is from the i7-1365U. The Ryzen 7 5700X re-run (2026-10-09, `--job Medium`) is in
+  `benchmarks.md`: `InflateStream` is 0.70x / 0.78x / 0.63x of `DeflateStream` on the XLSX sheet, XLSB
+  sheet and string-heavy `sharedStrings.xml`, against 0.62 / 0.71 / 0.64 on the laptop. The
+  non-prefetched reads moved with it (real-data XLSX 49.7 → 43.8 ms, XLSB 27.7 → 25.7 ms; string-heavy
+  XLSX 41.2 → 33.2 ms) and the prefetched ones did not (27.8 → 29.5 ms, 16.9 → 17.4 ms), as the
+  `max(I, P)` model predicts. The native C ABI table in `benchmarks.md` has not been re-run since.
 - NativeAOT XLSX is ~13% behind the JIT, and the static profile does not close it (see "NativeAOT,
   again"). Next step: diff the JIT's Tier1 code for `ParseRowInWindow` against ILC's output.
 - 17-digit numbers are parsed twice in XLSX: emit rejects them to keep the text exact, and the

From 4aa3766fa887f0a72a7a3878cd94dc9b915d540d Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 02:27:41 -0300
Subject: [PATCH 039/115] perf(docs): update performance metrics for NativeAOT
 XLSX and CSV enumerator overhead based on recent measurements

---
 docs/performance/reader-performance.md | 140 +++++++++++++++++++++----
 1 file changed, 122 insertions(+), 18 deletions(-)

diff --git a/docs/performance/reader-performance.md b/docs/performance/reader-performance.md
index a41568cb..02b94976 100644
--- a/docs/performance/reader-performance.md
+++ b/docs/performance/reader-performance.md
@@ -985,6 +985,54 @@ before publishing.
 The C++ binding's full XLSX read moved from 93.2 to ~85.4 ms with no native change, from the
 XLSX changes above.
 
+### NativeAOT XLSX gap, re-checked (2026-10-09, Ryzen 7 5700X)
+
+The gap quoted under "NativeAOT, again" (JIT 74.1 ms, NativeAOT 84.0 ms) predates `InflateStream`, the
+regenerated profile and the native column buffers, so it was re-measured first. The python binding
+reads `65K_Records_Data.xlsx` with `parse_typed` in 58.0–58.5 ms from the shipped library. The same
+`ReadApi.OpenMemory` + `TypedApi.ParseTyped` calls in a scratch console, JIT against NativeAOT built
+with the library's settings (`OptimizationPreference=Speed`, `x86-64-v3`, the `.mibc`), min of 40
+rounds:
+
+| stage | JIT | NativeAOT |
+|---|---|---|
+| inflate `sheet1.xml` (`InflateStream`) | 16.0 ms | 16.0 ms |
+| rows only, no prefetch | 39.1 ms | 43.5 ms |
+| rows + `TryGetDouble` on every number | 42.8 ms | 47.9 ms |
+| `xl_parse_typed` | 54.0 ms | 60.7 ms |
+
+So the gap is ~12% in the harness and ~7% against the shipped library. **Inflate is at parity**, so
+the decode loop is not part of it. About two thirds is the worksheet scan and a third is the typed
+conversions after it.
+
+**A first harness left out `OptimizationPreference=Speed`** and read 66.5 ms for NativeAOT: ILC's
+default blended mode inlines much less. Check a harness's ILC settings against the project's before
+trusting a gap measured in it.
+
+The disassembly, with `--codegenopt:JitDisasm=ParseRowInWindow` and `JitStdOutFile` given to ILC as
+`IlcArg` items through a `CustomAfterMicrosoftCommonTargets` file: ILC's `ParseRowInWindow` is 846
+bytes with 15 inlinees and **a call to `ParseCellSpan`**. The JIT's Tier1 listing is 3,906 bytes with
+202 inlinees and no such call; it pulled `ParseCellSpan` and its callees into the row loop. (Earlier
+notes found `NoInlining` on `ParseCellSpan` costs the JIT 5–8%, so the inlined shape is the fast one.)
+`[MethodImpl(MethodImplOptions.AggressiveInlining)]` on `ParseCellSpan` makes ILC do the same:
+
+| | NativeAOT before | after | JIT before | after |
+|---|---|---|---|---|
+| rows only | 43.5 ms | 41.8 ms | 39.2 ms | 39.5 ms |
+| `xl_parse_typed` | 60.7 ms | 58.9 ms | 54.0 ms | 54.0 ms |
+
+That is 3–4% in the harness and neutral under the JIT. **It does not reach the shipped library**: the
+real `ExcelReader.Native.dll` built with and without the attribute, alternated three times through the
+python binding, measured 57.9–58.5 ms and 58.4–58.7 ms. The C++ `BM_ExcelReader_Xlsx_ParseOnly` agreed
+(55.9–56.8 ms against 56.6–56.8). The real library's `ParseCellSpan` was a call in its baseline too, so
+the attribute applies there; the Core-level harness just does not predict the end-to-end number, most
+likely because the C ABI layer and the typed column writers dominate what the scan saves. Not kept.
+
+What is left is spread thin: ~0.7 ms in the consumer's double parse (`TryGetDouble` over every number
+costs 4.4 ms under ILC and 3.7 ms under the JIT, with listings of about the same size, 662 and 641
+bytes), ~2.5 ms in the typed conversions, and the rest in the scan. No hot spot is visible in either
+listing.
+
 ### Fourth round (2026-10-08, i7-1365U): a managed inflate decoder
 
 Measured on the laptop, so only the ratios mean anything; the published tables need the Ryzen run.
@@ -1033,7 +1081,33 @@ Measured and not kept:
 | `AggressiveOptimization` on the decode loop | no change, so the loop does not depend on dynamic PGO |
 | `Vector128` match copy for offsets of 16 and up | no change on XLSX, slightly slower on XLSB |
 
-The remaining gap to libdeflate has not been diagnosed; nobody has read the loop's disassembly yet.
+#### The decode loop's Tier1 disassembly (2026-10-09, Ryzen 7 5700X)
+
+`DOTNET_JitDisasm=FastLoop` on a scratch harness that inflates the XLSX sheet 150 times. The `(Tier1)`
+listing is 955 bytes, and the loop **keeps every live value in a register**: `bitbuf`, `bitsleft`, both
+cursors, the limits, the table base and the mask are all in registers, with eight callee-saved pushes in the
+prologue and no stack traffic inside the loop. The spill problem the CSV scanner had is not here. Two
+earlier listings are `Instrumented Tier0` and `Tier1-OSR`; the OSR one is the method's first long call,
+so read the last listing.
+
+Where the time goes, from timestamps around the pieces, one XLSX sheet, 16.6 ms in total:
+
+| piece | ms | |
+|---|---|---|
+| `FastLoop` (1,042 calls) | 14.6 | 88% |
+| 417 dynamic block headers and table builds | 0.7 | 4% |
+| copy to the caller and slide the window (isolated) | 0.8 | 5% |
+
+So the streaming overhead the "Fourth round" blamed for part of the gap is ~5%, and the table builds
+are not it either. The gap to libdeflate is inside the loop, at ~2.4 GB/s of output.
+
+What the listing does show is small. Each decoded entry pays a zero-extending `mov r12d, r15d` before
+`sub rsi, r12`, because `bitsleft` is a `long` and the entry a `uint`. Making `bitsleft` a `uint`, as
+libdeflate has it, removes that and measured 15.87–15.99 ms → 15.63–15.77 ms on XLSX (~1.5%) and nothing on XLSB.
+Not applied. The literal path takes four jumps per run of literals because the JIT laid the second and
+third literal out of line, and several `mov r13, rbx` / `shrx rbx, r13, r15` pairs keep the pre-shift
+`saved` value alive for the match path whether or not it is used. None of that is something source
+changes reach reliably; what is left is the JIT's block layout and register copies. Not worth chasing.
 
 **A behavior change came with it.** `DeflateStream` does not reject a stream that ends before its
 final block: it returns what it decoded and reports end of stream. A sheet entry cut short therefore
@@ -1041,33 +1115,63 @@ used to yield a silent prefix of its rows. `InflateStream` throws `InvalidDataEx
 
 ## Known open items
 
-- `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The gap is
-  undiagnosed. Next step: read the Tier1 disassembly of `InflateDecoder.FastLoop` for values the
-  JIT keeps on the stack.
+- `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The Tier1
+  disassembly shows no spills and 88% of the time in `FastLoop` itself (see "The decode loop's Tier1
+  disassembly"); the remainder is JIT codegen. A `uint bitsleft` is worth ~1.5% if anyone wants it.
 - "Fourth round" is from the i7-1365U. The Ryzen 7 5700X re-run (2026-10-09, `--job Medium`) is in
   `benchmarks.md`: `InflateStream` is 0.70x / 0.78x / 0.63x of `DeflateStream` on the XLSX sheet, XLSB
   sheet and string-heavy `sharedStrings.xml`, against 0.62 / 0.71 / 0.64 on the laptop. The
   non-prefetched reads moved with it (real-data XLSX 49.7 → 43.8 ms, XLSB 27.7 → 25.7 ms; string-heavy
   XLSX 41.2 → 33.2 ms) and the prefetched ones did not (27.8 → 29.5 ms, 16.9 → 17.4 ms), as the
   `max(I, P)` model predicts. The native C ABI table in `benchmarks.md` has not been re-run since.
-- NativeAOT XLSX is ~13% behind the JIT, and the static profile does not close it (see "NativeAOT,
-  again"). Next step: diff the JIT's Tier1 code for `ParseRowInWindow` against ILC's output.
-- 17-digit numbers are parsed twice in XLSX: emit rejects them to keep the text exact, and the
-  consumer parses them again. A `Cell` flag for an approximate double would save ~3 ms per
-  real-data read, at the cost of a wider `Cell`.
+- NativeAOT XLSX is ~7–10% behind the JIT, down from the ~13% in "NativeAOT, again"; the diff of the
+  JIT's Tier1 `ParseRowInWindow` against ILC's is done (see "NativeAOT XLSX gap, re-checked"). The one
+  difference found does not move the shipped library.
+- **17-digit numbers parsed twice in XLSX: prototyped 2026-10-09 (Ryzen 7 5700X), not kept.** Emit
+  rejects them to keep the text exact and the consumer parses them again. The prototype parsed up to
+  19 digits at emit, had `FastDouble` report whether the result keeps every digit (15 or fewer), and
+  carried that as a `NumberApproximate` flag through `CellAccumulator`, `CellDesc` and `Cell`.
+  `TryGetDouble` and `TryParse<double>` used the number; every other `T` ignored an approximate one and
+  read the text, so `long` and `decimal` stayed exact. The flag costs nothing in size: `CellDesc` stays
+  32 bytes (the new `bool` fills the last padding byte) and `Cell` has padding to spare, so "a wider
+  `Cell`" was wrong. Real-data XLSX, 49,799 17-digit cells of 589,815, min of 35 rounds, base and new
+  `ExcelReader.Core.dll` alternated three times in separate processes, identical checksums:
+
+  | consumer | before | after |
+  |---|---|---|
+  | `TryParse<double>` on every number | 43.3–43.6 ms | 42.1–43.1 ms (~2%) |
+  | `TryGetDouble` on every number | 42.4–43.0 ms | 42.2–42.4 ms (~1%) |
+  | `TryParse<decimal>` | 53.5–54.5 ms | 54.3–54.8 ms (~+1%) |
+  | no number parsed | 41.5–41.9 ms | 42.1–43.0 ms (~+1.5%) |
+
+  A trade, like lazy number parsing: the double consumers win ~1 ms, not the ~3 ms estimated, because
+  the 36 ns parse moves to emit and the consumers that never ask for a double (`decimal`, `long`,
+  text) now pay it for nothing. Not worth a flag threaded through three structs and a `Cell`
+  semantics rule. Reopen only if double columns dominate real workloads.
 - `PrefetchStream` handoff: ~2.7 ms on the i7, ≤2.1 ms on the Ryzen string-heavy sheet, of which
   the copy itself is ~0.3 ms. Removing it means replacing the `Stream` seam with a buffer-exchange
   protocol — and that seam is where the decompressed-byte limit counters sit, so it is a trust
   boundary, not just a copy.
-- **Needs re-measuring.** This reading predates `CsvStructuralScanner` (de49a45, 2026-09-22), which
-  moved the enumerator off `CsvControlScanner` and made `Reset` per buffer rather than per record,
-  so the write barrier named below is likely already gone. The 1BRC re-run above found 1.36x on
-  rows-only enumeration over the same period, so the gap quoted here is stale.
-  After `DrainFields`, rows-only enumeration of wide rows still runs ~1.75x the framing prototype.
-  What remains is per record rather than per field (the `MoveNext` → `TryParseRecordFromBuffer` →
-  `TryParseSimpleRecord` call chain, `BeginRecord`, the write barrier from `CsvControlScanner.Continue`
-  storing the buffer reference every record) plus the consumer side: `Row` indexer access costs
-  about as much again as enumeration on the wide shape.
+- **CSV enumerator overhead, re-measured 2026-10-09 (Ryzen 7 5700X).** The earlier reading is
+  superseded: it predates `CsvStructuralScanner` and its per-record diagnosis no longer holds.
+  Scratch harness, min of 50 interleaved rounds, 50,000 rows, the scanner driven directly for the
+  framing floor (drain the field-end bits, emit a descriptor per field):
+
+  | | wide, 32 fields (9.8 MB) | narrow, 4 fields (1.2 MB) |
+  |---|---|---|
+  | scanner only, popcount | 0.79 ms | 0.10 ms |
+  | scan + drain + emit a 32-byte descriptor | 2.93 ms | 0.38 ms |
+  | reader, rows only | 5.37 ms (1.83x) | 0.88 ms (2.3x) |
+  | reader + `row[i].Value.Length` on every cell | 7.72 ms | 1.10 ms |
+
+  The overhead above framing is **per field, not per record**: fitting the two shapes gives ~1.4 ns
+  per field and ~4 ns per row. Per field, `DrainFields` also loads `buf[stop]` to find the record end,
+  `buf[start]` to test for a quote, and builds a `CellDesc` with a branch on empty; the prototype does
+  none of that. The indexer adds ~1.4 ns per cell on top, about 45% of rows-only, not "as much again".
+  Hoisting `_delimiter` and `_quote` into locals made it **slower** (5.37 → 5.6–5.7 ms), the register
+  pressure result from the CSV enumerator section again. Telling quoted from unquoted fields from a
+  scanner quote-start mask instead of the `buf[start]` load is the one idea left; it is worth at most
+  ~0.5 ns of a ~3.3 ns field, which is a few percent of any read that converts values.
 - Reading a CSV from an already-resident buffer is slower than from a stream for spans only, and
   faster for full conversion. Reproduced in both directions across four runs, unexplained.
 

From f90a080a931a2682331d4954d6799a583b9347ec Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:08:36 -0300
Subject: [PATCH 040/115] feat(reader): add table part model with A1 range
 parsing

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
---
 .../Reader/Internal/TablePart.cs              | 123 ++++++++++++++++++
 .../Reader/Tables/TablePartTests.cs           |  74 +++++++++++
 2 files changed, 197 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/Internal/TablePart.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/TablePartTests.cs

diff --git a/src/ExcelReader.Core/Reader/Internal/TablePart.cs b/src/ExcelReader.Core/Reader/Internal/TablePart.cs
new file mode 100644
index 00000000..506e2925
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Internal/TablePart.cs
@@ -0,0 +1,123 @@
+using System.Buffers.Text;
+using System.Text;
+using ExcelReader.Core.Writer.Internal;
+
+namespace ExcelReader.Core.Reader.Internal
+{
+    internal sealed class TablePart
+    {
+        private TablePart(int sheetIndex, int id, string name, int firstRow, int firstColumn, int lastRow, int lastColumn,
+            int headerRowCount, int totalsRowCount, string[] columns, string? styleName)
+        {
+            SheetIndex = sheetIndex;
+            Id = id;
+            Name = name;
+            FirstRow = firstRow;
+            FirstColumn = firstColumn;
+            LastRow = lastRow;
+            LastColumn = lastColumn;
+            HeaderRowCount = headerRowCount;
+            TotalsRowCount = totalsRowCount;
+            Columns = columns;
+            StyleName = styleName;
+        }
+
+        internal int SheetIndex { get; }
+        internal int Id { get; }
+        internal string Name { get; }
+        internal int FirstRow { get; }
+        internal int FirstColumn { get; }
+        internal int LastRow { get; }
+        internal int LastColumn { get; }
+        internal int HeaderRowCount { get; }
+        internal int TotalsRowCount { get; }
+        internal string[] Columns { get; }
+        internal string? StyleName { get; }
+
+        internal static TablePart Create(int sheetIndex, int id, string name, int firstRow, int firstColumn, int lastRow, int lastColumn,
+            int headerRowCount, int totalsRowCount, string[] columns, string? styleName)
+        {
+            if (name.Length == 0)
+            {
+                throw new InvalidDataException("A table has no name.");
+            }
+            if (firstRow < 0 || firstRow > lastRow || lastRow >= ExcelLimits.MaxRows
+                || firstColumn < 0 || firstColumn > lastColumn || lastColumn >= ExcelLimits.MaxColumns)
+            {
+                throw Malformed(name, "its range lies outside the sheet");
+            }
+            if (headerRowCount is < 0 or > 1 || totalsRowCount is < 0 or > 1
+                || headerRowCount + totalsRowCount > lastRow - firstRow + 1)
+            {
+                throw Malformed(name, "its header and totals row counts do not fit its range");
+            }
+            if (columns.Length != lastColumn - firstColumn + 1)
+            {
+                throw Malformed(name, "its column count does not match its range");
+            }
+            return new TablePart(sheetIndex, id, name, firstRow, firstColumn, lastRow, lastColumn,
+                headerRowCount, totalsRowCount, columns, styleName);
+        }
+
+        internal static bool TryParseRange(ReadOnlySpan<byte> text, out int firstRow, out int firstColumn, out int lastRow, out int lastColumn)
+        {
+            int colon = text.IndexOf((byte)':');
+            if (colon < 0)
+            {
+                bool parsed = TryParseCell(text, out firstRow, out firstColumn);
+                lastRow = firstRow;
+                lastColumn = firstColumn;
+                return parsed;
+            }
+            lastRow = 0;
+            lastColumn = 0;
+            return TryParseCell(text[..colon], out firstRow, out firstColumn)
+                && TryParseCell(text[(colon + 1)..], out lastRow, out lastColumn);
+        }
+
+        internal static string FormatRange(int firstRow, int firstColumn, int lastRow, int lastColumn)
+        {
+            Span<byte> buffer = stackalloc byte[32];
+            int written = WriteCell(buffer, firstRow, firstColumn);
+            buffer[written++] = (byte)':';
+            written += WriteCell(buffer[written..], lastRow, lastColumn);
+            return Encoding.ASCII.GetString(buffer[..written]);
+        }
+
+        private static bool TryParseCell(ReadOnlySpan<byte> text, out int row, out int column)
+        {
+            row = 0;
+            column = 0;
+            int letters = 0;
+            while (letters < text.Length && (uint)(text[letters] - 'A') <= 25)
+            {
+                column = (column * 26) + (text[letters] - 'A' + 1);
+                letters++;
+                if (column > ExcelLimits.MaxColumns)
+                {
+                    return false;
+                }
+            }
+            if (letters == 0 || !Utf8Parser.TryParse(text[letters..], out int rowNumber, out int consumed)
+                || consumed != text.Length - letters || rowNumber < 1)
+            {
+                return false;
+            }
+            row = rowNumber - 1;
+            column--;
+            return true;
+        }
+
+        private static int WriteCell(Span<byte> destination, int row, int column)
+        {
+            int written = ColumnName.Write(destination, column);
+            Utf8Formatter.TryFormat(row + 1, destination[written..], out int digits);
+            return written + digits;
+        }
+
+        private static InvalidDataException Malformed(string name, string reason)
+        {
+            return new InvalidDataException($"Table '{name}' is malformed: {reason}.");
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TablePartTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TablePartTests.cs
new file mode 100644
index 00000000..19d06c16
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/TablePartTests.cs
@@ -0,0 +1,74 @@
+using System.Text;
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class TablePartTests
+    {
+        [Theory]
+        [InlineData("C4:E8", 3, 2, 7, 4)]
+        [InlineData("A1", 0, 0, 0, 0)]
+        [InlineData("AA10:AB12", 9, 26, 11, 27)]
+        [InlineData("XFD1048576:XFD1048576", 1048575, 16383, 1048575, 16383)]
+        public void TryParseRangeReadsA1Ranges(string text, int firstRow, int firstColumn, int lastRow, int lastColumn)
+        {
+            Assert.True(TablePart.TryParseRange(Encoding.ASCII.GetBytes(text), out int r1, out int c1, out int r2, out int c2));
+            Assert.Equal((firstRow, firstColumn, lastRow, lastColumn), (r1, c1, r2, c2));
+        }
+
+        [Theory]
+        [InlineData("")]
+        [InlineData("C")]
+        [InlineData("4")]
+        [InlineData("C0")]
+        [InlineData("c4")]
+        [InlineData("C4:")]
+        [InlineData("C4:E")]
+        [InlineData("$C$4:$E$8")]
+        [InlineData("XFE1")]
+        [InlineData("AAAA1")]
+        [InlineData("C4x")]
+        [InlineData("C99999999999")]
+        public void TryParseRangeRejectsMalformedText(string text)
+        {
+            Assert.False(TablePart.TryParseRange(Encoding.ASCII.GetBytes(text), out _, out _, out _, out _));
+        }
+
+        [Fact]
+        public void FormatRangeWritesA1Notation()
+        {
+            Assert.Equal("C4:E8", TablePart.FormatRange(3, 2, 7, 4));
+            Assert.Equal("XFD1048576:XFD1048576", TablePart.FormatRange(1048575, 16383, 1048575, 16383));
+        }
+
+        [Fact]
+        public void CreateKeepsAWellFormedTable()
+        {
+            TablePart part = TablePart.Create(1, 7, "Sales", 3, 2, 7, 4, 1, 1, ["Product", "Qty", "Price"], "TableStyleMedium2");
+
+            Assert.Equal(("Sales", 1, 7, "TableStyleMedium2"), (part.Name, part.SheetIndex, part.Id, part.StyleName));
+            Assert.Equal((3, 2, 7, 4, 1, 1), (part.FirstRow, part.FirstColumn, part.LastRow, part.LastColumn, part.HeaderRowCount, part.TotalsRowCount));
+            Assert.Equal(["Product", "Qty", "Price"], part.Columns);
+        }
+
+        [Theory]
+        [InlineData("", 0, 0, 1, 0, 1, 0, 1)]
+        [InlineData("T", -1, 0, 1, 0, 1, 0, 1)]
+        [InlineData("T", 2, 0, 1, 0, 1, 0, 1)]
+        [InlineData("T", 0, 0, 1048576, 0, 1, 0, 1)]
+        [InlineData("T", 0, 1, 1, 0, 1, 0, 1)]
+        [InlineData("T", 0, 0, 1, 16384, 1, 0, 16385)]
+        [InlineData("T", 0, 0, 1, 0, 2, 0, 1)]
+        [InlineData("T", 0, 0, 1, 0, 1, -1, 1)]
+        [InlineData("T", 0, 0, 0, 0, 1, 1, 1)]
+        [InlineData("T", 0, 0, 1, 1, 1, 0, 1)]
+        public void CreateRejectsInconsistentTables(string name, int firstRow, int firstColumn, int lastRow, int lastColumn,
+            int headerRowCount, int totalsRowCount, int columnCount)
+        {
+            string[] columns = [.. Enumerable.Range(0, columnCount).Select(static i => $"C{i}")];
+
+            Assert.Throws<InvalidDataException>(() => TablePart.Create(
+                0, 1, name, firstRow, firstColumn, lastRow, lastColumn, headerRowCount, totalsRowCount, columns, null));
+        }
+    }
+}

From c402ebc5f456f2a8ef3f71113ece026b2d409038 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:16:59 -0300
Subject: [PATCH 041/115] feat(reader): expose workbook tables on every format

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../PublicAPI/PublicAPI.Unshipped.txt         | 22 +++++++
 src/ExcelReader.Core/Reader/Csv/CsvReader.cs  | 23 +++++++
 src/ExcelReader.Core/Reader/ExcelTable.cs     | 60 +++++++++++++++++++
 src/ExcelReader.Core/Reader/IExcelWorkbook.cs | 14 +++++
 .../Reader/Internal/WorkbookTables.cs         | 56 +++++++++++++++++
 .../Reader/Xls/XlsWorkbook.cs                 | 23 +++++++
 .../Reader/Xlsb/XlsbWorkbook.cs               | 24 ++++++++
 .../Reader/Xlsx/XlsxWorkbook.cs               | 24 ++++++++
 .../Native/NativeApiTests.Reading.cs          |  5 ++
 .../Reader/Tables/WorkbookTablesTests.cs      | 51 ++++++++++++++++
 10 files changed, 302 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/ExcelTable.cs
 create mode 100644 src/ExcelReader.Core/Reader/Internal/WorkbookTables.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/WorkbookTablesTests.cs

diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 7dc5c581..8fd47b58 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -1 +1,23 @@
 #nullable enable
+ExcelReader.Core.Reader.Csv.CsvReader.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
+ExcelReader.Core.Reader.Csv.CsvReader.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
+ExcelReader.Core.Reader.ExcelTable
+ExcelReader.Core.Reader.ExcelTable.ColumnNames.get -> System.Collections.Generic.IReadOnlyList<string!>!
+ExcelReader.Core.Reader.ExcelTable.FirstColumn.get -> int
+ExcelReader.Core.Reader.ExcelTable.FirstRow.get -> int
+ExcelReader.Core.Reader.ExcelTable.HeaderRowCount.get -> int
+ExcelReader.Core.Reader.ExcelTable.LastColumn.get -> int
+ExcelReader.Core.Reader.ExcelTable.LastRow.get -> int
+ExcelReader.Core.Reader.ExcelTable.Name.get -> string!
+ExcelReader.Core.Reader.ExcelTable.Ref.get -> string!
+ExcelReader.Core.Reader.ExcelTable.Sheet.get -> ExcelReader.Core.Reader.IExcelSheet!
+ExcelReader.Core.Reader.ExcelTable.StyleName.get -> string?
+ExcelReader.Core.Reader.ExcelTable.TotalsRowCount.get -> int
+ExcelReader.Core.Reader.IExcelWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
+ExcelReader.Core.Reader.IExcelWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
+ExcelReader.Core.Reader.Xls.XlsWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
+ExcelReader.Core.Reader.Xls.XlsWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
+ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
+ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
index 59899d3a..c4e9f72d 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvReader.cs
@@ -187,6 +187,29 @@ bool IExcelWorkbook.TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)]
             return found;
         }
 
+        /// <summary>Gets the workbook's tables: always empty, since CSV workbooks report no tables.</summary>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public IReadOnlyList<ExcelTable> Tables
+        {
+            get
+            {
+                Lifetime.ThrowIfClosed(this);
+                return WorkbookTables.Empty;
+            }
+        }
+
+        /// <summary>Finds a table by name: always fails, since CSV workbooks report no tables.</summary>
+        /// <param name="name">The table name to look for.</param>
+        /// <param name="table">Always <see langword="null"/>.</param>
+        /// <returns>Always <see langword="false"/>.</returns>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+        {
+            Lifetime.ThrowIfClosed(this);
+            table = null;
+            return false;
+        }
+
         /// <summary>Gets the source's only sheet.</summary>
         /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
         public CsvSheet FirstSheet
diff --git a/src/ExcelReader.Core/Reader/ExcelTable.cs b/src/ExcelReader.Core/Reader/ExcelTable.cs
new file mode 100644
index 00000000..2c574b46
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/ExcelTable.cs
@@ -0,0 +1,60 @@
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Reader
+{
+    /// <summary>
+    /// An Excel table (a range formatted with "Format as Table", stored as a ListObject): its name, its
+    /// position on its sheet and its columns.
+    /// </summary>
+    /// <remarks>Row and column positions are zero-based and include the header and totals rows.</remarks>
+    public sealed class ExcelTable
+    {
+        internal ExcelTable(TablePart part, IExcelSheet sheet)
+        {
+            Name = part.Name;
+            Sheet = sheet;
+            Ref = TablePart.FormatRange(part.FirstRow, part.FirstColumn, part.LastRow, part.LastColumn);
+            FirstRow = part.FirstRow;
+            FirstColumn = part.FirstColumn;
+            LastRow = part.LastRow;
+            LastColumn = part.LastColumn;
+            HeaderRowCount = part.HeaderRowCount;
+            TotalsRowCount = part.TotalsRowCount;
+            ColumnNames = Array.AsReadOnly(part.Columns);
+            StyleName = part.StyleName;
+        }
+
+        /// <summary>Gets the table's name, as formulas refer to it (its display name).</summary>
+        public string Name { get; }
+
+        /// <summary>Gets the sheet that holds the table.</summary>
+        public IExcelSheet Sheet { get; }
+
+        /// <summary>Gets the table's range in A1 notation, header and totals rows included, such as <c>C4:E8</c>.</summary>
+        public string Ref { get; }
+
+        /// <summary>Gets the zero-based row of the table's first row: its header row, when it has one.</summary>
+        public int FirstRow { get; }
+
+        /// <summary>Gets the zero-based index of the table's first column.</summary>
+        public int FirstColumn { get; }
+
+        /// <summary>Gets the zero-based row of the table's last row: its totals row, when it has one.</summary>
+        public int LastRow { get; }
+
+        /// <summary>Gets the zero-based index of the table's last column.</summary>
+        public int LastColumn { get; }
+
+        /// <summary>Gets the number of header rows: 1, or 0 when the table's header row is turned off.</summary>
+        public int HeaderRowCount { get; }
+
+        /// <summary>Gets the number of totals rows: 1 when the table shows a totals row, otherwise 0.</summary>
+        public int TotalsRowCount { get; }
+
+        /// <summary>Gets the table's column names, in column order.</summary>
+        public IReadOnlyList<string> ColumnNames { get; }
+
+        /// <summary>Gets the name of the table's style, such as <c>TableStyleMedium2</c>, or <see langword="null"/> when the table has none.</summary>
+        public string? StyleName { get; }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/IExcelWorkbook.cs b/src/ExcelReader.Core/Reader/IExcelWorkbook.cs
index 4a01d69c..ce11d2be 100644
--- a/src/ExcelReader.Core/Reader/IExcelWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/IExcelWorkbook.cs
@@ -44,6 +44,20 @@ public interface IExcelWorkbook : IDisposable, IAsyncDisposable
         /// <returns><see langword="true"/> if a sheet with that name exists; otherwise <see langword="false"/>.</returns>
         /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
         bool TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out IExcelSheet sheet);
+
+        /// <summary>
+        /// Gets the workbook's tables (ranges formatted with "Format as Table"), ordered by sheet and then by
+        /// the order they were created in. Always empty for XLS and CSV. Opens nothing.
+        /// </summary>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        IReadOnlyList<ExcelTable> Tables { get; }
+
+        /// <summary>Finds a table by name, ignoring case. Opens nothing.</summary>
+        /// <param name="name">The table name to look for.</param>
+        /// <param name="table">The matching table, when one is found.</param>
+        /// <returns><see langword="true"/> if a table with that name exists; otherwise <see langword="false"/>.</returns>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table);
     }
 
     /// <summary>
diff --git a/src/ExcelReader.Core/Reader/Internal/WorkbookTables.cs b/src/ExcelReader.Core/Reader/Internal/WorkbookTables.cs
new file mode 100644
index 00000000..5f51bc1e
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Internal/WorkbookTables.cs
@@ -0,0 +1,56 @@
+using System.Collections.ObjectModel;
+using System.Diagnostics.CodeAnalysis;
+
+namespace ExcelReader.Core.Reader.Internal
+{
+    internal static class WorkbookTables
+    {
+        internal static ReadOnlyCollection<ExcelTable> Empty
+        {
+            get
+            {
+                return ReadOnlyCollection<ExcelTable>.Empty;
+            }
+        }
+
+        internal static ReadOnlyCollection<ExcelTable> Build<TSheet>(List<TablePart> parts, ExcelSheetList<TSheet> sheets)
+            where TSheet : IExcelSheet
+        {
+            if (parts.Count == 0)
+            {
+                return Empty;
+            }
+            parts.Sort(CompareBySheetThenId);
+            ExcelTable[] tables = new ExcelTable[parts.Count];
+            for (int i = 0; i < tables.Length; i++)
+            {
+                tables[i] = new ExcelTable(parts[i], sheets[parts[i].SheetIndex]);
+            }
+            return Array.AsReadOnly(tables);
+        }
+
+        internal static bool TryFind(ReadOnlyCollection<ExcelTable> tables, ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+        {
+            foreach (ExcelTable candidate in tables)
+            {
+                if (name.Equals(candidate.Name, StringComparison.OrdinalIgnoreCase))
+                {
+                    table = candidate;
+                    return true;
+                }
+            }
+            table = null;
+            return false;
+        }
+
+        private static int CompareBySheetThenId(TablePart left, TablePart right)
+        {
+            int bySheet = left.SheetIndex.CompareTo(right.SheetIndex);
+            if (bySheet != 0)
+            {
+                return bySheet;
+            }
+            return left.Id.CompareTo(right.Id);
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.cs b/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.cs
index bd0cca33..0953fcc8 100644
--- a/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.cs
@@ -138,6 +138,29 @@ bool IExcelWorkbook.TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)]
             return found;
         }
 
+        /// <summary>Gets the workbook's tables: always empty, since XLS workbooks report no tables.</summary>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public IReadOnlyList<ExcelTable> Tables
+        {
+            get
+            {
+                Lifetime.ThrowIfClosed(this);
+                return WorkbookTables.Empty;
+            }
+        }
+
+        /// <summary>Finds a table by name: always fails, since XLS workbooks report no tables.</summary>
+        /// <param name="name">The table name to look for.</param>
+        /// <param name="table">Always <see langword="null"/>.</param>
+        /// <returns>Always <see langword="false"/>.</returns>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+        {
+            Lifetime.ThrowIfClosed(this);
+            table = null;
+            return false;
+        }
+
         internal Enumerator OpenSheet(int index)
         {
             Lifetime.Acquire(this);
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
index 57de30fe..f646dd19 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
@@ -1,4 +1,5 @@
 using System.Buffers;
+using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
 using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Sources;
@@ -25,6 +26,7 @@ public sealed partial class XlsbWorkbook : IExcelWorkbook
         private readonly ZipIndex? _zip;
         private readonly (string Name, string Path, ExcelSheetVisibility Visibility)[]? _sheets;
         private readonly ExcelSheetList<XlsbSheet> _sheetList;
+        private readonly ReadOnlyCollection<ExcelTable> _tables = WorkbookTables.Empty;
         internal ReaderLifetime Lifetime { get; }
 
         internal XlsbWorkbook(byte[] sharedFlat, int[] sharedOffsets, bool[] styleIsDate, bool date1904)
@@ -243,6 +245,28 @@ bool IExcelWorkbook.TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)]
             return found;
         }
 
+        /// <summary>Gets the workbook's tables, ordered by sheet and then by the order they were created in. Opens nothing.</summary>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public IReadOnlyList<ExcelTable> Tables
+        {
+            get
+            {
+                Lifetime.ThrowIfClosed(this);
+                return _tables;
+            }
+        }
+
+        /// <summary>Finds a table by name, ignoring case. Opens nothing.</summary>
+        /// <param name="name">The table name to look for.</param>
+        /// <param name="table">The matching table, when one is found.</param>
+        /// <returns><see langword="true"/> if a table with that name exists; otherwise <see langword="false"/>.</returns>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+        {
+            Lifetime.ThrowIfClosed(this);
+            return WorkbookTables.TryFind(_tables, name, out table);
+        }
+
         internal Enumerator OpenSheet(int index)
         {
             Lifetime.Acquire(this);
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
index 912d0af6..ae106836 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
@@ -1,4 +1,5 @@
 using System.Buffers;
+using System.Collections.ObjectModel;
 using System.Diagnostics.CodeAnalysis;
 using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Sources;
@@ -16,6 +17,7 @@ public sealed partial class XlsxWorkbook : IExcelWorkbook
         private readonly (string Name, string Path, ExcelSheetVisibility Visibility)[] _sheets;
         private readonly bool[] _styleIsDate;
         private readonly ExcelSheetList<XlsxSheet> _sheetList;
+        private readonly ReadOnlyCollection<ExcelTable> _tables = WorkbookTables.Empty;
 
         [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed", Justification = "Disposed by ReleaseResources, which the lifetime runs after the last enumerator.")]
         private readonly OnceGate _sharedGate = new();
@@ -174,6 +176,28 @@ bool IExcelWorkbook.TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)]
             return found;
         }
 
+        /// <summary>Gets the workbook's tables, ordered by sheet and then by the order they were created in. Opens nothing.</summary>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public IReadOnlyList<ExcelTable> Tables
+        {
+            get
+            {
+                Lifetime.ThrowIfClosed(this);
+                return _tables;
+            }
+        }
+
+        /// <summary>Finds a table by name, ignoring case. Opens nothing.</summary>
+        /// <param name="name">The table name to look for.</param>
+        /// <param name="table">The matching table, when one is found.</param>
+        /// <returns><see langword="true"/> if a table with that name exists; otherwise <see langword="false"/>.</returns>
+        /// <exception cref="ObjectDisposedException">The workbook was disposed.</exception>
+        public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+        {
+            Lifetime.ThrowIfClosed(this);
+            return WorkbookTables.TryFind(_tables, name, out table);
+        }
+
         internal Enumerator OpenSheet(int index)
         {
             Lifetime.Acquire(this);
diff --git a/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs b/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
index c3f8734d..c329bd7d 100644
--- a/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
+++ b/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
@@ -136,6 +136,11 @@ public bool TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out IExc
                 sheet = null;
                 return false;
             }
+            public IReadOnlyList<ExcelTable> Tables => inner.Tables;
+            public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
+            {
+                return inner.TryGetTable(name, out table);
+            }
 
             public void Dispose()
             {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/WorkbookTablesTests.cs b/tests/ExcelReader.Tests/Reader/Tables/WorkbookTablesTests.cs
new file mode 100644
index 00000000..572a5106
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/WorkbookTablesTests.cs
@@ -0,0 +1,51 @@
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Xls;
+using ExcelReader.Core.Reader.Xlsx;
+using ExcelReader.Tests.Reader.Xls;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class WorkbookTablesTests
+    {
+        [Fact]
+        public void XlsxWithoutTablesReportsNone()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build("""<row r="1"><c r="A1"><v>1</v></c></row>""");
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Empty(workbook.Tables);
+            Assert.False(workbook.TryGetTable("Sales", out _));
+        }
+
+        [Fact]
+        public void XlsReportsNoTables()
+        {
+            using MemoryStream ms = XlsWorkbookBuilder.Build(false, null, null, ("S1", [["a"]]));
+            using XlsWorkbook workbook = Excel.FromXls(ms);
+
+            Assert.Empty(workbook.Tables);
+            Assert.False(workbook.TryGetTable("Sales", out _));
+        }
+
+        [Fact]
+        public void CsvReportsNoTables()
+        {
+            using CsvReader workbook = Excel.FromCsv("a,b\n1,2\n"u8.ToArray());
+
+            Assert.Empty(workbook.Tables);
+            Assert.False(workbook.TryGetTable("Sales", out _));
+        }
+
+        [Fact]
+        public void TablesThrowOnceTheWorkbookIsDisposed()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build("""<row r="1"><c r="A1"><v>1</v></c></row>""");
+            XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            workbook.Dispose();
+
+            Assert.Throws<ObjectDisposedException>(() => workbook.Tables);
+            Assert.Throws<ObjectDisposedException>(() => workbook.TryGetTable("Sales", out _));
+        }
+    }
+}

From d60068bfb71957c599d61417a678635be89492f1 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:22:04 -0300
Subject: [PATCH 042/115] feat(reader): discover XLSX tables at open

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Xlsx/TableDiscovery.cs             | 125 ++++++++++++++++++
 .../Reader/Xlsx/XlsxTables.cs                 |  71 ++++++++++
 .../Reader/Xlsx/XlsxWorkbook.cs               |  10 +-
 src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs   |  13 ++
 src/ExcelReader.Core/Reader/Zip/ZipIndex.cs   |  14 ++
 .../Reader/ReaderLimitTests.cs                |  37 ++++++
 .../Reader/Tables/TableMetadataTests.cs       | 121 +++++++++++++++++
 .../Reader/Tables/TableWorkbooks.cs           |  22 +++
 tests/ExcelReader.Tests/TestUtils.cs          |   7 +-
 .../ExcelReader.Tests/data/tables/tables.xlsb | Bin 0 -> 11349 bytes
 .../ExcelReader.Tests/data/tables/tables.xlsx | Bin 0 -> 13489 bytes
 11 files changed, 416 insertions(+), 4 deletions(-)
 create mode 100644 src/ExcelReader.Core/Reader/Xlsx/TableDiscovery.cs
 create mode 100644 src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
 create mode 100644 tests/ExcelReader.Tests/data/tables/tables.xlsb
 create mode 100644 tests/ExcelReader.Tests/data/tables/tables.xlsx

diff --git a/src/ExcelReader.Core/Reader/Xlsx/TableDiscovery.cs b/src/ExcelReader.Core/Reader/Xlsx/TableDiscovery.cs
new file mode 100644
index 00000000..b6ae41e7
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Xlsx/TableDiscovery.cs
@@ -0,0 +1,125 @@
+using System.Text;
+using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Zip;
+
+namespace ExcelReader.Core.Reader.Xlsx
+{
+    internal delegate TablePart TablePartParser(int sheetIndex, ReadOnlySpan<byte> part);
+
+    internal static class TableDiscovery
+    {
+        private static ReadOnlySpan<byte> TablesFolder => "xl/tables/"u8;
+
+        private static ReadOnlySpan<byte> TableRelationshipType => "/table"u8;
+
+        internal static List<TablePart> Load(ZipIndex zip, (string Name, string Path, ExcelSheetVisibility Visibility)[] sheets,
+            DecompressedByteCounter counter, TablePartParser parse)
+        {
+            List<TablePart> parts = [];
+            if (!zip.HasEntryWithPrefix(TablesFolder))
+            {
+                return parts;
+            }
+            for (int i = 0; i < sheets.Length; i++)
+            {
+                foreach (string partPath in TablePartPaths(zip, sheets[i].Path, counter))
+                {
+                    using ZipPart part = zip.OpenPart(RequireEntry(zip, partPath), counter);
+                    parts.Add(parse(i, part.Memory.Span));
+                }
+            }
+            return parts;
+        }
+
+        internal static async ValueTask<List<TablePart>> LoadAsync(ZipIndex zip, (string Name, string Path, ExcelSheetVisibility Visibility)[] sheets,
+            DecompressedByteCounter counter, TablePartParser parse, CancellationToken ct)
+        {
+            List<TablePart> parts = [];
+            if (!zip.HasEntryWithPrefix(TablesFolder))
+            {
+                return parts;
+            }
+            for (int i = 0; i < sheets.Length; i++)
+            {
+                List<string> partPaths;
+                using (ZipPart rels = await zip.OpenPartOrDefaultAsync(Utf8(RelsPath(sheets[i].Path)), counter, ct).ConfigureAwait(false))
+                {
+                    partPaths = ResolveTargets(sheets[i].Path, rels.Memory.Span);
+                }
+                foreach (string partPath in partPaths)
+                {
+                    using ZipPart part = await zip.OpenPartAsync(RequireEntry(zip, partPath), counter, ct).ConfigureAwait(false);
+                    parts.Add(parse(i, part.Memory.Span));
+                }
+            }
+            return parts;
+        }
+
+        internal static string RelsPath(string partPath)
+        {
+            int slash = partPath.LastIndexOf('/');
+            return string.Concat(partPath.AsSpan(0, slash + 1), "_rels/", partPath.AsSpan(slash + 1), ".rels");
+        }
+
+        internal static string ResolvePartPath(string sourcePart, string target)
+        {
+            if (target.StartsWith('/'))
+            {
+                return target[1..];
+            }
+            List<string> segments = [.. sourcePart.Split('/')];
+            segments.RemoveAt(segments.Count - 1);
+            foreach (string segment in target.Split('/'))
+            {
+                ApplySegment(segments, segment);
+            }
+            return string.Join('/', segments);
+        }
+
+        private static void ApplySegment(List<string> segments, string segment)
+        {
+            if (string.Equals(segment, "..", StringComparison.Ordinal))
+            {
+                if (segments.Count > 0)
+                {
+                    segments.RemoveAt(segments.Count - 1);
+                }
+                return;
+            }
+            if (segment.Length > 0 && !string.Equals(segment, ".", StringComparison.Ordinal))
+            {
+                segments.Add(segment);
+            }
+        }
+
+        private static List<string> TablePartPaths(ZipIndex zip, string sheetPath, DecompressedByteCounter counter)
+        {
+            using ZipPart rels = zip.OpenPartOrDefault(Utf8(RelsPath(sheetPath)), counter);
+            return ResolveTargets(sheetPath, rels.Memory.Span);
+        }
+
+        private static List<string> ResolveTargets(string sheetPath, ReadOnlySpan<byte> rels)
+        {
+            List<string> targets = XlsxXml.RelationshipTargets(rels, TableRelationshipType);
+            for (int i = 0; i < targets.Count; i++)
+            {
+                targets[i] = ResolvePartPath(sheetPath, targets[i]);
+            }
+            return targets;
+        }
+
+        private static ZipEntryRef RequireEntry(ZipIndex zip, string partPath)
+        {
+            if (!zip.TryGetEntry(Utf8(partPath), out ZipEntryRef entry))
+            {
+                throw new InvalidDataException($"The table part '{partPath}' is missing from the package.");
+            }
+            return entry;
+        }
+
+        private static byte[] Utf8(string text)
+        {
+            return Encoding.UTF8.GetBytes(text);
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
new file mode 100644
index 00000000..2899e7b6
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
@@ -0,0 +1,71 @@
+using System.Buffers.Text;
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Reader.Xlsx
+{
+    internal static class XlsxTables
+    {
+        internal static TablePart ParseTable(int sheetIndex, ReadOnlySpan<byte> xml)
+        {
+            ReadOnlySpan<byte> prefix = XlsxXml.DetectElementPrefix(xml);
+            ReadOnlySpan<byte> table = FirstTag(xml, XlsxXml.Token("<"u8, prefix, "table"u8));
+            if (table.IsEmpty)
+            {
+                throw new InvalidDataException("A table part has no <table> element.");
+            }
+            string name = XlsxXml.DecodeToString(XlsxXml.Attr(table, " displayName="u8));
+            if (!TablePart.TryParseRange(XlsxXml.Attr(table, " ref="u8), out int firstRow, out int firstColumn, out int lastRow, out int lastColumn))
+            {
+                throw new InvalidDataException($"Table '{name}' has an unreadable ref.");
+            }
+            int id = XlsxXml.ParseIntOr(XlsxXml.Attr(table, " id="u8), 0);
+            int headerRowCount = ParseRowCount(table, " headerRowCount="u8, 1, name);
+            int totalsRowCount = ParseRowCount(table, " totalsRowCount="u8, 0, name);
+            return TablePart.Create(sheetIndex, id, name, firstRow, firstColumn, lastRow, lastColumn,
+                headerRowCount, totalsRowCount, ColumnNames(xml, prefix), StyleName(xml, prefix));
+        }
+
+        private static int ParseRowCount(ReadOnlySpan<byte> table, ReadOnlySpan<byte> attribute, int fallback, string name)
+        {
+            ReadOnlySpan<byte> value = XlsxXml.Attr(table, attribute);
+            if (value.IsEmpty)
+            {
+                return fallback;
+            }
+            if (!Utf8Parser.TryParse(value, out int count, out int consumed) || consumed != value.Length)
+            {
+                throw new InvalidDataException($"Table '{name}' has an unreadable row count.");
+            }
+            return count;
+        }
+
+        private static string[] ColumnNames(ReadOnlySpan<byte> xml, ReadOnlySpan<byte> prefix)
+        {
+            List<string> names = [];
+            foreach (ReadOnlySpan<byte> column in new TagSpanEnumerable(xml, XlsxXml.Token("<"u8, prefix, "tableColumn"u8)))
+            {
+                names.Add(XlsxXml.DecodeToString(XlsxXml.Attr(column, " name="u8)));
+            }
+            return [.. names];
+        }
+
+        private static string? StyleName(ReadOnlySpan<byte> xml, ReadOnlySpan<byte> prefix)
+        {
+            ReadOnlySpan<byte> style = XlsxXml.Attr(FirstTag(xml, XlsxXml.Token("<"u8, prefix, "tableStyleInfo"u8)), " name="u8);
+            if (style.IsEmpty)
+            {
+                return null;
+            }
+            return XlsxXml.DecodeToString(style);
+        }
+
+        private static ReadOnlySpan<byte> FirstTag(ReadOnlySpan<byte> xml, ReadOnlySpan<byte> token)
+        {
+            foreach (ReadOnlySpan<byte> tag in new TagSpanEnumerable(xml, token))
+            {
+                return tag;
+            }
+            return default;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
index ae106836..89ff1512 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
@@ -17,7 +17,7 @@ public sealed partial class XlsxWorkbook : IExcelWorkbook
         private readonly (string Name, string Path, ExcelSheetVisibility Visibility)[] _sheets;
         private readonly bool[] _styleIsDate;
         private readonly ExcelSheetList<XlsxSheet> _sheetList;
-        private readonly ReadOnlyCollection<ExcelTable> _tables = WorkbookTables.Empty;
+        private readonly ReadOnlyCollection<ExcelTable> _tables;
 
         [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed", Justification = "Disposed by ReleaseResources, which the lifetime runs after the last enumerator.")]
         private readonly OnceGate _sharedGate = new();
@@ -51,6 +51,8 @@ private XlsxWorkbook(ZipIndex zip, ExcelReaderOptions options)
                 _styleIsDate = ParseStyleDateFlags(stylesPart.Memory.Span);
                 IsDate1904 = ParseDate1904(wbPart.Memory.Span);
                 _sheetList = CreateSheetList();
+                _tables = WorkbookTables.Build(
+                    TableDiscovery.Load(zip, _sheets, _decompressedBytes, XlsxTables.ParseTable), _sheetList);
             }
             catch
             {
@@ -61,7 +63,7 @@ private XlsxWorkbook(ZipIndex zip, ExcelReaderOptions options)
 
         private XlsxWorkbook(ZipIndex zip,
             (string Name, string Path, ExcelSheetVisibility Visibility)[] sheets, bool[] styleIsDate, bool date1904,
-            ExcelReaderOptions options, DecompressedByteCounter decompressedBytes)
+            List<TablePart> tables, ExcelReaderOptions options, DecompressedByteCounter decompressedBytes)
         {
             Lifetime = new ReaderLifetime(ReleaseResources);
             _zip = zip;
@@ -71,6 +73,7 @@ private XlsxWorkbook(ZipIndex zip,
             _styleIsDate = styleIsDate;
             IsDate1904 = date1904;
             _sheetList = CreateSheetList();
+            _tables = WorkbookTables.Build(tables, _sheetList);
         }
 
         internal static XlsxWorkbook CreateFromMemory(ReadOnlyMemory<byte> data, ExcelReaderOptions? options = null)
@@ -107,7 +110,8 @@ internal static async ValueTask<XlsxWorkbook> CreateFromIndexAsync(ZipIndex zip,
                 using ZipPart stylesPart = await zip.OpenPartOrDefaultAsync("xl/styles.xml"u8, decompressedBytes, ct).ConfigureAwait(false);
                 bool[] styleIsDate = ParseStyleDateFlags(stylesPart.Memory.Span);
                 bool date1904 = ParseDate1904(wbPart.Memory.Span);
-                return new XlsxWorkbook(zip, sheets, styleIsDate, date1904, options, decompressedBytes);
+                List<TablePart> tables = await TableDiscovery.LoadAsync(zip, sheets, decompressedBytes, XlsxTables.ParseTable, ct).ConfigureAwait(false);
+                return new XlsxWorkbook(zip, sheets, styleIsDate, date1904, tables, options, decompressedBytes);
             }
             catch
             {
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs
index be9ae7be..8cc6c831 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs
@@ -331,5 +331,18 @@ internal static Dictionary<string, string> ParseRelationships(ReadOnlySpan<byte>
             }
             return rels;
         }
+
+        internal static List<string> RelationshipTargets(ReadOnlySpan<byte> relsBytes, ReadOnlySpan<byte> typeSuffix)
+        {
+            List<string> targets = [];
+            foreach (ReadOnlySpan<byte> tag in new TagSpanEnumerable(relsBytes, "<Relationship"u8))
+            {
+                if (Attr(tag, " Type="u8).EndsWith(typeSuffix))
+                {
+                    targets.Add(DecodeToString(Attr(tag, " Target="u8)));
+                }
+            }
+            return targets;
+        }
     }
 }
diff --git a/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs b/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
index 86332b39..a796ef9d 100644
--- a/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
+++ b/src/ExcelReader.Core/Reader/Zip/ZipIndex.cs
@@ -305,6 +305,20 @@ internal bool TryGetEntry(ReadOnlySpan<byte> utf8Name, out ZipEntryRef entry)
             return false;
         }
 
+        internal bool HasEntryWithPrefix(ReadOnlySpan<byte> utf8Prefix)
+        {
+            ThrowIfDisposed();
+            ReadOnlySpan<byte> directory = _directory.Span;
+            foreach (ref readonly ZipEntryRef candidate in _entries.AsSpan(0, Count))
+            {
+                if (directory.Slice(candidate.NameStart, candidate.NameLength).StartsWith(utf8Prefix))
+                {
+                    return true;
+                }
+            }
+            return false;
+        }
+
         internal ZipPart OpenPart(in ZipEntryRef entry, DecompressedByteCounter counter, string entryLimitName = "", long entryLimit = 0)
         {
             ThrowIfDisposed();
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index 459e19eb..535df782 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -9,12 +9,49 @@
 using ExcelReader.Core.Reader.Xlsx;
 using ExcelReader.Core.Reader.Zip;
 using ExcelReader.Tests.Crypto;
+using ExcelReader.Tests.Reader.Tables;
 using ExcelReader.Tests.Reader.Xls;
 
 namespace ExcelReader.Tests.Reader
 {
     public class ReaderLimitTests
     {
+        [Theory]
+        [InlineData("A1:B2", "")]
+        [InlineData("nonsense", "")]
+        [InlineData("A0:A2", "")]
+        [InlineData("A1:A2", " headerRowCount=\"2\"")]
+        [InlineData("A1:A2", " totalsRowCount=\"x\"")]
+        [InlineData("A1:A1", " totalsRowCount=\"1\"")]
+        public void MalformedXlsxTablePartThrowsInvalidData(string reference, string attributes)
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsx(
+                """<row r="1"><c r="A1"><v>1</v></c></row>""",
+                TableWorkbooks.Table(reference, """<tableColumn id="1" name="A"/>""", attributes));
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsx(ms));
+        }
+
+        [Fact]
+        public void XlsxTablePartWithoutATableElementThrowsInvalidData()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsx("""<row r="1"><c r="A1"><v>1</v></c></row>""", "<nothing/>");
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsx(ms));
+        }
+
+        [Fact]
+        public void XlsxTableRelationshipToAMissingPartThrowsInvalidData()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsx(
+                """<row r="1"><c r="A1"><v>1</v></c></row>""",
+                TableWorkbooks.Table("A1:A1", """<tableColumn id="1" name="A"/>"""),
+                target: "../tables/table9.xml");
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => Excel.FromXlsx(ms));
+            Assert.Contains("xl/tables/table9.xml", ex.Message, StringComparison.Ordinal);
+        }
+
         [Fact]
         public void CellAccumulatorRejectsColumnIndexAtOrAboveExcelLimit()
         {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
new file mode 100644
index 00000000..b457be6f
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
@@ -0,0 +1,121 @@
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class TableMetadataTests
+    {
+        private const string Rows = """<row r="1"><c r="A1" t="inlineStr"><is><t>H</t></is></c></row><row r="2"><c r="A2"><v>1</v></c></row>""";
+
+        public static TheoryData<string> Fixtures { get; } = new() { "tables.xlsx" };
+
+        private static readonly (string Name, int Sheet, string Ref, int FirstRow, int FirstColumn, int LastRow, int LastColumn,
+            int HeaderRowCount, int TotalsRowCount, string[] Columns, string? Style)[] Expected =
+        [
+            ("Sales", 0, "C4:E8", 3, 2, 7, 4, 1, 1, ["Product", "Qty", "Price"], "TableStyleMedium2"),
+            ("Stock", 0, "G4:H7", 3, 6, 6, 7, 1, 0, ["Product", "Qty"], "TableStyleLight9"),
+            ("NoHeader", 1, "A2:B4", 1, 0, 3, 1, 0, 0, ["Letter", "Number"], "TableStyleMedium2"),
+            ("NoStyle", 1, "D1:E3", 0, 3, 2, 4, 1, 0, ["Name", "Value"], null),
+        ];
+
+        internal static string FixturePath(string file)
+        {
+            return Path.Combine(AppContext.BaseDirectory, "data", "tables", file);
+        }
+
+        [Theory]
+        [MemberData(nameof(Fixtures))]
+        public void FixtureTablesReportTheirMetadata(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(FixturePath(file));
+
+            AssertExpectedTables(workbook);
+        }
+
+        [Theory]
+        [MemberData(nameof(Fixtures))]
+        public async Task AsyncOpenReportsTheSameTables(string file)
+        {
+            await using IExcelWorkbook workbook = await Excel.OpenAsync(
+                File.OpenRead(FixturePath(file)), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+
+            AssertExpectedTables(workbook);
+        }
+
+        [Theory]
+        [MemberData(nameof(Fixtures))]
+        public void TryGetTableIgnoresCase(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(FixturePath(file));
+
+            Assert.True(workbook.TryGetTable("sales", out ExcelTable? sales));
+            Assert.Equal("Sales", sales.Name);
+            Assert.Equal("Data", sales.Sheet.Name);
+            Assert.False(workbook.TryGetTable("Missing", out _));
+        }
+
+        [Fact]
+        public void EncryptedWorkbookReportsItsTables()
+        {
+            using MemoryStream encrypted = new();
+            using (FileStream package = File.OpenRead(FixturePath("tables.xlsx")))
+            {
+                Excel.EncryptPackage(package, encrypted, "hunter2");
+            }
+            encrypted.Position = 0;
+
+            using IExcelWorkbook workbook = Excel.Open(encrypted, options: ExcelReaderOptions.Default with { Password = "hunter2" });
+
+            AssertExpectedTables(workbook);
+        }
+
+        [Fact]
+        public void PrefixedTablePartParses()
+        {
+            string table = """<x:table xmlns:x="http://schemas.openxmlformats.org/spreadsheetml/2006/main" id="1" name="T" displayName="T" ref="A1:A2"><x:tableColumns count="1"><x:tableColumn id="1" name="H"/></x:tableColumns><x:tableStyleInfo name="TableStyleLight1"/></x:table>""";
+            using MemoryStream ms = TableWorkbooks.Xlsx(Rows, table);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            ExcelTable parsed = Assert.Single(workbook.Tables);
+            Assert.Equal(("T", "A1:A2", "TableStyleLight1"), (parsed.Name, parsed.Ref, parsed.StyleName));
+            Assert.Equal(["H"], parsed.ColumnNames);
+        }
+
+        [Fact]
+        public void EscapedColumnNamesAreDecoded()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsx(Rows, TableWorkbooks.Table("A1:A2", """<tableColumn id="1" name="Qty &amp; Price"/>"""));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Equal(["Qty & Price"], Assert.Single(workbook.Tables).ColumnNames);
+        }
+
+        [Fact]
+        public void OnlyTableRelationshipsAreFollowed()
+        {
+            string others =
+                """<Relationship Id="rId7" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" Target="https://example.com" TargetMode="External"/>"""
+                + """<Relationship Id="rId8" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable" Target="../pivotTables/pivotTable1.xml"/>""";
+            using MemoryStream ms = TableWorkbooks.Xlsx(Rows, TableWorkbooks.Table("A1:A2", """<tableColumn id="1" name="H"/>"""), extraRelationships: others);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Equal("T", Assert.Single(workbook.Tables).Name);
+        }
+
+        private static void AssertExpectedTables(IExcelWorkbook workbook)
+        {
+            Assert.Equal(Expected.Length, workbook.Tables.Count);
+            for (int i = 0; i < Expected.Length; i++)
+            {
+                ExcelTable table = workbook.Tables[i];
+                var expected = Expected[i];
+                Assert.Equal((expected.Name, expected.Sheet, expected.Ref), (table.Name, table.Sheet.Index, table.Ref));
+                Assert.Equal((expected.FirstRow, expected.FirstColumn, expected.LastRow, expected.LastColumn),
+                    (table.FirstRow, table.FirstColumn, table.LastRow, table.LastColumn));
+                Assert.Equal((expected.HeaderRowCount, expected.TotalsRowCount), (table.HeaderRowCount, table.TotalsRowCount));
+                Assert.Equal(expected.Columns, table.ColumnNames);
+                Assert.Equal(expected.Style, table.StyleName);
+            }
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
new file mode 100644
index 00000000..9206c6ae
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
@@ -0,0 +1,22 @@
+namespace ExcelReader.Tests.Reader.Tables
+{
+    internal static class TableWorkbooks
+    {
+        internal const string TableRelationship = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table";
+        private const string PackageRelationships = "http://schemas.openxmlformats.org/package/2006/relationships";
+        private const string Main = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+
+        internal static MemoryStream Xlsx(string rows, string tableXml, string target = "../tables/table1.xml", string extraRelationships = "")
+        {
+            string rels = $"""<Relationships xmlns="{PackageRelationships}">{extraRelationships}<Relationship Id="rId1" Type="{TableRelationship}" Target="{target}"/></Relationships>""";
+            return WorkbookBuilder.BuildMultiSheet(
+                [("S1", rows)],
+                extraParts: [("xl/worksheets/_rels/sheet1.xml.rels", rels), ("xl/tables/table1.xml", tableXml)]);
+        }
+
+        internal static string Table(string reference, string columns, string attributes = "")
+        {
+            return $"""<table xmlns="{Main}" id="1" name="T" displayName="T" ref="{reference}"{attributes}><tableColumns>{columns}</tableColumns></table>""";
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/TestUtils.cs b/tests/ExcelReader.Tests/TestUtils.cs
index a930bef7..ec52bb1c 100644
--- a/tests/ExcelReader.Tests/TestUtils.cs
+++ b/tests/ExcelReader.Tests/TestUtils.cs
@@ -446,7 +446,8 @@ internal static MemoryStream BuildMultiSheet(
             (string Name, string Rows)[] sheets,
             string? sharedStrings = null,
             string? styles = null,
-            bool date1904 = false)
+            bool date1904 = false,
+            (string Path, string Content)[]? extraParts = null)
         {
             var sheetXml = new string[sheets.Length];
             var relXml = new string[sheets.Length];
@@ -477,6 +478,10 @@ internal static MemoryStream BuildMultiSheet(
                         $"""<styleSheet xmlns="{Main}">""", StringComparison.Ordinal);
                     Write(zip, "xl/styles.xml", $"""<?xml version="1.0"?>{withNs}""");
                 }
+                foreach ((string path, string content) in extraParts ?? [])
+                {
+                    Write(zip, path, content);
+                }
             }
             ms.Position = 0;
             return ms;
diff --git a/tests/ExcelReader.Tests/data/tables/tables.xlsb b/tests/ExcelReader.Tests/data/tables/tables.xlsb
new file mode 100644
index 0000000000000000000000000000000000000000..de4e2719f3c598e9ac8cd2f2a62182c6d0ecc988
GIT binary patch
literal 11349
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
HyT$(ir2S!^

literal 0
HcmV?d00001

diff --git a/tests/ExcelReader.Tests/data/tables/tables.xlsx b/tests/ExcelReader.Tests/data/tables/tables.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..a2452dbfbcececd1354154d9f02593d7a1b19d1a
GIT binary patch
literal 13489
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
YNfr{g7l44E0AJ-mN$lhgsRQKy0IpnRWB>pF

literal 0
HcmV?d00001


From 48e0aede9be0b743bb47a0cbfa8c16d78653bd5d Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:26:28 -0300
Subject: [PATCH 043/115] feat(reader): discover XLSB tables at open

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Xlsb/Brt.cs       |  3 +
 .../Reader/Xlsb/XlsbTables.cs                 | 95 +++++++++++++++++++
 .../Reader/Xlsb/XlsbWorkbook.cs               |  9 +-
 .../Reader/ReaderLimitTests.cs                | 46 +++++++++
 .../Reader/Tables/TableMetadataTests.cs       |  2 +-
 .../Reader/Tables/TableWorkbooks.cs           | 69 ++++++++++++++
 6 files changed, 221 insertions(+), 3 deletions(-)
 create mode 100644 src/ExcelReader.Core/Reader/Xlsb/XlsbTables.cs

diff --git a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
index 2130f7ec..f7fda569 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
@@ -18,6 +18,9 @@ internal static class Brt
         internal const int SSTItem = 19;
         internal const int ColInfo = 60;
         internal const int Font = 43;
+        internal const int BeginList = 343;
+        internal const int BeginListCol = 347;
+        internal const int ListTableStyleClient = 513;
         internal const int Fmt = 44;
         internal const int Fill = 45;
         internal const int Border = 46;
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbTables.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbTables.cs
new file mode 100644
index 00000000..21ee3d9e
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbTables.cs
@@ -0,0 +1,95 @@
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Reader.Xlsb
+{
+    internal static class XlsbTables
+    {
+        private const int BeginListFixedSize = 64;
+        private const int BeginListColFixedSize = 24;
+        private const int StyleClientFlagsSize = 2;
+
+        internal static TablePart ParseTable(int sheetIndex, ReadOnlySpan<byte> part)
+        {
+            ListHeader? header = null;
+            List<string> columns = [];
+            string? styleName = null;
+            var reader = new Biff12RecordReader(part);
+            while (reader.TryReadRecord(out int id, out ReadOnlySpan<byte> payload))
+            {
+                switch (id)
+                {
+                    case Brt.BeginList:
+                        header = ReadBeginList(payload);
+                        break;
+                    case Brt.BeginListCol:
+                        columns.Add(ReadColumnName(payload));
+                        break;
+                    case Brt.ListTableStyleClient:
+                        styleName = ReadStyleName(payload);
+                        break;
+                }
+            }
+            if (header is not { } list)
+            {
+                throw new InvalidDataException("A table part has no BrtBeginList record.");
+            }
+            return TablePart.Create(sheetIndex, list.Id, list.Name, list.FirstRow, list.FirstColumn, list.LastRow, list.LastColumn,
+                list.HeaderRowCount, list.TotalsRowCount, [.. columns], styleName);
+        }
+
+        private readonly record struct ListHeader(int Id, string Name, int FirstRow, int FirstColumn, int LastRow, int LastColumn,
+            int HeaderRowCount, int TotalsRowCount);
+
+        private static ListHeader ReadBeginList(ReadOnlySpan<byte> payload)
+        {
+            if (payload.Length < BeginListFixedSize
+                || !Biff12.TryReadWideString(payload, BeginListFixedSize, out _, out int nameBytes)
+                || !Biff12.TryReadWideString(payload, BeginListFixedSize + nameBytes, out ReadOnlySpan<char> displayName, out _))
+            {
+                throw Truncated("BrtBeginList");
+            }
+            return new ListHeader(
+                Id: Biff12.ReadI32(payload, 20),
+                Name: new string(displayName),
+                FirstRow: Biff12.ReadI32(payload, 0),
+                FirstColumn: Biff12.ReadI32(payload, 8),
+                LastRow: Biff12.ReadI32(payload, 4),
+                LastColumn: Biff12.ReadI32(payload, 12),
+                HeaderRowCount: Biff12.ReadI32(payload, 24),
+                TotalsRowCount: Biff12.ReadI32(payload, 28));
+        }
+
+        private static string ReadColumnName(ReadOnlySpan<byte> payload)
+        {
+            if (payload.Length < BeginListColFixedSize
+                || !Biff12.TryReadWideString(payload, BeginListColFixedSize, out ReadOnlySpan<char> name, out int nameBytes)
+                || !Biff12.TryReadWideString(payload, BeginListColFixedSize + nameBytes, out ReadOnlySpan<char> caption, out _))
+            {
+                throw Truncated("BrtBeginListCol");
+            }
+            if (caption.IsEmpty)
+            {
+                return new string(name);
+            }
+            return new string(caption);
+        }
+
+        private static string? ReadStyleName(ReadOnlySpan<byte> payload)
+        {
+            if (!Biff12.TryReadWideString(payload, StyleClientFlagsSize, out ReadOnlySpan<char> name, out _))
+            {
+                throw Truncated("BrtTableStyleClient");
+            }
+            if (name.IsEmpty)
+            {
+                return null;
+            }
+            return new string(name);
+        }
+
+        private static InvalidDataException Truncated(string record)
+        {
+            return new InvalidDataException($"A table part has a truncated {record} record.");
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
index f646dd19..60b78151 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
@@ -3,6 +3,7 @@
 using System.Diagnostics.CodeAnalysis;
 using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Sources;
+using ExcelReader.Core.Reader.Xlsx;
 using ExcelReader.Core.Reader.Zip;
 
 namespace ExcelReader.Core.Reader.Xlsb
@@ -66,6 +67,8 @@ private XlsbWorkbook(ZipIndex zip, ExcelReaderOptions options)
                 IsDate1904 = XlsbWorkbookParts.ParseDate1904(wbPart.Memory.Span);
                 (_sharedFlat, _sharedOffsets, _pooledSharedFlat) = LoadSharedStrings(zip, _decompressedBytes, options);
                 _sheetList = CreateSheetList();
+                _tables = WorkbookTables.Build(
+                    TableDiscovery.Load(zip, _sheets, _decompressedBytes, XlsbTables.ParseTable), _sheetList);
             }
             catch
             {
@@ -75,7 +78,7 @@ private XlsbWorkbook(ZipIndex zip, ExcelReaderOptions options)
         }
 
         private XlsbWorkbook(ZipIndex zip,
-            (string Name, string Path, ExcelSheetVisibility Visibility)[] sheets, bool[] styleIsDate, bool date1904,
+            (string Name, string Path, ExcelSheetVisibility Visibility)[] sheets, bool[] styleIsDate, bool date1904, List<TablePart> tables,
             byte[] sharedFlat, int[] sharedOffsets, bool pooledSharedFlat, ExcelReaderOptions options, DecompressedByteCounter decompressedBytes)
         {
             Lifetime = new ReaderLifetime(ReleaseResources);
@@ -89,6 +92,7 @@ private XlsbWorkbook(ZipIndex zip,
             _sharedOffsets = sharedOffsets;
             _pooledSharedFlat = pooledSharedFlat;
             _sheetList = CreateSheetList();
+            _tables = WorkbookTables.Build(tables, _sheetList);
         }
 
         internal static XlsbWorkbook CreateFromMemory(ReadOnlyMemory<byte> data, ExcelReaderOptions? options = null)
@@ -126,7 +130,8 @@ internal static async ValueTask<XlsbWorkbook> CreateFromIndexAsync(ZipIndex zip,
                 bool[] styleIsDate = XlsbStyles.ParseStyleDateFlags(stylesPart.Memory.Span);
                 bool date1904 = XlsbWorkbookParts.ParseDate1904(wbPart.Memory.Span);
                 (byte[] flat, int[] offsets, bool pooled) = await LoadSharedStringsAsync(zip, decompressedBytes, options, ct).ConfigureAwait(false);
-                return new XlsbWorkbook(zip, sheets, styleIsDate, date1904, flat, offsets, pooled, options, decompressedBytes);
+                List<TablePart> tables = await TableDiscovery.LoadAsync(zip, sheets, decompressedBytes, XlsbTables.ParseTable, ct).ConfigureAwait(false);
+                return new XlsbWorkbook(zip, sheets, styleIsDate, date1904, tables, flat, offsets, pooled, options, decompressedBytes);
             }
             catch
             {
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index 535df782..a2bf9015 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -6,11 +6,13 @@
 using ExcelReader.Core.Crypto;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsb;
 using ExcelReader.Core.Reader.Xlsx;
 using ExcelReader.Core.Reader.Zip;
 using ExcelReader.Tests.Crypto;
 using ExcelReader.Tests.Reader.Tables;
 using ExcelReader.Tests.Reader.Xls;
+using B = ExcelReader.Tests.Reader.Xlsb.Biff12Build;
 
 namespace ExcelReader.Tests.Reader
 {
@@ -645,5 +647,49 @@ public void MiniStreamChainWithACycleThrowsInvalidDataInsteadOfRepeatingSectors(
             Assert.Throws<InvalidDataException>(() =>
                 CfbContainer.ReadMiniStream(miniStream, miniFat, miniSectorSize: 64, startSector: 0, size: 256));
         }
+
+        [Fact]
+        public void SyntheticXlsbTableParses()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsb(
+            [
+                .. TableWorkbooks.BeginList(0, 1, 0, 0, 1, 0, "T"),
+                .. TableWorkbooks.ListColumn(1, "H"),
+                .. TableWorkbooks.StyleClient("TableStyleLight1"),
+            ]);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+
+            ExcelTable table = Assert.Single(workbook.Tables);
+            Assert.Equal(("T", "A1:A2", "TableStyleLight1"), (table.Name, table.Ref, table.StyleName));
+            Assert.Equal(["H"], table.ColumnNames);
+        }
+
+        [Fact]
+        public void TruncatedXlsbBeginListThrowsInvalidData()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsb(B.Record(Brt.BeginList, new byte[10]));
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(ms));
+        }
+
+        [Fact]
+        public void XlsbTablePartWithoutBeginListThrowsInvalidData()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsb(TableWorkbooks.ListColumn(1, "H"));
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(ms));
+        }
+
+        [Fact]
+        public void XlsbTableWithNegativeRowsThrowsInvalidData()
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsb(
+            [
+                .. TableWorkbooks.BeginList(0xFFFFFFFF, 1, 0, 0, 1, 0, "T"),
+                .. TableWorkbooks.ListColumn(1, "H"),
+            ]);
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(ms));
+        }
     }
 }
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
index b457be6f..00cfca78 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableMetadataTests.cs
@@ -7,7 +7,7 @@ public class TableMetadataTests
     {
         private const string Rows = """<row r="1"><c r="A1" t="inlineStr"><is><t>H</t></is></c></row><row r="2"><c r="A2"><v>1</v></c></row>""";
 
-        public static TheoryData<string> Fixtures { get; } = new() { "tables.xlsx" };
+        public static TheoryData<string> Fixtures { get; } = new() { "tables.xlsx", "tables.xlsb" };
 
         private static readonly (string Name, int Sheet, string Ref, int FirstRow, int FirstColumn, int LastRow, int LastColumn,
             int HeaderRowCount, int TotalsRowCount, string[] Columns, string? Style)[] Expected =
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
index 9206c6ae..9996ddca 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
@@ -1,3 +1,8 @@
+using System.IO.Compression;
+using System.Text;
+using ExcelReader.Core.Reader.Xlsb;
+using B = ExcelReader.Tests.Reader.Xlsb.Biff12Build;
+
 namespace ExcelReader.Tests.Reader.Tables
 {
     internal static class TableWorkbooks
@@ -18,5 +23,69 @@ internal static string Table(string reference, string columns, string attributes
         {
             return $"""<table xmlns="{Main}" id="1" name="T" displayName="T" ref="{reference}"{attributes}><tableColumns>{columns}</tableColumns></table>""";
         }
+
+        internal static MemoryStream Xlsb(byte[] tableBin)
+        {
+            MemoryStream ms = new();
+            using (var zip = new ZipArchive(ms, ZipArchiveMode.Create, leaveOpen: true))
+            {
+                Add(zip, "xl/workbook.bin", B.Record(Brt.BundleSh, [.. B.U32(0), .. B.U32(0), .. B.WideString("rId1"), .. B.WideString("S1")]));
+                Add(zip, "xl/_rels/workbook.bin.rels", Encoding.UTF8.GetBytes(
+                    """<Relationships><Relationship Id="rId1" Target="worksheets/sheet1.bin"/></Relationships>"""));
+                Add(zip, "xl/styles.bin", []);
+                Add(zip, "xl/sharedStrings.bin", []);
+                Add(zip, "xl/worksheets/sheet1.bin",
+                [
+                    .. B.Record(Brt.RowHdr, B.U32(0)),
+                    .. B.Record(Brt.CellSt, B.CellSt(0, 0, "H")),
+                    .. B.Record(Brt.RowHdr, B.U32(1)),
+                    .. B.Record(Brt.CellRk, B.CellRk(0, 0, (1u << 2) | 0x02)),
+                    .. B.Record(Brt.EndSheetData),
+                ]);
+                Add(zip, "xl/worksheets/_rels/sheet1.bin.rels", Encoding.UTF8.GetBytes(
+                    $"""<Relationships><Relationship Id="rId1" Type="{TableRelationship}" Target="../tables/table1.bin"/></Relationships>"""));
+                Add(zip, "xl/tables/table1.bin", tableBin);
+            }
+            ms.Position = 0;
+            return ms;
+        }
+
+        internal static byte[] BeginList(uint firstRow, uint lastRow, uint firstColumn, uint lastColumn, uint headerRowCount, uint totalsRowCount, string name)
+        {
+            return B.Record(Brt.BeginList,
+            [
+                .. B.U32(firstRow), .. B.U32(lastRow), .. B.U32(firstColumn), .. B.U32(lastColumn),
+                .. B.U32(0), .. B.U32(1), .. B.U32(headerRowCount), .. B.U32(totalsRowCount), .. B.U32(0),
+                .. Ones(24), .. B.U32(0),
+                .. B.WideString(name), .. B.WideString(name), .. B.WideString(""),
+                .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+            ]);
+        }
+
+        internal static byte[] ListColumn(uint id, string caption)
+        {
+            return B.Record(Brt.BeginListCol,
+            [
+                .. B.U32(id), .. B.U32(0), .. Ones(12), .. B.U32(0),
+                .. B.NullWideString(), .. B.WideString(caption),
+                .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+            ]);
+        }
+
+        internal static byte[] StyleClient(string style)
+        {
+            return B.Record(Brt.ListTableStyleClient, [.. B.U16(4), .. B.WideString(style)]);
+        }
+
+        private static byte[] Ones(int count)
+        {
+            return Enumerable.Repeat((byte)0xFF, count).ToArray();
+        }
+
+        private static void Add(ZipArchive zip, string name, byte[] bytes)
+        {
+            using Stream stream = zip.CreateEntry(name).Open();
+            stream.Write(bytes);
+        }
     }
 }

From bdf0e2ff3c7d24313b54e03afbbb7fcbdf7d195e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:29:45 -0300
Subject: [PATCH 044/115] fix(reader): discover XLSB tables before renting
 shared strings

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs   |  6 +++---
 tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs | 11 +++++++++++
 2 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
index 60b78151..089307a1 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
@@ -65,10 +65,10 @@ private XlsbWorkbook(ZipIndex zip, ExcelReaderOptions options)
                 using ZipPart stylesPart = zip.OpenPartOrDefault("xl/styles.bin"u8, _decompressedBytes);
                 _styleIsDate = XlsbStyles.ParseStyleDateFlags(stylesPart.Memory.Span);
                 IsDate1904 = XlsbWorkbookParts.ParseDate1904(wbPart.Memory.Span);
+                List<TablePart> tableParts = TableDiscovery.Load(zip, _sheets, _decompressedBytes, XlsbTables.ParseTable);
                 (_sharedFlat, _sharedOffsets, _pooledSharedFlat) = LoadSharedStrings(zip, _decompressedBytes, options);
                 _sheetList = CreateSheetList();
-                _tables = WorkbookTables.Build(
-                    TableDiscovery.Load(zip, _sheets, _decompressedBytes, XlsbTables.ParseTable), _sheetList);
+                _tables = WorkbookTables.Build(tableParts, _sheetList);
             }
             catch
             {
@@ -129,8 +129,8 @@ internal static async ValueTask<XlsbWorkbook> CreateFromIndexAsync(ZipIndex zip,
                 using ZipPart stylesPart = await zip.OpenPartOrDefaultAsync("xl/styles.bin"u8, decompressedBytes, ct).ConfigureAwait(false);
                 bool[] styleIsDate = XlsbStyles.ParseStyleDateFlags(stylesPart.Memory.Span);
                 bool date1904 = XlsbWorkbookParts.ParseDate1904(wbPart.Memory.Span);
-                (byte[] flat, int[] offsets, bool pooled) = await LoadSharedStringsAsync(zip, decompressedBytes, options, ct).ConfigureAwait(false);
                 List<TablePart> tables = await TableDiscovery.LoadAsync(zip, sheets, decompressedBytes, XlsbTables.ParseTable, ct).ConfigureAwait(false);
+                (byte[] flat, int[] offsets, bool pooled) = await LoadSharedStringsAsync(zip, decompressedBytes, options, ct).ConfigureAwait(false);
                 return new XlsbWorkbook(zip, sheets, styleIsDate, date1904, tables, flat, offsets, pooled, options, decompressedBytes);
             }
             catch
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index a2bf9015..fb0265e7 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -691,5 +691,16 @@ .. TableWorkbooks.ListColumn(1, "H"),
 
             Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(ms));
         }
+
+        [Fact]
+        public async Task MalformedXlsbTableFromStreamingSourceThrowsInvalidData()
+        {
+            byte[] bytes = TableWorkbooks.Xlsb(TableWorkbooks.ListColumn(1, "H")).ToArray();
+
+            Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(new StreamBackedMemory(bytes)));
+            await Assert.ThrowsAsync<InvalidDataException>(async () => await Excel.FromXlsbAsync(new StreamBackedMemory(bytes), leaveOpen: false, ct: TestContext.Current.CancellationToken));
+        }
+
+        private sealed class StreamBackedMemory(byte[] bytes) : MemoryStream(bytes);
     }
 }

From ed16d725e9ee30190f98392db9da0a7516b63f15 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 20:59:47 -0300
Subject: [PATCH 045/115] feat(reader): track absolute row index on demand in
 XLSX/XLSB enumerators

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Internal/IRowIndexedEnumerator.cs  |   9 ++
 .../Reader/Xlsb/XlsbWorkbook.Enumerator.cs    |  42 ++++-
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |  36 ++++-
 .../Reader/Tables/RowIndexTests.cs            | 153 ++++++++++++++++++
 4 files changed, 237 insertions(+), 3 deletions(-)
 create mode 100644 src/ExcelReader.Core/Reader/Internal/IRowIndexedEnumerator.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/RowIndexTests.cs

diff --git a/src/ExcelReader.Core/Reader/Internal/IRowIndexedEnumerator.cs b/src/ExcelReader.Core/Reader/Internal/IRowIndexedEnumerator.cs
new file mode 100644
index 00000000..87ac5383
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Internal/IRowIndexedEnumerator.cs
@@ -0,0 +1,9 @@
+namespace ExcelReader.Core.Reader.Internal
+{
+    internal interface IRowIndexedEnumerator
+    {
+        int RowIndex { get; }
+
+        void EnableRowIndex();
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
index a37658e6..f3bbf1e0 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
@@ -16,7 +16,7 @@ public sealed partial class XlsbWorkbook
         /// </remarks>
         [SuppressMessage("Design", "CA1034:Nested types should not be visible",
             Justification = "Public nested enumerator is the standard foreach pattern.")]
-        public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator
+        public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator, IRowIndexedEnumerator
         {
             [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed",
                 Justification = "XlsbWorkbook is borrowed; its lifetime is managed by the caller, not this enumerator.")]
@@ -27,6 +27,9 @@ public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator
             private readonly ZipEntryRef _entry;
             private bool _ended;
             private bool _pendingRowHdr;
+            private bool _trackRowIndex;
+            private int _rowIndex = -1;
+            private int _nextRowIndex = -1;
 
             internal Enumerator(XlsbWorkbook reader, Stream sheet, long entryLength = 0, CancellationToken ct = default)
                 : base(sheet, reader._options.MaxCellBytes, nameof(ExcelReaderOptions.MaxCellBytes), WorkbookLookups.InitialBufferCapacity(entryLength), ownsSource: true, ct)
@@ -63,6 +66,19 @@ private protected override async ValueTask<Stream> OpenSourceAsync()
             public Row Current =>
                 new(_acc.CellSpan, _acc.ValueSpan, _reader.SharedSpan, rowBuffer: default, _reader.SharedStringCache, _contentCache);
 
+            int IRowIndexedEnumerator.RowIndex
+            {
+                get
+                {
+                    return _rowIndex;
+                }
+            }
+
+            void IRowIndexedEnumerator.EnableRowIndex()
+            {
+                _trackRowIndex = true;
+            }
+
             /// <inheritdoc/>
             public bool MoveNext()
             {
@@ -92,6 +108,7 @@ public ValueTask<bool> MoveNextAsync()
                     }
                 }
                 _pendingRowHdr = false;
+                _rowIndex = _nextRowIndex;
                 if (CollectCellsFromBuffer() == 2)
                 {
                     return MoveNextRowAsync(seekDone: true);
@@ -106,6 +123,7 @@ private async ValueTask<bool> MoveNextRowAsync(bool seekDone)
                     return false;
                 }
                 _pendingRowHdr = false;
+                _rowIndex = _nextRowIndex;
                 await CollectCellsAsync().ConfigureAwait(false);
                 return true;
             }
@@ -122,6 +140,7 @@ private bool MoveNextCore()
                     return false;
                 }
                 _pendingRowHdr = false;
+                _rowIndex = _nextRowIndex;
                 CollectCells();
                 return true;
             }
@@ -180,10 +199,14 @@ private async ValueTask CollectCellsAsync()
             private int SeekRowHdrFromBuffer()
             {
                 Biff12RecordReader reader = new(_buf.AsSpan(_pos, _len - _pos));
-                while (reader.TryReadRecord(out int id, out _))
+                while (reader.TryReadRecord(out int id, out ReadOnlySpan<byte> payload))
                 {
                     if (id == Brt.RowHdr)
                     {
+                        if (_trackRowIndex)
+                        {
+                            NoteRowHeader(payload);
+                        }
                         _pos += reader.Position;
                         return 1;
                     }
@@ -211,6 +234,10 @@ private int CollectCellsFromBuffer()
                 {
                     if (id == Brt.RowHdr)
                     {
+                        if (_trackRowIndex)
+                        {
+                            NoteRowHeader(payload);
+                        }
                         _pos += reader.Position;
                         _pendingRowHdr = true;
                         return 1;
@@ -233,6 +260,17 @@ private int CollectCellsFromBuffer()
                 return 2;
             }
 
+            [MethodImpl(MethodImplOptions.NoInlining)]
+            private void NoteRowHeader(ReadOnlySpan<byte> payload)
+            {
+                if (payload.Length >= 4)
+                {
+                    _nextRowIndex = Biff12.ReadI32(payload, 0);
+                    return;
+                }
+                _nextRowIndex++;
+            }
+
             private void ProcessCell(int id, ReadOnlySpan<byte> payload)
             {
                 if (payload.Length < 8)
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 000a579e..6f698c33 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -14,7 +14,7 @@ public sealed partial class XlsxWorkbook
         /// <remarks>Low-memory: streams the sheet through a refillable pooled buffer, growing it as needed so a single <c>&lt;c&gt;...&lt;/c&gt;</c> element is always guaranteed contiguous.</remarks>
         [SuppressMessage("Design", "CA1034:Nested types should not be visible",
             Justification = "Public nested enumerator is the standard foreach pattern.")]
-        public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator
+        public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator, IRowIndexedEnumerator
         {
             [SuppressMessage("Usage", "CA2213:Disposable fields should be disposed", Justification = "Borrowed, not owned.")]
             private readonly XlsxWorkbook _reader;
@@ -23,6 +23,8 @@ public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator
             private readonly Utf8StringCache? _contentCache;
             private readonly ZipEntryRef _entry;
             private int _nextCol;
+            private bool _trackRowIndex;
+            private int _rowIndex = -1;
 
             private NsTokens? _ns;
             private bool _nsChecked;
@@ -70,6 +72,18 @@ private protected override async ValueTask<Stream> OpenSourceAsync()
             public Row Current =>
                 new(_acc.CellSpan, _acc.ValueSpan, _reader.SharedSpan, _buf.AsSpan(0, _len), _reader.SharedStringCache, _contentCache);
 
+            int IRowIndexedEnumerator.RowIndex
+            {
+                get
+                {
+                    return _rowIndex;
+                }
+            }
+
+            void IRowIndexedEnumerator.EnableRowIndex()
+            {
+                _trackRowIndex = true;
+            }
 
             /// <inheritdoc/>
             public bool MoveNext()
@@ -548,6 +562,10 @@ private async ValueTask<bool> BeginRowSlowAsync()
 
             private bool BeginRowAt(int gt)
             {
+                if (_trackRowIndex)
+                {
+                    AdvanceRowIndex(_buf.AsSpan(_pos, gt - _pos));
+                }
                 _pos = gt + 1;
                 _acc.Reset();
                 _nextCol = 0;
@@ -556,12 +574,28 @@ private bool BeginRowAt(int gt)
 
             private bool MissingRowOpenTag()
             {
+                if (_trackRowIndex)
+                {
+                    _rowIndex++;
+                }
                 _pos = _len;
                 _acc.Reset();
                 _nextCol = 0;
                 return true;
             }
 
+            [MethodImpl(MethodImplOptions.NoInlining)]
+            private void AdvanceRowIndex(ReadOnlySpan<byte> rowTag)
+            {
+                int rowNumber = XlsxXml.ParseIntOr(XlsxXml.Attr(rowTag, " r="u8), 0);
+                if (rowNumber > 0)
+                {
+                    _rowIndex = rowNumber - 1;
+                    return;
+                }
+                _rowIndex++;
+            }
+
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
             private static bool TryScanCanonicalCellTag(byte[] buf, int len, int i, out int gt, out int col, out int style, out Kind kind)
             {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/RowIndexTests.cs b/tests/ExcelReader.Tests/Reader/Tables/RowIndexTests.cs
new file mode 100644
index 00000000..8e70e9b4
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/RowIndexTests.cs
@@ -0,0 +1,153 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Reader.Xlsx;
+using B = ExcelReader.Tests.Reader.Xlsb.Biff12Build;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class RowIndexTests
+    {
+        private sealed class StreamBackedMemory(byte[] bytes) : MemoryStream(bytes);
+
+        [Fact]
+        public void XlsxRowIndexFollowsTheRAttributeAndFallsBackToTheNextRow()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(
+                """<row r="2"><c r="A2"><v>1</v></c></row><row r="5"><c r="A5"><v>2</v></c></row><row><c r="A6"><v>3</v></c></row><row r="9"/>""");
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Equal([1, 4, 5, 8], ReadIndexes(workbook.FirstSheet.GetEnumerator()));
+        }
+
+        [Fact]
+        public void RowIndexStaysUnsetUntilEnabled()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build("""<row r="3"><c r="A3"><v>1</v></c></row>""");
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            using XlsxWorkbook.Enumerator rows = workbook.FirstSheet.GetEnumerator();
+
+            Assert.True(rows.MoveNext());
+            Assert.Equal(-1, ((IRowIndexedEnumerator)rows).RowIndex);
+        }
+
+        [Fact]
+        public void XlsbRowIndexFollowsTheRowHeaderAndFallsBackToTheNextRow()
+        {
+            using MemoryStream ms = XlsbSheet(
+            [
+                .. B.Record(Brt.RowHdr, B.U32(1)), .. B.Record(Brt.CellRk, B.CellRk(0, 0, (1u << 2) | 0x02)),
+                .. B.Record(Brt.RowHdr, B.U32(4)), .. B.Record(Brt.CellRk, B.CellRk(0, 0, (2u << 2) | 0x02)),
+                .. B.Record(Brt.RowHdr), .. B.Record(Brt.CellRk, B.CellRk(0, 0, (3u << 2) | 0x02)),
+                .. B.Record(Brt.EndSheetData),
+            ]);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+
+            Assert.Equal([1, 4, 5], ReadIndexes(workbook.FirstSheet.GetEnumerator()));
+        }
+
+        [Fact]
+        public async Task XlsxSyncAndAsyncRowIndexesMatchAcrossBufferRefills()
+        {
+            StringBuilder rows = new();
+            for (int i = 0; i < 20_000; i++)
+            {
+                int r = (3 * i) + 1;
+                rows.Append(CultureInfo.InvariantCulture, $"""<row r="{r}"><c r="A{r}" t="inlineStr"><is><t>row-{i}-padding-padding-padding</t></is></c></row>""");
+            }
+            using MemoryStream source = WorkbookBuilder.Build(rows.ToString());
+            byte[] bytes = source.ToArray();
+            int[] expected = [.. Enumerable.Range(0, 20_000).Select(static i => 3 * i)];
+
+            using XlsxWorkbook syncBook = Excel.FromXlsx(new StreamBackedMemory(bytes), leaveOpen: false);
+            await using XlsxWorkbook asyncBook = await Excel.FromXlsxAsync(
+                new StreamBackedMemory(bytes), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+
+            Assert.Equal(expected, ReadIndexes(syncBook.FirstSheet.GetEnumerator()));
+            Assert.Equal(expected, await ReadIndexesAsync(asyncBook.FirstSheet.GetAsyncEnumerator(TestContext.Current.CancellationToken)));
+        }
+
+        [Fact]
+        public async Task XlsbSyncAndAsyncRowIndexesMatchAcrossBufferRefills()
+        {
+            List<byte> sheet = [];
+            for (int i = 0; i < 20_000; i++)
+            {
+                sheet.AddRange(B.Record(Brt.RowHdr, B.U32((uint)(3 * i))));
+                sheet.AddRange(B.Record(Brt.CellSt, B.CellSt(0, 0, $"row-{i}-padding-padding-padding")));
+            }
+            sheet.AddRange(B.Record(Brt.EndSheetData));
+            byte[] bytes = XlsbSheet([.. sheet]).ToArray();
+            int[] expected = [.. Enumerable.Range(0, 20_000).Select(static i => 3 * i)];
+
+            using XlsbWorkbook syncBook = Excel.FromXlsb(new StreamBackedMemory(bytes), leaveOpen: false);
+            await using XlsbWorkbook asyncBook = await Excel.FromXlsbAsync(
+                new StreamBackedMemory(bytes), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+
+            Assert.Equal(expected, ReadIndexes(syncBook.FirstSheet.GetEnumerator()));
+            Assert.Equal(expected, await ReadIndexesAsync(asyncBook.FirstSheet.GetAsyncEnumerator(TestContext.Current.CancellationToken)));
+        }
+
+        [Fact]
+        public void FixtureRowIndexesSkipAbsentRows()
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath("tables.xlsx"));
+
+            Assert.Equal([3, 4, 5, 6, 7, 10], ReadIndexes(workbook.FirstSheet.GetEnumerator()));
+        }
+
+        private static int[] ReadIndexes(IExcelRowEnumerator rows)
+        {
+            using (rows)
+            {
+                IRowIndexedEnumerator indexed = (IRowIndexedEnumerator)rows;
+                indexed.EnableRowIndex();
+                List<int> indexes = [];
+                while (rows.MoveNext())
+                {
+                    indexes.Add(indexed.RowIndex);
+                }
+                return [.. indexes];
+            }
+        }
+
+        private static async Task<int[]> ReadIndexesAsync(IExcelRowEnumerator rows)
+        {
+            await using (rows.ConfigureAwait(false))
+            {
+                IRowIndexedEnumerator indexed = (IRowIndexedEnumerator)rows;
+                indexed.EnableRowIndex();
+                List<int> indexes = [];
+                while (await rows.MoveNextAsync().ConfigureAwait(false))
+                {
+                    indexes.Add(indexed.RowIndex);
+                }
+                return [.. indexes];
+            }
+        }
+
+        private static MemoryStream XlsbSheet(byte[] sheet)
+        {
+            MemoryStream ms = new();
+            using (var zip = new System.IO.Compression.ZipArchive(ms, System.IO.Compression.ZipArchiveMode.Create, leaveOpen: true))
+            {
+                Add(zip, "xl/workbook.bin", B.Record(Brt.BundleSh, [.. B.U32(0), .. B.U32(0), .. B.WideString("rId1"), .. B.WideString("S1")]));
+                Add(zip, "xl/_rels/workbook.bin.rels", Encoding.UTF8.GetBytes(
+                    """<Relationships><Relationship Id="rId1" Target="worksheets/sheet1.bin"/></Relationships>"""));
+                Add(zip, "xl/styles.bin", []);
+                Add(zip, "xl/sharedStrings.bin", []);
+                Add(zip, "xl/worksheets/sheet1.bin", sheet);
+            }
+            ms.Position = 0;
+            return ms;
+        }
+
+        private static void Add(System.IO.Compression.ZipArchive zip, string name, byte[] bytes)
+        {
+            using Stream stream = zip.CreateEntry(name).Open();
+            stream.Write(bytes);
+        }
+    }
+}

From d2b30d777dd3d15684425f6aea774fecd1b5edae Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 21:07:08 -0300
Subject: [PATCH 046/115] feat(reader): read a table's rows through
 ExcelTable.AsSheet

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../PublicAPI/PublicAPI.Unshipped.txt         |   1 +
 src/ExcelReader.Core/Reader/ExcelTable.cs     |  15 ++
 .../Reader/Internal/ExcelTableSheet.cs        |  68 ++++++
 .../Reader/Internal/TableRowEnumerator.cs     |  79 +++++++
 src/ExcelReader.Core/Reader/Row.cs            |  26 +++
 .../Reader/Tables/TableViewTests.cs           | 195 ++++++++++++++++++
 6 files changed, 384 insertions(+)
 create mode 100644 src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
 create mode 100644 src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs

diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 8fd47b58..7a138ce2 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -21,3 +21,4 @@ ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Tables.get -> System.Collections.Gener
 ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
 ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
 ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
+ExcelReader.Core.Reader.ExcelTable.AsSheet() -> ExcelReader.Core.Reader.IExcelSheet!
diff --git a/src/ExcelReader.Core/Reader/ExcelTable.cs b/src/ExcelReader.Core/Reader/ExcelTable.cs
index 2c574b46..365656cc 100644
--- a/src/ExcelReader.Core/Reader/ExcelTable.cs
+++ b/src/ExcelReader.Core/Reader/ExcelTable.cs
@@ -56,5 +56,20 @@ internal ExcelTable(TablePart part, IExcelSheet sheet)
 
         /// <summary>Gets the name of the table's style, such as <c>TableStyleMedium2</c>, or <see langword="null"/> when the table has none.</summary>
         public string? StyleName { get; }
+
+        /// <summary>
+        /// Gets a sheet that reads only this table: its header row first (when it has one), then its data
+        /// rows without the totals row, each cut to the table's columns.
+        /// </summary>
+        /// <remarks>
+        /// Column indexes stay those of <see cref="Sheet"/>: a table starting at column C reports its first
+        /// cell at index 2. The returned sheet reports <see cref="Sheet"/>'s name, index and visibility.
+        /// Rows absent from the file are skipped, as on any sheet.
+        /// </remarks>
+        /// <returns>A sheet bounded to this table.</returns>
+        public IExcelSheet AsSheet()
+        {
+            return new ExcelTableSheet(this);
+        }
     }
 }
diff --git a/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs b/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
new file mode 100644
index 00000000..94b86fec
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
@@ -0,0 +1,68 @@
+namespace ExcelReader.Core.Reader.Internal
+{
+    internal sealed class ExcelTableSheet : IExcelSheet
+    {
+        private readonly ExcelTable _table;
+
+        internal ExcelTableSheet(ExcelTable table)
+        {
+            _table = table;
+        }
+
+        public int Index
+        {
+            get
+            {
+                return _table.Sheet.Index;
+            }
+        }
+
+        public string Name
+        {
+            get
+            {
+                return _table.Sheet.Name;
+            }
+        }
+
+        public ExcelSheetVisibility Visibility
+        {
+            get
+            {
+                return _table.Sheet.Visibility;
+            }
+        }
+
+        public bool IsDate1904
+        {
+            get
+            {
+                return _table.Sheet.IsDate1904;
+            }
+        }
+
+        public IExcelRowEnumerator GetEnumerator()
+        {
+            return Bound(_table.Sheet.GetEnumerator());
+        }
+
+        public IExcelRowEnumerator GetAsyncEnumerator(CancellationToken ct = default)
+        {
+            return Bound(_table.Sheet.GetAsyncEnumerator(ct));
+        }
+
+        internal static void ThrowIfHeaderless(IExcelSheet sheet)
+        {
+            if (sheet is ExcelTableSheet view && view._table.HeaderRowCount == 0)
+            {
+                throw new InvalidOperationException(
+                    $"Table '{view._table.Name}' has no header row, so its columns cannot be matched by name.");
+            }
+        }
+
+        private TableRowEnumerator Bound(IExcelRowEnumerator rows)
+        {
+            return new TableRowEnumerator(rows, _table.FirstRow, _table.LastRow - _table.TotalsRowCount, _table.FirstColumn, _table.LastColumn);
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs b/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
new file mode 100644
index 00000000..7ffc7430
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
@@ -0,0 +1,79 @@
+namespace ExcelReader.Core.Reader.Internal
+{
+    internal sealed class TableRowEnumerator : IExcelRowEnumerator
+    {
+        private readonly IExcelRowEnumerator _rows;
+        private readonly IRowIndexedEnumerator _indexed;
+        private readonly int _firstRow;
+        private readonly int _lastDataRow;
+        private readonly int _firstColumn;
+        private readonly int _lastColumn;
+        private bool _done;
+
+        internal TableRowEnumerator(IExcelRowEnumerator rows, int firstRow, int lastDataRow, int firstColumn, int lastColumn)
+        {
+            _rows = rows;
+            _indexed = (IRowIndexedEnumerator)rows;
+            _indexed.EnableRowIndex();
+            _firstRow = firstRow;
+            _lastDataRow = lastDataRow;
+            _firstColumn = firstColumn;
+            _lastColumn = lastColumn;
+        }
+
+        public Row Current
+        {
+            get
+            {
+                return _rows.Current.Slice(_firstColumn, _lastColumn);
+            }
+        }
+
+        public bool MoveNext()
+        {
+            while (!_done && _rows.MoveNext())
+            {
+                if (IsInTable())
+                {
+                    return true;
+                }
+            }
+            _done = true;
+            return false;
+        }
+
+        public async ValueTask<bool> MoveNextAsync()
+        {
+            while (!_done && await _rows.MoveNextAsync().ConfigureAwait(false))
+            {
+                if (IsInTable())
+                {
+                    return true;
+                }
+            }
+            _done = true;
+            return false;
+        }
+
+        public void Dispose()
+        {
+            _rows.Dispose();
+        }
+
+        public ValueTask DisposeAsync()
+        {
+            return _rows.DisposeAsync();
+        }
+
+        private bool IsInTable()
+        {
+            int row = _indexed.RowIndex;
+            if (row > _lastDataRow)
+            {
+                _done = true;
+                return false;
+            }
+            return row >= _firstRow;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Row.cs b/src/ExcelReader.Core/Reader/Row.cs
index b06c955b..094dd042 100644
--- a/src/ExcelReader.Core/Reader/Row.cs
+++ b/src/ExcelReader.Core/Reader/Row.cs
@@ -66,5 +66,31 @@ private int IndexOf(int column)
             }
             return -1;
         }
+
+        internal Row Slice(int firstColumn, int lastColumn)
+        {
+            int start = LowerBound(firstColumn);
+            int end = LowerBound(lastColumn + 1);
+            return new Row(_cells[start..end], _rowValues, _shared, _rowBuffer, _sharedStringCache, _contentCache);
+        }
+
+        private int LowerBound(int column)
+        {
+            int lo = 0;
+            int hi = _cells.Length;
+            while (lo < hi)
+            {
+                int mid = (lo + hi) >> 1;
+                if (_cells[mid].Column < column)
+                {
+                    lo = mid + 1;
+                }
+                else
+                {
+                    hi = mid;
+                }
+            }
+            return lo;
+        }
     }
 }
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs
new file mode 100644
index 00000000..dc7d7990
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs
@@ -0,0 +1,195 @@
+using ExcelReader.Core;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class TableViewTests
+    {
+        private sealed class FakeRows(int[] rowIndexes) : IExcelRowEnumerator, IRowIndexedEnumerator
+        {
+            private int _next;
+
+            public int MoveNextCalls { get; private set; }
+
+            public bool Disposed { get; private set; }
+
+            public bool Enabled { get; private set; }
+
+            public int RowIndex { get; private set; } = -1;
+
+            public Row Current
+            {
+                get
+                {
+                    return default;
+                }
+            }
+
+            public void EnableRowIndex()
+            {
+                Enabled = true;
+            }
+
+            public bool MoveNext()
+            {
+                MoveNextCalls++;
+                if (_next == rowIndexes.Length)
+                {
+                    return false;
+                }
+                RowIndex = rowIndexes[_next++];
+                return true;
+            }
+
+            public ValueTask<bool> MoveNextAsync()
+            {
+                return new ValueTask<bool>(MoveNext());
+            }
+
+            public void Dispose()
+            {
+                Disposed = true;
+            }
+
+            public ValueTask DisposeAsync()
+            {
+                Disposed = true;
+                return ValueTask.CompletedTask;
+            }
+        }
+
+        [Fact]
+        public void BoundedRowsStopAtTheFirstRowPastTheTable()
+        {
+            FakeRows rows = new([0, 3, 4, 5, 6, 7, 8, 9]);
+            using TableRowEnumerator table = new(rows, firstRow: 3, lastDataRow: 6, firstColumn: 0, lastColumn: 0);
+
+            int yielded = 0;
+            while (table.MoveNext())
+            {
+                yielded++;
+            }
+
+            Assert.True(rows.Enabled);
+            Assert.Equal(4, yielded);
+            Assert.Equal(6, rows.MoveNextCalls);
+            Assert.False(table.MoveNext());
+            Assert.Equal(6, rows.MoveNextCalls);
+        }
+
+        [Fact]
+        public async Task BoundedRowsStopAtTheFirstRowPastTheTableAsync()
+        {
+            FakeRows rows = new([0, 3, 4, 5, 6, 7, 8, 9]);
+            await using TableRowEnumerator table = new(rows, firstRow: 3, lastDataRow: 6, firstColumn: 0, lastColumn: 0);
+
+            int yielded = 0;
+            while (await table.MoveNextAsync())
+            {
+                yielded++;
+            }
+
+            Assert.Equal(4, yielded);
+            Assert.Equal(6, rows.MoveNextCalls);
+        }
+
+        [Fact]
+        public void DisposingTheViewDisposesTheSheetEnumerator()
+        {
+            FakeRows rows = new([0]);
+            TableRowEnumerator table = new(rows, firstRow: 0, lastDataRow: 0, firstColumn: 0, lastColumn: 0);
+
+            table.Dispose();
+
+            Assert.True(rows.Disposed);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void SalesViewYieldsHeaderAndDataRowsCutToTheTable(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            Assert.Equal(
+                ["2,3,4:Product,Qty", "2,3,4:Pen,10", "2,3,4:Notebook,4", "2,3,4:Pencil,25"],
+                Render(Table(workbook, "Sales").AsSheet(), 2, 3));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void StockViewIgnoresTheNeighbouringTableAndCells(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            Assert.Equal(
+                ["6,7:Product,Qty", "6,7:Pen,100", "6,7:Notebook,40", "6,7:Pencil,250"],
+                Render(Table(workbook, "Stock").AsSheet(), 6, 7));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void HeaderlessViewYieldsOnlyDataRows(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            Assert.Equal(["0,1:a,1", "0,1:b,2", "0,1:c,3"], Render(Table(workbook, "NoHeader").AsSheet(), 0, 1));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void ViewReportsItsOwningSheet(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            IExcelSheet view = Table(workbook, "NoStyle").AsSheet();
+
+            Assert.Equal(("Extra", 1, ExcelSheetVisibility.Visible), (view.Name, view.Index, view.Visibility));
+            Assert.Equal(["3,4:Name,Value", "3,4:x,1", "3,4:y,2"], Render(view, 3, 4));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public async Task AsyncViewOverAStreamYieldsTheSameRows(string file)
+        {
+            await using IExcelWorkbook workbook = await Excel.OpenAsync(
+                File.OpenRead(TableMetadataTests.FixturePath(file)), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+            IExcelSheet view = Table(workbook, "Sales").AsSheet();
+
+            List<string> rows = [];
+            await using IExcelRowEnumerator enumerator = view.GetAsyncEnumerator(TestContext.Current.CancellationToken);
+            while (await enumerator.MoveNextAsync())
+            {
+                rows.Add(RenderRow(enumerator.Current, 2, 3));
+            }
+
+            Assert.Equal(["2,3,4:Product,Qty", "2,3,4:Pen,10", "2,3,4:Notebook,4", "2,3,4:Pencil,25"], rows);
+        }
+
+        private static ExcelTable Table(IExcelWorkbook workbook, string name)
+        {
+            Assert.True(workbook.TryGetTable(name, out ExcelTable? table));
+            return table;
+        }
+
+        private static List<string> Render(IExcelSheet sheet, int firstShown, int secondShown)
+        {
+            List<string> rows = [];
+            using IExcelRowEnumerator enumerator = sheet.GetEnumerator();
+            while (enumerator.MoveNext())
+            {
+                rows.Add(RenderRow(enumerator.Current, firstShown, secondShown));
+            }
+            return rows;
+        }
+
+        private static string RenderRow(Row row, int firstShown, int secondShown)
+        {
+            List<int> columns = [];
+            foreach (RowCell cell in row.Cells)
+            {
+                columns.Add(cell.ColumnIndex);
+            }
+            return $"{string.Join(',', columns)}:{row[firstShown].GetString()},{row[secondShown].GetString()}";
+        }
+    }
+}

From a24214f1e568e9c0a446901e084f6cc804b4e6bb Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 21:11:44 -0300
Subject: [PATCH 047/115] feat(reader): reject name binding on headerless
 tables

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Parser/ExcelParser.cs    |   3 +
 src/ExcelReader.Core/Reader/Excel.cs          |   8 ++
 .../Reader/ExcelDataReader.cs                 |   7 ++
 .../Reader/Tables/TableBindingTests.cs        | 101 ++++++++++++++++++
 4 files changed, 119 insertions(+)
 create mode 100644 tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs

diff --git a/src/ExcelReader.Core/Parser/ExcelParser.cs b/src/ExcelReader.Core/Parser/ExcelParser.cs
index fe590f18..99212d62 100644
--- a/src/ExcelReader.Core/Parser/ExcelParser.cs
+++ b/src/ExcelReader.Core/Parser/ExcelParser.cs
@@ -1,6 +1,7 @@
 using System.Diagnostics.CodeAnalysis;
 using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Csv;
 using ExcelReader.Core.Reader.Xls;
 using ExcelReader.Core.Reader.Xlsb;
@@ -66,9 +67,11 @@ public ExcelEnumerable<T> Parse(XlsxSheet sheet)
         /// <param name="sheet">The sheet to pull rows from. Each enumeration of the result starts a new read of it.</param>
         /// <returns>An enumerable that yields one <typeparamref name="T"/> per data row.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is <see langword="null"/>.</exception>
+        /// <exception cref="InvalidOperationException"><paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
         public ExcelEnumerable<T, IExcelSheet, IExcelRowEnumerator> Parse(IExcelSheet sheet)
         {
             ArgumentNullException.ThrowIfNull(sheet);
+            ExcelTableSheet.ThrowIfHeaderless(sheet);
             return new ExcelEnumerable<T, IExcelSheet, IExcelRowEnumerator>(sheet, _config, _info());
         }
 
diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index dccf0847..c435bb66 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -4,6 +4,7 @@
 using ExcelReader.Core.Crypto;
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Schema;
 using ExcelReader.Core.Reader.Sources;
 using ExcelReader.Core.Reader.Xls;
@@ -279,6 +280,7 @@ public static async ValueTask<CsvReader> FromCsvAsync(Stream stream, bool leaveO
         /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative, or
         /// <paramref name="sampleSize"/> is not positive.</exception>
         /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
+        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
         public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow, int sampleSize)
         {
             return InferSchema(sheet, headerRow, sampleSize, parseText: false);
@@ -304,9 +306,15 @@ public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow,
         /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative, or
         /// <paramref name="sampleSize"/> is not positive.</exception>
         /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
+        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
         public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow = 1, int sampleSize = 100, bool parseText = false)
         {
             ArgumentNullException.ThrowIfNull(sheet);
+            if (headerRow > 0)
+            {
+                ExcelTableSheet.ThrowIfHeaderless(sheet);
+            }
+
             using IExcelRowEnumerator rows = sheet.GetEnumerator();
             return SchemaInference.Infer(rows, sheet.IsDate1904, headerRow, sampleSize, parseText);
         }
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReader.cs b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
index 597c043a..67813b91 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReader.cs
+++ b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
@@ -4,6 +4,7 @@
 using System.Globalization;
 using System.Runtime.CompilerServices;
 using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Reader.Schema;
 
 namespace ExcelReader.Core.Reader
@@ -49,10 +50,16 @@ public sealed class ExcelDataReader : IDataReader
         /// </param>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is null.</exception>
         /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative.</exception>
+        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
         public ExcelDataReader(IExcelSheet sheet, int headerRow = 1)
         {
             ArgumentNullException.ThrowIfNull(sheet);
             ArgumentOutOfRangeException.ThrowIfNegative(headerRow);
+            if (headerRow > 0)
+            {
+                ExcelTableSheet.ThrowIfHeaderless(sheet);
+            }
+
             _isDate1904 = sheet.IsDate1904;
             _sheetName = sheet.Name;
             _rows = sheet.GetEnumerator();
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
new file mode 100644
index 00000000..8df8d8c6
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
@@ -0,0 +1,101 @@
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Tests.Reader.Tables
+{
+    public class TableBindingTests
+    {
+        private sealed class SalesRow
+        {
+            public string? Product { get; set; }
+
+            public int Qty { get; set; }
+
+            public double Price { get; set; }
+        }
+
+        private sealed class StockRow
+        {
+            public string? Product { get; set; }
+
+            public int Qty { get; set; }
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void SalesBindsItsDataRowsWithoutTheTotalsRow(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            List<SalesRow> rows = ExcelParser.FromAttributes<SalesRow>().Parse(Table(workbook, "Sales").AsSheet()).ToList();
+
+            Assert.Equal(
+                [("Pen", 10, 2.5), ("Notebook", 4, 18.9), ("Pencil", 25, 1.2)],
+                rows.Select(static r => (r.Product, r.Qty, r.Price)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void StockBindsItsOwnColumnsDespiteSharedHeaderNames(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            List<StockRow> rows = ExcelParser.FromAttributes<StockRow>().Parse(Table(workbook, "Stock").AsSheet()).ToList();
+
+            Assert.Equal([("Pen", 100), ("Notebook", 40), ("Pencil", 250)], rows.Select(static r => (r.Product, r.Qty)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public async Task StockBindsAsynchronouslyOverAStream(string file)
+        {
+            await using IExcelWorkbook workbook = await Excel.OpenAsync(
+                File.OpenRead(TableMetadataTests.FixturePath(file)), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+            List<StockRow> rows = [];
+
+            await foreach (StockRow row in ExcelParser.FromAttributes<StockRow>().Parse(Table(workbook, "Stock").AsSheet())
+                .WithCancellation(TestContext.Current.CancellationToken))
+            {
+                rows.Add(row);
+            }
+
+            Assert.Equal([("Pen", 100), ("Notebook", 40), ("Pencil", 250)], rows.Select(static r => (r.Product, r.Qty)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void HeaderlessTableRejectsBindingByName(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            IExcelSheet view = Table(workbook, "NoHeader").AsSheet();
+
+            Assert.Throws<InvalidOperationException>(() => ExcelParser.FromAttributes<StockRow>().Parse(view));
+            Assert.Throws<InvalidOperationException>(() => new ExcelDataReader(view));
+            Assert.Throws<InvalidOperationException>(() => Excel.InferSchema(view));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void HeaderlessTableReadsWithoutAHeader(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            IExcelSheet view = Table(workbook, "NoHeader").AsSheet();
+
+            using ExcelDataReader reader = new(view, headerRow: 0);
+            List<string> letters = [];
+            while (reader.Read())
+            {
+                letters.Add(reader.GetString(0));
+            }
+
+            Assert.Equal(["a", "b", "c"], letters);
+            Assert.Equal(2, Excel.InferSchema(view, headerRow: 0).Length);
+        }
+
+        private static ExcelTable Table(IExcelWorkbook workbook, string name)
+        {
+            Assert.True(workbook.TryGetTable(name, out ExcelTable? table));
+            return table;
+        }
+    }
+}

From fac7938d357a08cf6ce13f8ce0fa4378596d9c7d Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Fri, 9 Oct 2026 21:13:30 -0300
Subject: [PATCH 048/115] test(fuzz): drain table views; docs: document reading
 Excel tables

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 docs/guide/reading.md                         |  27 ++++++++++++++++++
 tests/ExcelReader.Fuzz/Harnesses.cs           |   4 +++
 tests/ExcelReader.Fuzz/corpus/xlsb-tables.bin | Bin 0 -> 11349 bytes
 tests/ExcelReader.Fuzz/corpus/xlsx-tables.bin | Bin 0 -> 13489 bytes
 4 files changed, 31 insertions(+)
 create mode 100644 tests/ExcelReader.Fuzz/corpus/xlsb-tables.bin
 create mode 100644 tests/ExcelReader.Fuzz/corpus/xlsx-tables.bin

diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index ad838027..80527b9e 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -184,6 +184,33 @@ Detection covers the signed formats only. To open a source whose format you alre
 using IExcelWorkbook workbook = Excel.Open("report.csv", ExcelFileFormat.Csv);
 ```
 
+## Read an Excel table
+
+A workbook's tables (ranges formatted with **Format as Table**) are listed on `Tables`, ordered by sheet
+and creation, and found by name with `TryGetTable`, ignoring case. XLSX/XLSM and XLSB report them; XLS
+and CSV always report none. `AsSheet()` reads only the table: its header row first, then its data rows
+without the totals row, each cut to the table's columns, so it plugs into anything that takes a sheet.
+
+```csharp
+using IExcelWorkbook workbook = Excel.Open("sales.xlsx");
+if (workbook.TryGetTable("Sales", out ExcelTable? sales))
+{
+    foreach (SaleRow row in ExcelParser.FromAttributes<SaleRow>().Parse(sales.AsSheet()))
+    {
+        Console.WriteLine($"{row.Product}: {row.Qty}");
+    }
+}
+```
+
+- `FirstRow`, `FirstColumn`, `LastRow` and `LastColumn` are zero-based and include the header and totals
+  rows; `Ref` is the same range in A1 notation.
+- Column indexes inside `AsSheet()` stay those of the sheet: a table starting at column C reports its
+  first cell at index 2.
+- A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but binding by name
+  throws `InvalidOperationException`. Read it with `new ExcelDataReader(table.AsSheet(), headerRow: 0)`
+  or by column index.
+- `StyleName` is the table style's name, such as `TableStyleMedium2`, or `null` when the table has none.
+
 ## Reading sheets in parallel
 
 Each sheet of a workbook can be read on its own thread:
diff --git a/tests/ExcelReader.Fuzz/Harnesses.cs b/tests/ExcelReader.Fuzz/Harnesses.cs
index 8dd070fb..4e73c04e 100644
--- a/tests/ExcelReader.Fuzz/Harnesses.cs
+++ b/tests/ExcelReader.Fuzz/Harnesses.cs
@@ -479,6 +479,10 @@ private static void DrainAllSheets(IExcelWorkbook reader)
             {
                 DrainRows(reader.SheetAt(i));
             }
+            foreach (ExcelTable table in reader.Tables)
+            {
+                DrainRows(table.AsSheet());
+            }
         }
 
         private static void DrainRows(IExcelSheet reader)
diff --git a/tests/ExcelReader.Fuzz/corpus/xlsb-tables.bin b/tests/ExcelReader.Fuzz/corpus/xlsb-tables.bin
new file mode 100644
index 0000000000000000000000000000000000000000..de4e2719f3c598e9ac8cd2f2a62182c6d0ecc988
GIT binary patch
literal 11349
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
HyT$(ir2S!^

literal 0
HcmV?d00001

diff --git a/tests/ExcelReader.Fuzz/corpus/xlsx-tables.bin b/tests/ExcelReader.Fuzz/corpus/xlsx-tables.bin
new file mode 100644
index 0000000000000000000000000000000000000000..a2452dbfbcececd1354154d9f02593d7a1b19d1a
GIT binary patch
literal 13489
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
YNfr{g7l44E0AJ-mN$lhgsRQKy0IpnRWB>pF

literal 0
HcmV?d00001


From 1393c4ca5542cdeee8d92268df9cf99142a5ea72 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:10:58 -0300
Subject: [PATCH 049/115] fix(reader): map table view columns from the table's
 first column

ExcelDataReader ordinals start at the table's first column; InferSchema
drops columns left of it but keeps absolute indexes, so Arrow emits only
the table's fields.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Excel.cs          |  2 +-
 .../Reader/ExcelDataReader.cs                 | 14 +++---
 .../Reader/Internal/ExcelTableSheet.cs        |  5 +++
 .../Reader/Schema/SchemaInference.cs          |  9 ++--
 .../Arrow/ArrowConversionTests.cs             | 15 +++++++
 .../Reader/Tables/TableBindingTests.cs        | 43 +++++++++++++++++++
 6 files changed, 77 insertions(+), 11 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index c435bb66..81afedbd 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -316,7 +316,7 @@ public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow =
             }
 
             using IExcelRowEnumerator rows = sheet.GetEnumerator();
-            return SchemaInference.Infer(rows, sheet.IsDate1904, headerRow, sampleSize, parseText);
+            return SchemaInference.Infer(rows, sheet.IsDate1904, headerRow, sampleSize, parseText, ExcelTableSheet.FirstColumnOf(sheet));
         }
 
         private static ReadOnlySpan<byte> ZipSignature => [0x50, 0x4B, 0x03, 0x04];
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReader.cs b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
index 67813b91..ca877c92 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReader.cs
+++ b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
@@ -33,6 +33,7 @@ public sealed class ExcelDataReader : IDataReader
         private readonly IExcelRowEnumerator _rows;
         private readonly bool _isDate1904;
         private readonly string _sheetName;
+        private readonly int _firstColumn;
         private readonly string?[] _names;
         private readonly Dictionary<string, int> _ordinals;
         private readonly bool _hasPendingRow;
@@ -62,13 +63,14 @@ public ExcelDataReader(IExcelSheet sheet, int headerRow = 1)
 
             _isDate1904 = sheet.IsDate1904;
             _sheetName = sheet.Name;
+            _firstColumn = ExcelTableSheet.FirstColumnOf(sheet);
             _rows = sheet.GetEnumerator();
             _pendingConsumed = true;
             try
             {
                 if (headerRow > 0 && SchemaInference.TrySkipToHeaderRow(_rows, headerRow, out _))
                 {
-                    _names = ReadHeaderNames(_rows.Current);
+                    _names = ReadHeaderNames(_rows.Current, _firstColumn);
                 }
                 else if (headerRow > 0)
                 {
@@ -78,7 +80,7 @@ public ExcelDataReader(IExcelSheet sheet, int headerRow = 1)
                 {
                     _hasPendingRow = _rows.MoveNext();
                     _pendingConsumed = false;
-                    _names = _hasPendingRow ? new string?[_rows.Current.ColumnCount] : [];
+                    _names = _hasPendingRow ? new string?[Math.Max(0, _rows.Current.ColumnCount - _firstColumn)] : [];
                 }
                 _ordinals = BuildOrdinals(_names);
             }
@@ -89,13 +91,13 @@ public ExcelDataReader(IExcelSheet sheet, int headerRow = 1)
             }
         }
 
-        private static string?[] ReadHeaderNames(Row header)
+        private static string?[] ReadHeaderNames(Row header, int firstColumn)
         {
-            string?[] names = new string?[header.ColumnCount];
+            string?[] names = new string?[Math.Max(0, header.ColumnCount - firstColumn)];
             foreach (RowCell cell in header.Cells)
             {
                 string text = cell.Value.GetString().Trim();
-                names[cell.ColumnIndex] = text.Length == 0 ? null : text;
+                names[cell.ColumnIndex - firstColumn] = text.Length == 0 ? null : text;
             }
             return names;
         }
@@ -431,7 +433,7 @@ private Cell CurrentCell(int i)
             {
                 throw new InvalidOperationException("No current row; call Read() first.");
             }
-            return _rows.Current[i];
+            return _rows.Current[_firstColumn + i];
         }
 
         private T GetParsed<T>(int i) where T : struct, IUtf8SpanParsable<T>
diff --git a/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs b/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
index 94b86fec..6a7d80ef 100644
--- a/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
+++ b/src/ExcelReader.Core/Reader/Internal/ExcelTableSheet.cs
@@ -60,6 +60,11 @@ internal static void ThrowIfHeaderless(IExcelSheet sheet)
             }
         }
 
+        internal static int FirstColumnOf(IExcelSheet sheet)
+        {
+            return sheet is ExcelTableSheet view ? view._table.FirstColumn : 0;
+        }
+
         private TableRowEnumerator Bound(IExcelRowEnumerator rows)
         {
             return new TableRowEnumerator(rows, _table.FirstRow, _table.LastRow - _table.TotalsRowCount, _table.FirstColumn, _table.LastColumn);
diff --git a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
index fd54b2d7..1d31b075 100644
--- a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
+++ b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
@@ -28,7 +28,8 @@ internal static class SchemaInference
         /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative, or
         /// <paramref name="sampleSize"/> is not positive.</exception>
         /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
-        internal static ExcelColumnSchema[] Infer(IExcelRowEnumerator rows, bool isDate1904, int headerRow, int sampleSize, bool parseText = false)
+        /// <param name="firstColumn">Columns before this index are left out of the result; the remaining entries keep their absolute <see cref="ExcelColumnSchema.Index"/>.</param>
+        internal static ExcelColumnSchema[] Infer(IExcelRowEnumerator rows, bool isDate1904, int headerRow, int sampleSize, bool parseText = false, int firstColumn = 0)
         {
             ArgumentOutOfRangeException.ThrowIfNegative(headerRow);
             ArgumentOutOfRangeException.ThrowIfNegativeOrZero(sampleSize);
@@ -40,10 +41,10 @@ internal static ExcelColumnSchema[] Infer(IExcelRowEnumerator rows, bool isDate1
             }
             int dataRowCount = SampleDataRows(rows, sampleSize, isDate1904, parseText, names, stats);
             MarkSparseColumnsNullable(CollectionsMarshal.AsSpan(stats), dataRowCount);
-            ExcelColumnSchema[] schema = new ExcelColumnSchema[names.Count];
-            for (int i = 0; i < schema.Length; i++)
+            ExcelColumnSchema[] schema = new ExcelColumnSchema[Math.Max(0, names.Count - firstColumn)];
+            for (int i = firstColumn; i < names.Count; i++)
             {
-                schema[i] = new ExcelColumnSchema
+                schema[i - firstColumn] = new ExcelColumnSchema
                 {
                     Index = i,
                     Name = names[i],
diff --git a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
index f8b39ab7..73737873 100644
--- a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
+++ b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
@@ -9,11 +9,26 @@
 using ExcelReader.Native.Arrow;
 using ExcelReader.Native.Reading;
 using ExcelReader.Tests.Native;
+using ExcelReader.Tests.Reader.Tables;
 
 namespace ExcelReader.Tests.Arrow
 {
     public sealed class ArrowConversionTests
     {
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void ToArrowRecordBatch_Should_Emit_Only_The_Table_Columns(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            Assert.True(workbook.TryGetTable("Sales", out ExcelTable? table));
+
+            RecordBatch batch = table.AsSheet().ToArrowRecordBatch();
+
+            Assert.Equal(("Product", "Qty", "Price"), (batch.Schema.GetFieldByIndex(0).Name, batch.Schema.GetFieldByIndex(1).Name, batch.Schema.GetFieldByIndex(2).Name));
+            Assert.Equal((3, 3), (batch.ColumnCount, batch.Length));
+            Assert.Equal("Pen", Assert.IsType<StringArray>(batch.Column(0)).GetString(0));
+        }
+
         [Fact]
         public void ToArrowRecordBatch_Should_Convert_String_And_Int64_Columns()
         {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
index 8df8d8c6..725d0d49 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
@@ -1,5 +1,6 @@
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Schema;
 
 namespace ExcelReader.Tests.Reader.Tables
 {
@@ -92,6 +93,48 @@ public void HeaderlessTableReadsWithoutAHeader(string file)
             Assert.Equal(2, Excel.InferSchema(view, headerRow: 0).Length);
         }
 
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void DataReaderOrdinalsStartAtTheTableFirstColumn(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            using ExcelDataReader reader = new(Table(workbook, "Sales").AsSheet());
+            Assert.True(reader.Read());
+
+            Assert.Equal(3, reader.FieldCount);
+            Assert.Equal(("Product", "Qty", "Price"), (reader.GetName(0), reader.GetName(1), reader.GetName(2)));
+            Assert.Equal(1, reader.GetOrdinal("Qty"));
+            Assert.Equal(("Pen", 10.0, 2.5), ((string)reader.GetValue(0), (double)reader.GetValue(1), (double)reader.GetValue(2)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void DataReaderOrdinalsLineUpWithOrWithoutAHeaderRow(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            IExcelSheet view = Table(workbook, "NoStyle").AsSheet();
+
+            using ExcelDataReader named = new(view, headerRow: 1);
+            Assert.True(named.Read());
+            using ExcelDataReader unnamed = new(view, headerRow: 0);
+            Assert.True(unnamed.Read());
+
+            Assert.Equal((2, "Name", "Value", "x"), (named.FieldCount, named.GetName(0), named.GetName(1), named.GetString(0)));
+            Assert.Equal((2, "Column0", "Name"), (unnamed.FieldCount, unnamed.GetName(0), unnamed.GetString(0)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public void InferSchemaDropsColumnsLeftOfTheTableAndKeepsAbsoluteIndexes(string file)
+        {
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+
+            ExcelColumnSchema[] schema = Excel.InferSchema(Table(workbook, "Sales").AsSheet());
+
+            Assert.Equal([("Product", 2), ("Qty", 3), ("Price", 4)], schema.Select(static c => (c.Name, c.Index)));
+        }
+
         private static ExcelTable Table(IExcelWorkbook workbook, string name)
         {
             Assert.True(workbook.TryGetTable(name, out ExcelTable? table));

From 325784bfb7376819c7a7207b0be505d581aa740f Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:10:58 -0300
Subject: [PATCH 050/115] fix(reader): reject malformed row numbers in table
 views

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Internal/TableRowEnumerator.cs     |  6 ++++
 .../Reader/ReaderLimitTests.cs                | 29 +++++++++++++++
 .../Reader/Tables/TableViewTests.cs           | 36 +++++++++++++++++++
 .../Reader/Tables/TableWorkbooks.cs           |  4 +--
 4 files changed, 73 insertions(+), 2 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs b/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
index 7ffc7430..b7fde64f 100644
--- a/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
+++ b/src/ExcelReader.Core/Reader/Internal/TableRowEnumerator.cs
@@ -8,6 +8,7 @@ internal sealed class TableRowEnumerator : IExcelRowEnumerator
         private readonly int _lastDataRow;
         private readonly int _firstColumn;
         private readonly int _lastColumn;
+        private int _previousRow = -1;
         private bool _done;
 
         internal TableRowEnumerator(IExcelRowEnumerator rows, int firstRow, int lastDataRow, int firstColumn, int lastColumn)
@@ -68,6 +69,11 @@ public ValueTask DisposeAsync()
         private bool IsInTable()
         {
             int row = _indexed.RowIndex;
+            if (row < 0 || row >= ExcelLimits.MaxRows || row <= _previousRow)
+            {
+                throw new InvalidDataException($"Row index {row} is out of range or not after the previous row {_previousRow}.");
+            }
+            _previousRow = row;
             if (row > _lastDataRow)
             {
                 _done = true;
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index fb0265e7..0153e247 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -692,6 +692,35 @@ .. TableWorkbooks.ListColumn(1, "H"),
             Assert.Throws<InvalidDataException>(() => Excel.FromXlsb(ms));
         }
 
+        [Theory]
+        [InlineData(0xFFFFFFFFu)]
+        [InlineData(0u)]
+        public void XlsbTableOverMalformedRowNumbersThrowsInvalidData(uint badRow)
+        {
+            using MemoryStream ms = TableWorkbooks.Xlsb(
+                [.. TableWorkbooks.BeginList(0, 3, 0, 0, 1, 0, "T"), .. TableWorkbooks.ListColumn(1, "H")],
+                [
+                    .. B.Record(Brt.RowHdr, B.U32(0)),
+                    .. B.Record(Brt.CellSt, B.CellSt(0, 0, "H")),
+                    .. B.Record(Brt.RowHdr, B.U32(1)),
+                    .. B.Record(Brt.CellRk, B.CellRk(0, 0, (1u << 2) | 0x02)),
+                    .. B.Record(Brt.RowHdr, B.U32(badRow)),
+                    .. B.Record(Brt.CellRk, B.CellRk(0, 0, (2u << 2) | 0x02)),
+                    .. B.Record(Brt.RowHdr, B.U32(2)),
+                    .. B.Record(Brt.CellRk, B.CellRk(0, 0, (3u << 2) | 0x02)),
+                    .. B.Record(Brt.EndSheetData),
+                ]);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+            using IExcelRowEnumerator rows = Assert.Single(workbook.Tables).AsSheet().GetEnumerator();
+
+            Assert.Throws<InvalidDataException>(() =>
+            {
+                while (rows.MoveNext())
+                {
+                }
+            });
+        }
+
         [Fact]
         public async Task MalformedXlsbTableFromStreamingSourceThrowsInvalidData()
         {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs
index dc7d7990..c8081b55 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableViewTests.cs
@@ -94,6 +94,42 @@ public async Task BoundedRowsStopAtTheFirstRowPastTheTableAsync()
             Assert.Equal(6, rows.MoveNextCalls);
         }
 
+        public static TheoryData<int[]> MalformedRowIndexes { get; } = new()
+        {
+            new[] { 0, -1 },
+            new[] { 0, ExcelLimits.MaxRows },
+            new[] { 0, 2, 2 },
+            new[] { 0, 3, 2 },
+        };
+
+        [Theory]
+        [MemberData(nameof(MalformedRowIndexes))]
+        public void MalformedRowIndexThrowsInvalidData(int[] rowIndexes)
+        {
+            using TableRowEnumerator table = new(new FakeRows(rowIndexes), firstRow: 0, lastDataRow: 10, firstColumn: 0, lastColumn: 0);
+
+            Assert.Throws<InvalidDataException>(() =>
+            {
+                while (table.MoveNext())
+                {
+                }
+            });
+        }
+
+        [Theory]
+        [MemberData(nameof(MalformedRowIndexes))]
+        public async Task MalformedRowIndexThrowsInvalidDataAsync(int[] rowIndexes)
+        {
+            await using TableRowEnumerator table = new(new FakeRows(rowIndexes), firstRow: 0, lastDataRow: 10, firstColumn: 0, lastColumn: 0);
+
+            await Assert.ThrowsAsync<InvalidDataException>(async () =>
+            {
+                while (await table.MoveNextAsync())
+                {
+                }
+            });
+        }
+
         [Fact]
         public void DisposingTheViewDisposesTheSheetEnumerator()
         {
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
index 9996ddca..5ae6543c 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableWorkbooks.cs
@@ -24,7 +24,7 @@ internal static string Table(string reference, string columns, string attributes
             return $"""<table xmlns="{Main}" id="1" name="T" displayName="T" ref="{reference}"{attributes}><tableColumns>{columns}</tableColumns></table>""";
         }
 
-        internal static MemoryStream Xlsb(byte[] tableBin)
+        internal static MemoryStream Xlsb(byte[] tableBin, byte[]? sheetBin = null)
         {
             MemoryStream ms = new();
             using (var zip = new ZipArchive(ms, ZipArchiveMode.Create, leaveOpen: true))
@@ -34,7 +34,7 @@ internal static MemoryStream Xlsb(byte[] tableBin)
                     """<Relationships><Relationship Id="rId1" Target="worksheets/sheet1.bin"/></Relationships>"""));
                 Add(zip, "xl/styles.bin", []);
                 Add(zip, "xl/sharedStrings.bin", []);
-                Add(zip, "xl/worksheets/sheet1.bin",
+                Add(zip, "xl/worksheets/sheet1.bin", sheetBin ??
                 [
                     .. B.Record(Brt.RowHdr, B.U32(0)),
                     .. B.Record(Brt.CellSt, B.CellSt(0, 0, "H")),

From addef340eaa4d2e84c43355b95cedd9f1880a945 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:10:58 -0300
Subject: [PATCH 051/115] docs: clarify headerless-table and column-index rules
 for table views

Also block-bodies the Tables property in the native test wrapper.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/guide/reading.md                               | 13 ++++++++-----
 .../Native/NativeApiTests.Reading.cs                | 10 +++++++++-
 2 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index 80527b9e..eec0e114 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -204,11 +204,14 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
 
 - `FirstRow`, `FirstColumn`, `LastRow` and `LastColumn` are zero-based and include the header and totals
   rows; `Ref` is the same range in A1 notation.
-- Column indexes inside `AsSheet()` stay those of the sheet: a table starting at column C reports its
-  first cell at index 2.
-- A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but binding by name
-  throws `InvalidOperationException`. Read it with `new ExcelDataReader(table.AsSheet(), headerRow: 0)`
-  or by column index.
+- Column indexes inside `AsSheet()` rows stay those of the sheet: a table starting at column C reports
+  its first cell at index 2. `Excel.InferSchema` keeps those indexes in `ExcelColumnSchema.Index` but
+  lists only the table's columns. `ExcelDataReader` ordinals are relative to the table: ordinal 0 is
+  its first column.
+- A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but `Parse` throws
+  `InvalidOperationException` for every map, and `ExcelDataReader` and `InferSchema` throw it when
+  `headerRow` is greater than 0. Read it with `new ExcelDataReader(table.AsSheet(), headerRow: 0)`,
+  `Excel.InferSchema(table.AsSheet(), headerRow: 0)`, or by column index on the rows.
 - `StyleName` is the table style's name, such as `TableStyleMedium2`, or `null` when the table has none.
 
 ## Reading sheets in parallel
diff --git a/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs b/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
index c329bd7d..90af0fc3 100644
--- a/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
+++ b/tests/ExcelReader.Tests/Native/NativeApiTests.Reading.cs
@@ -136,7 +136,15 @@ public bool TryGetSheet(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out IExc
                 sheet = null;
                 return false;
             }
-            public IReadOnlyList<ExcelTable> Tables => inner.Tables;
+
+            public IReadOnlyList<ExcelTable> Tables
+            {
+                get
+                {
+                    return inner.Tables;
+                }
+            }
+
             public bool TryGetTable(ReadOnlySpan<char> name, [MaybeNullWhen(false)] out ExcelTable table)
             {
                 return inner.TryGetTable(name, out table);

From cf27e69086ede905b3aa6e62eee7911805fdec3a Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:19:39 -0300
Subject: [PATCH 052/115] fix(reader): keep XLSX rows whose open tag straddles
 an async refill

When BeginRowAsync suspended (the <row ...> tag crossed a buffer refill on a truly async read), ReadRowAsync awaited it and restarted MoveNextAsync. BeginRowAt had already moved past the tag, so the restart treated the row's cells as markup and silently dropped the row. Continue with the row body instead, as the sync twin does.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |  15 +-
 .../Reader/Xlsx/XlsxAsyncRowBoundaryTests.cs  | 175 ++++++++++++++++++
 2 files changed, 189 insertions(+), 1 deletion(-)
 create mode 100644 tests/ExcelReader.Tests/Reader/Xlsx/XlsxAsyncRowBoundaryTests.cs

diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 6f698c33..eef45f84 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -178,13 +178,26 @@ private ValueTask<bool> ReadRowAsync()
                 ValueTask<bool> beginTask = BeginRowAsync();
                 if (!beginTask.IsCompletedSuccessfully)
                 {
-                    return AwaitThenRestartAsync(beginTask);
+                    return ReadRowBodyAfterAsync(beginTask);
                 }
                 if (beginTask.Result)
                 {
                     return new ValueTask<bool>(true);
                 }
+                return ReadRowBodyAsync();
+            }
 
+            private async ValueTask<bool> ReadRowBodyAfterAsync(ValueTask<bool> beginTask)
+            {
+                if (await beginTask.ConfigureAwait(false))
+                {
+                    return true;
+                }
+                return await ReadRowBodyAsync().ConfigureAwait(false);
+            }
+
+            private ValueTask<bool> ReadRowBodyAsync()
+            {
                 int rowStart = _pos;
                 if (ParseRowInWindow())
                 {
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/XlsxAsyncRowBoundaryTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxAsyncRowBoundaryTests.cs
new file mode 100644
index 00000000..09a78e19
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxAsyncRowBoundaryTests.cs
@@ -0,0 +1,175 @@
+using System.Globalization;
+using System.IO.Compression;
+using System.Text;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Tests.Reader.Xlsx
+{
+    public class XlsxAsyncRowBoundaryTests
+    {
+        private const int RowCount = 4_000;
+
+        private sealed class YieldingStream(byte[] bytes) : Stream
+        {
+            private const int MaxPerRead = 4096;
+
+            private long _position;
+
+            public override bool CanRead
+            {
+                get
+                {
+                    return true;
+                }
+            }
+
+            public override bool CanSeek
+            {
+                get
+                {
+                    return true;
+                }
+            }
+
+            public override bool CanWrite
+            {
+                get
+                {
+                    return false;
+                }
+            }
+
+            public override long Length
+            {
+                get
+                {
+                    return bytes.Length;
+                }
+            }
+
+            public override long Position
+            {
+                get
+                {
+                    return _position;
+                }
+                set
+                {
+                    _position = value;
+                }
+            }
+
+            public override int Read(byte[] buffer, int offset, int count)
+            {
+                return Read(buffer.AsSpan(offset, count));
+            }
+
+            public override int Read(Span<byte> buffer)
+            {
+                int available = (int)Math.Max(0, Math.Min(bytes.Length - _position, Math.Min(buffer.Length, MaxPerRead)));
+                bytes.AsSpan((int)_position, available).CopyTo(buffer);
+                _position += available;
+                return available;
+            }
+
+            public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+            {
+                await Task.Yield();
+                return Read(buffer.Span);
+            }
+
+            public override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+            {
+                return ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();
+            }
+
+            public override long Seek(long offset, SeekOrigin origin)
+            {
+                _position = origin switch
+                {
+                    SeekOrigin.Begin => offset,
+                    SeekOrigin.Current => _position + offset,
+                    _ => bytes.Length + offset,
+                };
+                return _position;
+            }
+
+            public override void Flush()
+            {
+            }
+
+            public override void SetLength(long value)
+            {
+                throw new NotSupportedException();
+            }
+
+            public override void Write(byte[] buffer, int offset, int count)
+            {
+                throw new NotSupportedException();
+            }
+        }
+
+        [Fact]
+        public async Task AsyncReadKeepsRowsWhoseOpenTagStraddlesARefill()
+        {
+            byte[] bytes = BuildWideRowTagWorkbook();
+            string[] expected = [.. Enumerable.Range(1, RowCount).Select(static i => i.ToString(CultureInfo.InvariantCulture))];
+
+            await using XlsxWorkbook workbook = await Excel.FromXlsxAsync(
+                new YieldingStream(bytes), leaveOpen: false, ct: TestContext.Current.CancellationToken);
+            List<string> values = [];
+            await using (XlsxWorkbook.Enumerator rows = workbook.FirstSheet.GetAsyncEnumerator(TestContext.Current.CancellationToken))
+            {
+                while (await rows.MoveNextAsync())
+                {
+                    values.Add(rows.Current[0].GetString());
+                }
+            }
+
+            Assert.Equal(expected, values, StringComparer.Ordinal);
+            Assert.Equal(expected, ReadSync(bytes), StringComparer.Ordinal);
+        }
+
+        private static List<string> ReadSync(byte[] bytes)
+        {
+            using XlsxWorkbook workbook = Excel.FromXlsx(new YieldingStream(bytes), leaveOpen: false);
+            using XlsxWorkbook.Enumerator rows = workbook.FirstSheet.GetEnumerator();
+            List<string> values = [];
+            while (rows.MoveNext())
+            {
+                values.Add(rows.Current[0].GetString());
+            }
+            return values;
+        }
+
+        private static byte[] BuildWideRowTagWorkbook()
+        {
+            string padding = new('p', 400);
+            StringBuilder rows = new();
+            for (int i = 1; i <= RowCount; i++)
+            {
+                rows.Append(CultureInfo.InvariantCulture,
+                    $"""<row r="{i}" spans="1:1" pad="{padding}"><c r="A{i}"><v>{i}</v></c></row>""");
+            }
+            using MemoryStream compressed = WorkbookBuilder.Build(rows.ToString());
+            return Stored(compressed);
+        }
+
+        private static byte[] Stored(MemoryStream compressed)
+        {
+            using MemoryStream stored = new();
+            using (ZipArchive source = new(compressed, ZipArchiveMode.Read))
+            using (ZipArchive target = new(stored, ZipArchiveMode.Create, leaveOpen: true))
+            {
+                foreach (ZipArchiveEntry entry in source.Entries)
+                {
+                    using Stream from = entry.Open();
+                    using Stream to = target.CreateEntry(entry.FullName, CompressionLevel.NoCompression).Open();
+                    from.CopyTo(to);
+                }
+            }
+            return stored.ToArray();
+        }
+    }
+}

From 4a4519cb12fe25a80df2560a5e255d851f8b4239 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:47:48 -0300
Subject: [PATCH 053/115] feat(writer): add table options, validation and
 tracking

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../PublicAPI/PublicAPI.Unshipped.txt         |  26 +++
 .../Writer/ExcelTableOptions.cs               |  31 ++++
 .../Writer/ITableSheetWriter.cs               |  39 ++++
 .../Writer/Internal/TablePackage.cs           |  29 +++
 .../Writer/Internal/TableRegistry.cs          |  23 +++
 .../Writer/Internal/TableTracker.cs           |  72 ++++++++
 .../Writer/Internal/TableValidation.cs        | 156 ++++++++++++++++
 .../Writer/Internal/WrittenTable.cs           |  31 ++++
 .../Writer/Tables/TableValidationTests.cs     | 172 ++++++++++++++++++
 9 files changed, 579 insertions(+)
 create mode 100644 src/ExcelReader.Core/Writer/ExcelTableOptions.cs
 create mode 100644 src/ExcelReader.Core/Writer/ITableSheetWriter.cs
 create mode 100644 src/ExcelReader.Core/Writer/Internal/TablePackage.cs
 create mode 100644 src/ExcelReader.Core/Writer/Internal/TableRegistry.cs
 create mode 100644 src/ExcelReader.Core/Writer/Internal/TableTracker.cs
 create mode 100644 src/ExcelReader.Core/Writer/Internal/TableValidation.cs
 create mode 100644 src/ExcelReader.Core/Writer/Internal/WrittenTable.cs
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/TableValidationTests.cs

diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 7a138ce2..69242acc 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -22,3 +22,29 @@ ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.TryGetTable(System.ReadOnlySpan<char>
 ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Tables.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.ExcelTable!>!
 ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.TryGetTable(System.ReadOnlySpan<char> name, out ExcelReader.Core.Reader.ExcelTable! table) -> bool
 ExcelReader.Core.Reader.ExcelTable.AsSheet() -> ExcelReader.Core.Reader.IExcelSheet!
+ExcelReader.Core.Writer.ExcelTableOptions
+ExcelReader.Core.Writer.ExcelTableOptions.<Clone>$() -> ExcelReader.Core.Writer.ExcelTableOptions!
+ExcelReader.Core.Writer.ExcelTableOptions.Equals(ExcelReader.Core.Writer.ExcelTableOptions? other) -> bool
+ExcelReader.Core.Writer.ExcelTableOptions.ExcelTableOptions() -> void
+ExcelReader.Core.Writer.ExcelTableOptions.FirstColumn.get -> int
+ExcelReader.Core.Writer.ExcelTableOptions.FirstColumn.init -> void
+ExcelReader.Core.Writer.ExcelTableOptions.ShowColumnStripes.get -> bool
+ExcelReader.Core.Writer.ExcelTableOptions.ShowColumnStripes.init -> void
+ExcelReader.Core.Writer.ExcelTableOptions.ShowFirstColumn.get -> bool
+ExcelReader.Core.Writer.ExcelTableOptions.ShowFirstColumn.init -> void
+ExcelReader.Core.Writer.ExcelTableOptions.ShowLastColumn.get -> bool
+ExcelReader.Core.Writer.ExcelTableOptions.ShowLastColumn.init -> void
+ExcelReader.Core.Writer.ExcelTableOptions.ShowRowStripes.get -> bool
+ExcelReader.Core.Writer.ExcelTableOptions.ShowRowStripes.init -> void
+ExcelReader.Core.Writer.ExcelTableOptions.StyleName.get -> string?
+ExcelReader.Core.Writer.ExcelTableOptions.StyleName.init -> void
+ExcelReader.Core.Writer.ITableSheetWriter<TRow>
+ExcelReader.Core.Writer.ITableSheetWriter<TRow>.BeginTable(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null) -> void
+ExcelReader.Core.Writer.ITableSheetWriter<TRow>.BeginTableAsync(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Writer.ITableSheetWriter<TRow>.EndTable() -> void
+override ExcelReader.Core.Writer.ExcelTableOptions.Equals(object? obj) -> bool
+override ExcelReader.Core.Writer.ExcelTableOptions.GetHashCode() -> int
+override ExcelReader.Core.Writer.ExcelTableOptions.ToString() -> string!
+static ExcelReader.Core.Writer.ExcelTableOptions.Default.get -> ExcelReader.Core.Writer.ExcelTableOptions!
+static ExcelReader.Core.Writer.ExcelTableOptions.operator !=(ExcelReader.Core.Writer.ExcelTableOptions? left, ExcelReader.Core.Writer.ExcelTableOptions? right) -> bool
+static ExcelReader.Core.Writer.ExcelTableOptions.operator ==(ExcelReader.Core.Writer.ExcelTableOptions? left, ExcelReader.Core.Writer.ExcelTableOptions? right) -> bool
diff --git a/src/ExcelReader.Core/Writer/ExcelTableOptions.cs b/src/ExcelReader.Core/Writer/ExcelTableOptions.cs
new file mode 100644
index 00000000..ce4a4671
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/ExcelTableOptions.cs
@@ -0,0 +1,31 @@
+namespace ExcelReader.Core.Writer
+{
+    /// <summary>Configures an Excel table written with <see cref="ITableSheetWriter{TRow}.BeginTable"/>.</summary>
+    public sealed record ExcelTableOptions
+    {
+        /// <summary>The zero-based column of the table's first column. Defaults to 0 (column A).</summary>
+        /// <remarks>Rows written while the table is open must skip to this column themselves.</remarks>
+        public int FirstColumn { get; init; }
+
+        /// <summary>
+        /// The built-in table style: <c>TableStyleLight1</c>–<c>21</c>, <c>TableStyleMedium1</c>–<c>28</c> or
+        /// <c>TableStyleDark1</c>–<c>11</c>; <see langword="null"/> for no style. Defaults to <c>TableStyleMedium2</c>.
+        /// </summary>
+        public string? StyleName { get; init; } = "TableStyleMedium2";
+
+        /// <summary>Whether alternate rows are banded. Defaults to <see langword="true"/>.</summary>
+        public bool ShowRowStripes { get; init; } = true;
+
+        /// <summary>Whether alternate columns are banded. Defaults to <see langword="false"/>.</summary>
+        public bool ShowColumnStripes { get; init; }
+
+        /// <summary>Whether the first column gets the style's emphasis. Defaults to <see langword="false"/>.</summary>
+        public bool ShowFirstColumn { get; init; }
+
+        /// <summary>Whether the last column gets the style's emphasis. Defaults to <see langword="false"/>.</summary>
+        public bool ShowLastColumn { get; init; }
+
+        /// <summary>The default options: column A, <c>TableStyleMedium2</c>, banded rows.</summary>
+        public static ExcelTableOptions Default { get; } = new();
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/ITableSheetWriter.cs b/src/ExcelReader.Core/Writer/ITableSheetWriter.cs
new file mode 100644
index 00000000..ba4ee656
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/ITableSheetWriter.cs
@@ -0,0 +1,39 @@
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Core.Writer
+{
+    /// <summary>
+    /// A sheet writer that can write Excel tables (ranges formatted with "Format as Table"). Implemented by the
+    /// XLSX and XLSB sheet writers.
+    /// </summary>
+    /// <typeparam name="TRow">The concrete row writer type.</typeparam>
+    public interface ITableSheetWriter<TRow> : ISheetWriter<TRow>
+    {
+        /// <summary>
+        /// Writes a header row with <paramref name="columns"/> at the sheet's next row and opens a table there.
+        /// The table covers every row written until <see cref="EndTable"/> or the end of the sheet.
+        /// </summary>
+        /// <param name="name">The table name: unique in the workbook, ignoring case, and valid as an Excel name.</param>
+        /// <param name="columns">The column names, written as the header row.</param>
+        /// <param name="options">Position and style. Defaults to <see cref="ExcelTableOptions.Default"/>.</param>
+        /// <exception cref="ArgumentNullException"><paramref name="name"/> or <paramref name="columns"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentException">The name, a column name or the style is not valid, or the name is already used in this workbook.</exception>
+        /// <exception cref="ArgumentOutOfRangeException"><see cref="ExcelTableOptions.FirstColumn"/> is negative.</exception>
+        /// <exception cref="InvalidOperationException">A table is already open on this sheet, or a row is still active.</exception>
+        /// <exception cref="ObjectDisposedException">The sheet has already been ended.</exception>
+        /// <exception cref="ExcelLimitExceededException">The sheet has no room left for a header row and a data row.</exception>
+        void BeginTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null);
+
+        /// <inheritdoc cref="BeginTable"/>
+        /// <param name="name">The table name: unique in the workbook, ignoring case, and valid as an Excel name.</param>
+        /// <param name="columns">The column names, written as the header row.</param>
+        /// <param name="options">Position and style. Defaults to <see cref="ExcelTableOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel the header write.</param>
+        ValueTask BeginTableAsync(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null, CancellationToken ct = default);
+
+        /// <summary>Closes the open table at the last row written. Writes nothing; the table is stored when the sheet ends.</summary>
+        /// <exception cref="InvalidOperationException">No table is open on this sheet.</exception>
+        /// <exception cref="ObjectDisposedException">The sheet has already been ended.</exception>
+        void EndTable();
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Internal/TablePackage.cs b/src/ExcelReader.Core/Writer/Internal/TablePackage.cs
new file mode 100644
index 00000000..8d4c3e9a
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Internal/TablePackage.cs
@@ -0,0 +1,29 @@
+using System.Globalization;
+using System.Text;
+
+namespace ExcelReader.Core.Writer.Internal
+{
+    internal static class TablePackage
+    {
+        internal const string TableRelType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table";
+
+        internal static string RelationshipId(int index)
+        {
+            return string.Create(CultureInfo.InvariantCulture, $"rId{index + 1}");
+        }
+
+        internal static string SheetRelsXml(IReadOnlyList<WrittenTable> tables, string extension)
+        {
+            StringBuilder sb = new();
+            sb.Append("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>");
+            sb.Append(CultureInfo.InvariantCulture, $"<Relationships xmlns=\"{XlsxConstants.PackageRelationshipsNs}\">");
+            for (int i = 0; i < tables.Count; i++)
+            {
+                sb.Append(CultureInfo.InvariantCulture,
+                    $"<Relationship Id=\"{RelationshipId(i)}\" Type=\"{TableRelType}\" Target=\"../tables/table{tables[i].Id}.{extension}\"/>");
+            }
+            sb.Append("</Relationships>");
+            return sb.ToString();
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Internal/TableRegistry.cs b/src/ExcelReader.Core/Writer/Internal/TableRegistry.cs
new file mode 100644
index 00000000..6f26c2e2
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Internal/TableRegistry.cs
@@ -0,0 +1,23 @@
+namespace ExcelReader.Core.Writer.Internal
+{
+    internal sealed class TableRegistry
+    {
+        private readonly HashSet<string> _names = new(StringComparer.OrdinalIgnoreCase);
+        private int _nextId = 1;
+
+        internal void RequireAvailable(string name)
+        {
+            if (_names.Contains(name))
+            {
+                throw new ArgumentException($"A table named '{name}' already exists in this workbook.", nameof(name));
+            }
+        }
+
+        internal int Claim(string name)
+        {
+            RequireAvailable(name);
+            _names.Add(name);
+            return _nextId++;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Internal/TableTracker.cs b/src/ExcelReader.Core/Writer/Internal/TableTracker.cs
new file mode 100644
index 00000000..24ecf2ae
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Internal/TableTracker.cs
@@ -0,0 +1,72 @@
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Writer.Internal
+{
+    internal sealed class TableTracker
+    {
+        private readonly List<WrittenTable> _finished = [];
+        private WrittenTable? _open;
+
+        internal IReadOnlyList<WrittenTable> Finished
+        {
+            get
+            {
+                return _finished;
+            }
+        }
+
+        internal void RequireNoneOpen()
+        {
+            if (_open is not null)
+            {
+                throw new InvalidOperationException($"Table '{_open.Name}' is still open on this sheet; call EndTable first.");
+            }
+        }
+
+        internal void Begin(int id, string name, string[] columns, ExcelTableOptions options, int headerRow)
+        {
+            RequireNoneOpen();
+            _open = new WrittenTable(id, name, columns, options, headerRow, headerRow);
+        }
+
+        internal void End(int lastWrittenRow)
+        {
+            if (_open is null)
+            {
+                throw new InvalidOperationException("No table is open on this sheet.");
+            }
+            CloseOpen(lastWrittenRow);
+        }
+
+        internal void CloseOpen(int lastWrittenRow)
+        {
+            if (_open is null)
+            {
+                return;
+            }
+            _finished.Add(_open with { LastRow = Math.Max(lastWrittenRow, _open.HeaderRow + 1) });
+            _open = null;
+        }
+
+        internal static void RequireRoom(int nextRowIndex)
+        {
+            if (nextRowIndex > ExcelLimits.MaxRows - 2)
+            {
+                ExcelLimits.ThrowRowLimit(nextRowIndex + 2L);
+            }
+        }
+
+        internal static void WriteHeader<TRow>(TRow row, int firstColumn, string[] columns)
+            where TRow : IRowWriter
+        {
+            if (firstColumn > 0)
+            {
+                row.Skip(firstColumn);
+            }
+            foreach (string column in columns)
+            {
+                row.Write(column);
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Internal/TableValidation.cs b/src/ExcelReader.Core/Writer/Internal/TableValidation.cs
new file mode 100644
index 00000000..e36cfe0e
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Internal/TableValidation.cs
@@ -0,0 +1,156 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Writer.Internal
+{
+    internal static class TableValidation
+    {
+        private const int MaxNameLength = 255;
+
+        private static readonly HashSet<string> BuiltInStyles = BuildStyles();
+
+        internal static string[] Validate(string name, IReadOnlyList<string> columns, ExcelTableOptions options)
+        {
+            ValidateName(name);
+            ArgumentNullException.ThrowIfNull(options);
+            ArgumentOutOfRangeException.ThrowIfNegative(options.FirstColumn, nameof(options));
+            ValidateStyle(options);
+            return ValidateColumns(columns, options.FirstColumn);
+        }
+
+        private static void ValidateName(string name)
+        {
+            ArgumentNullException.ThrowIfNull(name);
+            if (name.Length is 0 or > MaxNameLength)
+            {
+                throw new ArgumentException("A table name must be 1 to 255 characters long.", nameof(name));
+            }
+            if (!IsNameStart(name[0]) || !HasOnlyNameCharacters(name.AsSpan(1)))
+            {
+                throw new ArgumentException(
+                    $"'{name}' is not a valid table name: it must start with a letter, '_' or '\\' and contain only letters, digits, '.' and '_'.",
+                    nameof(name));
+            }
+            if (IsA1Reference(name) || IsR1C1Reference(name))
+            {
+                throw new ArgumentException($"'{name}' is not a valid table name: Excel reads it as a cell reference.", nameof(name));
+            }
+        }
+
+        private static bool IsNameStart(char c)
+        {
+            return char.IsLetter(c) || c is '_' or '\\';
+        }
+
+        private static bool HasOnlyNameCharacters(ReadOnlySpan<char> rest)
+        {
+            foreach (char c in rest)
+            {
+                if (!char.IsLetterOrDigit(c) && c is not ('.' or '_'))
+                {
+                    return false;
+                }
+            }
+            return true;
+        }
+
+        private static bool IsA1Reference(string name)
+        {
+            string upper = name.ToUpperInvariant();
+            return Ascii.IsValid(upper) && TablePart.TryParseRange(Encoding.ASCII.GetBytes(upper), out _, out _, out _, out _);
+        }
+
+        private static bool IsR1C1Reference(string name)
+        {
+            string upper = name.ToUpperInvariant();
+            int i = 0;
+            bool marker = false;
+            if (i < upper.Length && upper[i] == 'R')
+            {
+                i = SkipDigits(upper, i + 1);
+                marker = true;
+            }
+            if (i < upper.Length && upper[i] == 'C')
+            {
+                i = SkipDigits(upper, i + 1);
+                marker = true;
+            }
+            return marker && i == upper.Length;
+        }
+
+        private static int SkipDigits(string text, int i)
+        {
+            while (i < text.Length && char.IsAsciiDigit(text[i]))
+            {
+                i++;
+            }
+            return i;
+        }
+
+        private static void ValidateStyle(ExcelTableOptions options)
+        {
+            string? styleName = options.StyleName;
+            if (styleName is null || BuiltInStyles.Contains(styleName))
+            {
+                return;
+            }
+            throw new ArgumentException(
+                $"'{styleName}' is not a built-in table style (TableStyleLight1-21, TableStyleMedium1-28, TableStyleDark1-11).",
+                nameof(options));
+        }
+
+        private static string[] ValidateColumns(IReadOnlyList<string> columns, int firstColumn)
+        {
+            ArgumentNullException.ThrowIfNull(columns);
+            if (columns.Count == 0)
+            {
+                throw new ArgumentException("A table needs at least one column.", nameof(columns));
+            }
+            if (columns.Count > ExcelLimits.MaxColumns - firstColumn)
+            {
+                throw new ArgumentException(
+                    $"A table starting at column {firstColumn} cannot have {columns.Count} columns: the sheet has {ExcelLimits.MaxColumns}.",
+                    nameof(columns));
+            }
+            string[] names = new string[columns.Count];
+            HashSet<string> seen = new(StringComparer.OrdinalIgnoreCase);
+            for (int i = 0; i < names.Length; i++)
+            {
+                names[i] = ValidateColumnName(columns, i);
+                if (!seen.Add(names[i]))
+                {
+                    throw new ArgumentException($"The column name '{names[i]}' appears more than once.", nameof(columns));
+                }
+            }
+            return names;
+        }
+
+        private static string ValidateColumnName(IReadOnlyList<string> columns, int index)
+        {
+            string? column = columns[index];
+            if (string.IsNullOrEmpty(column) || column.Length > MaxNameLength || column.AsSpan().ContainsAnyInRange('\0', '\u001F'))
+            {
+                throw new ArgumentException("Table column names must be 1 to 255 characters long, with no control characters.", nameof(columns));
+            }
+            return column;
+        }
+
+        private static HashSet<string> BuildStyles()
+        {
+            HashSet<string> styles = new(StringComparer.Ordinal);
+            AddStyles(styles, "TableStyleLight", 21);
+            AddStyles(styles, "TableStyleMedium", 28);
+            AddStyles(styles, "TableStyleDark", 11);
+            return styles;
+        }
+
+        private static void AddStyles(HashSet<string> styles, string prefix, int count)
+        {
+            for (int i = 1; i <= count; i++)
+            {
+                styles.Add(string.Create(CultureInfo.InvariantCulture, $"{prefix}{i}"));
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Internal/WrittenTable.cs b/src/ExcelReader.Core/Writer/Internal/WrittenTable.cs
new file mode 100644
index 00000000..eb942431
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Internal/WrittenTable.cs
@@ -0,0 +1,31 @@
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Writer.Internal
+{
+    internal sealed record WrittenTable(int Id, string Name, string[] Columns, ExcelTableOptions Options, int HeaderRow, int LastRow)
+    {
+        internal int FirstColumn
+        {
+            get
+            {
+                return Options.FirstColumn;
+            }
+        }
+
+        internal int LastColumn
+        {
+            get
+            {
+                return Options.FirstColumn + Columns.Length - 1;
+            }
+        }
+
+        internal string Ref
+        {
+            get
+            {
+                return TablePart.FormatRange(HeaderRow, FirstColumn, LastRow, LastColumn);
+            }
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableValidationTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableValidationTests.cs
new file mode 100644
index 00000000..8f48298f
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableValidationTests.cs
@@ -0,0 +1,172 @@
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Writer;
+using ExcelReader.Core.Writer.Internal;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    public class TableValidationTests
+    {
+        [Theory]
+        [InlineData("Sales")]
+        [InlineData("_private")]
+        [InlineData("\\back")]
+        [InlineData("Q1.Results_2026")]
+        [InlineData("Vendas")]
+        [InlineData("ABCD1")]
+        [InlineData("Ação")]
+        public void ValidNamesPass(string name)
+        {
+            string[] columns = TableValidation.Validate(name, ["A"], ExcelTableOptions.Default);
+
+            Assert.Equal(["A"], columns);
+        }
+
+        [Theory]
+        [InlineData("")]
+        [InlineData("1abc")]
+        [InlineData(".dot")]
+        [InlineData("has space")]
+        [InlineData("dash-name")]
+        [InlineData("A1")]
+        [InlineData("abc1")]
+        [InlineData("XFD1048576")]
+        [InlineData("R1C1")]
+        [InlineData("r")]
+        [InlineData("C")]
+        [InlineData("RC")]
+        [InlineData("R12")]
+        [InlineData("c3")]
+        public void InvalidNamesThrow(string name)
+        {
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate(name, ["A"], ExcelTableOptions.Default));
+        }
+
+        [Fact]
+        public void NullAndOverlongNamesThrow()
+        {
+            Assert.Throws<ArgumentNullException>(() => TableValidation.Validate(null!, ["A"], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate(new string('a', 256), ["A"], ExcelTableOptions.Default));
+            Assert.Equal(["A"], TableValidation.Validate(new string('a', 255), ["A"], ExcelTableOptions.Default));
+        }
+
+        [Fact]
+        public void InvalidColumnsThrow()
+        {
+            Assert.Throws<ArgumentNullException>(() => TableValidation.Validate("T", null!, ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", [], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", ["a", ""], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", ["a", null!], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", ["Qty", "qty"], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", ["a\nb"], ExcelTableOptions.Default));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", [new string('c', 256)], ExcelTableOptions.Default));
+        }
+
+        [Fact]
+        public void ColumnsMustFitTheSheet()
+        {
+            string[] two = ["a", "b"];
+
+            Assert.Equal(two, TableValidation.Validate("T", two, ExcelTableOptions.Default with { FirstColumn = 16382 }));
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", two, ExcelTableOptions.Default with { FirstColumn = 16383 }));
+            Assert.Throws<ArgumentOutOfRangeException>(() => TableValidation.Validate("T", two, ExcelTableOptions.Default with { FirstColumn = -1 }));
+        }
+
+        [Theory]
+        [InlineData("TableStyleLight1")]
+        [InlineData("TableStyleLight21")]
+        [InlineData("TableStyleMedium28")]
+        [InlineData("TableStyleDark11")]
+        [InlineData(null)]
+        public void BuiltInStylesPass(string? style)
+        {
+            Assert.Equal(["A"], TableValidation.Validate("T", ["A"], ExcelTableOptions.Default with { StyleName = style }));
+        }
+
+        [Theory]
+        [InlineData("TableStyleLight0")]
+        [InlineData("TableStyleLight22")]
+        [InlineData("TableStyleMedium29")]
+        [InlineData("TableStyleDark12")]
+        [InlineData("TableStyleLight01")]
+        [InlineData("tablestylelight1")]
+        [InlineData("MyStyle")]
+        [InlineData("")]
+        public void UnknownStylesThrow(string style)
+        {
+            Assert.Throws<ArgumentException>(() => TableValidation.Validate("T", ["A"], ExcelTableOptions.Default with { StyleName = style }));
+        }
+
+        [Fact]
+        public void ValidateReturnsACopyOfTheColumns()
+        {
+            List<string> source = ["a", "b"];
+            string[] copy = TableValidation.Validate("T", source, ExcelTableOptions.Default);
+            source[0] = "changed";
+
+            Assert.Equal(["a", "b"], copy);
+        }
+
+        [Fact]
+        public void RegistryClaimsNamesCaseInsensitivelyAndNumbersTables()
+        {
+            TableRegistry registry = new();
+
+            Assert.Equal(1, registry.Claim("Sales"));
+            Assert.Equal(2, registry.Claim("Stock"));
+            Assert.Throws<ArgumentException>(() => registry.RequireAvailable("sales"));
+            Assert.Throws<ArgumentException>(() => registry.Claim("STOCK"));
+            Assert.Equal(3, registry.Claim("Other"));
+        }
+
+        [Fact]
+        public void TrackerGivesHeaderOnlyTablesOneDataRow()
+        {
+            TableTracker tracker = new();
+            tracker.Begin(1, "T", ["A"], ExcelTableOptions.Default, headerRow: 4);
+            tracker.End(lastWrittenRow: 4);
+
+            WrittenTable table = Assert.Single(tracker.Finished);
+            Assert.Equal((4, 5, "A5:A6"), (table.HeaderRow, table.LastRow, table.Ref));
+        }
+
+        [Fact]
+        public void TrackerRefusesTwoOpenTablesAndEndWithoutOpen()
+        {
+            TableTracker tracker = new();
+            Assert.Throws<InvalidOperationException>(() => tracker.End(0));
+
+            tracker.Begin(1, "T", ["A", "B"], ExcelTableOptions.Default with { FirstColumn = 2 }, headerRow: 0);
+            Assert.Throws<InvalidOperationException>(() => tracker.RequireNoneOpen());
+            tracker.CloseOpen(lastWrittenRow: 3);
+            tracker.CloseOpen(lastWrittenRow: 9);
+
+            WrittenTable table = Assert.Single(tracker.Finished);
+            Assert.Equal((2, 3, "C1:D4"), (table.FirstColumn, table.LastColumn, table.Ref));
+        }
+
+        [Fact]
+        public void TableNeedsRoomForItsHeaderAndOneDataRow()
+        {
+            TableTracker.RequireRoom(1_048_574);
+
+            Assert.Throws<ExcelLimitExceededException>(() => TableTracker.RequireRoom(1_048_575));
+        }
+
+        [Fact]
+        public void SheetRelsListOneRelationshipPerTable()
+        {
+            WrittenTable first = new(3, "A", ["x"], ExcelTableOptions.Default, 0, 1);
+            WrittenTable second = new(4, "B", ["y"], ExcelTableOptions.Default, 3, 4);
+
+            string xml = TablePackage.SheetRelsXml([first, second], "bin");
+
+            Assert.Equal(
+                "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+                + "<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+                + "<Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/table\" Target=\"../tables/table3.bin\"/>"
+                + "<Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/table\" Target=\"../tables/table4.bin\"/>"
+                + "</Relationships>",
+                xml);
+        }
+    }
+}

From 8512d9e81fa88ea12d8f863b081074a34538937b Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:52:38 -0300
Subject: [PATCH 054/115] feat(writer): write Excel tables to XLSX

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../PublicAPI/PublicAPI.Unshipped.txt         |   3 +
 .../Writer/Internal/XlsxConstants.cs          |   1 +
 .../Writer/Xlsx/XlsxSheetWriter.cs            |  65 +++++-
 .../Writer/Xlsx/XlsxTableXml.cs               |  58 +++++
 .../Writer/Xlsx/XlsxWorkbookWriter.cs         |  44 ++++
 .../Writer/Tables/TableBooks.cs               | 147 ++++++++++++
 .../Writer/Tables/TableWriterTests.cs         | 217 ++++++++++++++++++
 .../Writer/Tables/XlsxTableShapeTests.cs      |  92 ++++++++
 8 files changed, 622 insertions(+), 5 deletions(-)
 create mode 100644 src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs

diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 69242acc..3ea8820a 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -48,3 +48,6 @@ override ExcelReader.Core.Writer.ExcelTableOptions.ToString() -> string!
 static ExcelReader.Core.Writer.ExcelTableOptions.Default.get -> ExcelReader.Core.Writer.ExcelTableOptions!
 static ExcelReader.Core.Writer.ExcelTableOptions.operator !=(ExcelReader.Core.Writer.ExcelTableOptions? left, ExcelReader.Core.Writer.ExcelTableOptions? right) -> bool
 static ExcelReader.Core.Writer.ExcelTableOptions.operator ==(ExcelReader.Core.Writer.ExcelTableOptions? left, ExcelReader.Core.Writer.ExcelTableOptions? right) -> bool
+ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.BeginTable(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null) -> void
+ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.BeginTableAsync(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.EndTable() -> void
diff --git a/src/ExcelReader.Core/Writer/Internal/XlsxConstants.cs b/src/ExcelReader.Core/Writer/Internal/XlsxConstants.cs
index 2e90c195..bc55f18f 100644
--- a/src/ExcelReader.Core/Writer/Internal/XlsxConstants.cs
+++ b/src/ExcelReader.Core/Writer/Internal/XlsxConstants.cs
@@ -11,6 +11,7 @@ internal static class XlsxConstants
         internal const string WorksheetContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml";
         internal const string StylesContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml";
         internal const string SharedStringsContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml";
+        internal const string TableContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml";
         internal const string RelationshipsContentType = "application/vnd.openxmlformats-package.relationships+xml";
 
         internal const string WorkbookRelType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
index 0f7ddd0b..f26d157a 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
@@ -11,8 +11,9 @@ namespace ExcelReader.Core.Writer.Xlsx
     /// <summary>
     /// Writes a single worksheet's XML into an XLSX ZIP archive, buffering rows and flushing them to the entry stream once they cross a size threshold.
     /// </summary>
-    public sealed class XlsxSheetWriter : ISheetWriter<XlsxRowWriter>
+    public sealed class XlsxSheetWriter : ISheetWriter<XlsxRowWriter>, ITableSheetWriter<XlsxRowWriter>
     {
+        private readonly TableTracker _tables = new();
         private readonly XlsxWorkbookWriter _owner;
         private readonly ZipArchive _zip;
         private readonly CompressionLevel _compression;
@@ -91,7 +92,7 @@ private void EnsureStarted()
                 _rowBuffer.Reset();
                 _rowBuffer.WriteUtf8(
                     "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" +
-                    $"<worksheet xmlns=\"{XlsxConstants.MainNs}\">{BuildColsXml()}<sheetData>");
+                    $"<worksheet xmlns=\"{XlsxConstants.MainNs}\" xmlns:r=\"{XlsxConstants.RelationshipsNs}\">{BuildColsXml()}<sheetData>");
                 _stream.Write(_rowBuffer.Span);
             }
             catch
@@ -120,7 +121,7 @@ private async ValueTask StartCoreAsync(CancellationToken ct)
                 _rowBuffer.Reset();
                 _rowBuffer.WriteUtf8(
                     "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" +
-                    $"<worksheet xmlns=\"{XlsxConstants.MainNs}\">{BuildColsXml()}<sheetData>");
+                    $"<worksheet xmlns=\"{XlsxConstants.MainNs}\" xmlns:r=\"{XlsxConstants.RelationshipsNs}\">{BuildColsXml()}<sheetData>");
                 await _stream.WriteAsync(_rowBuffer.Memory, ct).ConfigureAwait(false);
             }
             catch
@@ -250,7 +251,7 @@ public void End()
             try
             {
                 EnsureStarted();
-                _rowBuffer.Write("</sheetData></worksheet>"u8);
+                WriteTrailer();
 #pragma warning disable CS8602
                 _stream.Write(_rowBuffer.Span);
                 _stream.Flush();
@@ -262,9 +263,62 @@ public void End()
                 Fault();
                 throw;
             }
+            _owner.RegisterTables(SheetId, _tables.Finished);
             Release(faulted: false);
         }
 
+        private void WriteTrailer()
+        {
+            _tables.CloseOpen(_rowNumber - 1);
+            _rowBuffer.Write("</sheetData>"u8);
+            if (_tables.Finished.Count > 0)
+            {
+                _rowBuffer.WriteUtf8(XlsxTableXml.TableParts(_tables.Finished.Count));
+            }
+            _rowBuffer.Write("</worksheet>"u8);
+        }
+
+        /// <inheritdoc/>
+        public void BeginTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null)
+        {
+            (string[] names, ExcelTableOptions effective) = PrepareTable(name, columns, options);
+            using (XlsxRowWriter row = StartRow())
+            {
+                TableTracker.WriteHeader(row, effective.FirstColumn, names);
+            }
+            _tables.Begin(_owner.Tables.Claim(name), name, names, effective, _rowNumber - 1);
+        }
+
+        /// <inheritdoc/>
+        public async ValueTask BeginTableAsync(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null, CancellationToken ct = default)
+        {
+            (string[] names, ExcelTableOptions effective) = PrepareTable(name, columns, options);
+            XlsxRowWriter row = await StartRowAsync(ct).ConfigureAwait(false);
+            await using (row.ConfigureAwait(false))
+            {
+                TableTracker.WriteHeader(row, effective.FirstColumn, names);
+            }
+            _tables.Begin(_owner.Tables.Claim(name), name, names, effective, _rowNumber - 1);
+        }
+
+        /// <inheritdoc/>
+        public void EndTable()
+        {
+            WriterStateGuard.ThrowIfEnded(_state, this);
+            _tables.End(_rowNumber - 1);
+        }
+
+        private (string[] Names, ExcelTableOptions Options) PrepareTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options)
+        {
+            WriterStateGuard.ThrowIfEnded(_state, this);
+            ExcelTableOptions effective = options ?? ExcelTableOptions.Default;
+            string[] names = TableValidation.Validate(name, columns, effective);
+            _tables.RequireNoneOpen();
+            _owner.Tables.RequireAvailable(name);
+            TableTracker.RequireRoom(_rowNumber);
+            return (names, effective);
+        }
+
         private void Fault()
         {
             if (_state == WriterState.Ended)
@@ -307,7 +361,7 @@ public async ValueTask EndAsync(CancellationToken ct = default)
                 {
                     await StartCoreAsync(ct).ConfigureAwait(false);
                 }
-                _rowBuffer.Write("</sheetData></worksheet>"u8);
+                WriteTrailer();
 #pragma warning disable CS8602
                 await _stream.WriteAsync(_rowBuffer.Memory, ct).ConfigureAwait(false);
 #pragma warning restore CS8602
@@ -319,6 +373,7 @@ public async ValueTask EndAsync(CancellationToken ct = default)
                 await FaultAsync().ConfigureAwait(false);
                 throw;
             }
+            _owner.RegisterTables(SheetId, _tables.Finished);
             Release(faulted: false);
         }
 
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
new file mode 100644
index 00000000..d1de1c19
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
@@ -0,0 +1,58 @@
+using System.Globalization;
+using System.Security;
+using System.Text;
+using ExcelReader.Core.Writer.Internal;
+
+namespace ExcelReader.Core.Writer.Xlsx
+{
+    internal static class XlsxTableXml
+    {
+        internal static string TableParts(int count)
+        {
+            StringBuilder sb = new();
+            sb.Append(CultureInfo.InvariantCulture, $"<tableParts count=\"{count}\">");
+            for (int i = 0; i < count; i++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<tablePart r:id=\"{TablePackage.RelationshipId(i)}\"/>");
+            }
+            sb.Append("</tableParts>");
+            return sb.ToString();
+        }
+
+        internal static string Table(WrittenTable table)
+        {
+            string name = SecurityElement.Escape(table.Name);
+            string reference = table.Ref;
+            StringBuilder sb = new();
+            sb.Append("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>");
+            sb.Append(CultureInfo.InvariantCulture,
+                $"<table xmlns=\"{XlsxConstants.MainNs}\" id=\"{table.Id}\" name=\"{name}\" displayName=\"{name}\" ref=\"{reference}\" totalsRowShown=\"0\">");
+            sb.Append(CultureInfo.InvariantCulture, $"<autoFilter ref=\"{reference}\"/>");
+            sb.Append(CultureInfo.InvariantCulture, $"<tableColumns count=\"{table.Columns.Length}\">");
+            for (int i = 0; i < table.Columns.Length; i++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<tableColumn id=\"{i + 1}\" name=\"{SecurityElement.Escape(table.Columns[i])}\"/>");
+            }
+            sb.Append("</tableColumns>");
+            AppendStyleInfo(sb, table.Options);
+            sb.Append("</table>");
+            return sb.ToString();
+        }
+
+        private static void AppendStyleInfo(StringBuilder sb, ExcelTableOptions options)
+        {
+            sb.Append("<tableStyleInfo");
+            if (options.StyleName is not null)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $" name=\"{options.StyleName}\"");
+            }
+            sb.Append(CultureInfo.InvariantCulture,
+                $" showFirstColumn=\"{Flag(options.ShowFirstColumn)}\" showLastColumn=\"{Flag(options.ShowLastColumn)}\" showRowStripes=\"{Flag(options.ShowRowStripes)}\" showColumnStripes=\"{Flag(options.ShowColumnStripes)}\"/>");
+        }
+
+        private static char Flag(bool value)
+        {
+            return value ? '1' : '0';
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
index 1c7267e6..d06da584 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
@@ -19,6 +19,7 @@ public sealed class XlsxWorkbookWriter : IWorkbookWriter<XlsxSheetWriter>
         private readonly SharedStringTable? _sharedStrings;
         private readonly StyleTable _styles = new();
         private readonly List<(string Name, int SheetId, ExcelSheetVisibility Visibility)> _sheets = [];
+        private readonly List<(int SheetId, IReadOnlyList<WrittenTable> Tables)> _sheetTables = [];
         private bool _ended;
         private bool _sheetActive;
         private XlsxSheetWriter? _activeSheet;
@@ -84,6 +85,40 @@ internal void RegisterSheet(string name, int sheetId, ExcelSheetVisibility visib
             _sheets.Add((name, sheetId, visibility));
         }
 
+        internal TableRegistry Tables { get; } = new();
+
+        internal void RegisterTables(int sheetId, IReadOnlyList<WrittenTable> tables)
+        {
+            if (tables.Count > 0)
+            {
+                _sheetTables.Add((sheetId, tables));
+            }
+        }
+
+        private void WriteTables()
+        {
+            foreach ((int sheetId, IReadOnlyList<WrittenTable> tables) in _sheetTables)
+            {
+                WriteEntry($"xl/worksheets/_rels/sheet{sheetId}.xml.rels", TablePackage.SheetRelsXml(tables, "xml"));
+                foreach (WrittenTable table in tables)
+                {
+                    WriteEntry($"xl/tables/table{table.Id}.xml", XlsxTableXml.Table(table));
+                }
+            }
+        }
+
+        private async ValueTask WriteTablesAsync(CancellationToken ct)
+        {
+            foreach ((int sheetId, IReadOnlyList<WrittenTable> tables) in _sheetTables)
+            {
+                await WriteEntryAsync($"xl/worksheets/_rels/sheet{sheetId}.xml.rels", TablePackage.SheetRelsXml(tables, "xml"), ct).ConfigureAwait(false);
+                foreach (WrittenTable table in tables)
+                {
+                    await WriteEntryAsync($"xl/tables/table{table.Id}.xml", XlsxTableXml.Table(table), ct).ConfigureAwait(false);
+                }
+            }
+        }
+
         internal void NotifySheetEnded(bool faulted)
         {
             _sheetActive = false;
@@ -132,6 +167,7 @@ public void End()
                 {
                     throw new InvalidOperationException("An XLSX workbook must contain at least one sheet.");
                 }
+                WriteTables();
                 WriteEntry("_rels/.rels", BuildRootRelsXml());
                 WriteEntry("xl/styles.xml", BuildStylesXml());
                 if (_sharedStrings is not null)
@@ -169,6 +205,7 @@ public async ValueTask EndAsync(CancellationToken ct = default)
                 {
                     throw new InvalidOperationException("An XLSX workbook must contain at least one sheet.");
                 }
+                await WriteTablesAsync(ct).ConfigureAwait(false);
                 await WriteEntryAsync("_rels/.rels", BuildRootRelsXml(), ct).ConfigureAwait(false);
                 await WriteStylesAsync(ct).ConfigureAwait(false);
                 if (_sharedStrings is not null)
@@ -509,6 +546,13 @@ private string BuildContentTypesXml()
             {
                 sb.Append(CultureInfo.InvariantCulture, $"<Override PartName=\"/xl/worksheets/sheet{sheetId}.xml\" ContentType=\"{XlsxConstants.WorksheetContentType}\"/>");
             }
+            foreach ((_, IReadOnlyList<WrittenTable> tables) in _sheetTables)
+            {
+                foreach (WrittenTable table in tables)
+                {
+                    sb.Append(CultureInfo.InvariantCulture, $"<Override PartName=\"/xl/tables/table{table.Id}.xml\" ContentType=\"{XlsxConstants.TableContentType}\"/>");
+                }
+            }
             sb.Append("</Types>");
             return sb.ToString();
         }
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
new file mode 100644
index 00000000..7e84334a
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
@@ -0,0 +1,147 @@
+using System.IO.Compression;
+using ExcelReader.Core.Writer;
+using ExcelReader.Core.Writer.Xlsx;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    internal interface ITableBook
+    {
+        void AddSheet(string name);
+
+        void BeginTable(string name, string[] columns, ExcelTableOptions? options = null);
+
+        ValueTask BeginTableAsync(string name, string[] columns, ExcelTableOptions? options = null);
+
+        void Row(params object?[] values);
+
+        void EndTable();
+
+        void EndSheet();
+
+        byte[] Finish();
+    }
+
+    internal sealed class TableBook<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, MemoryStream stream) : ITableBook
+        where TSheet : class, ITableSheetWriter<TRow>
+        where TRow : IRowWriter
+    {
+        private TSheet? _sheet;
+
+        private TSheet Sheet
+        {
+            get
+            {
+                return _sheet ?? throw new InvalidOperationException("No sheet added.");
+            }
+        }
+
+        public void AddSheet(string name)
+        {
+            _sheet = workbook.AddSheet(name);
+        }
+
+        public void BeginTable(string name, string[] columns, ExcelTableOptions? options = null)
+        {
+            Sheet.BeginTable(name, columns, options);
+        }
+
+        public ValueTask BeginTableAsync(string name, string[] columns, ExcelTableOptions? options = null)
+        {
+            return Sheet.BeginTableAsync(name, columns, options, TestContext.Current.CancellationToken);
+        }
+
+        public void Row(params object?[] values)
+        {
+            using TRow row = Sheet.StartRow();
+            foreach (object? value in values)
+            {
+                WriteValue(row, value);
+            }
+        }
+
+        public void EndTable()
+        {
+            Sheet.EndTable();
+        }
+
+        public void EndSheet()
+        {
+            Sheet.End();
+            _sheet = null;
+        }
+
+        public byte[] Finish()
+        {
+            workbook.End();
+            workbook.Dispose();
+            return stream.ToArray();
+        }
+
+        private static void WriteValue(TRow row, object? value)
+        {
+            switch (value)
+            {
+                case null:
+                    row.Skip();
+                    break;
+                case string text:
+                    row.Write(text);
+                    break;
+                case int number:
+                    row.Write(number);
+                    break;
+                case double real:
+                    row.Write(real);
+                    break;
+                default:
+                    throw new ArgumentException($"Unsupported cell value {value.GetType()}.", nameof(value));
+            }
+        }
+    }
+
+    public static class TableBooks
+    {
+        public static TheoryData<string> Formats { get; } = new() { "xlsx" };
+
+        internal static ITableBook Create(string format)
+        {
+            MemoryStream stream = new();
+            return format switch
+            {
+                "xlsx" => new TableBook<XlsxSheetWriter, XlsxRowWriter>(XlsxWorkbookWriter.Create(stream, leaveOpen: true), stream),
+                _ => throw new ArgumentOutOfRangeException(nameof(format)),
+            };
+        }
+
+        internal static string Extension(string format)
+        {
+            return string.Equals(format, "xlsx", StringComparison.Ordinal) ? "xml" : "bin";
+        }
+
+        internal static byte[] Entry(byte[] package, string name)
+        {
+            using ZipArchive zip = new(new MemoryStream(package), ZipArchiveMode.Read);
+            ZipArchiveEntry entry = zip.GetEntry(name) ?? throw new InvalidOperationException($"Package has no entry '{name}'.");
+            using Stream content = entry.Open();
+            using MemoryStream copy = new();
+            content.CopyTo(copy);
+            return copy.ToArray();
+        }
+
+        internal static IReadOnlyList<string> EntryNames(byte[] package)
+        {
+            using ZipArchive zip = new(new MemoryStream(package), ZipArchiveMode.Read);
+            return [.. zip.Entries.Select(static e => e.FullName)];
+        }
+
+        internal static Dictionary<string, byte[]> Entries(byte[] package)
+        {
+            Dictionary<string, byte[]> entries = new(StringComparer.Ordinal);
+            foreach (string name in EntryNames(package))
+            {
+                entries[name] = Entry(package, name);
+            }
+            return entries;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
new file mode 100644
index 00000000..00854440
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
@@ -0,0 +1,217 @@
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Writer;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    public class TableWriterTests
+    {
+        private sealed class StockRow
+        {
+            public string? Product { get; set; }
+
+            public int Qty { get; set; }
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void SingleTableRoundTrips(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("Stock", ["Product", "Qty"]);
+            book.Row("Pen", 100);
+            book.Row("Notebook", 40);
+            book.EndTable();
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            ExcelTable table = Assert.Single(workbook.Tables);
+            Assert.Equal(("Stock", "A1:B3", "TableStyleMedium2"), (table.Name, table.Ref, table.StyleName));
+            Assert.Equal((1, 0, "Report"), (table.HeaderRowCount, table.TotalsRowCount, table.Sheet.Name));
+            Assert.Equal(["Product", "Qty"], table.ColumnNames);
+            Assert.Equal([("Pen", 100), ("Notebook", 40)], ParseStock(table));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void TableAtAnOffsetColumnRoundTrips(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("Stock", ["Product", "Qty"], ExcelTableOptions.Default with { FirstColumn = 2 });
+            book.Row(null, null, "Pen", 100);
+            book.Row(null, null, "Notebook", 40);
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            ExcelTable table = Assert.Single(workbook.Tables);
+            Assert.Equal("C1:D3", table.Ref);
+            Assert.Equal([("Pen", 100), ("Notebook", 40)], ParseStock(table));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void TablesInSequenceAndAcrossSheetsGetWorkbookWideIds(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("One");
+            book.BeginTable("First", ["A"]);
+            book.Row("x");
+            book.EndTable();
+            book.Row("between");
+            book.BeginTable("Second", ["B"]);
+            book.Row("y");
+            book.EndTable();
+            book.EndSheet();
+            book.AddSheet("Two");
+            book.BeginTable("Third", ["C"]);
+            book.Row("z");
+            byte[] package = book.Finish();
+
+            using IExcelWorkbook workbook = Read(package);
+
+            Assert.Equal(
+                [("First", 0, "A1:A2"), ("Second", 0, "A4:A5"), ("Third", 1, "A1:A2")],
+                workbook.Tables.Select(static t => (t.Name, t.Sheet.Index, t.Ref)));
+            string ext = TableBooks.Extension(format);
+            IReadOnlyList<string> names = TableBooks.EntryNames(package);
+            Assert.Contains($"xl/tables/table1.{ext}", names, StringComparer.Ordinal);
+            Assert.Contains($"xl/tables/table2.{ext}", names, StringComparer.Ordinal);
+            Assert.Contains($"xl/tables/table3.{ext}", names, StringComparer.Ordinal);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void HeaderOnlyTableGetsOneEmptyDataRow(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("Empty", ["Only"]);
+            book.EndTable();
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Equal("A1:A2", Assert.Single(workbook.Tables).Ref);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void SheetEndClosesTheOpenTable(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("Open", ["H"]);
+            book.Row("a");
+            book.Row("b");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Equal("A1:A3", Assert.Single(workbook.Tables).Ref);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void UnstyledTableHasNoStyleName(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("Plain", ["H"], ExcelTableOptions.Default with { StyleName = null });
+            book.Row("a");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Null(Assert.Single(workbook.Tables).StyleName);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void FailedBeginTableWritesNothingAndClaimsNoName(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+
+            Assert.Throws<ArgumentException>(() => book.BeginTable("A1", ["H"]));
+            Assert.Throws<ArgumentException>(() => book.BeginTable("Good", ["H", "h"]));
+            book.BeginTable("Good", ["H"]);
+            book.Row("a");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Equal("A1:A2", Assert.Single(workbook.Tables).Ref);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void DuplicateNameAcrossSheetsIsRejectedBeforeWriting(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("One");
+            book.BeginTable("Sales", ["H"]);
+            book.Row("a");
+            book.EndSheet();
+            book.AddSheet("Two");
+
+            Assert.Throws<ArgumentException>(() => book.BeginTable("sales", ["H"]));
+            book.Row("untouched");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Single(workbook.Tables);
+            using IExcelRowEnumerator rows = workbook.SheetAt(1).GetEnumerator();
+            Assert.True(rows.MoveNext());
+            Assert.Equal("untouched", rows.Current[0].GetString());
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void SecondOpenTableAndEndWithoutOpenAreRejected(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+
+            Assert.Throws<InvalidOperationException>(() => book.EndTable());
+            book.BeginTable("First", ["H"]);
+            Assert.Throws<InvalidOperationException>(() => book.BeginTable("Second", ["H"]));
+            book.Finish();
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public async Task AsyncBeginTableMatchesSync(string format)
+        {
+            ITableBook sync = TableBooks.Create(format);
+            sync.AddSheet("Report");
+            sync.BeginTable("Stock", ["Product", "Qty"], ExcelTableOptions.Default with { FirstColumn = 1 });
+            sync.Row(null, "Pen", 100);
+
+            ITableBook async = TableBooks.Create(format);
+            async.AddSheet("Report");
+            await async.BeginTableAsync("Stock", ["Product", "Qty"], ExcelTableOptions.Default with { FirstColumn = 1 });
+            async.Row(null, "Pen", 100);
+
+            Dictionary<string, byte[]> expected = TableBooks.Entries(sync.Finish());
+            Dictionary<string, byte[]> actual = TableBooks.Entries(async.Finish());
+            Assert.Equal(expected.Keys.Order(StringComparer.Ordinal), actual.Keys.Order(StringComparer.Ordinal));
+            foreach ((string name, byte[] bytes) in expected)
+            {
+                Assert.Equal(bytes, actual[name]);
+            }
+        }
+
+        private static IExcelWorkbook Read(byte[] package)
+        {
+            return Excel.Open(new ReadOnlyMemory<byte>(package));
+        }
+
+        private static List<(string?, int)> ParseStock(ExcelTable table)
+        {
+            List<(string?, int)> rows = [];
+            foreach (StockRow row in ExcelParser.FromAttributes<StockRow>().Parse(table.AsSheet()))
+            {
+                rows.Add((row.Product, row.Qty));
+            }
+            return rows;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs b/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs
new file mode 100644
index 00000000..75fb1827
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs
@@ -0,0 +1,92 @@
+using System.Text;
+using ExcelReader.Core.Writer;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    public class XlsxTableShapeTests
+    {
+        [Fact]
+        public void SheetReferencesItsTablesAndDeclaresTheRelationshipsNamespace()
+        {
+            byte[] package = TwoTables();
+
+            string sheet = Text(package, "xl/worksheets/sheet1.xml");
+
+            Assert.StartsWith(
+                "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">",
+                sheet, StringComparison.Ordinal);
+            Assert.EndsWith(
+                "</sheetData><tableParts count=\"2\"><tablePart r:id=\"rId1\"/><tablePart r:id=\"rId2\"/></tableParts></worksheet>",
+                sheet, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void SheetRelsAndContentTypesListTheTables()
+        {
+            byte[] package = TwoTables();
+
+            Assert.Equal(
+                "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+                + "<Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/table\" Target=\"../tables/table1.xml\"/>"
+                + "<Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/table\" Target=\"../tables/table2.xml\"/>"
+                + "</Relationships>",
+                Text(package, "xl/worksheets/_rels/sheet1.xml.rels"));
+            string types = Text(package, "[Content_Types].xml");
+            Assert.Contains("<Override PartName=\"/xl/tables/table1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml\"/>", types, StringComparison.Ordinal);
+            Assert.Contains("<Override PartName=\"/xl/tables/table2.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml\"/>", types, StringComparison.Ordinal);
+        }
+
+        [Fact]
+        public void TablePartCarriesNameRangeColumnsAndStyleFlags()
+        {
+            byte[] package = TwoTables();
+
+            Assert.Equal(
+                "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+                + "<table xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" id=\"2\" name=\"Prices\" displayName=\"Prices\" ref=\"B5:C6\" totalsRowShown=\"0\">"
+                + "<autoFilter ref=\"B5:C6\"/>"
+                + "<tableColumns count=\"2\"><tableColumn id=\"1\" name=\"Item\"/><tableColumn id=\"2\" name=\"Qty &amp; &quot;Price&quot;\"/></tableColumns>"
+                + "<tableStyleInfo name=\"TableStyleLight9\" showFirstColumn=\"1\" showLastColumn=\"0\" showRowStripes=\"0\" showColumnStripes=\"1\"/>"
+                + "</table>",
+                Text(package, "xl/tables/table2.xml"));
+        }
+
+        [Fact]
+        public void UnstyledTableOmitsTheStyleName()
+        {
+            ITableBook book = TableBooks.Create("xlsx");
+            book.AddSheet("S");
+            book.BeginTable("Plain", ["H"], ExcelTableOptions.Default with { StyleName = null });
+
+            string table = Text(book.Finish(), "xl/tables/table1.xml");
+
+            Assert.Contains("<tableStyleInfo showFirstColumn=\"0\" showLastColumn=\"0\" showRowStripes=\"1\" showColumnStripes=\"0\"/>", table, StringComparison.Ordinal);
+        }
+
+        private static byte[] TwoTables()
+        {
+            ITableBook book = TableBooks.Create("xlsx");
+            book.AddSheet("S");
+            book.BeginTable("Stock", ["Product"]);
+            book.Row("Pen");
+            book.EndTable();
+            book.Row();
+            book.Row();
+            book.BeginTable("Prices", ["Item", "Qty & \"Price\""], new ExcelTableOptions
+            {
+                FirstColumn = 1,
+                StyleName = "TableStyleLight9",
+                ShowRowStripes = false,
+                ShowColumnStripes = true,
+                ShowFirstColumn = true,
+            });
+            book.Row(null, "Pen", 2);
+            return book.Finish();
+        }
+
+        private static string Text(byte[] package, string name)
+        {
+            return Encoding.UTF8.GetString(TableBooks.Entry(package, name));
+        }
+    }
+}

From 528c5739075a09a61a96d4bebced76947b941835 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:55:16 -0300
Subject: [PATCH 055/115] test(writer): cover the async end path for XLSX
 tables

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../ExcelReader.Tests/Writer/Tables/TableBooks.cs | 15 +++++++++++++++
 .../Writer/Tables/TableWriterTests.cs             |  2 +-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
index 7e84334a..fcb6d728 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
@@ -19,6 +19,8 @@ internal interface ITableBook
         void EndSheet();
 
         byte[] Finish();
+
+        ValueTask<byte[]> FinishAsync();
     }
 
     internal sealed class TableBook<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, MemoryStream stream) : ITableBook
@@ -77,6 +79,19 @@ public byte[] Finish()
             return stream.ToArray();
         }
 
+        public async ValueTask<byte[]> FinishAsync()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            if (_sheet is not null)
+            {
+                await _sheet.EndAsync(ct);
+                _sheet = null;
+            }
+            await workbook.EndAsync(ct);
+            await workbook.DisposeAsync();
+            return stream.ToArray();
+        }
+
         private static void WriteValue(TRow row, object? value)
         {
             switch (value)
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
index 00854440..a607f04e 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
@@ -191,7 +191,7 @@ public async Task AsyncBeginTableMatchesSync(string format)
             async.Row(null, "Pen", 100);
 
             Dictionary<string, byte[]> expected = TableBooks.Entries(sync.Finish());
-            Dictionary<string, byte[]> actual = TableBooks.Entries(async.Finish());
+            Dictionary<string, byte[]> actual = TableBooks.Entries(await async.FinishAsync());
             Assert.Equal(expected.Keys.Order(StringComparer.Ordinal), actual.Keys.Order(StringComparer.Ordinal));
             foreach ((string name, byte[] bytes) in expected)
             {

From 5842fa7cbdcab5abfe3e429c71a47dce5f32d694 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 00:58:48 -0300
Subject: [PATCH 056/115] feat(writer): write Excel tables to XLSB

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../PublicAPI/PublicAPI.Unshipped.txt         |   3 +
 src/ExcelReader.Core/Reader/Xlsb/Brt.cs       |   9 ++
 .../Writer/Xlsb/XlsbSheetWriter.cs            |  65 ++++++++-
 .../Writer/Xlsb/XlsbTableRecords.cs           | 129 ++++++++++++++++++
 .../Writer/Xlsb/XlsbWorkbookWriter.cs         |  54 ++++++++
 .../Writer/Tables/TableBooks.cs               |   4 +-
 .../Writer/Tables/XlsbTableShapeTests.cs      | 108 +++++++++++++++
 7 files changed, 370 insertions(+), 2 deletions(-)
 create mode 100644 src/ExcelReader.Core/Writer/Xlsb/XlsbTableRecords.cs
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs

diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 3ea8820a..3c110f0a 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -51,3 +51,6 @@ static ExcelReader.Core.Writer.ExcelTableOptions.operator ==(ExcelReader.Core.Wr
 ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.BeginTable(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null) -> void
 ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.BeginTableAsync(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.EndTable() -> void
+ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.BeginTable(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null) -> void
+ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.BeginTableAsync(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.EndTable() -> void
diff --git a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
index f7fda569..a28ec6e7 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
@@ -21,6 +21,15 @@ internal static class Brt
         internal const int BeginList = 343;
         internal const int BeginListCol = 347;
         internal const int ListTableStyleClient = 513;
+        internal const int BeginAFilter = 161;
+        internal const int EndAFilter = 162;
+        internal const int EndList = 344;
+        internal const int BeginListCols = 345;
+        internal const int EndListCols = 346;
+        internal const int EndListCol = 348;
+        internal const int BeginListParts = 660;
+        internal const int ListPart = 661;
+        internal const int EndListParts = 662;
         internal const int Fmt = 44;
         internal const int Fill = 45;
         internal const int Border = 46;
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
index e4b6c591..1f4b81fb 100644
--- a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
@@ -8,7 +8,7 @@
 namespace ExcelReader.Core.Writer.Xlsb
 {
     /// <summary>Writes a single worksheet's rows into an .xlsb workbook produced by <see cref="XlsbWorkbookWriter"/>.</summary>
-    public sealed class XlsbSheetWriter : ISheetWriter<XlsbRowWriter>
+    public sealed class XlsbSheetWriter : ISheetWriter<XlsbRowWriter>, ITableSheetWriter<XlsbRowWriter>
     {
         private const int SpillThreshold = 64 * 1024;
 
@@ -18,6 +18,7 @@ public sealed class XlsbSheetWriter : ISheetWriter<XlsbRowWriter>
         private readonly CompressionLevel _compression;
         private readonly bool _offloadWrite;
         private readonly BiffBuffer _records = new(4096);
+        private readonly TableTracker _tables = new();
         private Stream? _stream;
         private WriterState _state = WriterState.Created;
         private bool _rowActive;
@@ -64,6 +65,14 @@ internal XlsbSheetWriter(
         internal bool UseSharedStrings => _owner.UseSharedStrings;
         internal bool ResourcesReleased => _stream is null && _buffersDisposed;
 
+        internal IReadOnlyList<WrittenTable> Tables
+        {
+            get
+            {
+                return _tables.Finished;
+            }
+        }
+
         /// <inheritdoc/>
         /// <exception cref="ArgumentOutOfRangeException"><paramref name="columnIndex"/> is negative, or <paramref name="styleId"/> is negative or was never returned by <see cref="XlsbWorkbookWriter.AddStyle"/>.</exception>
         /// <exception cref="InvalidOperationException">The first row has already been started.</exception>
@@ -212,8 +221,10 @@ public void End()
             try
             {
                 EnsureStarted();
+                _tables.CloseOpen(_rowNumber);
                 WriteRecord(Brt.EndSheetData);
                 WriteSheetMetadata();
+                WriteListParts();
                 WriteRecord(Brt.EndSheet);
                 if (_stream is null)
                 {
@@ -243,8 +254,10 @@ public async ValueTask EndAsync(CancellationToken ct = default)
             try
             {
                 EnsureStarted();
+                _tables.CloseOpen(_rowNumber);
                 WriteRecord(Brt.EndSheetData);
                 WriteSheetMetadata();
+                WriteListParts();
                 WriteRecord(Brt.EndSheet);
                 if (_stream is null)
                 {
@@ -265,6 +278,56 @@ public async ValueTask EndAsync(CancellationToken ct = default)
             Release(faulted: false);
         }
 
+        private void WriteListParts()
+        {
+            IReadOnlyList<WrittenTable> tables = _tables.Finished;
+            if (tables.Count == 0)
+            {
+                return;
+            }
+            Payload.Reset();
+            Payload.WriteU32((uint)tables.Count);
+            WriteRecord(Brt.BeginListParts, Payload.Span);
+            for (int i = 0; i < tables.Count; i++)
+            {
+                Payload.Reset();
+                Biff12RecordWriter.WriteWideString(Payload, TablePackage.RelationshipId(i));
+                WriteRecord(Brt.ListPart, Payload.Span);
+            }
+            WriteRecord(Brt.EndListParts);
+        }
+
+        /// <inheritdoc/>
+        public void BeginTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null)
+        {
+            WriterStateGuard.ThrowIfEnded(_state, this);
+            ExcelTableOptions effective = options ?? ExcelTableOptions.Default;
+            string[] names = TableValidation.Validate(name, columns, effective);
+            _tables.RequireNoneOpen();
+            _owner.Tables.RequireAvailable(name);
+            TableTracker.RequireRoom(_rowNumber + 1);
+            using (XlsbRowWriter row = StartRow())
+            {
+                TableTracker.WriteHeader(row, effective.FirstColumn, names);
+            }
+            _tables.Begin(_owner.Tables.Claim(name), name, names, effective, _rowNumber);
+        }
+
+        /// <inheritdoc/>
+        public ValueTask BeginTableAsync(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null, CancellationToken ct = default)
+        {
+            ct.ThrowIfCancellationRequested();
+            BeginTable(name, columns, options);
+            return ValueTask.CompletedTask;
+        }
+
+        /// <inheritdoc/>
+        public void EndTable()
+        {
+            WriterStateGuard.ThrowIfEnded(_state, this);
+            _tables.End(_rowNumber);
+        }
+
         private void Fault()
         {
             if (_state == WriterState.Ended)
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbTableRecords.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbTableRecords.cs
new file mode 100644
index 00000000..09389e17
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbTableRecords.cs
@@ -0,0 +1,129 @@
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Writer.Internal;
+
+namespace ExcelReader.Core.Writer.Xlsb
+{
+    internal static class XlsbTableRecords
+    {
+        private const uint Unset = 0xFFFFFFFF;
+        private const uint RangeListType = 0;
+        private const uint HeaderRowCount = 1;
+        private const uint TotalsRowCount = 0;
+        private const uint ListFlags = 0;
+        private const uint ConnectionId = 0;
+        private const uint NoTotalsFunction = 0;
+        private const uint NoQuerySource = 0;
+        private const int ListDxfCount = 6;
+        private const int ColumnDxfCount = 3;
+        private const int ListTrailingStrings = 3;
+        private const int ColumnTrailingStrings = 4;
+        private const int FirstColumnFlag = 1;
+        private const int LastColumnFlag = 2;
+        private const int RowStripesFlag = 4;
+        private const int ColumnStripesFlag = 8;
+
+        internal static void WriteTable(BiffBuffer dest, BiffBuffer payload, WrittenTable table)
+        {
+            WriteBeginList(dest, payload, table);
+            payload.Reset();
+            WriteRange(payload, table);
+            Biff12RecordWriter.WriteRecord(dest, Brt.BeginAFilter, payload.Span);
+            Biff12RecordWriter.WriteRecord(dest, Brt.EndAFilter);
+            WriteColumns(dest, payload, table.Columns);
+            WriteStyle(dest, payload, table.Options);
+            Biff12RecordWriter.WriteRecord(dest, Brt.EndList);
+        }
+
+        internal static int StyleFlags(ExcelTableOptions options)
+        {
+            int flags = 0;
+            if (options.ShowFirstColumn)
+            {
+                flags |= FirstColumnFlag;
+            }
+            if (options.ShowLastColumn)
+            {
+                flags |= LastColumnFlag;
+            }
+            if (options.ShowRowStripes)
+            {
+                flags |= RowStripesFlag;
+            }
+            if (options.ShowColumnStripes)
+            {
+                flags |= ColumnStripesFlag;
+            }
+            return flags;
+        }
+
+        private static void WriteBeginList(BiffBuffer dest, BiffBuffer payload, WrittenTable table)
+        {
+            payload.Reset();
+            WriteRange(payload, table);
+            payload.WriteU32(RangeListType);
+            payload.WriteU32((uint)table.Id);
+            payload.WriteU32(HeaderRowCount);
+            payload.WriteU32(TotalsRowCount);
+            payload.WriteU32(ListFlags);
+            WriteUnset(payload, ListDxfCount);
+            payload.WriteU32(ConnectionId);
+            Biff12RecordWriter.WriteWideString(payload, table.Name);
+            Biff12RecordWriter.WriteWideString(payload, table.Name);
+            Biff12RecordWriter.WriteWideString(payload, ReadOnlySpan<char>.Empty);
+            WriteUnset(payload, ListTrailingStrings);
+            Biff12RecordWriter.WriteRecord(dest, Brt.BeginList, payload.Span);
+        }
+
+        private static void WriteRange(BiffBuffer payload, WrittenTable table)
+        {
+            payload.WriteU32((uint)table.HeaderRow);
+            payload.WriteU32((uint)table.LastRow);
+            payload.WriteU32((uint)table.FirstColumn);
+            payload.WriteU32((uint)table.LastColumn);
+        }
+
+        private static void WriteColumns(BiffBuffer dest, BiffBuffer payload, string[] columns)
+        {
+            payload.Reset();
+            payload.WriteU32((uint)columns.Length);
+            Biff12RecordWriter.WriteRecord(dest, Brt.BeginListCols, payload.Span);
+            for (int i = 0; i < columns.Length; i++)
+            {
+                payload.Reset();
+                payload.WriteU32((uint)(i + 1));
+                payload.WriteU32(NoTotalsFunction);
+                WriteUnset(payload, ColumnDxfCount);
+                payload.WriteU32(NoQuerySource);
+                payload.WriteU32(Unset);
+                Biff12RecordWriter.WriteWideString(payload, columns[i]);
+                WriteUnset(payload, ColumnTrailingStrings);
+                Biff12RecordWriter.WriteRecord(dest, Brt.BeginListCol, payload.Span);
+                Biff12RecordWriter.WriteRecord(dest, Brt.EndListCol);
+            }
+            Biff12RecordWriter.WriteRecord(dest, Brt.EndListCols);
+        }
+
+        private static void WriteStyle(BiffBuffer dest, BiffBuffer payload, ExcelTableOptions options)
+        {
+            payload.Reset();
+            payload.WriteU16(StyleFlags(options));
+            if (options.StyleName is null)
+            {
+                payload.WriteU32(Unset);
+            }
+            else
+            {
+                Biff12RecordWriter.WriteWideString(payload, options.StyleName);
+            }
+            Biff12RecordWriter.WriteRecord(dest, Brt.ListTableStyleClient, payload.Span);
+        }
+
+        private static void WriteUnset(BiffBuffer payload, int count)
+        {
+            for (int i = 0; i < count; i++)
+            {
+                payload.WriteU32(Unset);
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbWorkbookWriter.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbWorkbookWriter.cs
index 1996b324..ab7b373d 100644
--- a/src/ExcelReader.Core/Writer/Xlsb/XlsbWorkbookWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbWorkbookWriter.cs
@@ -84,6 +84,8 @@ internal void NotifySheetEnded(bool faulted)
 
         internal bool UseSharedStrings { get; }
 
+        internal TableRegistry Tables { get; } = new();
+
         internal int GetSharedStringIndex(string value)
         {
             return _sharedStrings!.GetOrAdd(value);
@@ -124,6 +126,7 @@ public void End()
                 WriteStyles();
                 WriteSharedStrings();
                 WriteAppProperties();
+                WriteTables();
                 WriteContentTypes();
                 CloseZip();
             }
@@ -157,6 +160,7 @@ public async ValueTask EndAsync(CancellationToken ct = default)
                 await WriteStylesAsync(ct).ConfigureAwait(false);
                 await WriteSharedStringsAsync(ct).ConfigureAwait(false);
                 await WriteAppPropertiesAsync(ct).ConfigureAwait(false);
+                await WriteTablesAsync(ct).ConfigureAwait(false);
                 await WriteContentTypesAsync(ct).ConfigureAwait(false);
                 await CloseZipAsync().ConfigureAwait(false);
             }
@@ -563,6 +567,49 @@ private ValueTask WriteAppPropertiesAsync(CancellationToken ct)
             return WriteEntryAsync("docProps/app.xml", AppPropertiesXml, ct);
         }
 
+        private void WriteTables()
+        {
+            foreach (XlsbSheetWriter sheet in _sheets)
+            {
+                if (sheet.Tables.Count == 0)
+                {
+                    continue;
+                }
+                WriteEntry($"xl/worksheets/_rels/sheet{sheet.SheetId}.bin.rels", TablePackage.SheetRelsXml(sheet.Tables, "bin"));
+                foreach (WrittenTable table in sheet.Tables)
+                {
+                    using BiffBuffer data = new(256);
+                    using BiffBuffer payload = new(128);
+                    XlsbTableRecords.WriteTable(data, payload, table);
+                    WriteEntry($"xl/tables/table{table.Id}.bin", data.Span);
+                }
+            }
+        }
+
+        private async ValueTask WriteTablesAsync(CancellationToken ct)
+        {
+            foreach (XlsbSheetWriter sheet in _sheets)
+            {
+                if (sheet.Tables.Count == 0)
+                {
+                    continue;
+                }
+                await WriteEntryAsync($"xl/worksheets/_rels/sheet{sheet.SheetId}.bin.rels", TablePackage.SheetRelsXml(sheet.Tables, "bin"), ct).ConfigureAwait(false);
+                foreach (WrittenTable table in sheet.Tables)
+                {
+                    await WriteTablePartAsync(table, ct).ConfigureAwait(false);
+                }
+            }
+        }
+
+        private async ValueTask WriteTablePartAsync(WrittenTable table, CancellationToken ct)
+        {
+            using BiffBuffer data = new(256);
+            using BiffBuffer payload = new(128);
+            XlsbTableRecords.WriteTable(data, payload, table);
+            await WriteEntryAsync($"xl/tables/table{table.Id}.bin", data.Memory, ct).ConfigureAwait(false);
+        }
+
         private static void WriteXf(BiffBuffer data, BiffBuffer payload, int numFmtId, bool isStyleXf = false)
         {
             payload.Reset();
@@ -597,6 +644,13 @@ private string BuildContentTypesXml()
             {
                 sb.Append(CultureInfo.InvariantCulture, $"<Override PartName=\"/xl/worksheets/sheet{sheet.SheetId}.bin\" ContentType=\"application/vnd.ms-excel.worksheet\"/>");
             }
+            foreach (XlsbSheetWriter sheet in _sheets)
+            {
+                foreach (WrittenTable table in sheet.Tables)
+                {
+                    sb.Append(CultureInfo.InvariantCulture, $"<Override PartName=\"/xl/tables/table{table.Id}.bin\" ContentType=\"application/vnd.ms-excel.table\"/>");
+                }
+            }
             sb.Append("</Types>");
             return sb.ToString();
         }
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
index fcb6d728..10ece1ff 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableBooks.cs
@@ -1,5 +1,6 @@
 using System.IO.Compression;
 using ExcelReader.Core.Writer;
+using ExcelReader.Core.Writer.Xlsb;
 using ExcelReader.Core.Writer.Xlsx;
 
 namespace ExcelReader.Tests.Writer.Tables
@@ -116,7 +117,7 @@ private static void WriteValue(TRow row, object? value)
 
     public static class TableBooks
     {
-        public static TheoryData<string> Formats { get; } = new() { "xlsx" };
+        public static TheoryData<string> Formats { get; } = new() { "xlsx", "xlsb" };
 
         internal static ITableBook Create(string format)
         {
@@ -124,6 +125,7 @@ internal static ITableBook Create(string format)
             return format switch
             {
                 "xlsx" => new TableBook<XlsxSheetWriter, XlsxRowWriter>(XlsxWorkbookWriter.Create(stream, leaveOpen: true), stream),
+                "xlsb" => new TableBook<XlsbSheetWriter, XlsbRowWriter>(XlsbWorkbookWriter.Create(stream, leaveOpen: true), stream),
                 _ => throw new ArgumentOutOfRangeException(nameof(format)),
             };
         }
diff --git a/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs b/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs
new file mode 100644
index 00000000..c08e8dd0
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs
@@ -0,0 +1,108 @@
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Writer;
+using B = ExcelReader.Tests.Reader.Xlsb.Biff12Build;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    public class XlsbTableShapeTests
+    {
+        [Fact]
+        public void TablePartHasExcelsRecordSequence()
+        {
+            List<(int Id, byte[] Payload)> records = Records(TableBooks.Entry(StockPackage(), "xl/tables/table1.bin"));
+
+            Assert.Equal([343, 161, 162, 345, 347, 348, 347, 348, 346, 513, 344], records.Select(static r => r.Id));
+        }
+
+        [Fact]
+        public void BeginListMatchesExcelsLayout()
+        {
+            byte[] payload = Records(TableBooks.Entry(StockPackage(), "xl/tables/table1.bin"))[0].Payload;
+
+            byte[] expected =
+            [
+                .. B.U32(0), .. B.U32(2), .. B.U32(0), .. B.U32(1),
+                .. B.U32(0), .. B.U32(1), .. B.U32(1), .. B.U32(0), .. B.U32(0),
+                .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+                .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+                .. B.U32(0),
+                .. B.WideString("Stock"), .. B.WideString("Stock"), .. B.WideString(""),
+                .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+            ];
+            Assert.Equal(108, payload.Length);
+            Assert.Equal(expected, payload);
+        }
+
+        [Fact]
+        public void ColumnsAutoFilterAndStyleMatchExcelsLayout()
+        {
+            List<(int Id, byte[] Payload)> records = Records(TableBooks.Entry(StockPackage(), "xl/tables/table1.bin"));
+
+            Assert.Equal([.. B.U32(0), .. B.U32(2), .. B.U32(0), .. B.U32(1)], records[1].Payload);
+            Assert.Equal(B.U32(2), records[3].Payload);
+            Assert.Equal(
+                [
+                    .. B.U32(1), .. B.U32(0), .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(), .. B.U32(0),
+                    .. B.NullWideString(), .. B.WideString("Product"),
+                    .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(), .. B.NullWideString(),
+                ],
+                records[4].Payload);
+            Assert.Equal([.. B.U16(4), .. B.WideString("TableStyleMedium2")], records[9].Payload);
+        }
+
+        [Fact]
+        public void StyleFlagsAndNullStyleAreEncoded()
+        {
+            ITableBook book = TableBooks.Create("xlsb");
+            book.AddSheet("S");
+            book.BeginTable("Plain", ["H"], new ExcelTableOptions
+            {
+                StyleName = null,
+                ShowFirstColumn = true,
+                ShowLastColumn = true,
+                ShowRowStripes = false,
+                ShowColumnStripes = true,
+            });
+
+            byte[] style = Records(TableBooks.Entry(book.Finish(), "xl/tables/table1.bin"))[^2].Payload;
+
+            Assert.Equal([.. B.U16(1 | 2 | 8), .. B.NullWideString()], style);
+        }
+
+        [Fact]
+        public void SheetListsItsTablePartsBeforeEndSheet()
+        {
+            byte[] package = StockPackage();
+
+            List<(int Id, byte[] Payload)> sheet = Records(TableBooks.Entry(package, "xl/worksheets/sheet1.bin"));
+
+            Assert.Equal([660, 661, 662, 130], sheet.Skip(sheet.Count - 4).Select(static r => r.Id));
+            Assert.Equal(B.U32(1), sheet[^4].Payload);
+            Assert.Equal(B.WideString("rId1"), sheet[^3].Payload);
+            string types = System.Text.Encoding.UTF8.GetString(TableBooks.Entry(package, "[Content_Types].xml"));
+            Assert.Contains("<Override PartName=\"/xl/tables/table1.bin\" ContentType=\"application/vnd.ms-excel.table\"/>", types, StringComparison.Ordinal);
+            Assert.Contains("Target=\"../tables/table1.bin\"", System.Text.Encoding.UTF8.GetString(TableBooks.Entry(package, "xl/worksheets/_rels/sheet1.bin.rels")), StringComparison.Ordinal);
+        }
+
+        private static byte[] StockPackage()
+        {
+            ITableBook book = TableBooks.Create("xlsb");
+            book.AddSheet("S");
+            book.BeginTable("Stock", ["Product", "Qty"]);
+            book.Row("Pen", 100);
+            book.Row("Notebook", 40);
+            return book.Finish();
+        }
+
+        private static List<(int Id, byte[] Payload)> Records(byte[] part)
+        {
+            List<(int, byte[])> records = [];
+            Biff12RecordReader reader = new(part);
+            while (reader.TryReadRecord(out int id, out ReadOnlySpan<byte> payload))
+            {
+                records.Add((id, payload.ToArray()));
+            }
+            return records;
+        }
+    }
+}

From 975d55d68a16dad47ac7e2e657497b7be318739d Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 01:02:20 -0300
Subject: [PATCH 057/115] feat(writer): write records as an Excel table; docs:
 document writing tables

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 docs/guide/writing.md                         | 37 ++++++++
 .../PublicAPI/PublicAPI.Unshipped.txt         |  2 +
 .../Writer/SheetWriterExtensions.cs           | 67 ++++++++++++++
 .../Writer/Tables/TableRecordWriterTests.cs   | 92 +++++++++++++++++++
 4 files changed, 198 insertions(+)
 create mode 100644 tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs

diff --git a/docs/guide/writing.md b/docs/guide/writing.md
index e2e9e6c8..9ed6793b 100644
--- a/docs/guide/writing.md
+++ b/docs/guide/writing.md
@@ -187,6 +187,43 @@ Column behavior mirrors the parser attributes:
 
 For a model marked `[ExcelSerializable]`, pass `ExcelRecordLayout.Generated<T>()` instead — same behavior, but driven by the source-generated map instead of reflection, so it stays Native AOT/trim-safe. See [Generate typed maps at compile time](parsing.md#generate-typed-maps-at-compile-time-native-aot--trimming).
 
+## Write an Excel table
+
+The XLSX and XLSB sheet writers implement `ITableSheetWriter<TRow>`. `BeginTable` writes the header row
+and opens a table there; every row written until `EndTable` (or the end of the sheet) belongs to it. The
+file opens in Excel already formatted as a table, with filter buttons and the chosen built-in style, and
+reads back through `IExcelWorkbook.Tables`.
+
+```csharp
+using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("report.xlsx"));
+XlsxSheetWriter sheet = workbook.AddSheet("Report");
+sheet.BeginTable("Sales", ["Product", "Qty", "Price"]);
+foreach (Sale s in sales)
+{
+    using XlsxRowWriter row = sheet.StartRow();
+    row.Write(s.Product);
+    row.Write(s.Qty);
+    row.Write(s.Price);
+}
+sheet.EndTable();
+```
+
+For records, `WriteTableAsync` does all three steps with the same layouts as `WriteRecordsAsync`:
+
+```csharp
+await sheet.WriteTableAsync(sales, "Sales", ExcelRecordLayout.FromAttributes<Sale>());
+```
+
+- `ExcelTableOptions` sets `FirstColumn`, `StyleName` (a built-in `TableStyleLight1`–`21`,
+  `TableStyleMedium1`–`28` or `TableStyleDark1`–`11`, or `null` for none; default `TableStyleMedium2`) and
+  the banding flags `ShowRowStripes`, `ShowColumnStripes`, `ShowFirstColumn`, `ShowLastColumn`.
+- With `FirstColumn > 0`, rows you write yourself must `Skip(FirstColumn)` to reach the table;
+  `WriteTableAsync` does it for you.
+- One table can be open per sheet at a time; write as many as you like one after another. Table names
+  must be valid Excel names, must not read as cell references (`A1`, `R1C1`), and must be unique in the
+  workbook, ignoring case. A table with no data rows gets one empty row, as Excel requires.
+- Totals rows, custom table styles, and tables in XLS or CSV are not supported.
+
 ## Prefetch compression (XLSX/XLSB writing)
 
 The write-side mirror of [Prefetch decompression](reading.md#prefetch-decompression-xlsxxlsb). XLSX and XLSB
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 3c110f0a..1742ce90 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -54,3 +54,5 @@ ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter.EndTable() -> void
 ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.BeginTable(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null) -> void
 ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.BeginTableAsync(string! name, System.Collections.Generic.IReadOnlyList<string!>! columns, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.EndTable() -> void
+static ExcelReader.Core.Writer.SheetWriterExtensions.WriteTableAsync<T, TRow>(this ExcelReader.Core.Writer.ITableSheetWriter<TRow>! sheet, System.Collections.Generic.IAsyncEnumerable<T>! records, string! name, ExcelReader.Core.Writer.ExcelRecordLayout<T>! layout, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+static ExcelReader.Core.Writer.SheetWriterExtensions.WriteTableAsync<T, TRow>(this ExcelReader.Core.Writer.ITableSheetWriter<TRow>! sheet, System.Collections.Generic.IEnumerable<T>! records, string! name, ExcelReader.Core.Writer.ExcelRecordLayout<T>! layout, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
diff --git a/src/ExcelReader.Core/Writer/SheetWriterExtensions.cs b/src/ExcelReader.Core/Writer/SheetWriterExtensions.cs
index 8de01f31..f312fed4 100644
--- a/src/ExcelReader.Core/Writer/SheetWriterExtensions.cs
+++ b/src/ExcelReader.Core/Writer/SheetWriterExtensions.cs
@@ -60,6 +60,73 @@ public static async ValueTask WriteRecordsAsync<T, TRow>(this ISheetWriter<TRow>
             await sheet.WriteRecordsAsync(records, writeRow, ct).ConfigureAwait(false);
         }
 
+        /// <summary>
+        /// Writes <paramref name="records"/> as an Excel table named <paramref name="name"/>: a header row from
+        /// <paramref name="layout"/>, then one row per record, then closes the table. The sheet stays open.
+        /// </summary>
+        /// <typeparam name="T">The record type being written.</typeparam>
+        /// <typeparam name="TRow">The concrete row writer type.</typeparam>
+        /// <param name="sheet">The XLSX or XLSB sheet to write to.</param>
+        /// <param name="records">The records to write, one row each, in enumeration order.</param>
+        /// <param name="name">The table name; see <see cref="ITableSheetWriter{TRow}.BeginTable"/>.</param>
+        /// <param name="layout">The columns to write, from <see cref="ExcelRecordLayout"/>.</param>
+        /// <param name="options">Position and style. Defaults to <see cref="ExcelTableOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel the operation between rows.</param>
+        public static async ValueTask WriteTableAsync<T, TRow>(this ITableSheetWriter<TRow> sheet, IEnumerable<T> records,
+                                                               string name, ExcelRecordLayout<T> layout,
+                                                               ExcelTableOptions? options = null, CancellationToken ct = default)
+                                                               where TRow : IRowWriter
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(records);
+            ArgumentNullException.ThrowIfNull(layout);
+            (string[] headers, Action<TRow, T> writeRow) = layout.Columns<TRow>();
+            await sheet.BeginTableAsync(name, headers, options, ct).ConfigureAwait(false);
+            await sheet.WriteRecordsAsync(records, ShiftToTable(writeRow, options), ct).ConfigureAwait(false);
+            sheet.EndTable();
+        }
+
+        /// <summary>
+        /// Writes the records produced by <paramref name="records"/> as an Excel table named <paramref name="name"/>,
+        /// as <see cref="WriteTableAsync{T, TRow}(ITableSheetWriter{TRow}, IEnumerable{T}, string, ExcelRecordLayout{T}, ExcelTableOptions?, CancellationToken)"/> does.
+        /// </summary>
+        /// <typeparam name="T">The record type being written.</typeparam>
+        /// <typeparam name="TRow">The concrete row writer type.</typeparam>
+        /// <param name="sheet">The XLSX or XLSB sheet to write to.</param>
+        /// <param name="records">The records to write, one row each, in enumeration order.</param>
+        /// <param name="name">The table name; see <see cref="ITableSheetWriter{TRow}.BeginTable"/>.</param>
+        /// <param name="layout">The columns to write, from <see cref="ExcelRecordLayout"/>.</param>
+        /// <param name="options">Position and style. Defaults to <see cref="ExcelTableOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel the operation between rows, and passed to the source enumerable.</param>
+        public static async ValueTask WriteTableAsync<T, TRow>(this ITableSheetWriter<TRow> sheet, IAsyncEnumerable<T> records,
+                                                               string name, ExcelRecordLayout<T> layout,
+                                                               ExcelTableOptions? options = null, CancellationToken ct = default)
+                                                               where TRow : IRowWriter
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(records);
+            ArgumentNullException.ThrowIfNull(layout);
+            (string[] headers, Action<TRow, T> writeRow) = layout.Columns<TRow>();
+            await sheet.BeginTableAsync(name, headers, options, ct).ConfigureAwait(false);
+            await sheet.WriteRecordsAsync(records, ShiftToTable(writeRow, options), ct).ConfigureAwait(false);
+            sheet.EndTable();
+        }
+
+        private static Action<TRow, T> ShiftToTable<TRow, T>(Action<TRow, T> writeRow, ExcelTableOptions? options)
+            where TRow : IRowWriter
+        {
+            int firstColumn = (options ?? ExcelTableOptions.Default).FirstColumn;
+            if (firstColumn == 0)
+            {
+                return writeRow;
+            }
+            return (row, item) =>
+            {
+                row.Skip(firstColumn);
+                writeRow(row, item);
+            };
+        }
+
         private static async ValueTask WriteHeaderAsync<TRow>(ISheetWriter<TRow> sheet, string[] headers, CancellationToken ct)
             where TRow : IRowWriter
         {
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs
new file mode 100644
index 00000000..2c68f11f
--- /dev/null
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs
@@ -0,0 +1,92 @@
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Writer;
+using ExcelReader.Core.Writer.Xlsb;
+using ExcelReader.Core.Writer.Xlsx;
+
+namespace ExcelReader.Tests.Writer.Tables
+{
+    public class TableRecordWriterTests
+    {
+        public sealed class Sale
+        {
+            public string? Product { get; set; }
+
+            public int Qty { get; set; }
+
+            public double Price { get; set; }
+        }
+
+        private static readonly Sale[] Sales =
+        [
+            new() { Product = "Pen", Qty = 10, Price = 2.5 },
+            new() { Product = "Notebook", Qty = 4, Price = 18.9 },
+        ];
+
+        [Fact]
+        public async Task XlsxRecordsRoundTripAsATable()
+        {
+            using MemoryStream stream = new();
+            await using (XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(stream, leaveOpen: true))
+            {
+                XlsxSheetWriter sheet = workbook.AddSheet("Report");
+                await sheet.WriteTableAsync(Sales, "Sales", ExcelRecordLayout.FromAttributes<Sale>(),
+                    ExcelTableOptions.Default with { FirstColumn = 1 }, TestContext.Current.CancellationToken);
+            }
+
+            AssertSalesTable(stream.ToArray(), "B1:D3");
+        }
+
+        [Fact]
+        public async Task XlsbAsyncRecordsRoundTripAsATable()
+        {
+            using MemoryStream stream = new();
+            await using (XlsbWorkbookWriter workbook = XlsbWorkbookWriter.Create(stream, leaveOpen: true))
+            {
+                XlsbSheetWriter sheet = workbook.AddSheet("Report");
+                await sheet.WriteTableAsync(Stream(), "Sales", ExcelRecordLayout.FromAttributes<Sale>(),
+                    ct: TestContext.Current.CancellationToken);
+            }
+
+            AssertSalesTable(stream.ToArray(), "A1:C3");
+        }
+
+        [Fact]
+        public async Task TableIsClosedSoAnotherCanFollow()
+        {
+            using MemoryStream stream = new();
+            await using (XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(stream, leaveOpen: true))
+            {
+                XlsxSheetWriter sheet = workbook.AddSheet("Report");
+                await sheet.WriteTableAsync(Sales, "First", ExcelRecordLayout.FromAttributes<Sale>(), ct: TestContext.Current.CancellationToken);
+                await sheet.WriteTableAsync(Sales, "Second", ExcelRecordLayout.FromAttributes<Sale>(), ct: TestContext.Current.CancellationToken);
+            }
+
+            using IExcelWorkbook read = Excel.Open(new ReadOnlyMemory<byte>(stream.ToArray()));
+            Assert.Equal([("First", "A1:C3"), ("Second", "A4:C6")], read.Tables.Select(static t => (t.Name, t.Ref)));
+        }
+
+        private static async IAsyncEnumerable<Sale> Stream()
+        {
+            foreach (Sale sale in Sales)
+            {
+                await Task.Yield();
+                yield return sale;
+            }
+        }
+
+        private static void AssertSalesTable(byte[] package, string reference)
+        {
+            using IExcelWorkbook read = Excel.Open(new ReadOnlyMemory<byte>(package));
+            ExcelTable table = Assert.Single(read.Tables);
+            Assert.Equal(("Sales", reference), (table.Name, table.Ref));
+            Assert.Equal(["Product", "Qty", "Price"], table.ColumnNames);
+            List<(string?, int, double)> rows = [];
+            foreach (Sale sale in ExcelParser.FromAttributes<Sale>().Parse(table.AsSheet()))
+            {
+                rows.Add((sale.Product, sale.Qty, sale.Price));
+            }
+            Assert.Equal([("Pen", 10, 2.5), ("Notebook", 4, 18.9)], rows);
+        }
+    }
+}

From 155f25b447ec7a25b3325822639405df6bf4ac4b Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 01:08:01 -0300
Subject: [PATCH 058/115] fix(writer): drop the stray sheet AutoFilter and sort
 state from XLSB sheets

Records 161/162 and 648/649/650 were mislabeled as cell metadata/table styles; in a worksheet they are BrtBeginAFilter/EndAFilter and BrtBeginSortState/SortCond/EndSortState, giving every sheet an A1:B1 filter that made Excel reject tables.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Xlsb/Brt.cs       |  5 -----
 .../Writer/Xlsb/XlsbSheetWriter.cs            | 12 ----------
 .../Writer/Tables/XlsbTableShapeTests.cs      | 22 +++++++++++++++++++
 3 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
index a28ec6e7..1a420bf6 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/Brt.cs
@@ -50,8 +50,6 @@ internal static class Brt
         internal const int BundleSh = 156;
         internal const int BeginSst = 159;
         internal const int EndSst = 160;
-        internal const int BeginCellMetadata = 161;
-        internal const int EndCellMetadata = 162;
         internal const int BeginStyleSheet = 278;
         internal const int EndStyleSheet = 279;
         internal const int BeginColInfos = 390;
@@ -71,9 +69,6 @@ internal static class Brt
         internal const int Style = 48;
         internal const int BeginCellStyleXFs = 626;
         internal const int EndCellStyleXFs = 627;
-        internal const int BeginTableStyles = 648;
-        internal const int TableStyleClient = 649;
-        internal const int EndTableStyles = 650;
         internal const int BeginBundleShs = 143;
         internal const int EndBundleShs = 144;
     }
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
index 1f4b81fb..6b9661dc 100644
--- a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
@@ -223,7 +223,6 @@ public void End()
                 EnsureStarted();
                 _tables.CloseOpen(_rowNumber);
                 WriteRecord(Brt.EndSheetData);
-                WriteSheetMetadata();
                 WriteListParts();
                 WriteRecord(Brt.EndSheet);
                 if (_stream is null)
@@ -256,7 +255,6 @@ public async ValueTask EndAsync(CancellationToken ct = default)
                 EnsureStarted();
                 _tables.CloseOpen(_rowNumber);
                 WriteRecord(Brt.EndSheetData);
-                WriteSheetMetadata();
                 WriteListParts();
                 WriteRecord(Brt.EndSheet);
                 if (_stream is null)
@@ -587,16 +585,6 @@ private void WriteWorksheetView()
             WriteRecord(Brt.EndWsView);
             WriteRecord(Brt.EndWsViews);
         }
-        private static ReadOnlySpan<byte> SheetMetadataPayload => [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00];
-        private static ReadOnlySpan<byte> TableStyleClientPayload => [0x04, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00];
-        private void WriteSheetMetadata()
-        {
-            WriteBlobRecord(Brt.BeginCellMetadata, SheetMetadataPayload);
-            WriteRecord(Brt.EndCellMetadata);
-            WriteRecord(Brt.BeginTableStyles);
-            WriteBlobRecord(Brt.TableStyleClient, TableStyleClientPayload);
-            WriteRecord(Brt.EndTableStyles);
-        }
 
         private void WriteCell(int columnIndex, XlsbCell cell)
         {
diff --git a/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs b/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs
index c08e8dd0..433de1fd 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/XlsbTableShapeTests.cs
@@ -84,6 +84,28 @@ public void SheetListsItsTablePartsBeforeEndSheet()
             Assert.Contains("Target=\"../tables/table1.bin\"", System.Text.Encoding.UTF8.GetString(TableBooks.Entry(package, "xl/worksheets/_rels/sheet1.bin.rels")), StringComparison.Ordinal);
         }
 
+        [Fact]
+        public void SheetWithoutTableHasNoAutoFilterOrSortState()
+        {
+            ITableBook book = TableBooks.Create("xlsb");
+            book.AddSheet("S");
+            book.Row("Pen", 100);
+
+            List<int> ids = [.. Records(TableBooks.Entry(book.Finish(), "xl/worksheets/sheet1.bin")).Select(static r => r.Id)];
+
+            Assert.DoesNotContain(161, ids);
+            Assert.DoesNotContain(648, ids);
+            Assert.Equal([146, 130], ids.Skip(ids.Count - 2));
+        }
+
+        [Fact]
+        public void TableSheetTailAfterSheetDataIsOnlyListParts()
+        {
+            List<int> ids = [.. Records(TableBooks.Entry(StockPackage(), "xl/worksheets/sheet1.bin")).Select(static r => r.Id)];
+
+            Assert.Equal([660, 661, 662, 130], ids.Skip(ids.IndexOf(146) + 1));
+        }
+
         private static byte[] StockPackage()
         {
             ITableBook book = TableBooks.Create("xlsb");

From 7634308f7e202bb377928b7b5a5590f2386cb7c8 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 01:17:10 -0300
Subject: [PATCH 059/115] fix(writer): keep the reserved row of a header-only
 table out of the next table

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Writer/Internal/TableTracker.cs           |  4 +-
 .../Writer/Xlsb/XlsbSheetWriter.cs            |  6 ++-
 .../Writer/Xlsx/XlsxSheetWriter.cs            | 16 +++++--
 .../Writer/Tables/TableRecordWriterTests.cs   | 15 +++++++
 .../Writer/Tables/TableWriterTests.cs         | 45 +++++++++++++++++++
 5 files changed, 80 insertions(+), 6 deletions(-)

diff --git a/src/ExcelReader.Core/Writer/Internal/TableTracker.cs b/src/ExcelReader.Core/Writer/Internal/TableTracker.cs
index 24ecf2ae..caa3776f 100644
--- a/src/ExcelReader.Core/Writer/Internal/TableTracker.cs
+++ b/src/ExcelReader.Core/Writer/Internal/TableTracker.cs
@@ -29,13 +29,15 @@ internal void Begin(int id, string name, string[] columns, ExcelTableOptions opt
             _open = new WrittenTable(id, name, columns, options, headerRow, headerRow);
         }
 
-        internal void End(int lastWrittenRow)
+        internal bool End(int lastWrittenRow)
         {
             if (_open is null)
             {
                 throw new InvalidOperationException("No table is open on this sheet.");
             }
+            bool headerOnly = lastWrittenRow <= _open.HeaderRow;
             CloseOpen(lastWrittenRow);
+            return headerOnly;
         }
 
         internal void CloseOpen(int lastWrittenRow)
diff --git a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
index 6b9661dc..61baab2f 100644
--- a/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsb/XlsbSheetWriter.cs
@@ -323,7 +323,11 @@ public ValueTask BeginTableAsync(string name, IReadOnlyList<string> columns, Exc
         public void EndTable()
         {
             WriterStateGuard.ThrowIfEnded(_state, this);
-            _tables.End(_rowNumber);
+            if (_tables.End(_rowNumber))
+            {
+                BeginRow(styleId: 0);
+                _rowActive = false;
+            }
         }
 
         private void Fault()
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
index f26d157a..d7639d0d 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
@@ -305,7 +305,11 @@ public async ValueTask BeginTableAsync(string name, IReadOnlyList<string> column
         public void EndTable()
         {
             WriterStateGuard.ThrowIfEnded(_state, this);
-            _tables.End(_rowNumber - 1);
+            if (_tables.End(_rowNumber - 1))
+            {
+                BeginRow(styleId: 0);
+                CloseBufferedRow();
+            }
         }
 
         private (string[] Names, ExcelTableOptions Options) PrepareTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options)
@@ -421,10 +425,15 @@ private int BeginRow(int styleId)
             return _rowNumber;
         }
 
-        internal void EndBufferedRow()
+        private void CloseBufferedRow()
         {
             _rowBuffer.Write("</row>"u8);
             _rowActive = false;
+        }
+
+        internal void EndBufferedRow()
+        {
+            CloseBufferedRow();
             if (_rowBuffer.Length >= FlushThreshold)
             {
                 FlushRowBuffer();
@@ -453,8 +462,7 @@ private void FlushRowBuffer()
 
         internal ValueTask EndBufferedRowAsync(CancellationToken ct = default)
         {
-            _rowBuffer.Write("</row>"u8);
-            _rowActive = false;
+            CloseBufferedRow();
             return _rowBuffer.Length >= FlushThreshold ? FlushRowBufferAsync(ct) : ValueTask.CompletedTask;
         }
 
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs
index 2c68f11f..41e7f771 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableRecordWriterTests.cs
@@ -66,6 +66,21 @@ public async Task TableIsClosedSoAnotherCanFollow()
             Assert.Equal([("First", "A1:C3"), ("Second", "A4:C6")], read.Tables.Select(static t => (t.Name, t.Ref)));
         }
 
+        [Fact]
+        public async Task EmptyTableDoesNotOverlapTheNextOne()
+        {
+            using MemoryStream stream = new();
+            await using (XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(stream, leaveOpen: true))
+            {
+                XlsxSheetWriter sheet = workbook.AddSheet("Report");
+                await sheet.WriteTableAsync(Array.Empty<Sale>(), "Empty", ExcelRecordLayout.FromAttributes<Sale>(), ct: TestContext.Current.CancellationToken);
+                await sheet.WriteTableAsync(Sales, "Full", ExcelRecordLayout.FromAttributes<Sale>(), ct: TestContext.Current.CancellationToken);
+            }
+
+            using IExcelWorkbook read = Excel.Open(new ReadOnlyMemory<byte>(stream.ToArray()));
+            Assert.Equal([("Empty", "A1:C2"), ("Full", "A3:C5")], read.Tables.Select(static t => (t.Name, t.Ref)));
+        }
+
         private static async IAsyncEnumerable<Sale> Stream()
         {
             foreach (Sale sale in Sales)
diff --git a/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
index a607f04e..3075defb 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/TableWriterTests.cs
@@ -1,5 +1,6 @@
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
 using ExcelReader.Core.Writer;
 
 namespace ExcelReader.Tests.Writer.Tables
@@ -95,6 +96,50 @@ public void HeaderOnlyTableGetsOneEmptyDataRow(string format)
             Assert.Equal("A1:A2", Assert.Single(workbook.Tables).Ref);
         }
 
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void TableAfterAHeaderOnlyTableStartsBelowItsReservedRow(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("A", ["H"]);
+            book.EndTable();
+            book.BeginTable("B", ["H"]);
+            book.Row("x");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Equal(
+                [("A", "A1:A2"), ("B", "A3:A4")],
+                workbook.Tables.Select(static t => (t.Name, t.Ref)));
+        }
+
+        [Theory]
+        [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
+        public void RowAfterAHeaderOnlyTableLandsOutsideIt(string format)
+        {
+            ITableBook book = TableBooks.Create(format);
+            book.AddSheet("Report");
+            book.BeginTable("A", ["H"]);
+            book.EndTable();
+            book.Row("x");
+
+            using IExcelWorkbook workbook = Read(book.Finish());
+
+            Assert.Equal("A1:A2", Assert.Single(workbook.Tables).Ref);
+            using IExcelRowEnumerator rows = workbook.SheetAt(0).GetEnumerator();
+            IRowIndexedEnumerator indexed = (IRowIndexedEnumerator)rows;
+            indexed.EnableRowIndex();
+            int lastIndex = -1;
+            string? lastText = null;
+            while (rows.MoveNext())
+            {
+                lastIndex = indexed.RowIndex;
+                lastText = rows.Current[0].GetString();
+            }
+            Assert.Equal((2, "x"), (lastIndex, lastText));
+        }
+
         [Theory]
         [MemberData(nameof(TableBooks.Formats), MemberType = typeof(TableBooks))]
         public void SheetEndClosesTheOpenTable(string format)

From 470f8c285069afb88b05c13578ca0129f76b1777 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 01:20:46 -0300
Subject: [PATCH 060/115] fix(writer): escape XLSX table column names like
 their header cells

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs     | 12 +++++++++---
 .../Writer/Tables/XlsxTableShapeTests.cs             | 12 ++++++++++++
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
index d1de1c19..6a96f7b1 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxTableXml.cs
@@ -1,5 +1,4 @@
 using System.Globalization;
-using System.Security;
 using System.Text;
 using ExcelReader.Core.Writer.Internal;
 
@@ -21,7 +20,7 @@ internal static string TableParts(int count)
 
         internal static string Table(WrittenTable table)
         {
-            string name = SecurityElement.Escape(table.Name);
+            string name = Escape(table.Name);
             string reference = table.Ref;
             StringBuilder sb = new();
             sb.Append("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>");
@@ -31,7 +30,7 @@ internal static string Table(WrittenTable table)
             sb.Append(CultureInfo.InvariantCulture, $"<tableColumns count=\"{table.Columns.Length}\">");
             for (int i = 0; i < table.Columns.Length; i++)
             {
-                sb.Append(CultureInfo.InvariantCulture, $"<tableColumn id=\"{i + 1}\" name=\"{SecurityElement.Escape(table.Columns[i])}\"/>");
+                sb.Append(CultureInfo.InvariantCulture, $"<tableColumn id=\"{i + 1}\" name=\"{Escape(table.Columns[i])}\"/>");
             }
             sb.Append("</tableColumns>");
             AppendStyleInfo(sb, table.Options);
@@ -39,6 +38,13 @@ internal static string Table(WrittenTable table)
             return sb.ToString();
         }
 
+        private static string Escape(string value)
+        {
+            using BiffBuffer buffer = new(value.Length + 16);
+            CellFormatter.WriteEscaped(buffer, value);
+            return Encoding.UTF8.GetString(buffer.Span);
+        }
+
         private static void AppendStyleInfo(StringBuilder sb, ExcelTableOptions options)
         {
             sb.Append("<tableStyleInfo");
diff --git a/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs b/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs
index 75fb1827..56f6de6f 100644
--- a/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Tables/XlsxTableShapeTests.cs
@@ -63,6 +63,18 @@ public void UnstyledTableOmitsTheStyleName()
             Assert.Contains("<tableStyleInfo showFirstColumn=\"0\" showLastColumn=\"0\" showRowStripes=\"1\" showColumnStripes=\"0\"/>", table, StringComparison.Ordinal);
         }
 
+        [Fact]
+        public void ColumnNameWithAnEscapeLookalikeIsEscapedLikeItsHeaderCell()
+        {
+            ITableBook book = TableBooks.Create("xlsx");
+            book.AddSheet("S");
+            book.BeginTable("Codes", ["Code_x0041_"]);
+            book.Row("a");
+            byte[] package = book.Finish();
+
+            Assert.Contains("<tableColumn id=\"1\" name=\"Code_x005F_x0041_\"/>", Text(package, "xl/tables/table1.xml"), StringComparison.Ordinal);
+        }
+
         private static byte[] TwoTables()
         {
             ITableBook book = TableBooks.Create("xlsx");

From 2fd4f7a17a476d09d6f93211e5ed3f38ac8dc846 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 01:49:52 -0300
Subject: [PATCH 061/115] docs: PrefetchDecompression applies to in-memory
 XLSX/XLSB reads

The in-memory FromXlsx/FromXlsb overloads claimed every part was materialized up front and that
PrefetchDecompression was ignored. Sheets are inflated as they are enumerated, and the option does
overlap that inflate with parsing (measured: 39 -> 24 ms XLSX, 24 -> 14 ms XLSB on 65K rows).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Excel.cs | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index 81afedbd..a81620e1 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -45,12 +45,13 @@ public static XlsxWorkbook FromXlsx(Stream stream, bool leaveOpen = true, ExcelR
 
         /// <summary>
         /// Opens an XLSX workbook directly from an in-memory buffer. Reads the ZIP
-        /// central directory and decompresses parts without a <c>ZipArchive</c>
-        /// or intermediate <see cref="Stream"/> — every part is fully materialized up front, so the returned
-        /// workbook never suspends, even under <c>await foreach</c>.
+        /// central directory without a <c>ZipArchive</c>. Small parts (workbook, styles, shared strings)
+        /// are decompressed whole; each sheet is decompressed as it is enumerated. Nothing waits on I/O, so
+        /// without <see cref="ExcelReaderOptions.PrefetchDecompression"/> enumeration never suspends, even
+        /// under <c>await foreach</c>.
         /// </summary>
         /// <param name="data">The whole XLSX file's bytes. Must stay valid and unmodified until the workbook and every enumerator obtained from it are disposed.</param>
-        /// <param name="options">Resource limits and behavior toggles; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>. <see cref="ExcelReaderOptions.PrefetchDecompression"/> is ignored on this path — there is nothing left to overlap.</param>
+        /// <param name="options">Resource limits and behavior toggles; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>. <see cref="ExcelReaderOptions.PrefetchDecompression"/> applies here too: a background thread inflates each sheet ahead of the parser, and async enumeration may then wait for it.</param>
         public static XlsxWorkbook FromXlsx(ReadOnlyMemory<byte> data, ExcelReaderOptions? options = null)
         {
             ExcelReaderOptions effective = options ?? ExcelReaderOptions.Default;
@@ -110,12 +111,13 @@ public static XlsbWorkbook FromXlsb(Stream stream, bool leaveOpen = true, ExcelR
 
         /// <summary>
         /// Opens an XLSB workbook directly from an in-memory buffer. Reads the ZIP
-        /// central directory and decompresses parts without a <c>ZipArchive</c>
-        /// or intermediate <see cref="Stream"/> — every part is fully materialized up front, so the returned
-        /// workbook never suspends, even under <c>await foreach</c>.
+        /// central directory without a <c>ZipArchive</c>. Small parts (workbook, styles, shared strings)
+        /// are decompressed whole; each sheet is decompressed as it is enumerated. Nothing waits on I/O, so
+        /// without <see cref="ExcelReaderOptions.PrefetchDecompression"/> enumeration never suspends, even
+        /// under <c>await foreach</c>.
         /// </summary>
         /// <param name="data">The whole XLSB file's bytes. Must stay valid and unmodified until the workbook and every enumerator obtained from it are disposed.</param>
-        /// <param name="options">Resource limits and behavior toggles; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>. <see cref="ExcelReaderOptions.PrefetchDecompression"/> is ignored on this path — there is nothing left to overlap.</param>
+        /// <param name="options">Resource limits and behavior toggles; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>. <see cref="ExcelReaderOptions.PrefetchDecompression"/> applies here too: a background thread inflates each sheet ahead of the parser, and async enumeration may then wait for it.</param>
         public static XlsbWorkbook FromXlsb(ReadOnlyMemory<byte> data, ExcelReaderOptions? options = null)
         {
             ExcelReaderOptions effective = options ?? ExcelReaderOptions.Default;

From fa71c84c7298c23f13d0eb5b95e819657b23cf76 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 02:07:52 -0300
Subject: [PATCH 062/115] chore: add the project icon to the NuGet packages and
 the README

assets/icon.svg is the master; icon.png (128 px) is packed as PackageIcon in ExcelReader.NET and
ExcelReader.Arrow, and social-preview.png (1280x640) is for the GitHub repository settings.
---
 README.md                                      |   2 ++
 assets/icon.png                                | Bin 0 -> 1047 bytes
 assets/icon.svg                                |   8 ++++++++
 assets/social-preview.png                      | Bin 0 -> 19978 bytes
 src/ExcelReader.Arrow/ExcelReader.Arrow.csproj |   2 ++
 src/ExcelReader.Core/ExcelReader.Core.csproj   |   2 ++
 6 files changed, 14 insertions(+)
 create mode 100644 assets/icon.png
 create mode 100644 assets/icon.svg
 create mode 100644 assets/social-preview.png

diff --git a/README.md b/README.md
index 57376477..643a01b6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+![ExcelReader logo](https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png)
+
 # ExcelReader
 
 [![CI](https://github.com/GabrielMarquezMatte/ExcelReader/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/GabrielMarquezMatte/ExcelReader/actions/workflows/ci.yml)
diff --git a/assets/icon.png b/assets/icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..72e431aa01faeda1e3fdf3beaec1cd3cea2b5f69
GIT binary patch
literal 1047
zcmeAS@N?(olHy`uVBq!ia0vp^4Is?H1|$#LC7uRSjKx9jP7LeL$-D$|SkfJR9T^xl
z_H+M9WCij$3p^r=85sBugD~Uq{1qt-49sghT^vIy;@)0U>=zCcIr?#;1;^&A>xB+(
zQBi4OX+H9q_1Z^X4x#Nroon0_Cr&*vRePg`2M1@-%-dTo_~h-LJJY<}@A(`xd&bL?
z=6wJ6X4{Q=Tc4|+yDLje4dd5jZ#U9>U9|6qfp>TK?brYQ@0vf2f1CLG+JI&0spb3j
z{#&#{|Nr98YBM(!#ns-7shc@Xf3Nw8FK2^FBX7KCeZMf^M+|#FtTlg&)7Q=a{=T;r
z5aVi?!=$jB;e;kb5fRKg4;X9ye~hmBaLz=XmEoNA<vAh@7VmwEgBTv{F+Qtl!|>iV
zmgnpHKHaM6Obo(%y%`%i?=59G;PO6*Az@LuCWFDn-69M#Uc_=S_<Yf0Wl$qYnYIl>
z=5aJDJsBH51Km=~$wHcKrau|N^5@_E_v_1}1?KDL@0x%6<?o-{{O(TWKI-34+_m8B
zI+=_*);ZoRx#eG7zsf$4QF^gyHUBRC#utJmcdv@ZGO$@T+3nu7fakyhw+rRr(OVcL
zj&Kyc$!fM@Xclu^7rT5B{{aQp3B}hnMGlC0vFt3r>&p1Xu_K`)_P9nv+eT%Htm}$g
z2Mp6#oZo%YXkb3pmGC0gm+L`?p;E_<t^SNMiQ-RU@ASoP_`Y+l-u!;BkioI1vlo_|
zYBC&;n4aHu=V>4VZ*tr|NsvJa=WhUoZj|;g-Ei7bGr9VDtcU~e(@(zVVwW%AXL$L^
z7vvy5hPR)5`(kr1ur*ZtT=st5HVtNny)~E9!^KM&72@~3+_hSJ6~hJn`z1H8vimYT
zFZj9a?Yey$Ocv8mo9C82HTcPJ?&YVmD|Z(y{4La>M?}P}`@pb77M?bs5d}#!Z2S%z
zh)Zzr#97L4)%<;<PrPOPpN;bwRzG82xKS@{<*pJrjz*)<_uSQ2>m$tNPd&N2WXii-
zCXLIF-M_}y<nD1?_Bw6aG=H<{`~PcQeiZvRK+z|}a{ap3`hUa!|9dX(`ceFl+_rr8
T4&8si%*^2F>gTe~DWM4fJ5|8m

literal 0
HcmV?d00001

diff --git a/assets/icon.svg b/assets/icon.svg
new file mode 100644
index 00000000..bf83f09d
--- /dev/null
+++ b/assets/icon.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" role="img" aria-label="ExcelReader">
+  <rect width="128" height="128" rx="6" fill="#14202E"/>
+  <rect x="26" y="26" width="76" height="76" fill="none" stroke="#E8EEF4" stroke-width="4"/>
+  <rect x="24" y="46" width="80" height="4" fill="#E8EEF4"/>
+  <rect x="46" y="24" width="4" height="80" fill="#E8EEF4"/>
+  <polygon points="56,60 64,60 80,76 64,92 56,92 72,76" fill="#F2A93B"/>
+  <polygon points="72,60 80,60 96,76 80,92 72,92 88,76" fill="#F2A93B"/>
+</svg>
diff --git a/assets/social-preview.png b/assets/social-preview.png
new file mode 100644
index 0000000000000000000000000000000000000000..33f1aa114373e84e5a815061fe94f7adc5986a46
GIT binary patch
literal 19978
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
YUwWc;YYlj38vuB1-t}#%=YdoI2M%3TX#fBK

literal 0
HcmV?d00001

diff --git a/src/ExcelReader.Arrow/ExcelReader.Arrow.csproj b/src/ExcelReader.Arrow/ExcelReader.Arrow.csproj
index 6b2a5232..2e0e098e 100644
--- a/src/ExcelReader.Arrow/ExcelReader.Arrow.csproj
+++ b/src/ExcelReader.Arrow/ExcelReader.Arrow.csproj
@@ -14,6 +14,7 @@
     <PackageTags>excel;arrow;apache-arrow;recordbatch;interop</PackageTags>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageReadmeFile>README.md</PackageReadmeFile>
+    <PackageIcon>icon.png</PackageIcon>
     <PackageProjectUrl>https://github.com/GabrielMarquezMatte/ExcelReader</PackageProjectUrl>
     <RepositoryUrl>https://github.com/GabrielMarquezMatte/ExcelReader</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
@@ -32,6 +33,7 @@
 
   <ItemGroup>
     <None Include="..\..\README.md" Pack="true" PackagePath="\" />
+    <None Include="..\..\assets\icon.png" Pack="true" PackagePath="\" Visible="false" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/ExcelReader.Core/ExcelReader.Core.csproj b/src/ExcelReader.Core/ExcelReader.Core.csproj
index f8a3cc5b..3bf3c80e 100644
--- a/src/ExcelReader.Core/ExcelReader.Core.csproj
+++ b/src/ExcelReader.Core/ExcelReader.Core.csproj
@@ -18,6 +18,7 @@
     <PackageTags>excel;xlsx;xlsb;xls;csv;reader;writer;parser;spreadsheet;streaming;performance;low-allocation</PackageTags>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageReadmeFile>README.md</PackageReadmeFile>
+    <PackageIcon>icon.png</PackageIcon>
     <PackageProjectUrl>https://github.com/GabrielMarquezMatte/ExcelReader</PackageProjectUrl>
     <RepositoryUrl>https://github.com/GabrielMarquezMatte/ExcelReader</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
@@ -37,6 +38,7 @@
   <ItemGroup>
     <None Include="..\..\README.md" Pack="true" PackagePath="\" />
     <None Include="..\..\THIRD-PARTY-NOTICES.md" Pack="true" PackagePath="\" />
+    <None Include="..\..\assets\icon.png" Pack="true" PackagePath="\" Visible="false" />
   </ItemGroup>
 
   <!-- Binary parsers (BIFF12 framing, etc.) are internal but warrant isolated unit tests. -->

From 30edcd0e0681bb4aeed145eb0b077a035e7d7590 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 02:09:40 -0300
Subject: [PATCH 063/115] chore: show the project icon in the Python, Rust and
 C++ READMEs and on docs.rs

---
 cpp/README.md               | 2 ++
 python/README.md            | 2 ++
 rust/excelreader/README.md  | 2 ++
 rust/excelreader/src/lib.rs | 4 ++++
 4 files changed, 10 insertions(+)

diff --git a/cpp/README.md b/cpp/README.md
index 78a00821..d756c881 100644
--- a/cpp/README.md
+++ b/cpp/README.md
@@ -1,3 +1,5 @@
+![ExcelReader logo](https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png)
+
 # excelreader (C++)
 
 Header-only C++23 wrapper around ExcelReader's native C ABI: opening a workbook (from a path or
diff --git a/python/README.md b/python/README.md
index aff81b8f..d04edc65 100644
--- a/python/README.md
+++ b/python/README.md
@@ -1,3 +1,5 @@
+![ExcelReader logo](https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png)
+
 # excelreader (Python)
 
 Read and write XLSX, XLSB, XLS and CSV through ExcelReader's NativeAOT library. No .NET runtime
diff --git a/rust/excelreader/README.md b/rust/excelreader/README.md
index d00f2f6a..61c5412a 100644
--- a/rust/excelreader/README.md
+++ b/rust/excelreader/README.md
@@ -1,3 +1,5 @@
+![ExcelReader logo](https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png)
+
 # excelreader (Rust)
 
 Read and write Excel/CSV workbooks via ExcelReader's native ABI: opening a workbook (from a path or
diff --git a/rust/excelreader/src/lib.rs b/rust/excelreader/src/lib.rs
index 53550150..1f2b200a 100644
--- a/rust/excelreader/src/lib.rs
+++ b/rust/excelreader/src/lib.rs
@@ -1,6 +1,10 @@
 //! Raw FFI bindings to ExcelReader's C ABI (`excelreader.h`). The `extern "C"` block below is
 //! declared directly in this crate root (not a submodule), so `crate::xl_open_file` etc. resolve
 //! from anywhere in the crate. See the `workbook` module for the safe wrapper built on top of this.
+#![doc(
+    html_logo_url = "https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png",
+    html_favicon_url = "https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png"
+)]
 
 pub mod aggregate;
 mod error;

From 7e0a8dbf202f0e12a30086af3056dd23a82f213e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 21:38:52 -0300
Subject: [PATCH 064/115] refactor!: rename the parallel record, accumulator
 and aggregation contracts off their CSV names

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Parser/ParallelCsv/MappedAggregation.cs   |  8 +-
 .../Parser/ParallelCsv/MappedCallback.cs      |  6 +-
 .../Parser/ParallelCsv/MappedProjection.cs    |  4 +-
 .../{CsvModelSink.cs => ModelSink.cs}         |  2 +-
 .../ParallelCsv/ParallelCsvProcessor.cs       | 38 ++++----
 .../Parser/ParallelCsv/RecordAggregation.cs   |  7 +-
 .../Parser/ParallelCsv/RecordCallback.cs      |  6 +-
 ...cumulateFactory.cs => RowActionFactory.cs} |  2 +-
 .../PublicAPI/PublicAPI.Shipped.txt           | 36 ++++----
 .../Reader/Csv/CsvParallel.cs                 | 88 +++++++++----------
 .../ICsvAccumulator.cs => IRowAccumulator.cs} | 10 ++-
 .../{Csv/ICsvRecord.cs => IRowRecord.cs}      |  8 +-
 .../{Csv/CsvRowAction.cs => RowAction.cs}     |  6 +-
 .../CsvAggregation.cs => RowAggregation.cs}   | 12 +--
 src/ExcelReader.Native/Csv/CsvAggregateApi.cs |  4 +-
 .../Typed/TypedApi.Parallel.cs                |  2 +-
 .../Parse/CsvParallelParseBenchmark.cs        |  5 +-
 .../ParallelCsv/AggregateCsvModelTests.cs     |  4 +-
 .../ParallelCsv/AggregateCsvParallelTests.cs  | 24 ++---
 .../ParallelCsv/CsvReaderChunkSourceTests.cs  |  2 +-
 .../ParallelCsv/ForEachCsvParallelTests.cs    |  6 +-
 21 files changed, 145 insertions(+), 135 deletions(-)
 rename src/ExcelReader.Core/Parser/ParallelCsv/{CsvModelSink.cs => ModelSink.cs} (51%)
 rename src/ExcelReader.Core/Parser/ParallelCsv/{CsvAccumulateFactory.cs => RowActionFactory.cs} (53%)
 rename src/ExcelReader.Core/Reader/{Csv/ICsvAccumulator.cs => IRowAccumulator.cs} (87%)
 rename src/ExcelReader.Core/Reader/{Csv/ICsvRecord.cs => IRowRecord.cs} (82%)
 rename src/ExcelReader.Core/Reader/{Csv/CsvRowAction.cs => RowAction.cs} (73%)
 rename src/ExcelReader.Core/Reader/{Csv/CsvAggregation.cs => RowAggregation.cs} (75%)

diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
index fa08f6c6..aef12a45 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
@@ -4,13 +4,13 @@
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
     internal static class MappedAggregation<TAccumulator, TModel>
-        where TAccumulator : ICsvAccumulator<TAccumulator, TModel>, new()
+        where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
         where TModel : allows ref struct
     {
-        private static readonly CsvModelSink<TAccumulator, TModel> Sink =
+        private static readonly ModelSink<TAccumulator, TModel> Sink =
             static (ref TAccumulator accumulator, TModel model) => accumulator.Add(model);
 
-        internal static readonly CsvAggregation<TAccumulator> Unbound = new()
+        internal static readonly RowAggregation<TAccumulator> Unbound = new()
         {
             Seed = static () => new TAccumulator(),
             Accumulate = static (ref _, _) => throw new InvalidOperationException("The model map was not bound before the first record."),
@@ -21,7 +21,7 @@ internal static class MappedAggregation<TAccumulator, TModel>
             },
         };
 
-        internal static CsvAccumulateFactory<TAccumulator> Binder(ExcelParser<TModel> parser, int headerRow)
+        internal static RowActionFactory<TAccumulator> Binder(ExcelParser<TModel> parser, int headerRow)
         {
             return (Row header, bool sequential) =>
                 MappedProjection<TAccumulator, TModel>.Bind(parser, header, headerRow, sequential, Sink);
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
index 0722a6fc..53640f08 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
@@ -6,16 +6,16 @@ namespace ExcelReader.Core.Parser.ParallelCsv
     internal static class MappedCallback<TModel>
         where TModel : allows ref struct
     {
-        internal static readonly CsvAggregation<byte> Unbound = new()
+        internal static readonly RowAggregation<byte> Unbound = new()
         {
             Seed = static () => 0,
             Accumulate = static (ref _, _) => throw new InvalidOperationException("The model map was not bound before the first record."),
             Combine = static (left, _) => left,
         };
 
-        internal static CsvAccumulateFactory<byte> Binder(ExcelParser<TModel> parser, int headerRow, Action<TModel> body)
+        internal static RowActionFactory<byte> Binder(ExcelParser<TModel> parser, int headerRow, Action<TModel> body)
         {
-            CsvModelSink<byte, TModel> sink = (ref byte _, TModel model) => body(model);
+            ModelSink<byte, TModel> sink = (ref byte _, TModel model) => body(model);
             return (Row header, bool sequential) =>
                 MappedProjection<byte, TModel>.Bind(parser, header, headerRow, sequential, sink);
         }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
index 58249b82..32144cb2 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
@@ -9,8 +9,8 @@ internal static class MappedProjection<TState, TModel>
     {
         private const int StackallocLimit = 256;
 
-        internal static CsvRowAction<TState> Bind(
-            ExcelParser<TModel> parser, Row header, int headerRow, bool sequential, CsvModelSink<TState, TModel> sink)
+        internal static RowAction<TState> Bind(
+            ExcelParser<TModel> parser, Row header, int headerRow, bool sequential, ModelSink<TState, TModel> sink)
         {
             TypeMapInfo<TModel> info = parser.CsvInfo;
             ExcelParserConfig config = parser.Config;
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvModelSink.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ModelSink.cs
similarity index 51%
rename from src/ExcelReader.Core/Parser/ParallelCsv/CsvModelSink.cs
rename to src/ExcelReader.Core/Parser/ParallelCsv/ModelSink.cs
index daab7434..22bbc4dd 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvModelSink.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ModelSink.cs
@@ -1,5 +1,5 @@
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
-    internal delegate void CsvModelSink<TState, TModel>(ref TState state, TModel model)
+    internal delegate void ModelSink<TState, TModel>(ref TState state, TModel model)
         where TModel : allows ref struct;
 }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
index b1822f87..f6f64e92 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
@@ -22,7 +22,7 @@ private sealed class ChunkOutcome<TState>(long actualStart, TState state)
         }
 
         internal static async Task<TState> RunAsync<TState>(
-            string path, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
+            string path, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
         {
             options = WithResolvedDialect(options, CsvDialectResolver.Resolve(path, options.Reader));
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
@@ -37,7 +37,7 @@ internal static async Task<TState> RunAsync<TState>(
         }
 
         internal static Task<TState> RunAsync<TState>(
-            ReadOnlyMemory<byte> data, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
+            ReadOnlyMemory<byte> data, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
         {
             options = WithResolvedDialect(options, CsvDialectResolver.Resolve(data, options.Reader));
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
@@ -49,7 +49,7 @@ internal static Task<TState> RunAsync<TState>(
         }
 
         internal static async Task<TState> RunAsync<TState>(
-            Stream stream, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
+            Stream stream, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
         {
             options = WithResolvedDialect(options, await CsvDialectResolver.ResolveAsync(stream, options.Reader, ct).ConfigureAwait(false));
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
@@ -63,7 +63,7 @@ internal static async Task<TState> RunAsync<TState>(
         }
 
         internal static Task<TState> RunWithChunkSizeAsync<TState>(
-            ReadOnlyMemory<byte> data, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, CsvParallelOptions options, int chunkSize, CancellationToken ct)
+            ReadOnlyMemory<byte> data, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, int chunkSize, CancellationToken ct)
         {
             options = WithResolvedDialect(options, CsvDialectResolver.Resolve(data, options.Reader));
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
@@ -71,7 +71,7 @@ internal static Task<TState> RunWithChunkSizeAsync<TState>(
         }
 
         internal static Task<TState> RunPartitionedAsync<TState>(
-            CsvChunkSource source, CsvAggregation<TState> aggregation, CsvParallelOptions options, int chunkSizeOverride, CancellationToken ct)
+            CsvChunkSource source, RowAggregation<TState> aggregation, CsvParallelOptions options, int chunkSizeOverride, CancellationToken ct)
         {
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
             return PartitionedAsync(source, aggregation, null, options, dop, chunkSizeOverride, ct);
@@ -91,13 +91,13 @@ private static CsvParallelOptions WithResolvedDialect(CsvParallelOptions options
             };
         }
 
-        private static CsvAggregation<TState> WithAccumulate<TState>(CsvAggregation<TState> aggregation, CsvRowAction<TState> accumulate)
+        private static RowAggregation<TState> WithAccumulate<TState>(RowAggregation<TState> aggregation, RowAction<TState> accumulate)
         {
-            return new CsvAggregation<TState> { Seed = aggregation.Seed, Accumulate = accumulate, Combine = aggregation.Combine };
+            return new RowAggregation<TState> { Seed = aggregation.Seed, Accumulate = accumulate, Combine = aggregation.Combine };
         }
 
         private static async Task<TState> SequentialAsync<TState>(
-            CsvReader reader, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, int headerRow, CancellationToken ct)
+            CsvReader reader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
         {
             await using (reader.ConfigureAwait(false))
             {
@@ -135,14 +135,14 @@ private static async Task<TState> SequentialAsync<TState>(
         }
 
         private static async Task<TState> PartitionedAsync<TState>(
-            CsvChunkSource source, CsvAggregation<TState> aggregation, CsvAccumulateFactory<TState>? factory, CsvParallelOptions options, int dop, int chunkSizeOverride,
+            CsvChunkSource source, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, int dop, int chunkSizeOverride,
             CancellationToken ct)
         {
             CsvReaderOptions reader = options.Reader;
             long dataStart = 0;
             if (options.HeaderRow > 0)
             {
-                (dataStart, CsvRowAction<TState>? bound) = await RecordStartAfterAsync(source, reader, options.HeaderRow, factory, ct).ConfigureAwait(false);
+                (dataStart, RowAction<TState>? bound) = await RecordStartAfterAsync(source, reader, options.HeaderRow, factory, ct).ConfigureAwait(false);
                 if (bound is not null)
                 {
                     aggregation = WithAccumulate(aggregation, bound);
@@ -189,7 +189,7 @@ private static async Task<TState> PartitionedAsync<TState>(
 
         private static async Task DrainPlanAsync<TState>(
             CsvChunkSource source, CsvChunkPlan plan, long dataStart, CsvReaderOptions reader,
-            CsvAggregation<TState> aggregation, ChunkOutcome<TState>[] outcomes, CancellationToken ct)
+            RowAggregation<TState> aggregation, ChunkOutcome<TState>[] outcomes, CancellationToken ct)
         {
             while (plan.TryTakeNext(out CsvChunk chunk))
             {
@@ -201,7 +201,7 @@ private static async Task DrainPlanAsync<TState>(
 
         private static ValueTask<ChunkOutcome<TState>> ParseChunkAsync<TState>(
             CsvChunkSource source, CsvChunk chunk, long start, CsvReaderOptions reader,
-            CsvAggregation<TState> aggregation, CancellationToken ct)
+            RowAggregation<TState> aggregation, CancellationToken ct)
         {
             var outcome = new ChunkOutcome<TState>(start, aggregation.Seed());
             if (start >= source.Length)
@@ -219,7 +219,7 @@ private static ValueTask<ChunkOutcome<TState>> ParseChunkAsync<TState>(
 
         private static void ParseMemoryChunk<TState>(
             CsvChunkSource source, CsvChunk chunk, ChunkOutcome<TState> outcome, CsvReaderOptions chunkOptions,
-            CsvRowAction<TState> accumulate, CancellationToken ct)
+            RowAction<TState> accumulate, CancellationToken ct)
         {
             var rows = new CsvReader.Enumerator(source.SliceAt(outcome.ActualStart), chunkOptions, ct);
             try
@@ -244,7 +244,7 @@ private static void ParseMemoryChunk<TState>(
 
         private static async ValueTask<ChunkOutcome<TState>> ParseFileChunkAsync<TState>(
             CsvChunkSource source, CsvChunk chunk, ChunkOutcome<TState> outcome, CsvReaderOptions chunkOptions,
-            CsvRowAction<TState> accumulate, CancellationToken ct)
+            RowAction<TState> accumulate, CancellationToken ct)
         {
             Stream partition = source.OpenAt(outcome.ActualStart);
             await using (partition.ConfigureAwait(false))
@@ -272,7 +272,7 @@ private static async ValueTask<ChunkOutcome<TState>> ParseFileChunkAsync<TState>
         }
 
         private static bool DeliverWithinChunk<TState>(
-            CsvReader.Enumerator rows, CsvChunk chunk, ChunkOutcome<TState> outcome, CsvRowAction<TState> accumulate, CancellationToken ct)
+            CsvReader.Enumerator rows, CsvChunk chunk, ChunkOutcome<TState> outcome, RowAction<TState> accumulate, CancellationToken ct)
         {
             long absolute = outcome.ActualStart + rows.CurrentRecordStart;
             if (absolute >= chunk.End)
@@ -288,15 +288,15 @@ private static bool DeliverWithinChunk<TState>(
             return true;
         }
 
-        private static void Deliver<TState>(CsvRowAction<TState> accumulate, ref TState state, CsvReader.Enumerator rows)
+        private static void Deliver<TState>(RowAction<TState> accumulate, ref TState state, CsvReader.Enumerator rows)
         {
             accumulate(ref state, rows.Current);
         }
 
-        private static async Task<(long Start, CsvRowAction<TState>? Accumulate)> RecordStartAfterAsync<TState>(
-            CsvChunkSource source, CsvReaderOptions reader, int records, CsvAccumulateFactory<TState>? factory, CancellationToken ct)
+        private static async Task<(long Start, RowAction<TState>? Accumulate)> RecordStartAfterAsync<TState>(
+            CsvChunkSource source, CsvReaderOptions reader, int records, RowActionFactory<TState>? factory, CancellationToken ct)
         {
-            CsvRowAction<TState>? bound = null;
+            RowAction<TState>? bound = null;
             CsvReader csv = source.OpenReader(reader);
             await using (csv.ConfigureAwait(false))
             {
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/RecordAggregation.cs b/src/ExcelReader.Core/Parser/ParallelCsv/RecordAggregation.cs
index 3704d893..99457ac8 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/RecordAggregation.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/RecordAggregation.cs
@@ -1,12 +1,13 @@
+using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
     internal static class RecordAggregation<TAccumulator, TRecord>
-        where TAccumulator : ICsvAccumulator<TAccumulator, TRecord>, new()
-        where TRecord : ICsvRecord<TRecord>, allows ref struct
+        where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
+        where TRecord : IRowRecord<TRecord>, allows ref struct
     {
-        internal static readonly CsvAggregation<TAccumulator> Instance = new()
+        internal static readonly RowAggregation<TAccumulator> Instance = new()
         {
             Seed = static () => new TAccumulator(),
             Accumulate = static (ref accumulator, row) =>
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/RecordCallback.cs b/src/ExcelReader.Core/Parser/ParallelCsv/RecordCallback.cs
index 050c5c13..c71f1177 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/RecordCallback.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/RecordCallback.cs
@@ -4,11 +4,11 @@
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
     internal static class RecordCallback<TRecord>
-        where TRecord : ICsvRecord<TRecord>, allows ref struct
+        where TRecord : IRowRecord<TRecord>, allows ref struct
     {
-        internal static CsvAggregation<byte> For(Action<TRecord> body)
+        internal static RowAggregation<byte> For(Action<TRecord> body)
         {
-            return new CsvAggregation<byte>
+            return new RowAggregation<byte>
             {
                 Seed = static () => 0,
                 Accumulate = (ref byte _, Row row) =>
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvAccumulateFactory.cs b/src/ExcelReader.Core/Parser/ParallelCsv/RowActionFactory.cs
similarity index 53%
rename from src/ExcelReader.Core/Parser/ParallelCsv/CsvAccumulateFactory.cs
rename to src/ExcelReader.Core/Parser/ParallelCsv/RowActionFactory.cs
index ad7b54c3..a8a11da6 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvAccumulateFactory.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/RowActionFactory.cs
@@ -3,5 +3,5 @@
 
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
-    internal delegate CsvRowAction<TState> CsvAccumulateFactory<TState>(Row header, bool sequential);
+    internal delegate RowAction<TState> RowActionFactory<TState>(Row header, bool sequential);
 }
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 514d6008..848ebba8 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -109,14 +109,14 @@ ExcelReader.Core.Reader.CellType.Error = 6 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.ExcelString = 1 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.Formula = 5 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.Number = 2 -> ExcelReader.Core.Reader.CellType
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Accumulate.get -> ExcelReader.Core.Reader.Csv.CsvRowAction<TState>!
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Accumulate.init -> void
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Combine.get -> System.Func<TState, TState, TState>!
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Combine.init -> void
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.CsvAggregation() -> void
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Seed.get -> System.Func<TState>!
-ExcelReader.Core.Reader.Csv.CsvAggregation<TState>.Seed.init -> void
+ExcelReader.Core.Reader.RowAggregation<TState>
+ExcelReader.Core.Reader.RowAggregation<TState>.Accumulate.get -> ExcelReader.Core.Reader.RowAction<TState>!
+ExcelReader.Core.Reader.RowAggregation<TState>.Accumulate.init -> void
+ExcelReader.Core.Reader.RowAggregation<TState>.Combine.get -> System.Func<TState, TState, TState>!
+ExcelReader.Core.Reader.RowAggregation<TState>.Combine.init -> void
+ExcelReader.Core.Reader.RowAggregation<TState>.RowAggregation() -> void
+ExcelReader.Core.Reader.RowAggregation<TState>.Seed.get -> System.Func<TState>!
+ExcelReader.Core.Reader.RowAggregation<TState>.Seed.init -> void
 ExcelReader.Core.Reader.Csv.CsvDialect
 ExcelReader.Core.Reader.Csv.CsvDialect.CsvDialect() -> void
 ExcelReader.Core.Reader.Csv.CsvDialect.Delimiter.get -> byte
@@ -168,7 +168,7 @@ ExcelReader.Core.Reader.Csv.CsvReaderOptions.Quote.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect.get -> bool
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.WithDialect(ExcelReader.Core.Reader.Csv.CsvDialect dialect) -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
-ExcelReader.Core.Reader.Csv.CsvRowAction<TState>
+ExcelReader.Core.Reader.RowAction<TState>
 ExcelReader.Core.Reader.Csv.CsvSheet
 ExcelReader.Core.Reader.Csv.CsvSheet.CsvSheet() -> void
 ExcelReader.Core.Reader.Csv.CsvSheet.Equals(ExcelReader.Core.Reader.Csv.CsvSheet other) -> bool
@@ -189,11 +189,11 @@ ExcelReader.Core.Reader.Csv.CsvSnifferOptions.CsvSnifferOptions() -> void
 ExcelReader.Core.Reader.Csv.CsvSnifferOptions.Equals(ExcelReader.Core.Reader.Csv.CsvSnifferOptions? other) -> bool
 ExcelReader.Core.Reader.Csv.CsvSnifferOptions.MaxSampleLines.get -> int
 ExcelReader.Core.Reader.Csv.CsvSnifferOptions.MaxSampleLines.init -> void
-ExcelReader.Core.Reader.Csv.ICsvAccumulator<TSelf, TModel>
-ExcelReader.Core.Reader.Csv.ICsvAccumulator<TSelf, TModel>.Add(TModel model) -> void
-ExcelReader.Core.Reader.Csv.ICsvAccumulator<TSelf, TModel>.Merge(TSelf following) -> void
-ExcelReader.Core.Reader.Csv.ICsvRecord<TSelf>
-ExcelReader.Core.Reader.Csv.ICsvRecord<TSelf>.TryParse(ExcelReader.Core.Reader.Row row, out TSelf record) -> bool
+ExcelReader.Core.Reader.IRowAccumulator<TSelf, TModel>
+ExcelReader.Core.Reader.IRowAccumulator<TSelf, TModel>.Add(TModel model) -> void
+ExcelReader.Core.Reader.IRowAccumulator<TSelf, TModel>.Merge(TSelf following) -> void
+ExcelReader.Core.Reader.IRowRecord<TSelf>
+ExcelReader.Core.Reader.IRowRecord<TSelf>.TryParse(ExcelReader.Core.Reader.Row row, out TSelf record) -> bool
 ExcelReader.Core.Reader.Excel
 ExcelReader.Core.Reader.ExcelDataReader
 ExcelReader.Core.Reader.ExcelDataReader.Close() -> void
@@ -699,9 +699,9 @@ static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TMod
 static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(System.IO.Stream! stream, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
 static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
 static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(string! path, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.IO.Stream! stream, ExcelReader.Core.Reader.Csv.CsvAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.Csv.CsvAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(string! path, ExcelReader.Core.Reader.Csv.CsvAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
+static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.IO.Stream! stream, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
+static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
+static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(string! path, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
 static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(System.IO.Stream! stream, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
 static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
 static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(string! path, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
@@ -834,7 +834,7 @@ virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.DisposeAsyn
 virtual ExcelReader.Core.Parser.ExcelCellReader<TValue>.Invoke(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TValue value) -> bool
 virtual ExcelReader.Core.Parser.ExcelPropertySetter<TModel, TValue>.Invoke(ref TModel model, TValue value) -> void
 virtual ExcelReader.Core.Parser.ExcelRowParser<TModel>.Invoke(ref TModel model, in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider) -> bool
-virtual ExcelReader.Core.Reader.Csv.CsvRowAction<TState>.Invoke(ref TState state, ExcelReader.Core.Reader.Row row) -> void
+virtual ExcelReader.Core.Reader.RowAction<TState>.Invoke(ref TState state, ExcelReader.Core.Reader.Row row) -> void
 ~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator!
 ~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator!
 ~override ExcelReader.Core.Parser.ExcelRowContext.Equals(object obj) -> bool
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs b/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
index 07b90323..52633387 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
@@ -115,8 +115,8 @@ public static IAsyncEnumerable<T> ParseAsync<T>(
         /// <typeparamref name="TRecord"/> and folds it into a <typeparamref name="TAccumulator"/>, one
         /// instance per partition, merged in buffer order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
@@ -125,12 +125,12 @@ public static IAsyncEnumerable<T> ParseAsync<T>(
         /// <para>
         /// Partitions start at guessed record boundaries; one whose guess landed inside a quoted field
         /// spanning lines is read again into a new accumulator. The result holds every record exactly once,
-        /// but <see cref="ICsvRecord{TSelf}.TryParse"/> and <see cref="ICsvAccumulator{TSelf, TModel}.Add"/>
-        /// may already have run for the discarded pass's records, as <see cref="ICsvAccumulator{TSelf, TModel}"/> describes.
+        /// but <see cref="IRowRecord{TSelf}.TryParse"/> and <see cref="IRowAccumulator{TSelf, TModel}.Add"/>
+        /// may already have run for the discarded pass's records, as <see cref="IRowAccumulator{TSelf, TModel}"/> describes.
         /// </para>
         /// <para>
         /// Falls back to one sequential pass, with a single accumulator and no call to
-        /// <see cref="ICsvAccumulator{TSelf, TModel}.Merge"/>, when the source is too small to partition usefully
+        /// <see cref="IRowAccumulator{TSelf, TModel}.Merge"/>, when the source is too small to partition usefully
         /// or when <see cref="CsvReaderOptions.Encoding"/> is set to a non-UTF-8 encoding.
         /// </para>
         /// </remarks>
@@ -138,8 +138,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
             ReadOnlyMemory<byte> data,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             return ParallelCsvProcessor.RunAsync(data, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
         }
@@ -148,8 +148,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
         /// Reads a CSV file across several threads, parses every record into a <typeparamref name="TRecord"/>
         /// and folds it into a <typeparamref name="TAccumulator"/>, one instance per partition, merged in file order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="path">The path of the CSV file to read.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
@@ -159,8 +159,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
             string path,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             ArgumentException.ThrowIfNullOrEmpty(path);
             return ParallelCsvProcessor.RunAsync(path, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
@@ -171,8 +171,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
         /// <typeparamref name="TRecord"/> and folds it into a <typeparamref name="TAccumulator"/>, one instance
         /// per partition, merged in stream order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
@@ -186,8 +186,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
             Stream stream,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             ArgumentNullException.ThrowIfNull(stream);
             return ParallelCsvProcessor.RunAsync(stream, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
@@ -197,7 +197,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
         /// Reads a CSV file across several threads, parses every record into a <typeparamref name="TRecord"/>
         /// and hands it to <paramref name="body"/>.
         /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="path">The path of the CSV file to read.</param>
         /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
@@ -241,7 +241,7 @@ public static Task ForEachAsync<TRecord>(
             Action<TRecord> body,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             ArgumentException.ThrowIfNullOrEmpty(path);
             ArgumentNullException.ThrowIfNull(body);
@@ -252,7 +252,7 @@ public static Task ForEachAsync<TRecord>(
         /// Reads an in-memory CSV buffer across several threads, parses every record into a
         /// <typeparamref name="TRecord"/> and hands it to <paramref name="body"/>.
         /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
         /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
@@ -265,7 +265,7 @@ public static Task ForEachAsync<TRecord>(
             Action<TRecord> body,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             ArgumentNullException.ThrowIfNull(body);
             return ParallelCsvProcessor.RunAsync(data, RecordCallback<TRecord>.For(body), null, Validated(options), ct);
@@ -275,7 +275,7 @@ public static Task ForEachAsync<TRecord>(
         /// Reads a CSV stream, in parallel where the stream can be partitioned, parses every record into a
         /// <typeparamref name="TRecord"/> and hands it to <paramref name="body"/>.
         /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="ICsvRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
         /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
         /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
@@ -292,7 +292,7 @@ public static Task ForEachAsync<TRecord>(
             Action<TRecord> body,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TRecord : ICsvRecord<TRecord>, allows ref struct
+            where TRecord : IRowRecord<TRecord>, allows ref struct
         {
             ArgumentNullException.ThrowIfNull(stream);
             ArgumentNullException.ThrowIfNull(body);
@@ -315,7 +315,7 @@ public static Task ForEachAsync<TRecord>(
         /// <remarks>
         /// <para>
         /// Carries the same concurrency, repeat-invocation and span-lifetime contract as the
-        /// <see cref="ICsvRecord{TSelf}"/> overloads. A property that fails to parse keeps its default
+        /// <see cref="IRowRecord{TSelf}"/> overloads. A property that fails to parse keeps its default
         /// unless <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing
         /// <c>[ExcelRequired]</c> column or value throws <see cref="ExcelParseException"/>; empty
         /// records are skipped.
@@ -379,7 +379,7 @@ public static Task ForEachAsync<TModel>(
         /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
         /// <remarks>
         /// Carries the same contract and fallbacks as the path-based overload, and the stream restrictions
-        /// of the <see cref="ICsvRecord{TSelf}"/> stream overload.
+        /// of the <see cref="IRowRecord{TSelf}"/> stream overload.
         /// </remarks>
         public static Task ForEachAsync<TModel>(
             Stream stream,
@@ -399,7 +399,7 @@ public static Task ForEachAsync<TModel>(
         /// <typeparamref name="TModel"/> through <paramref name="parser"/> and folds it into a
         /// <typeparamref name="TAccumulator"/>, one instance per partition, merged in buffer order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
         /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
@@ -417,14 +417,14 @@ public static Task ForEachAsync<TModel>(
         /// <see cref="ExcelParseException.Row"/> is exact when the source is read sequentially and 0 when it is
         /// partitioned, since a partition does not know how many records precede it.
         /// </para>
-        /// <para>Otherwise carries the same contract and fallbacks as the <see cref="ICsvRecord{TSelf}"/> overloads.</para>
+        /// <para>Otherwise carries the same contract and fallbacks as the <see cref="IRowRecord{TSelf}"/> overloads.</para>
         /// </remarks>
         public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
             ReadOnlyMemory<byte> data,
             ExcelParser<TModel> parser,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TModel>, new()
+            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
             where TModel : allows ref struct
         {
             CsvParallelOptions validated = Validated(options);
@@ -436,7 +436,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
         /// through <paramref name="parser"/> and folds it into a <typeparamref name="TAccumulator"/>, one instance
         /// per partition, merged in file order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="path">The path of the CSV file to read.</param>
         /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
@@ -450,7 +450,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
             ExcelParser<TModel> parser,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TModel>, new()
+            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
             where TModel : allows ref struct
         {
             ArgumentException.ThrowIfNullOrEmpty(path);
@@ -463,7 +463,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
         /// <typeparamref name="TModel"/> through <paramref name="parser"/> and folds it into a
         /// <typeparamref name="TAccumulator"/>, one instance per partition, merged in stream order.
         /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="ICsvAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
         /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
@@ -471,13 +471,13 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
         /// <param name="ct">A token to cancel processing.</param>
         /// <returns>The accumulator holding every record.</returns>
         /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>Carries the same contract and fallbacks as the in-memory overload, and the stream restrictions of the <see cref="ICsvRecord{TSelf}"/> stream overload.</remarks>
+        /// <remarks>Carries the same contract and fallbacks as the in-memory overload, and the stream restrictions of the <see cref="IRowRecord{TSelf}"/> stream overload.</remarks>
         public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
             Stream stream,
             ExcelParser<TModel> parser,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TModel>, new()
+            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
             where TModel : allows ref struct
         {
             ArgumentNullException.ThrowIfNull(stream);
@@ -485,8 +485,8 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
             return ParallelCsvProcessor.RunAsync(stream, MappedAggregation<TAccumulator, TModel>.Unbound, Bound<TAccumulator, TModel>(parser, validated), validated, ct);
         }
 
-        private static CsvAccumulateFactory<TAccumulator> Bound<TAccumulator, TModel>(ExcelParser<TModel> parser, CsvParallelOptions options)
-            where TAccumulator : ICsvAccumulator<TAccumulator, TModel>, new()
+        private static RowActionFactory<TAccumulator> Bound<TAccumulator, TModel>(ExcelParser<TModel> parser, CsvParallelOptions options)
+            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
             where TModel : allows ref struct
         {
             ArgumentNullException.ThrowIfNull(parser);
@@ -497,7 +497,7 @@ private static CsvAccumulateFactory<TAccumulator> Bound<TAccumulator, TModel>(Ex
             return MappedAggregation<TAccumulator, TModel>.Binder(parser, options.HeaderRow);
         }
 
-        private static CsvAccumulateFactory<byte> BoundCallback<TModel>(
+        private static RowActionFactory<byte> BoundCallback<TModel>(
             ExcelParser<TModel> parser, Action<TModel> body, CsvParallelOptions options)
             where TModel : allows ref struct
         {
@@ -516,14 +516,14 @@ private static CsvAccumulateFactory<byte> BoundCallback<TModel>(
         /// </summary>
         /// <typeparam name="TState">The accumulator type.</typeparam>
         /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="ICsvAccumulator{TSelf, TModel}"/>.</param>
+        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
         /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks as the <see cref="ICsvAccumulator{TSelf, TModel}"/> overloads.</remarks>
+        /// <remarks>Carries the same fallbacks as the <see cref="IRowAccumulator{TSelf, TModel}"/> overloads.</remarks>
         public static Task<TState> AggregateAsync<TState>(
             ReadOnlyMemory<byte> data,
-            CsvAggregation<TState> aggregation,
+            RowAggregation<TState> aggregation,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
         {
@@ -536,14 +536,14 @@ public static Task<TState> AggregateAsync<TState>(
         /// </summary>
         /// <typeparam name="TState">The accumulator type.</typeparam>
         /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="ICsvAccumulator{TSelf, TModel}"/>.</param>
+        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
         /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks as the <see cref="ICsvAccumulator{TSelf, TModel}"/> overloads.</remarks>
+        /// <remarks>Carries the same fallbacks as the <see cref="IRowAccumulator{TSelf, TModel}"/> overloads.</remarks>
         public static Task<TState> AggregateAsync<TState>(
             string path,
-            CsvAggregation<TState> aggregation,
+            RowAggregation<TState> aggregation,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
         {
@@ -557,14 +557,14 @@ public static Task<TState> AggregateAsync<TState>(
         /// </summary>
         /// <typeparam name="TState">The accumulator type.</typeparam>
         /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="ICsvAccumulator{TSelf, TModel}"/>.</param>
+        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
         /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
         /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks and stream restrictions as the <see cref="ICsvAccumulator{TSelf, TModel}"/> stream overload.</remarks>
+        /// <remarks>Carries the same fallbacks and stream restrictions as the <see cref="IRowAccumulator{TSelf, TModel}"/> stream overload.</remarks>
         public static Task<TState> AggregateAsync<TState>(
             Stream stream,
-            CsvAggregation<TState> aggregation,
+            RowAggregation<TState> aggregation,
             CsvParallelOptions? options = null,
             CancellationToken ct = default)
         {
@@ -572,7 +572,7 @@ public static Task<TState> AggregateAsync<TState>(
             return ParallelCsvProcessor.RunAsync(stream, Validated(aggregation), null, Validated(options), ct);
         }
 
-        private static CsvAggregation<TState> Validated<TState>(CsvAggregation<TState> aggregation)
+        private static RowAggregation<TState> Validated<TState>(RowAggregation<TState> aggregation)
         {
             ArgumentNullException.ThrowIfNull(aggregation);
             ArgumentNullException.ThrowIfNull(aggregation.Seed, nameof(aggregation));
diff --git a/src/ExcelReader.Core/Reader/Csv/ICsvAccumulator.cs b/src/ExcelReader.Core/Reader/IRowAccumulator.cs
similarity index 87%
rename from src/ExcelReader.Core/Reader/Csv/ICsvAccumulator.cs
rename to src/ExcelReader.Core/Reader/IRowAccumulator.cs
index 9effefdb..ea0bcfdf 100644
--- a/src/ExcelReader.Core/Reader/Csv/ICsvAccumulator.cs
+++ b/src/ExcelReader.Core/Reader/IRowAccumulator.cs
@@ -1,11 +1,13 @@
-namespace ExcelReader.Core.Reader.Csv
+using ExcelReader.Core.Reader.Csv;
+
+namespace ExcelReader.Core.Reader
 {
     /// <summary>
     /// Folds typed CSV records read by <c>CsvParallel.AggregateAsync</c> into a result. Each partition
     /// of the source gets its own instance.
     /// </summary>
     /// <typeparam name="TSelf">The implementing type.</typeparam>
-    /// <typeparam name="TModel">The record type, produced by <see cref="ICsvRecord{TSelf}.TryParse"/> or by an <see cref="Parser.ExcelParser{T}"/>.</typeparam>
+    /// <typeparam name="TModel">The record type, produced by <see cref="IRowRecord{TSelf}.TryParse"/> or by an <see cref="Parser.ExcelParser{T}"/>.</typeparam>
     /// <remarks>
     /// <para>
     /// <see cref="Add"/> runs concurrently across instances on worker threads, and must mutate only the
@@ -19,8 +21,8 @@ namespace ExcelReader.Core.Reader.Csv
     /// partition into the accumulator of everything before it. It may receive an instance that saw no records.
     /// </para>
     /// </remarks>
-    public interface ICsvAccumulator<TSelf, TModel>
-        where TSelf : ICsvAccumulator<TSelf, TModel>
+    public interface IRowAccumulator<TSelf, TModel>
+        where TSelf : IRowAccumulator<TSelf, TModel>
         where TModel : allows ref struct
     {
         /// <summary>Folds one record into this instance.</summary>
diff --git a/src/ExcelReader.Core/Reader/Csv/ICsvRecord.cs b/src/ExcelReader.Core/Reader/IRowRecord.cs
similarity index 82%
rename from src/ExcelReader.Core/Reader/Csv/ICsvRecord.cs
rename to src/ExcelReader.Core/Reader/IRowRecord.cs
index aae666c0..0706fdb3 100644
--- a/src/ExcelReader.Core/Reader/Csv/ICsvRecord.cs
+++ b/src/ExcelReader.Core/Reader/IRowRecord.cs
@@ -1,12 +1,14 @@
-namespace ExcelReader.Core.Reader.Csv
+using ExcelReader.Core.Reader.Csv;
+
+namespace ExcelReader.Core.Reader
 {
     /// <summary>
     /// A typed CSV record that parses itself from a <see cref="Row"/>, for
     /// <see cref="CsvParallel.AggregateAsync{TAccumulator, TRecord}(ReadOnlyMemory{byte}, CsvParallelOptions?, CancellationToken)"/>.
     /// </summary>
     /// <typeparam name="TSelf">The implementing type. May be a <see langword="ref struct"/> holding spans taken from the row.</typeparam>
-    public interface ICsvRecord<TSelf>
-        where TSelf : ICsvRecord<TSelf>, allows ref struct
+    public interface IRowRecord<TSelf>
+        where TSelf : IRowRecord<TSelf>, allows ref struct
     {
         /// <summary>Parses one record.</summary>
         /// <param name="row">The record. Spans taken from it stay valid only until the accumulator's <c>Add</c> returns.</param>
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvRowAction.cs b/src/ExcelReader.Core/Reader/RowAction.cs
similarity index 73%
rename from src/ExcelReader.Core/Reader/Csv/CsvRowAction.cs
rename to src/ExcelReader.Core/Reader/RowAction.cs
index be7ad414..4557fa70 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvRowAction.cs
+++ b/src/ExcelReader.Core/Reader/RowAction.cs
@@ -1,8 +1,10 @@
-namespace ExcelReader.Core.Reader.Csv
+using ExcelReader.Core.Reader.Csv;
+
+namespace ExcelReader.Core.Reader
 {
     /// <summary>Processes one CSV record into the state owned by the partition that read it.</summary>
     /// <typeparam name="TState">The per-partition accumulator type.</typeparam>
     /// <param name="state">The accumulator of the partition the record belongs to. Mutate only this.</param>
     /// <param name="row">The record. Valid only for the duration of the call.</param>
-    public delegate void CsvRowAction<TState>(ref TState state, Row row);
+    public delegate void RowAction<TState>(ref TState state, Row row);
 }
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvAggregation.cs b/src/ExcelReader.Core/Reader/RowAggregation.cs
similarity index 75%
rename from src/ExcelReader.Core/Reader/Csv/CsvAggregation.cs
rename to src/ExcelReader.Core/Reader/RowAggregation.cs
index 87bc7f30..b23e0e18 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvAggregation.cs
+++ b/src/ExcelReader.Core/Reader/RowAggregation.cs
@@ -1,18 +1,20 @@
-namespace ExcelReader.Core.Reader.Csv
+using ExcelReader.Core.Reader.Csv;
+
+namespace ExcelReader.Core.Reader
 {
     /// <summary>
     /// A fold over CSV records expressed as three functions, for
-    /// <see cref="CsvParallel.AggregateAsync{TState}(ReadOnlyMemory{byte}, CsvAggregation{TState}, CsvParallelOptions?, CancellationToken)"/>.
-    /// Carries the same contract as <see cref="ICsvAccumulator{TSelf, TModel}"/>, without requiring a type.
+    /// <see cref="CsvParallel.AggregateAsync{TState}(ReadOnlyMemory{byte}, RowAggregation{TState}, CsvParallelOptions?, CancellationToken)"/>.
+    /// Carries the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>, without requiring a type.
     /// </summary>
     /// <typeparam name="TState">The accumulator type. Each partition of the source owns one instance.</typeparam>
-    public sealed class CsvAggregation<TState>
+    public sealed class RowAggregation<TState>
     {
         /// <summary>Gets the function that creates an empty accumulator. Called once per partition, possibly more.</summary>
         public required Func<TState> Seed { get; init; }
 
         /// <summary>Gets the function that folds one record into its partition's accumulator. Runs concurrently on worker threads and must mutate only the accumulator it is given.</summary>
-        public required CsvRowAction<TState> Accumulate { get; init; }
+        public required RowAction<TState> Accumulate { get; init; }
 
         /// <summary>Gets the function that folds the following partition's accumulator into the preceding one. Called on one thread, left to right in source order.</summary>
         public required Func<TState, TState, TState> Combine { get; init; }
diff --git a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
index 51a77b4d..c3fc08f3 100644
--- a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
+++ b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
@@ -99,9 +99,9 @@ internal static int AggregateCsvMemory(
                 out result);
         }
 
-        private static CsvAggregation<CsvAggregateState> Build(CsvAggregateContext context)
+        private static RowAggregation<CsvAggregateState> Build(CsvAggregateContext context)
         {
-            return new CsvAggregation<CsvAggregateState>
+            return new RowAggregation<CsvAggregateState>
             {
                 Seed = () =>
                 {
diff --git a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
index f7c3b530..cf84a0ca 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
@@ -57,7 +57,7 @@ private static int ParseCsvInParallel(NativeHandle handle, CsvChunkSource source
                 }
 
                 bool isDate1904 = handle.Workbook.IsDate1904;
-                CsvAggregation<PartitionTable> aggregation = new()
+                RowAggregation<PartitionTable> aggregation = new()
                 {
                     Seed = () => new PartitionTable(specs),
                     Accumulate = (ref PartitionTable state, Row row) => state.Append(row, columnIndices, isDate1904),
diff --git a/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs b/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
index 6a34ead1..e0c20d3d 100644
--- a/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
@@ -1,6 +1,7 @@
 using System.Runtime.InteropServices;
 using BenchmarkDotNet.Attributes;
 using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
 namespace ExcelReader.Benchmarks
@@ -83,7 +84,7 @@ public async Task<long> NarrowInt()
             return n;
         }
 
-        private sealed class Aggregation : ICsvAccumulator<Aggregation, WideRowRef>
+        private sealed class Aggregation : IRowAccumulator<Aggregation, WideRowRef>
         {
             public long Units { get; private set; }
             public void Add(WideRowRef model)
@@ -97,7 +98,7 @@ public void Merge(Aggregation following)
             }
         }
 
-        private sealed class AggregationNarrow : ICsvAccumulator<AggregationNarrow, NarrowRowStruct>
+        private sealed class AggregationNarrow : IRowAccumulator<AggregationNarrow, NarrowRowStruct>
         {
             public long Units { get; private set; }
             public void Add(NarrowRowStruct model)
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
index b8f33ed3..6afffef7 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
@@ -31,7 +31,7 @@ public record struct IdOnly
             public int Id { get; set; }
         }
 
-        private sealed class PeopleLog : ICsvAccumulator<PeopleLog, Person>, ICsvAccumulator<PeopleLog, IdOnly>
+        private sealed class PeopleLog : IRowAccumulator<PeopleLog, Person>, IRowAccumulator<PeopleLog, IdOnly>
         {
             public List<string> Rows { get; } = [];
 
@@ -345,7 +345,7 @@ public struct WideRow : IEquatable<WideRow>
             public static bool operator !=(WideRow left, WideRow right) => !left.Equals(right);
         }
 
-        private sealed class WideLog : ICsvAccumulator<WideLog, WideRow>
+        private sealed class WideLog : IRowAccumulator<WideLog, WideRow>
         {
             public List<int> Values { get; } = [];
 
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
index 262e54d6..34c8c029 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
@@ -9,7 +9,7 @@ namespace ExcelReader.Tests.Parser.ParallelCsv
 {
     public class AggregateCsvParallelTests
     {
-        private readonly struct RowText : ICsvRecord<RowText>
+        private readonly struct RowText : IRowRecord<RowText>
         {
             public string Text { get; init; }
 
@@ -20,7 +20,7 @@ public static bool TryParse(Row row, out RowText record)
             }
         }
 
-        private ref struct NumberedRow : ICsvRecord<NumberedRow>
+        private ref struct NumberedRow : IRowRecord<NumberedRow>
         {
             public ReadOnlySpan<byte> Name;
             public int Id;
@@ -37,7 +37,7 @@ record = default;
             }
         }
 
-        private sealed class RowLog : ICsvAccumulator<RowLog, RowText>, ICsvAccumulator<RowLog, NumberedRow>
+        private sealed class RowLog : IRowAccumulator<RowLog, RowText>, IRowAccumulator<RowLog, NumberedRow>
         {
             public List<string> Rows { get; } = [];
 
@@ -57,7 +57,7 @@ public void Merge(RowLog following)
             }
         }
 
-        private static readonly CsvAggregation<List<string>> Collecting = new()
+        private static readonly RowAggregation<List<string>> Collecting = new()
         {
             Seed = static () => [],
             Accumulate = static (ref List<string> rows, Row row) => rows.Add(Render(row)),
@@ -89,7 +89,7 @@ private static List<string> Sequential(byte[] csv, int headerRow = 0)
             return rows.Count > headerRow ? rows[headerRow..] : [];
         }
 
-        private static Task<List<string>> WithChunkSize(byte[] csv, int dop, int chunkSize, int headerRow = 0, CsvAggregation<List<string>>? aggregation = null)
+        private static Task<List<string>> WithChunkSize(byte[] csv, int dop, int chunkSize, int headerRow = 0, RowAggregation<List<string>>? aggregation = null)
         {
             return ParallelCsvProcessor.RunWithChunkSizeAsync(
                 csv.AsMemory(),
@@ -153,7 +153,7 @@ public async Task DiscardsExceptionsThrownWhileReadingAMisguessedPartition()
             byte[] csv = Encoding.UTF8.GetBytes("ok,\"one\nBOOM,x\"\nok,two\nok,\"three\nBOOM,y\"\nok,four\n");
             List<string> expected = Sequential(csv);
             int misguessedDeliveries = 0;
-            var throwOnBoom = new CsvAggregation<List<string>>
+            var throwOnBoom = new RowAggregation<List<string>>
             {
                 Seed = Collecting.Seed,
                 Accumulate = (ref List<string> rows, Row row) =>
@@ -179,7 +179,7 @@ public async Task DiscardsExceptionsThrownWhileReadingAMisguessedPartition()
         public async Task SurfacesAnExceptionThrownForARealRecord()
         {
             byte[] csv = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Range(0, 200).Select(i => $"r{i},v\n")));
-            var failAt150 = new CsvAggregation<int>
+            var failAt150 = new RowAggregation<int>
             {
                 Seed = static () => 0,
                 Accumulate = static (ref int count, Row row) =>
@@ -259,8 +259,8 @@ public async Task RejectsInvalidOptionsAndAggregations()
             byte[] csv = "a\n"u8.ToArray();
             await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => CsvParallel.AggregateAsync<RowLog, RowText>(csv, new CsvParallelOptions { DegreeOfParallelism = -1 }, TestContext.Current.CancellationToken));
             await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => CsvParallel.AggregateAsync<RowLog, RowText>(csv, new CsvParallelOptions { HeaderRow = -1 }, TestContext.Current.CancellationToken));
-            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, (CsvAggregation<int>)null!, null, TestContext.Current.CancellationToken));
-            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, new CsvAggregation<int> { Seed = null!, Accumulate = static (ref int s, Row r) => s++, Combine = static (a, b) => a + b }, null, TestContext.Current.CancellationToken));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, (RowAggregation<int>)null!, null, TestContext.Current.CancellationToken));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, new RowAggregation<int> { Seed = null!, Accumulate = static (ref int s, Row r) => s++, Combine = static (a, b) => a + b }, null, TestContext.Current.CancellationToken));
         }
 
         [Fact]
@@ -284,7 +284,7 @@ public async Task CallsTheFactoryOnceWithTheHeaderRecord()
             foreach (bool partitioned in new[] { true, false })
             {
                 var calls = new ConcurrentBag<(string Header, bool Sequential)>();
-                CsvAccumulateFactory<List<string>> factory = (Row header, bool sequential) =>
+                RowActionFactory<List<string>> factory = (Row header, bool sequential) =>
                 {
                     calls.Add((Render(header), sequential));
                     return Collecting.Accumulate;
@@ -306,7 +306,7 @@ public async Task CallsTheFactoryWithAnEmptyHeaderWhenThereIsNoHeaderRow()
             byte[] csv = LargeCsv(rows: 500);
             CancellationToken ct = TestContext.Current.CancellationToken;
             var columnCounts = new ConcurrentBag<int>();
-            CsvAccumulateFactory<List<string>> factory = (Row header, bool sequential) =>
+            RowActionFactory<List<string>> factory = (Row header, bool sequential) =>
             {
                 columnCounts.Add(header.ColumnCount);
                 return Collecting.Accumulate;
@@ -322,7 +322,7 @@ public async Task CallsTheFactoryWithAnEmptyHeaderWhenThereIsNoHeaderRow()
         public async Task DoesNotCallTheFactoryWhenTheInputEndsBeforeTheHeader()
         {
             int calls = 0;
-            CsvAccumulateFactory<List<string>> factory = (Row header, bool sequential) =>
+            RowActionFactory<List<string>> factory = (Row header, bool sequential) =>
             {
                 Interlocked.Increment(ref calls);
                 return Collecting.Accumulate;
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
index 5e924f0c..ee7d91b6 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
@@ -82,7 +82,7 @@ public async Task RunPartitionedAsync_Should_Deliver_Every_Record_After_The_Head
             byte[] csv = Numbered(50_000);
             using CsvReader reader = Excel.FromCsv(csv.AsMemory());
             Assert.True(reader.TryGetChunkSource(out CsvChunkSource source));
-            CsvAggregation<long> count = new()
+            RowAggregation<long> count = new()
             {
                 Seed = () => 0L,
                 Accumulate = (ref long seen, Row _) => seen++,
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
index 1571980b..1c679698 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
@@ -10,7 +10,7 @@ namespace ExcelReader.Tests.Parser.ParallelCsv
 {
     public class ForEachCsvParallelTests
     {
-        public readonly ref struct Sale : ICsvRecord<Sale>
+        public readonly ref struct Sale : IRowRecord<Sale>
         {
             private Sale(int units)
             {
@@ -275,10 +275,10 @@ private sealed class ChunkProbe
 
             internal int Chunks => Volatile.Read(ref _chunks);
 
-            internal CsvAggregation<byte> Wrap(CsvAggregation<byte> inner)
+            internal RowAggregation<byte> Wrap(RowAggregation<byte> inner)
             {
                 Func<byte> seed = inner.Seed;
-                return new CsvAggregation<byte>
+                return new RowAggregation<byte>
                 {
                     Seed = () =>
                     {

From 97d797c627228d1c79326be11b135a4b9be06951 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 21:54:58 -0300
Subject: [PATCH 065/115] feat: add SheetParallel, a parallel reading API that
 takes a sheet of any format

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Parser/ExcelParser.cs    |   2 +
 .../Parser/ParallelCsv/MappedAggregation.cs   |   5 +-
 .../Parser/ParallelCsv/MappedCallback.cs      |   5 +-
 .../Parser/ParallelCsv/MappedProjection.cs    |  15 +-
 .../ParallelCsv/ParallelCsvEnumerable.cs      |  11 +-
 .../Parser/ParallelCsv/ParallelCsvFactory.cs  |  17 +-
 .../ParallelCsv/ParallelCsvProcessor.cs       |  55 +++-
 .../Parser/SheetPipeline/SheetRunner.cs       |  90 ++++++
 .../PublicAPI/PublicAPI.Unshipped.txt         |  14 +
 .../Reader/Csv/CsvParallel.cs                 |   4 +-
 src/ExcelReader.Core/Reader/Csv/CsvSheet.cs   |   2 +-
 src/ExcelReader.Core/Reader/SheetParallel.cs  | 278 ++++++++++++++++++
 .../Reader/SheetParallelOptions.cs            |  18 ++
 .../ParallelCsv/AggregateCsvModelTests.cs     |   4 +-
 .../ParallelCsv/ForEachCsvParallelTests.cs    |   3 +-
 .../Parser/SheetParallelTests.cs              | 195 ++++++++++++
 16 files changed, 682 insertions(+), 36 deletions(-)
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
 create mode 100644 src/ExcelReader.Core/Reader/SheetParallel.cs
 create mode 100644 src/ExcelReader.Core/Reader/SheetParallelOptions.cs
 create mode 100644 tests/ExcelReader.Tests/Parser/SheetParallelTests.cs

diff --git a/src/ExcelReader.Core/Parser/ExcelParser.cs b/src/ExcelReader.Core/Parser/ExcelParser.cs
index 99212d62..8bf07360 100644
--- a/src/ExcelReader.Core/Parser/ExcelParser.cs
+++ b/src/ExcelReader.Core/Parser/ExcelParser.cs
@@ -39,6 +39,8 @@ internal ExcelParser(ExcelParserConfig config, Func<TypeMapInfo<T>> info, Func<T
 
         internal TypeMapInfo<T> CsvInfo => _csvInfo();
 
+        internal TypeMapInfo<T> Info => _info();
+
         /// <summary>Parses the rows of an XLSX sheet into <typeparamref name="T"/> instances, lazily as the result is enumerated.</summary>
         /// <param name="sheet">The sheet to pull rows from. Each enumeration of the result starts a new read of it.</param>
         /// <returns>An enumerable that yields one <typeparamref name="T"/> per data row.</returns>
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
index aef12a45..cf5af1f9 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedAggregation.cs
@@ -1,3 +1,4 @@
+using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
@@ -21,10 +22,10 @@ internal static class MappedAggregation<TAccumulator, TModel>
             },
         };
 
-        internal static RowActionFactory<TAccumulator> Binder(ExcelParser<TModel> parser, int headerRow)
+        internal static RowActionFactory<TAccumulator> Binder(ExcelParser<TModel> parser, TypeMapInfo<TModel> info, bool isDate1904, int headerRow)
         {
             return (Row header, bool sequential) =>
-                MappedProjection<TAccumulator, TModel>.Bind(parser, header, headerRow, sequential, Sink);
+                MappedProjection<TAccumulator, TModel>.Bind(parser, info, isDate1904, header, headerRow, sequential, Sink);
         }
     }
 }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
index 53640f08..686ccbb4 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedCallback.cs
@@ -1,3 +1,4 @@
+using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
@@ -13,11 +14,11 @@ internal static class MappedCallback<TModel>
             Combine = static (left, _) => left,
         };
 
-        internal static RowActionFactory<byte> Binder(ExcelParser<TModel> parser, int headerRow, Action<TModel> body)
+        internal static RowActionFactory<byte> Binder(ExcelParser<TModel> parser, TypeMapInfo<TModel> info, bool isDate1904, int headerRow, Action<TModel> body)
         {
             ModelSink<byte, TModel> sink = (ref byte _, TModel model) => body(model);
             return (Row header, bool sequential) =>
-                MappedProjection<byte, TModel>.Bind(parser, header, headerRow, sequential, sink);
+                MappedProjection<byte, TModel>.Bind(parser, info, isDate1904, header, headerRow, sequential, sink);
         }
     }
 }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
index 32144cb2..93b5022f 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
@@ -10,9 +10,8 @@ internal static class MappedProjection<TState, TModel>
         private const int StackallocLimit = 256;
 
         internal static RowAction<TState> Bind(
-            ExcelParser<TModel> parser, Row header, int headerRow, bool sequential, ModelSink<TState, TModel> sink)
+            ExcelParser<TModel> parser, TypeMapInfo<TModel> info, bool isDate1904, Row header, int headerRow, bool sequential, ModelSink<TState, TModel> sink)
         {
-            TypeMapInfo<TModel> info = parser.CsvInfo;
             ExcelParserConfig config = parser.Config;
             ColumnBinding<TModel>[] bindings;
             int requireValueCount;
@@ -37,7 +36,7 @@ void Plain(ref TState state, Row row)
                     return;
                 }
                 TModel model = info.CreateInstance();
-                SparseRowProjection.ParseRow(in row, bindings, default, false, false, provider, throwOnParseFailure, 0, ref model);
+                SparseRowProjection.ParseRow(in row, bindings, default, false, isDate1904, provider, throwOnParseFailure, 0, ref model);
                 sink(ref state, model);
             }
 
@@ -49,7 +48,7 @@ void PlainNumbered(ref TState state, Row row)
                     return;
                 }
                 TModel model = info.CreateInstance();
-                SparseRowProjection.ParseRow(in row, bindings, default, false, false, provider, throwOnParseFailure, current, ref model);
+                SparseRowProjection.ParseRow(in row, bindings, default, false, isDate1904, provider, throwOnParseFailure, current, ref model);
                 sink(ref state, model);
             }
 
@@ -63,11 +62,11 @@ void Tracked(ref TState state, Row row)
                 if (bindings.Length <= StackallocLimit)
                 {
                     Span<bool> seen = stackalloc bool[bindings.Length];
-                    SparseRowProjection.ParseRow(in row, bindings, seen, true, false, provider, throwOnParseFailure, 0, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, seen, true, isDate1904, provider, throwOnParseFailure, 0, ref model);
                 }
                 else
                 {
-                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, false, provider, throwOnParseFailure, 0, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, isDate1904, provider, throwOnParseFailure, 0, ref model);
                 }
                 sink(ref state, model);
             }
@@ -83,11 +82,11 @@ void TrackedNumbered(ref TState state, Row row)
                 if (bindings.Length <= StackallocLimit)
                 {
                     Span<bool> seen = stackalloc bool[bindings.Length];
-                    SparseRowProjection.ParseRow(in row, bindings, seen, true, false, provider, throwOnParseFailure, current, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, seen, true, isDate1904, provider, throwOnParseFailure, current, ref model);
                 }
                 else
                 {
-                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, false, provider, throwOnParseFailure, current, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, isDate1904, provider, throwOnParseFailure, current, ref model);
                 }
                 sink(ref state, model);
             }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
index 6fd452a3..edb39806 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
@@ -2,6 +2,7 @@
 using System.Diagnostics.CodeAnalysis;
 using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Internal;
 using Microsoft.Win32.SafeHandles;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
@@ -18,6 +19,8 @@ internal sealed class ParallelCsvEnumerable<T> : IAsyncEnumerable<T>
         private readonly int _dop;
 
         private readonly SafeFileHandle? _ownedHandle;
+        private readonly ReaderLifetime? _lease;
+        private readonly object? _owner;
 
         internal ParallelCsvEnumerable(
             CsvChunkSource source,
@@ -28,7 +31,9 @@ internal ParallelCsvEnumerable(
             CsvReaderOptions readerOptions,
             ExcelParserConfig config,
             int degreeOfParallelism,
-            SafeFileHandle? ownedHandle)
+            SafeFileHandle? ownedHandle,
+            ReaderLifetime? lease = null,
+            object? owner = null)
         {
             _source = source;
             _plan = plan;
@@ -39,12 +44,15 @@ internal ParallelCsvEnumerable(
             _config = config;
             _dop = degreeOfParallelism;
             _ownedHandle = ownedHandle;
+            _lease = lease;
+            _owner = owner;
         }
 
         [SuppressMessage("Reliability", "CA2025:Do not pass 'IDisposable' instances into unawaited tasks",
             Justification = "The CTS and semaphore handed to the workers outlive them by construction: the finally block cancels and then awaits every worker task to completion, and only the enclosing `using` declarations' finally — which runs after it — disposes them.")]
         public async IAsyncEnumerator<T> GetAsyncEnumerator(CancellationToken cancellationToken = default)
         {
+            _lease?.Acquire(_owner!);
             using var cts = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
             CancellationToken ct = cts.Token;
 
@@ -90,6 +98,7 @@ public async IAsyncEnumerator<T> GetAsyncEnumerator(CancellationToken cancellati
                 await cts.CancelAsync().ConfigureAwait(false);
                 await allWorkers.ConfigureAwait(ConfigureAwaitOptions.SuppressThrowing);
                 _ownedHandle?.Dispose();
+                _lease?.Release();
             }
         }
 
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
index 3ce1d617..098331a3 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
@@ -3,6 +3,7 @@
 using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Internal;
 using Microsoft.Win32.SafeHandles;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
@@ -65,6 +66,16 @@ internal static IAsyncEnumerable<T> CreateWithChunkSize<T>(
             return Build(new CsvChunkSource(data), options, parser, Normalize(degreeOfParallelism), chunkSize, ownedHandle: null, ct);
         }
 
+        internal static IAsyncEnumerable<T> Create<T>(CsvReader reader, int degreeOfParallelism, ExcelParser<T> parser, CancellationToken ct)
+        {
+            int dop = Normalize(degreeOfParallelism);
+            if (!reader.TryGetChunkSource(out CsvChunkSource source) || !CanPartition(dop, source.Length, reader.Options))
+            {
+                return new CsvEnumerable<T>(reader.FirstSheet, parser.Config, parser.CsvInfo, ownedReader: null, ct);
+            }
+            return Build(source, reader.Options, parser, dop, chunkSizeOverride: 0, ownedHandle: null, ct, reader.Lifetime, reader);
+        }
+
         internal static int Normalize(int degreeOfParallelism)
         {
             return degreeOfParallelism == 0 ? Environment.ProcessorCount : degreeOfParallelism;
@@ -86,7 +97,9 @@ private static IAsyncEnumerable<T> Build<T>(
             int dop,
             int chunkSizeOverride,
             SafeFileHandle? ownedHandle,
-            CancellationToken ct)
+            CancellationToken ct,
+            ReaderLifetime? lease = null,
+            object? owner = null)
         {
             ExcelParserConfig config = parser.Config;
             TypeMapInfo<T> info = parser.CsvInfo;
@@ -110,7 +123,7 @@ private static IAsyncEnumerable<T> Build<T>(
                 return Sequential(source.OpenReader(options), parser, ct);
             }
 
-            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, ownedHandle);
+            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, ownedHandle, lease, owner);
         }
 
         private static CsvEnumerable<T> Sequential<T>(
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
index f6f64e92..c0101002 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
@@ -30,10 +30,10 @@ internal static async Task<TState> RunAsync<TState>(
             if (!ParallelCsvFactory.CanPartition(dop, length, options.Reader))
             {
                 CsvReader reader = await Excel.FromCsvFileAsync(path, options.Reader, ct).ConfigureAwait(false);
-                return await SequentialAsync(reader, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
+                return await SequentialAsync(reader, ownsReader: true, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
             }
             using SafeFileHandle handle = File.OpenHandle(path, FileMode.Open, FileAccess.Read, FileShare.Read, FileOptions.Asynchronous | FileOptions.RandomAccess);
-            return await PartitionedAsync(new CsvChunkSource(handle, length), aggregation, factory, options, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
+            return await PartitionedAsync(new CsvChunkSource(handle, length), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
         }
 
         internal static Task<TState> RunAsync<TState>(
@@ -43,9 +43,9 @@ internal static Task<TState> RunAsync<TState>(
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
             if (!ParallelCsvFactory.CanPartition(dop, data.Length, options.Reader))
             {
-                return SequentialAsync(Excel.FromCsv(data, options.Reader), aggregation, factory, options.HeaderRow, ct);
+                return SequentialAsync(Excel.FromCsv(data, options.Reader), ownsReader: true, aggregation, factory, options.HeaderRow, ct);
             }
-            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options, dop, chunkSizeOverride: 0, ct);
+            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct);
         }
 
         internal static async Task<TState> RunAsync<TState>(
@@ -57,9 +57,9 @@ internal static async Task<TState> RunAsync<TState>(
                 || !ParallelCsvFactory.CanPartition(dop, source.Length, options.Reader))
             {
                 CsvReader reader = await Excel.FromCsvAsync(stream, leaveOpen: true, options.Reader, ct).ConfigureAwait(false);
-                return await SequentialAsync(reader, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
+                return await SequentialAsync(reader, ownsReader: true, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
             }
-            return await PartitionedAsync(source, aggregation, factory, options, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
+            return await PartitionedAsync(source, aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
         }
 
         internal static Task<TState> RunWithChunkSizeAsync<TState>(
@@ -67,14 +67,33 @@ internal static Task<TState> RunWithChunkSizeAsync<TState>(
         {
             options = WithResolvedDialect(options, CsvDialectResolver.Resolve(data, options.Reader));
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options, dop, chunkSize, ct);
+            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSize, ct);
         }
 
         internal static Task<TState> RunPartitionedAsync<TState>(
             CsvChunkSource source, RowAggregation<TState> aggregation, CsvParallelOptions options, int chunkSizeOverride, CancellationToken ct)
         {
             int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            return PartitionedAsync(source, aggregation, null, options, dop, chunkSizeOverride, ct);
+            return PartitionedAsync(source, aggregation, null, options.Reader, options.HeaderRow, dop, chunkSizeOverride, ct);
+        }
+
+        internal static async Task<TState> RunAsync<TState>(
+            CsvReader reader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, SheetParallelOptions options, CancellationToken ct)
+        {
+            reader.Lifetime.Acquire(reader);
+            try
+            {
+                int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
+                if (!reader.TryGetChunkSource(out CsvChunkSource source) || !ParallelCsvFactory.CanPartition(dop, source.Length, reader.Options))
+                {
+                    return await SequentialAsync(reader, ownsReader: false, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
+                }
+                return await PartitionedAsync(source, aggregation, factory, reader.Options, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
+            }
+            finally
+            {
+                reader.Lifetime.Release();
+            }
         }
 
         private static CsvParallelOptions WithResolvedDialect(CsvParallelOptions options, CsvReaderOptions reader)
@@ -97,9 +116,9 @@ private static RowAggregation<TState> WithAccumulate<TState>(RowAggregation<TSta
         }
 
         private static async Task<TState> SequentialAsync<TState>(
-            CsvReader reader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
+            CsvReader reader, bool ownsReader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
         {
-            await using (reader.ConfigureAwait(false))
+            try
             {
                 CsvReader.Enumerator rows = reader.OpenSheet(ct);
                 await using (rows.ConfigureAwait(false))
@@ -132,17 +151,23 @@ private static async Task<TState> SequentialAsync<TState>(
                     return state;
                 }
             }
+            finally
+            {
+                if (ownsReader)
+                {
+                    await reader.DisposeAsync().ConfigureAwait(false);
+                }
+            }
         }
 
         private static async Task<TState> PartitionedAsync<TState>(
-            CsvChunkSource source, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, int dop, int chunkSizeOverride,
-            CancellationToken ct)
+            CsvChunkSource source, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvReaderOptions reader, int headerRow, int dop,
+            int chunkSizeOverride, CancellationToken ct)
         {
-            CsvReaderOptions reader = options.Reader;
             long dataStart = 0;
-            if (options.HeaderRow > 0)
+            if (headerRow > 0)
             {
-                (dataStart, RowAction<TState>? bound) = await RecordStartAfterAsync(source, reader, options.HeaderRow, factory, ct).ConfigureAwait(false);
+                (dataStart, RowAction<TState>? bound) = await RecordStartAfterAsync(source, reader, headerRow, factory, ct).ConfigureAwait(false);
                 if (bound is not null)
                 {
                     aggregation = WithAccumulate(aggregation, bound);
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
new file mode 100644
index 00000000..2e555b1c
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
@@ -0,0 +1,90 @@
+using System.Runtime.CompilerServices;
+using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Xls;
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal static class SheetRunner
+    {
+        private const int RowsPerCancellationCheck = 4096;
+
+        internal static Task<TState> RunAsync<TState>(
+            IExcelSheet sheet, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, SheetParallelOptions options, CancellationToken ct)
+        {
+            if (sheet is CsvSheet csv)
+            {
+                return ParallelCsvProcessor.RunAsync(csv.Reader, aggregation, factory, options, ct);
+            }
+            return SequentialAsync(sheet, aggregation, factory, options.HeaderRow, ct);
+        }
+
+        internal static IAsyncEnumerable<T> Parse<T>(IExcelSheet sheet, ExcelParser<T> parser, int degreeOfParallelism, CancellationToken ct)
+        {
+            if (sheet is CsvSheet csv)
+            {
+                return ParallelCsvFactory.Create(csv.Reader, degreeOfParallelism, parser, ct);
+            }
+            return Sequential(sheet, parser, ct);
+        }
+
+        private static async IAsyncEnumerable<T> Sequential<T>(IExcelSheet sheet, ExcelParser<T> parser, [EnumeratorCancellation] CancellationToken ct)
+        {
+            IAsyncEnumerable<T> rows = sheet switch
+            {
+                XlsxSheet xlsx => parser.Parse(xlsx),
+                XlsbSheet xlsb => parser.Parse(xlsb),
+                XlsSheet xls => parser.Parse(xls),
+                _ => parser.Parse(sheet),
+            };
+            await foreach (T row in rows.WithCancellation(ct).ConfigureAwait(false))
+            {
+                yield return row;
+            }
+        }
+
+        internal static async Task<TState> SequentialAsync<TState>(
+            IExcelSheet sheet, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
+        {
+            IExcelRowEnumerator rows = sheet.GetAsyncEnumerator(ct);
+            await using (rows.ConfigureAwait(false))
+            {
+                TState state = aggregation.Seed();
+                RowAction<TState> accumulate = aggregation.Accumulate;
+                if (factory is not null && headerRow == 0)
+                {
+                    accumulate = factory(default, sequential: true);
+                }
+                for (int skipped = 0; skipped < headerRow; skipped++)
+                {
+                    if (!await rows.MoveNextAsync().ConfigureAwait(false))
+                    {
+                        return state;
+                    }
+                    if (factory is not null && skipped == headerRow - 1)
+                    {
+                        accumulate = factory(rows.Current, sequential: true);
+                    }
+                }
+                long delivered = 0;
+                while (await rows.MoveNextAsync().ConfigureAwait(false))
+                {
+                    if (++delivered % RowsPerCancellationCheck == 0)
+                    {
+                        ct.ThrowIfCancellationRequested();
+                    }
+                    Deliver(accumulate, ref state, rows);
+                }
+                return state;
+            }
+        }
+
+        private static void Deliver<TState>(RowAction<TState> accumulate, ref TState state, IExcelRowEnumerator rows)
+        {
+            accumulate(ref state, rows.Current);
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 1742ce90..6b7a4d18 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -56,3 +56,17 @@ ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.BeginTableAsync(string! name, Syste
 ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter.EndTable() -> void
 static ExcelReader.Core.Writer.SheetWriterExtensions.WriteTableAsync<T, TRow>(this ExcelReader.Core.Writer.ITableSheetWriter<TRow>! sheet, System.Collections.Generic.IAsyncEnumerable<T>! records, string! name, ExcelReader.Core.Writer.ExcelRecordLayout<T>! layout, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 static ExcelReader.Core.Writer.SheetWriterExtensions.WriteTableAsync<T, TRow>(this ExcelReader.Core.Writer.ITableSheetWriter<TRow>! sheet, System.Collections.Generic.IEnumerable<T>! records, string! name, ExcelReader.Core.Writer.ExcelRecordLayout<T>! layout, ExcelReader.Core.Writer.ExcelTableOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+ExcelReader.Core.Reader.SheetParallel
+ExcelReader.Core.Reader.SheetParallelOptions
+ExcelReader.Core.Reader.SheetParallelOptions.DegreeOfParallelism.get -> int
+ExcelReader.Core.Reader.SheetParallelOptions.DegreeOfParallelism.init -> void
+ExcelReader.Core.Reader.SheetParallelOptions.HeaderRow.get -> int
+ExcelReader.Core.Reader.SheetParallelOptions.HeaderRow.init -> void
+ExcelReader.Core.Reader.SheetParallelOptions.SheetParallelOptions() -> void
+static ExcelReader.Core.Reader.SheetParallel.AggregateAsync<TAccumulator, TModel>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
+static ExcelReader.Core.Reader.SheetParallel.AggregateAsync<TAccumulator, TRecord>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
+static ExcelReader.Core.Reader.SheetParallel.AggregateAsync<TState>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
+static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TModel>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
+static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TRecord>(ExcelReader.Core.Reader.IExcelSheet! sheet, System.Action<TRecord>! body, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
+static ExcelReader.Core.Reader.SheetParallel.ParseAsync<T>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
+static ExcelReader.Core.Reader.SheetParallelOptions.Default.get -> ExcelReader.Core.Reader.SheetParallelOptions!
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs b/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
index 52633387..a19b0445 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
@@ -494,7 +494,7 @@ private static RowActionFactory<TAccumulator> Bound<TAccumulator, TModel>(ExcelP
             {
                 throw new ArgumentException("A parser that binds columns by header name needs CsvParallelOptions.HeaderRow of at least 1.", nameof(parser));
             }
-            return MappedAggregation<TAccumulator, TModel>.Binder(parser, options.HeaderRow);
+            return MappedAggregation<TAccumulator, TModel>.Binder(parser, parser.CsvInfo, false, options.HeaderRow);
         }
 
         private static RowActionFactory<byte> BoundCallback<TModel>(
@@ -507,7 +507,7 @@ private static RowActionFactory<byte> BoundCallback<TModel>(
             {
                 throw new ArgumentException("A parser that binds columns by header name needs CsvParallelOptions.HeaderRow of at least 1.", nameof(parser));
             }
-            return MappedCallback<TModel>.Binder(parser, options.HeaderRow, body);
+            return MappedCallback<TModel>.Binder(parser, parser.CsvInfo, false, options.HeaderRow, body);
         }
 
         /// <summary>
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvSheet.cs b/src/ExcelReader.Core/Reader/Csv/CsvSheet.cs
index 39015bc7..e6effc5e 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvSheet.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvSheet.cs
@@ -46,7 +46,7 @@ public bool IsDate1904
             }
         }
 
-        private CsvReader Reader
+        internal CsvReader Reader
         {
             get
             {
diff --git a/src/ExcelReader.Core/Reader/SheetParallel.cs b/src/ExcelReader.Core/Reader/SheetParallel.cs
new file mode 100644
index 00000000..5d643ef8
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/SheetParallel.cs
@@ -0,0 +1,278 @@
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Parser.Internal;
+using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Parser.SheetPipeline;
+using ExcelReader.Core.Reader.Csv;
+
+namespace ExcelReader.Core.Reader
+{
+    /// <summary>
+    /// Reads a sheet of any format across several threads: <c>ParseAsync</c> yields typed rows in source
+    /// order, <c>ForEachAsync</c> hands each row to a callback on the worker threads, and
+    /// <c>AggregateAsync</c> folds rows into one accumulator per partition.
+    /// </summary>
+    /// <remarks>
+    /// <para>
+    /// The caller owns the workbook and keeps it open until the returned task completes or the
+    /// enumeration ends. The CSV dialect is the <see cref="CsvReaderOptions"/> the workbook was opened with.
+    /// </para>
+    /// <para>
+    /// A read falls back to one sequential pass, with the same results and no error, when
+    /// <see cref="SheetParallelOptions.DegreeOfParallelism"/> is 1, the sheet is too small to partition
+    /// usefully, the sheet is an XLS sheet or a table view, or a CSV cannot be partitioned (a non-seekable
+    /// stream or a non-UTF-8 encoding).
+    /// </para>
+    /// <para>
+    /// Delivery guarantees. The general contract is the weaker CSV one: <c>ForEachAsync</c> is at-least-once,
+    /// and a partition whose start was guessed wrongly is discarded and read again. XLSB delivers every row
+    /// exactly once, in <c>ForEachAsync</c> too. XLSX delivers exactly once for a well-formed sheet; a
+    /// malformed one can make <c>ForEachAsync</c> deliver a row twice. <c>ParseAsync</c> yields the same items in
+    /// the same order as the sequential <see cref="ExcelParser{T}"/> on every format, and
+    /// <c>AggregateAsync</c> and <c>ForEachAsync</c> equal their own single-thread run.
+    /// </para>
+    /// <para>
+    /// <see cref="ExcelParseException.Row"/>: <c>ParseAsync</c> renumbers it from the count emitted at the
+    /// merge; <c>ForEachAsync</c> and <c>AggregateAsync</c> report the exact row when sequential and 0 when partitioned.
+    /// </para>
+    /// </remarks>
+    public static class SheetParallel
+    {
+        /// <summary>
+        /// Parses a sheet into <typeparamref name="T"/> instances across several threads, yielding the
+        /// same sequence, in the same order, that the sequential <see cref="ExcelParser{T}"/> produces.
+        /// </summary>
+        /// <typeparam name="T">The row model type to bind each row to.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the enumeration ends.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> locates the header.</param>
+        /// <param name="options">Parallelism options. Defaults to <see cref="SheetParallelOptions.Default"/>. <see cref="SheetParallelOptions.HeaderRow"/> does not apply here and must be left at <c>0</c>.</param>
+        /// <param name="ct">A token to cancel enumeration.</param>
+        /// <returns>An enumerable that yields one <typeparamref name="T"/> per data row.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> or <paramref name="parser"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentException"><see cref="SheetParallelOptions.HeaderRow"/> is not 0.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>
+        /// Parsing and type conversion run in parallel; whatever the caller does per row does not. A caller
+        /// whose per-row work dominates will see little gain from raising <see cref="SheetParallelOptions.DegreeOfParallelism"/>.
+        /// For CSV, <see cref="CsvReaderOptions.InternStrings"/> yields substantially less here than sequentially,
+        /// since each partition keeps its own dedup cache. A partition read from a wrongly guessed start is
+        /// discarded before any of its rows are yielded, but its cells have already passed through the parser's
+        /// converters and property setters, which must therefore be free of side effects.
+        /// </remarks>
+        public static IAsyncEnumerable<T> ParseAsync<T>(
+            IExcelSheet sheet, ExcelParser<T> parser, SheetParallelOptions? options = null, CancellationToken ct = default)
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(parser);
+            SheetParallelOptions validated = Validated(options);
+            if (validated.HeaderRow != 0)
+            {
+                throw new ArgumentException(
+                    $"{nameof(SheetParallelOptions)}.{nameof(SheetParallelOptions.HeaderRow)} does not apply to typed parsing; set {nameof(ExcelParserConfig)}.{nameof(ExcelParserConfig.HeaderRow)} instead.",
+                    nameof(options));
+            }
+            return SheetRunner.Parse(sheet, parser, validated.DegreeOfParallelism, ct);
+        }
+
+        /// <summary>
+        /// Reads a sheet across several threads, parses every row into a <typeparamref name="TRecord"/>
+        /// and hands it to <paramref name="body"/>.
+        /// </summary>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
+        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
+        /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel processing.</param>
+        /// <returns>A task that completes when every record has been delivered.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>
+        /// <para>
+        /// <paramref name="body"/> runs concurrently on worker threads and must be safe to call from
+        /// several at once; the caller owns any synchronization. Records arrive in no particular order.
+        /// </para>
+        /// <para>
+        /// Delivery is at least once in general: <paramref name="body"/> may be invoked more than once for the
+        /// same record. On CSV, a partition whose start was guessed wrongly is read again from the confirmed
+        /// offset, and the discarded speculative pass may already have delivered a whole partition's worth of
+        /// records, which may also be misparsed: a wrong start shifts every field boundary. An exception
+        /// <paramref name="body"/> throws during a discarded pass is discarded with it. A start is only guessed
+        /// wrongly inside a quoted field, so a CSV in which the quote character never appears delivers every
+        /// record exactly once. XLSB delivers every row exactly once. XLSX does too for a well-formed sheet; on
+        /// a malformed one, workers may already have called <paramref name="body"/> for rows that are then
+        /// dropped, so a row can be delivered twice or be one the sequential reader would not produce.
+        /// </para>
+        /// <para>
+        /// A <paramref name="body"/> with side effects must therefore be idempotent and tolerate records that
+        /// do not exist. For exactly-once on any source, use
+        /// <see cref="AggregateAsync{TAccumulator, TRecord}(IExcelSheet, SheetParallelOptions?, CancellationToken)"/>, where the
+        /// discarded partition's accumulator is thrown away, and apply the side effects once it returns.
+        /// </para>
+        /// <para>
+        /// A <see cref="ReadOnlySpan{T}"/> column points into a pooled buffer the worker reuses once
+        /// <paramref name="body"/> returns. Copy anything that must outlive the call.
+        /// </para>
+        /// </remarks>
+        public static Task ForEachAsync<TRecord>(
+            IExcelSheet sheet, Action<TRecord> body, SheetParallelOptions? options = null, CancellationToken ct = default)
+            where TRecord : IRowRecord<TRecord>, allows ref struct
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(body);
+            return SheetRunner.RunAsync(sheet, RecordCallback<TRecord>.For(body), null, Validated(options), ct);
+        }
+
+        /// <summary>
+        /// Reads a sheet across several threads, binds every row to a <typeparamref name="TModel"/>
+        /// through <paramref name="parser"/> and hands it to <paramref name="body"/>.
+        /// </summary>
+        /// <typeparam name="TModel">The model type. May be a <see langword="ref struct"/> with <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> properties.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
+        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
+        /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel processing.</param>
+        /// <returns>A task that completes when every record has been delivered.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/>, <paramref name="parser"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="SheetParallelOptions.HeaderRow"/> is 0.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>
+        /// <para>
+        /// Carries the same concurrency, delivery and span-lifetime contract as the
+        /// <see cref="IRowRecord{TSelf}"/> overload: <paramref name="body"/> runs concurrently, delivery is
+        /// at least once in general (exactly once on XLSB, and on a well-formed XLSX sheet), and records arrive
+        /// in no particular order. A property that fails to parse keeps its default unless
+        /// <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing <c>[ExcelRequired]</c> column or
+        /// value throws <see cref="ExcelParseException"/>; empty rows are skipped.
+        /// </para>
+        /// <para>
+        /// <see cref="ExcelParseException.Row"/> is exact when the sheet is read sequentially and
+        /// 0 when it is partitioned, since a partition does not know how many rows precede it.
+        /// </para>
+        /// </remarks>
+        public static Task ForEachAsync<TModel>(
+            IExcelSheet sheet, ExcelParser<TModel> parser, Action<TModel> body, SheetParallelOptions? options = null, CancellationToken ct = default)
+            where TModel : allows ref struct
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(parser);
+            ArgumentNullException.ThrowIfNull(body);
+            SheetParallelOptions validated = Validated(options);
+            TypeMapInfo<TModel> info = InfoFor(sheet, parser, validated);
+            return SheetRunner.RunAsync(
+                sheet, MappedCallback<TModel>.Unbound, MappedCallback<TModel>.Binder(parser, info, sheet.IsDate1904, validated.HeaderRow, body), validated, ct);
+        }
+
+        /// <summary>
+        /// Reads a sheet across several threads, parses every row into a <typeparamref name="TRecord"/>
+        /// and folds it into a <typeparamref name="TAccumulator"/>, one instance per partition, merged in sheet order.
+        /// </summary>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
+        /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel processing.</param>
+        /// <returns>The accumulator holding every record.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>
+        /// A partition read from a wrongly guessed start is read again into a new accumulator. The result
+        /// holds every record exactly once, but <see cref="IRowRecord{TSelf}.TryParse"/> and
+        /// <see cref="IRowAccumulator{TSelf, TModel}.Add"/> may already have run for the discarded pass's records, as
+        /// <see cref="IRowAccumulator{TSelf, TModel}"/> describes. A sequential fallback uses a single accumulator and never calls
+        /// <see cref="IRowAccumulator{TSelf, TModel}.Merge"/>.
+        /// </remarks>
+        public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
+            IExcelSheet sheet, SheetParallelOptions? options = null, CancellationToken ct = default)
+            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
+            where TRecord : IRowRecord<TRecord>, allows ref struct
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            return SheetRunner.RunAsync(sheet, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
+        }
+
+        /// <summary>
+        /// Reads a sheet across several threads, binds every row to a <typeparamref name="TModel"/>
+        /// through <paramref name="parser"/> and folds it into a <typeparamref name="TAccumulator"/>, one
+        /// instance per partition, merged in sheet order.
+        /// </summary>
+        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
+        /// <typeparam name="TModel">The model type.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
+        /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel processing.</param>
+        /// <returns>The accumulator holding every record.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> or <paramref name="parser"/> is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="SheetParallelOptions.HeaderRow"/> is 0.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>
+        /// <para>
+        /// The header is bound once, before any row is folded. A property that fails to parse keeps its
+        /// default unless <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing
+        /// <c>[ExcelRequired]</c> column or value throws <see cref="ExcelParseException"/>; empty rows are skipped.
+        /// </para>
+        /// <para>
+        /// <see cref="ExcelParseException.Row"/> is exact when the sheet is read sequentially and 0 when it is
+        /// partitioned, since a partition does not know how many rows precede it.
+        /// </para>
+        /// <para>Otherwise carries the same contract and fallbacks as the <see cref="IRowRecord{TSelf}"/> overload.</para>
+        /// </remarks>
+        public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
+            IExcelSheet sheet, ExcelParser<TModel> parser, SheetParallelOptions? options = null, CancellationToken ct = default)
+            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
+            where TModel : allows ref struct
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(parser);
+            SheetParallelOptions validated = Validated(options);
+            TypeMapInfo<TModel> info = InfoFor(sheet, parser, validated);
+            return SheetRunner.RunAsync(
+                sheet, MappedAggregation<TAccumulator, TModel>.Unbound,
+                MappedAggregation<TAccumulator, TModel>.Binder(parser, info, sheet.IsDate1904, validated.HeaderRow), validated, ct);
+        }
+
+        /// <summary>
+        /// Reads a sheet across several threads and folds every row with the functions of
+        /// <paramref name="aggregation"/>, one accumulator per partition, combined in sheet order.
+        /// </summary>
+        /// <typeparam name="TState">The accumulator type.</typeparam>
+        /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
+        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
+        /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
+        /// <param name="ct">A token to cancel processing.</param>
+        /// <returns>The combined accumulator.</returns>
+        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> or <paramref name="aggregation"/>, or one of its functions, is <see langword="null"/>.</exception>
+        /// <exception cref="ArgumentOutOfRangeException">A numeric option is negative.</exception>
+        /// <remarks>Carries the same fallbacks as the <see cref="IRowAccumulator{TSelf, TModel}"/> overloads.</remarks>
+        public static Task<TState> AggregateAsync<TState>(
+            IExcelSheet sheet, RowAggregation<TState> aggregation, SheetParallelOptions? options = null, CancellationToken ct = default)
+        {
+            ArgumentNullException.ThrowIfNull(sheet);
+            ArgumentNullException.ThrowIfNull(aggregation);
+            ArgumentNullException.ThrowIfNull(aggregation.Seed, nameof(aggregation));
+            ArgumentNullException.ThrowIfNull(aggregation.Accumulate, nameof(aggregation));
+            ArgumentNullException.ThrowIfNull(aggregation.Combine, nameof(aggregation));
+            return SheetRunner.RunAsync(sheet, aggregation, null, Validated(options), ct);
+        }
+
+        private static TypeMapInfo<TModel> InfoFor<TModel>(IExcelSheet sheet, ExcelParser<TModel> parser, SheetParallelOptions options)
+            where TModel : allows ref struct
+        {
+            TypeMapInfo<TModel> info = sheet is CsvSheet ? parser.CsvInfo : parser.Info;
+            if (options.HeaderRow == 0 && !info.IsIndexBased)
+            {
+                throw new ArgumentException(
+                    $"A parser that binds columns by header name needs {nameof(SheetParallelOptions)}.{nameof(SheetParallelOptions.HeaderRow)} of at least 1.", nameof(parser));
+            }
+            return info;
+        }
+
+        private static SheetParallelOptions Validated(SheetParallelOptions? options)
+        {
+            options ??= SheetParallelOptions.Default;
+            ArgumentOutOfRangeException.ThrowIfNegative(options.DegreeOfParallelism, nameof(options));
+            ArgumentOutOfRangeException.ThrowIfNegative(options.HeaderRow, nameof(options));
+            return options;
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/SheetParallelOptions.cs b/src/ExcelReader.Core/Reader/SheetParallelOptions.cs
new file mode 100644
index 00000000..be31ae13
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/SheetParallelOptions.cs
@@ -0,0 +1,18 @@
+namespace ExcelReader.Core.Reader
+{
+    /// <summary>Options for reading a sheet across several threads with <see cref="SheetParallel"/>.</summary>
+    public sealed class SheetParallelOptions
+    {
+        /// <summary>Gets the default options: one thread per processor, no header.</summary>
+        public static SheetParallelOptions Default { get; } = new();
+
+        /// <summary>Gets the maximum number of reading threads. <c>0</c>, the default, means <see cref="Environment.ProcessorCount"/>; <c>1</c> reads sequentially.</summary>
+        public int DegreeOfParallelism { get; init; }
+
+        /// <summary>
+        /// Gets the 1-based number of the header row; it and every row before it are skipped.
+        /// <c>0</c>, the default, means the sheet has no header.
+        /// </summary>
+        public int HeaderRow { get; init; }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
index 6afffef7..bc24b5ea 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
@@ -107,7 +107,7 @@ private static Task<PeopleLog> Chunked(byte[] csv, ExcelParser<Person> map, int
             return ParallelCsvProcessor.RunWithChunkSizeAsync(
                 csv.AsMemory(),
                 MappedAggregation<PeopleLog, Person>.Unbound,
-                MappedAggregation<PeopleLog, Person>.Binder(map, headerRow),
+                MappedAggregation<PeopleLog, Person>.Binder(map, map.CsvInfo, false, headerRow),
                 new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = headerRow },
                 chunkSize,
                 TestContext.Current.CancellationToken);
@@ -118,7 +118,7 @@ private static Task<PeopleLog> Chunked(byte[] csv, ExcelParser<IdOnly> map, int
             return ParallelCsvProcessor.RunWithChunkSizeAsync(
                 csv.AsMemory(),
                 MappedAggregation<PeopleLog, IdOnly>.Unbound,
-                MappedAggregation<PeopleLog, IdOnly>.Binder(map, headerRow),
+                MappedAggregation<PeopleLog, IdOnly>.Binder(map, map.CsvInfo, false, headerRow),
                 new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = headerRow },
                 chunkSize,
                 TestContext.Current.CancellationToken);
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
index 1c679698..d4931d0d 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
@@ -304,10 +304,11 @@ private static Task<byte> ChunkedRecord(byte[] csv, Action<Sale> body, ChunkProb
 
         private static Task<byte> ChunkedMapped(byte[] csv, Action<Order> body, ChunkProbe probe, int dop, int chunkSize)
         {
+            ExcelParser<Order> order = ExcelParser.FromAttributes<Order>();
             return ParallelCsvProcessor.RunWithChunkSizeAsync(
                 csv.AsMemory(),
                 probe.Wrap(MappedCallback<Order>.Unbound),
-                MappedCallback<Order>.Binder(ExcelParser.FromAttributes<Order>(), 1, body),
+                MappedCallback<Order>.Binder(order, order.CsvInfo, false, 1, body),
                 new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 },
                 chunkSize,
                 TestContext.Current.CancellationToken);
diff --git a/tests/ExcelReader.Tests/Parser/SheetParallelTests.cs b/tests/ExcelReader.Tests/Parser/SheetParallelTests.cs
new file mode 100644
index 00000000..de8c6aad
--- /dev/null
+++ b/tests/ExcelReader.Tests/Parser/SheetParallelTests.cs
@@ -0,0 +1,195 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Csv;
+using ExcelReader.Core.Reader.Xlsx;
+using ExcelReader.Core.Writer.Xls;
+using ExcelReader.Tests.Reader.Tables;
+
+namespace ExcelReader.Tests.Parser
+{
+    public class SheetParallelTests
+    {
+        private sealed class Person
+        {
+            public string? Name { get; set; }
+
+            public int Age { get; set; }
+        }
+
+        private static readonly RowAggregation<List<string>> Collecting = new()
+        {
+            Seed = static () => [],
+            Accumulate = static (ref List<string> rows, Row row) => rows.Add(Render(row)),
+            Combine = static (left, right) =>
+            {
+                left.AddRange(right);
+                return left;
+            },
+        };
+
+        private static string Render(Row row)
+        {
+            var sb = new StringBuilder();
+            foreach (RowCell cell in row.Cells)
+            {
+                sb.Append(cell.ColumnIndex).Append(':').Append(cell.Value.GetString()).Append('|');
+            }
+            return sb.ToString();
+        }
+
+        private static List<string> Sequential(IExcelSheet sheet, int headerRow)
+        {
+            var rows = new List<string>();
+            using IExcelRowEnumerator e = sheet.GetEnumerator();
+            while (e.MoveNext())
+            {
+                rows.Add(Render(e.Current));
+            }
+            return rows.Count > headerRow ? rows[headerRow..] : [];
+        }
+
+        private static byte[] Csv(int rows)
+        {
+            var sb = new StringBuilder("Name,Age\n");
+            for (int i = 0; i < rows; i++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"name{i:D5},{i}\n");
+            }
+            return Encoding.UTF8.GetBytes(sb.ToString());
+        }
+
+        private static async Task<MemoryStream> XlsxAsync(int rows)
+        {
+            object?[][] data = new object?[rows + 1][];
+            data[0] = ["Name", "Age"];
+            for (int i = 0; i < rows; i++)
+            {
+                data[i + 1] = [string.Create(CultureInfo.InvariantCulture, $"name{i:D5}"), i];
+            }
+            return await TypedWorkbook.BuildAsync(data);
+        }
+
+        [Fact]
+        public async Task CsvAggregateMatchesSequential()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using CsvReader reader = Excel.FromCsv(Csv(40_000));
+            var options = new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
+
+            List<string> actual = await SheetParallel.AggregateAsync(reader.FirstSheet, Collecting, options, ct);
+
+            Assert.Equal(Sequential(reader.FirstSheet, 1), actual);
+        }
+
+        [Fact]
+        public async Task CsvParseMatchesTheSequentialParser()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using CsvReader reader = Excel.FromCsv(Csv(40_000));
+            ExcelParser<Person> parser = ExcelParser.FromAttributes<Person>();
+            List<Person> expected = [.. parser.Parse(reader.FirstSheet)];
+
+            var actual = new List<Person>();
+            await foreach (Person person in SheetParallel.ParseAsync(reader.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct))
+            {
+                actual.Add(person);
+            }
+
+            Assert.Equal(expected.Select(p => (p.Name, p.Age)), actual.Select(p => (p.Name, p.Age)));
+        }
+
+        [Fact]
+        public async Task ACsvOverANonSeekableStreamFallsBackToSequential()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            byte[] csv = Csv(5_000);
+            await using var pipe = new NonSeekableStream(csv);
+            using CsvReader reader = Excel.FromCsv(pipe);
+            using CsvReader reference = Excel.FromCsv(csv);
+
+            List<string> actual = await SheetParallel.AggregateAsync(reader.FirstSheet, Collecting, new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 }, ct);
+
+            Assert.Equal(Sequential(reference.FirstSheet, 1), actual);
+        }
+
+        [Fact]
+        public async Task AnXlsSheetReadsSequentially()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var ms = new MemoryStream();
+            await using (XlsWorkbookWriter wb = XlsWorkbookWriter.Create(ms, leaveOpen: true))
+            {
+                XlsSheetWriter sheet = wb.AddSheet("S1");
+                for (int r = 0; r < 200; r++)
+                {
+                    using XlsRowWriter row = sheet.StartRow();
+                    row.Write("name-" + r.ToString(CultureInfo.InvariantCulture));
+                    row.Write(r);
+                }
+                sheet.End();
+                await wb.EndAsync(ct);
+            }
+            ms.Position = 0;
+            using IExcelWorkbook workbook = Excel.Open(ms);
+
+            List<string> actual = await SheetParallel.AggregateAsync(workbook.FirstSheet, Collecting, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct);
+
+            Assert.Equal(Sequential(workbook.FirstSheet, 0), actual);
+        }
+
+        [Theory]
+        [MemberData(nameof(TableMetadataTests.Fixtures), MemberType = typeof(TableMetadataTests))]
+        public async Task ATableViewReadsSequentially(string file)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
+            Assert.True(workbook.TryGetTable("Sales", out ExcelTable? table));
+            IExcelSheet view = table.AsSheet();
+
+            List<string> actual = await SheetParallel.AggregateAsync(view, Collecting, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct);
+
+            Assert.Equal(Sequential(view, 0), actual);
+        }
+
+        [Fact]
+        public async Task XlsxFamiliesMatchSequential()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await XlsxAsync(20_000);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Person> parser = ExcelParser.FromAttributes<Person>();
+            List<Person> expected = [.. parser.Parse(workbook.FirstSheet)];
+            var options = new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
+
+            Assert.Equal(Sequential(workbook.FirstSheet, 1), await SheetParallel.AggregateAsync(workbook.FirstSheet, Collecting, options, ct));
+
+            var parsed = new List<Person>();
+            await foreach (Person person in SheetParallel.ParseAsync(workbook.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct))
+            {
+                parsed.Add(person);
+            }
+            Assert.Equal(expected.Select(p => (p.Name, p.Age)), parsed.Select(p => (p.Name, p.Age)));
+
+            var seen = new System.Collections.Concurrent.ConcurrentBag<(string?, int)>();
+            await SheetParallel.ForEachAsync(workbook.FirstSheet, parser, (Person p) => seen.Add((p.Name, p.Age)), options, ct);
+            Assert.Equal(expected.Select(p => (p.Name, p.Age)).Order(), seen.Order());
+        }
+
+        [Fact]
+        public async Task ArgumentsAreValidated()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using CsvReader reader = Excel.FromCsv(Csv(10));
+            ExcelParser<Person> parser = ExcelParser.FromAttributes<Person>();
+
+            await Assert.ThrowsAsync<ArgumentNullException>(() => SheetParallel.AggregateAsync(null!, Collecting, null, ct));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => SheetParallel.AggregateAsync(reader.FirstSheet, (RowAggregation<int>)null!, null, ct));
+            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => SheetParallel.AggregateAsync(reader.FirstSheet, Collecting, new SheetParallelOptions { DegreeOfParallelism = -1 }, ct));
+            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => SheetParallel.AggregateAsync(reader.FirstSheet, Collecting, new SheetParallelOptions { HeaderRow = -1 }, ct));
+            Assert.Throws<ArgumentException>(() => SheetParallel.ParseAsync(reader.FirstSheet, parser, new SheetParallelOptions { HeaderRow = 2 }, ct));
+            await Assert.ThrowsAsync<ArgumentException>(() => SheetParallel.ForEachAsync(reader.FirstSheet, parser, (Person _) => { }, new SheetParallelOptions { HeaderRow = 0 }, ct));
+        }
+    }
+}

From cd6550e6d8277aca9d54ad8271598a48bce9e236 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 22:07:19 -0300
Subject: [PATCH 066/115] feat!: remove CsvParallel in favour of SheetParallel

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Parser/ParallelCsv/CsvSourceResolver.cs   |  39 --
 .../Parser/ParallelCsv/ParallelCsvFactory.cs  |  58 +-
 .../ParallelCsv/ParallelCsvProcessor.cs       | 124 +---
 .../PublicAPI/PublicAPI.Shipped.txt           |  28 -
 .../Reader/Csv/CsvParallel.cs                 | 605 ------------------
 .../Reader/Csv/CsvParallelOptions.cs          |  21 -
 .../Reader/IRowAccumulator.cs                 |  25 +-
 src/ExcelReader.Core/Reader/IRowRecord.cs     |  14 +-
 src/ExcelReader.Core/Reader/RowAction.cs      |   8 +-
 src/ExcelReader.Core/Reader/RowAggregation.cs |  12 +-
 src/ExcelReader.Native/Csv/CsvAggregateApi.cs |  40 +-
 .../Csv/NativeCsvAggregateOptions.cs          |  10 +-
 .../Typed/TypedApi.Parallel.cs                |   3 +-
 .../Parse/CsvParallelParseBenchmark.cs        |  16 +-
 .../Parse/CsvParallelVsSepBenchmark.cs        |   5 +-
 .../Native/CsvAggregateNativeTests.cs         |  28 +-
 .../ParallelCsv/AggregateCsvModelTests.cs     |  61 +-
 .../ParallelCsv/AggregateCsvParallelTests.cs  |  72 ++-
 .../ParallelCsv/CsvReaderChunkSourceTests.cs  |   4 +-
 .../ParallelCsv/ForEachCsvParallelTests.cs    |  88 ++-
 .../ParallelCsv/ParseCsvParallelTests.cs      |  39 +-
 .../Reader/Csv/CsvDialectAndFormatTests.cs    |   9 +-
 22 files changed, 292 insertions(+), 1017 deletions(-)
 delete mode 100644 src/ExcelReader.Core/Parser/ParallelCsv/CsvSourceResolver.cs
 delete mode 100644 src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
 delete mode 100644 src/ExcelReader.Core/Reader/Csv/CsvParallelOptions.cs

diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvSourceResolver.cs b/src/ExcelReader.Core/Parser/ParallelCsv/CsvSourceResolver.cs
deleted file mode 100644
index 2f50ec78..00000000
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvSourceResolver.cs
+++ /dev/null
@@ -1,39 +0,0 @@
-using Microsoft.Win32.SafeHandles;
-
-namespace ExcelReader.Core.Parser.ParallelCsv
-{
-    internal static class CsvSourceResolver
-    {
-        internal static bool TryResolve(Stream stream, out CsvChunkSource source)
-        {
-            if (stream is MemoryStream memory && memory.TryGetBuffer(out ArraySegment<byte> segment))
-            {
-                int offset = segment.Offset + (int)memory.Position;
-                int count = segment.Count - (int)memory.Position;
-                if (count <= 0)
-                {
-                    source = default;
-                    return false;
-                }
-                source = new CsvChunkSource(segment.Array!.AsMemory(offset, count));
-                return true;
-            }
-
-            if (stream is FileStream file)
-            {
-                SafeFileHandle handle = file.SafeFileHandle;
-                long length = RandomAccess.GetLength(handle);
-                if (file.Position >= length)
-                {
-                    source = default;
-                    return false;
-                }
-                source = new CsvChunkSource(handle, length, startOffset: file.Position);
-                return true;
-            }
-
-            source = default;
-            return false;
-        }
-    }
-}
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
index 098331a3..34babc94 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
@@ -1,10 +1,8 @@
-using System.Diagnostics.CodeAnalysis;
 using System.Text;
 using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 using ExcelReader.Core.Reader.Internal;
-using Microsoft.Win32.SafeHandles;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
@@ -12,58 +10,11 @@ internal static class ParallelCsvFactory
     {
         private const long MinParallelBytes = 4 * 64 * 1024;
 
-        [SuppressMessage("Performance", "CA1849:Call async methods when in an async method",
-            Justification = "This factory is synchronous by design (see the VSTHRD200 suppression above); opening the file here, once, before any enumeration starts, is deliberate rather than a blocking call inside an async method.")]
-        internal static IAsyncEnumerable<T> Create<T>(
-            string path, int degreeOfParallelism, CsvReaderOptions? readerOptions, ExcelParser<T> parser, CancellationToken ct)
-        {
-            CsvReaderOptions options = CsvDialectResolver.Resolve(path, readerOptions ?? CsvReaderOptions.Default);
-            int dop = Normalize(degreeOfParallelism);
-
-            var info = new FileInfo(path);
-            if (!CanPartition(dop, info.Length, options))
-            {
-                return Sequential(Excel.FromCsvFile(path, options), parser, ct);
-            }
-
-            SafeFileHandle handle = File.OpenHandle(path, FileMode.Open, FileAccess.Read, FileShare.Read, FileOptions.Asynchronous | FileOptions.RandomAccess);
-            return Build(new CsvChunkSource(handle, info.Length), options, parser, dop, chunkSizeOverride: 0, ownedHandle: handle, ct);
-        }
-
-        internal static IAsyncEnumerable<T> Create<T>(
-            ReadOnlyMemory<byte> data, int degreeOfParallelism, CsvReaderOptions? readerOptions, ExcelParser<T> parser, CancellationToken ct)
-        {
-            CsvReaderOptions options = CsvDialectResolver.Resolve(data, readerOptions ?? CsvReaderOptions.Default);
-            int dop = Normalize(degreeOfParallelism);
-
-            if (!CanPartition(dop, data.Length, options))
-            {
-                return Sequential(Excel.FromCsv(data, options), parser, ct);
-            }
-            return Build(new CsvChunkSource(data), options, parser, dop, chunkSizeOverride: 0, ownedHandle: null, ct);
-        }
-
-        [SuppressMessage("Performance", "CA1849:Call async methods when in an async method",
-            Justification = "This factory is synchronous by design (see the VSTHRD200 suppression above); wrapping the caller-owned stream here, once, before any enumeration starts, is deliberate rather than a blocking call inside an async method.")]
-        internal static IAsyncEnumerable<T> Create<T>(
-            Stream stream, int degreeOfParallelism, CsvReaderOptions? readerOptions, ExcelParser<T> parser, CancellationToken ct)
-        {
-            CsvReaderOptions options = CsvDialectResolver.Resolve(stream, readerOptions ?? CsvReaderOptions.Default);
-            int dop = Normalize(degreeOfParallelism);
-
-            if (!CsvSourceResolver.TryResolve(stream, out CsvChunkSource source)
-                || !CanPartition(dop, source.Length, options))
-            {
-                return Sequential(Excel.FromCsv(stream, leaveOpen: true, options), parser, ct);
-            }
-            return Build(source, options, parser, dop, chunkSizeOverride: 0, ownedHandle: null, ct);
-        }
-
         internal static IAsyncEnumerable<T> CreateWithChunkSize<T>(
             ReadOnlyMemory<byte> data, int degreeOfParallelism, int chunkSize, CsvReaderOptions? readerOptions, ExcelParser<T> parser, CancellationToken ct)
         {
             CsvReaderOptions options = CsvDialectResolver.Resolve(data, readerOptions ?? CsvReaderOptions.Default);
-            return Build(new CsvChunkSource(data), options, parser, Normalize(degreeOfParallelism), chunkSize, ownedHandle: null, ct);
+            return Build(new CsvChunkSource(data), options, parser, Normalize(degreeOfParallelism), chunkSize, ct);
         }
 
         internal static IAsyncEnumerable<T> Create<T>(CsvReader reader, int degreeOfParallelism, ExcelParser<T> parser, CancellationToken ct)
@@ -73,7 +24,7 @@ internal static IAsyncEnumerable<T> Create<T>(CsvReader reader, int degreeOfPara
             {
                 return new CsvEnumerable<T>(reader.FirstSheet, parser.Config, parser.CsvInfo, ownedReader: null, ct);
             }
-            return Build(source, reader.Options, parser, dop, chunkSizeOverride: 0, ownedHandle: null, ct, reader.Lifetime, reader);
+            return Build(source, reader.Options, parser, dop, chunkSizeOverride: 0, ct, reader.Lifetime, reader);
         }
 
         internal static int Normalize(int degreeOfParallelism)
@@ -96,7 +47,6 @@ private static IAsyncEnumerable<T> Build<T>(
             ExcelParser<T> parser,
             int dop,
             int chunkSizeOverride,
-            SafeFileHandle? ownedHandle,
             CancellationToken ct,
             ReaderLifetime? lease = null,
             object? owner = null)
@@ -112,18 +62,16 @@ private static IAsyncEnumerable<T> Build<T>(
 
             if (dataStart >= source.Length)
             {
-                ownedHandle?.Dispose();
                 return Empty<T>();
             }
 
             CsvChunkPlan plan = CsvChunkPlan.Create(dataStart, source.Length - dataStart, dop, chunkSizeOverride);
             if (plan.Count <= 1)
             {
-                ownedHandle?.Dispose();
                 return Sequential(source.OpenReader(options), parser, ct);
             }
 
-            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, ownedHandle, lease, owner);
+            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, null, lease, owner);
         }
 
         private static CsvEnumerable<T> Sequential<T>(
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
index c0101002..31e1e16b 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvProcessor.cs
@@ -1,7 +1,6 @@
 using System.Runtime.ExceptionServices;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
-using Microsoft.Win32.SafeHandles;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
@@ -21,60 +20,19 @@ private sealed class ChunkOutcome<TState>(long actualStart, TState state)
             public ExceptionDispatchInfo? Failure;
         }
 
-        internal static async Task<TState> RunAsync<TState>(
-            string path, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
-        {
-            options = WithResolvedDialect(options, CsvDialectResolver.Resolve(path, options.Reader));
-            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            long length = new FileInfo(path).Length;
-            if (!ParallelCsvFactory.CanPartition(dop, length, options.Reader))
-            {
-                CsvReader reader = await Excel.FromCsvFileAsync(path, options.Reader, ct).ConfigureAwait(false);
-                return await SequentialAsync(reader, ownsReader: true, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
-            }
-            using SafeFileHandle handle = File.OpenHandle(path, FileMode.Open, FileAccess.Read, FileShare.Read, FileOptions.Asynchronous | FileOptions.RandomAccess);
-            return await PartitionedAsync(new CsvChunkSource(handle, length), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
-        }
-
-        internal static Task<TState> RunAsync<TState>(
-            ReadOnlyMemory<byte> data, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
-        {
-            options = WithResolvedDialect(options, CsvDialectResolver.Resolve(data, options.Reader));
-            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            if (!ParallelCsvFactory.CanPartition(dop, data.Length, options.Reader))
-            {
-                return SequentialAsync(Excel.FromCsv(data, options.Reader), ownsReader: true, aggregation, factory, options.HeaderRow, ct);
-            }
-            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct);
-        }
-
-        internal static async Task<TState> RunAsync<TState>(
-            Stream stream, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, CancellationToken ct)
-        {
-            options = WithResolvedDialect(options, await CsvDialectResolver.ResolveAsync(stream, options.Reader, ct).ConfigureAwait(false));
-            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            if (!CsvSourceResolver.TryResolve(stream, out CsvChunkSource source)
-                || !ParallelCsvFactory.CanPartition(dop, source.Length, options.Reader))
-            {
-                CsvReader reader = await Excel.FromCsvAsync(stream, leaveOpen: true, options.Reader, ct).ConfigureAwait(false);
-                return await SequentialAsync(reader, ownsReader: true, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
-            }
-            return await PartitionedAsync(source, aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
-        }
-
         internal static Task<TState> RunWithChunkSizeAsync<TState>(
-            ReadOnlyMemory<byte> data, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, CsvParallelOptions options, int chunkSize, CancellationToken ct)
+            ReadOnlyMemory<byte> data, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory,
+            CsvReaderOptions reader, int headerRow, int degreeOfParallelism, int chunkSize, CancellationToken ct)
         {
-            options = WithResolvedDialect(options, CsvDialectResolver.Resolve(data, options.Reader));
-            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, options.Reader, options.HeaderRow, dop, chunkSize, ct);
+            CsvReaderOptions resolved = CsvDialectResolver.Resolve(data, reader);
+            return PartitionedAsync(new CsvChunkSource(data), aggregation, factory, resolved, headerRow, ParallelCsvFactory.Normalize(degreeOfParallelism), chunkSize, ct);
         }
 
         internal static Task<TState> RunPartitionedAsync<TState>(
-            CsvChunkSource source, RowAggregation<TState> aggregation, CsvParallelOptions options, int chunkSizeOverride, CancellationToken ct)
+            CsvChunkSource source, RowAggregation<TState> aggregation, CsvReaderOptions reader, int headerRow, int degreeOfParallelism,
+            int chunkSizeOverride, CancellationToken ct)
         {
-            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
-            return PartitionedAsync(source, aggregation, null, options.Reader, options.HeaderRow, dop, chunkSizeOverride, ct);
+            return PartitionedAsync(source, aggregation, null, reader, headerRow, ParallelCsvFactory.Normalize(degreeOfParallelism), chunkSizeOverride, ct);
         }
 
         internal static async Task<TState> RunAsync<TState>(
@@ -86,7 +44,7 @@ internal static async Task<TState> RunAsync<TState>(
                 int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
                 if (!reader.TryGetChunkSource(out CsvChunkSource source) || !ParallelCsvFactory.CanPartition(dop, source.Length, reader.Options))
                 {
-                    return await SequentialAsync(reader, ownsReader: false, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
+                    return await SequentialAsync(reader, aggregation, factory, options.HeaderRow, ct).ConfigureAwait(false);
                 }
                 return await PartitionedAsync(source, aggregation, factory, reader.Options, options.HeaderRow, dop, chunkSizeOverride: 0, ct).ConfigureAwait(false);
             }
@@ -96,67 +54,43 @@ internal static async Task<TState> RunAsync<TState>(
             }
         }
 
-        private static CsvParallelOptions WithResolvedDialect(CsvParallelOptions options, CsvReaderOptions reader)
-        {
-            if (ReferenceEquals(reader, options.Reader))
-            {
-                return options;
-            }
-            return new CsvParallelOptions
-            {
-                DegreeOfParallelism = options.DegreeOfParallelism,
-                Reader = reader,
-                HeaderRow = options.HeaderRow,
-            };
-        }
-
         private static RowAggregation<TState> WithAccumulate<TState>(RowAggregation<TState> aggregation, RowAction<TState> accumulate)
         {
             return new RowAggregation<TState> { Seed = aggregation.Seed, Accumulate = accumulate, Combine = aggregation.Combine };
         }
 
         private static async Task<TState> SequentialAsync<TState>(
-            CsvReader reader, bool ownsReader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
+            CsvReader reader, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory, int headerRow, CancellationToken ct)
         {
-            try
+            CsvReader.Enumerator rows = reader.OpenSheet(ct);
+            await using (rows.ConfigureAwait(false))
             {
-                CsvReader.Enumerator rows = reader.OpenSheet(ct);
-                await using (rows.ConfigureAwait(false))
+                TState state = aggregation.Seed();
+                if (factory is not null && headerRow == 0)
                 {
-                    TState state = aggregation.Seed();
-                    if (factory is not null && headerRow == 0)
+                    aggregation = WithAccumulate(aggregation, factory(default, sequential: true));
+                }
+                for (int skipped = 0; skipped < headerRow; skipped++)
+                {
+                    if (!await rows.MoveNextAsync().ConfigureAwait(false))
                     {
-                        aggregation = WithAccumulate(aggregation, factory(default, sequential: true));
+                        return state;
                     }
-                    for (int skipped = 0; skipped < headerRow; skipped++)
+                    if (factory is not null && skipped == headerRow - 1)
                     {
-                        if (!await rows.MoveNextAsync().ConfigureAwait(false))
-                        {
-                            return state;
-                        }
-                        if (factory is not null && skipped == headerRow - 1)
-                        {
-                            aggregation = WithAccumulate(aggregation, factory(rows.Current, sequential: true));
-                        }
-                    }
-                    long delivered = 0;
-                    while (await rows.MoveNextAsync().ConfigureAwait(false))
-                    {
-                        if (++delivered % RowsPerCancellationCheck == 0)
-                        {
-                            ct.ThrowIfCancellationRequested();
-                        }
-                        Deliver(aggregation.Accumulate, ref state, rows);
+                        aggregation = WithAccumulate(aggregation, factory(rows.Current, sequential: true));
                     }
-                    return state;
                 }
-            }
-            finally
-            {
-                if (ownsReader)
+                long delivered = 0;
+                while (await rows.MoveNextAsync().ConfigureAwait(false))
                 {
-                    await reader.DisposeAsync().ConfigureAwait(false);
+                    if (++delivered % RowsPerCancellationCheck == 0)
+                    {
+                        ct.ThrowIfCancellationRequested();
+                    }
+                    Deliver(aggregation.Accumulate, ref state, rows);
                 }
+                return state;
             }
         }
 
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 848ebba8..a175e6ab 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -128,15 +128,6 @@ ExcelReader.Core.Reader.Csv.CsvDialect.HasByteOrderMark.get -> bool
 ExcelReader.Core.Reader.Csv.CsvDialect.HasByteOrderMark.init -> void
 ExcelReader.Core.Reader.Csv.CsvDialect.Quote.get -> byte
 ExcelReader.Core.Reader.Csv.CsvDialect.Quote.init -> void
-ExcelReader.Core.Reader.Csv.CsvParallel
-ExcelReader.Core.Reader.Csv.CsvParallelOptions
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.CsvParallelOptions() -> void
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.DegreeOfParallelism.get -> int
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.DegreeOfParallelism.init -> void
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.HeaderRow.get -> int
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.HeaderRow.init -> void
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.Reader.get -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
-ExcelReader.Core.Reader.Csv.CsvParallelOptions.Reader.init -> void
 ExcelReader.Core.Reader.Csv.CsvReader
 ExcelReader.Core.Reader.Csv.CsvReader.Dispose() -> void
 ExcelReader.Core.Reader.Csv.CsvReader.DisposeAsync() -> System.Threading.Tasks.ValueTask
@@ -693,25 +684,6 @@ static ExcelReader.Core.Parser.ExcelRowContext.operator ==(ExcelReader.Core.Pars
 static ExcelReader.Core.Reader.Csv.CsvDialect.Default.get -> ExcelReader.Core.Reader.Csv.CsvDialect
 static ExcelReader.Core.Reader.Csv.CsvDialect.operator !=(ExcelReader.Core.Reader.Csv.CsvDialect left, ExcelReader.Core.Reader.Csv.CsvDialect right) -> bool
 static ExcelReader.Core.Reader.Csv.CsvDialect.operator ==(ExcelReader.Core.Reader.Csv.CsvDialect left, ExcelReader.Core.Reader.Csv.CsvDialect right) -> bool
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TModel>(System.IO.Stream! stream, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TModel>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TModel>(string! path, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(System.IO.Stream! stream, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TAccumulator, TRecord>(string! path, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TAccumulator>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.IO.Stream! stream, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.AggregateAsync<TState>(string! path, ExcelReader.Core.Reader.RowAggregation<TState>! aggregation, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task<TState>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(System.IO.Stream! stream, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TModel>(string! path, ExcelReader.Core.Parser.ExcelParser<TModel>! parser, System.Action<TModel>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TRecord>(System.IO.Stream! stream, System.Action<TRecord>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TRecord>(System.ReadOnlyMemory<byte> data, System.Action<TRecord>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ForEachAsync<TRecord>(string! path, System.Action<TRecord>! body, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ParseAsync<T>(System.IO.Stream! stream, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ParseAsync<T>(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
-static ExcelReader.Core.Reader.Csv.CsvParallel.ParseAsync<T>(string! path, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.Csv.CsvParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
-static ExcelReader.Core.Reader.Csv.CsvParallelOptions.Default.get -> ExcelReader.Core.Reader.Csv.CsvParallelOptions!
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.Default.get -> ExcelReader.Core.Reader.Csv.CsvReaderOptions!
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.operator !=(ExcelReader.Core.Reader.Csv.CsvReaderOptions? left, ExcelReader.Core.Reader.Csv.CsvReaderOptions? right) -> bool
 static ExcelReader.Core.Reader.Csv.CsvReaderOptions.operator ==(ExcelReader.Core.Reader.Csv.CsvReaderOptions? left, ExcelReader.Core.Reader.Csv.CsvReaderOptions? right) -> bool
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs b/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
deleted file mode 100644
index a19b0445..00000000
--- a/src/ExcelReader.Core/Reader/Csv/CsvParallel.cs
+++ /dev/null
@@ -1,605 +0,0 @@
-using ExcelReader.Core.Parser;
-using ExcelReader.Core.Parser.ParallelCsv;
-
-namespace ExcelReader.Core.Reader.Csv
-{
-    /// <summary>
-    /// Reads CSV across several threads: <see cref="ParseAsync{T}(string, ExcelParser{T}, CsvParallelOptions?, CancellationToken)"/>
-    /// yields typed rows in source order, <c>ForEachAsync</c> hands each record to a callback on the worker
-    /// threads, and <c>AggregateAsync</c> folds records into one accumulator per partition.
-    /// </summary>
-    public static class CsvParallel
-    {
-        /// <summary>
-        /// Parses a CSV file into <typeparamref name="T"/> instances across several threads, yielding the
-        /// same sequence, in the same order, that the sequential <see cref="ExcelParser{T}"/> produces.
-        /// </summary>
-        /// <typeparam name="T">The row model type to bind each CSV record to.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> locates the header.</param>
-        /// <param name="options">Parallelism and dialect options. Defaults to <see cref="CsvParallelOptions.Default"/>. <see cref="CsvParallelOptions.HeaderRow"/> does not apply here and must be left at <c>0</c>.</param>
-        /// <param name="ct">A token to cancel enumeration.</param>
-        /// <remarks>
-        /// <para>
-        /// Parsing and type conversion run in parallel; whatever the caller does per row does not. A caller
-        /// whose per-row work dominates will see little gain from raising <see cref="CsvParallelOptions.DegreeOfParallelism"/>.
-        /// </para>
-        /// <para>
-        /// Falls back to sequential parsing — same results, one thread — when the source is too small to
-        /// partition usefully, or when <see cref="CsvReaderOptions.Encoding"/> is set to a non-UTF-8 encoding,
-        /// which must be transcoded sequentially.
-        /// </para>
-        /// <para>
-        /// <see cref="CsvReaderOptions.InternStrings"/> yields substantially less here than on the sequential
-        /// path: each partition keeps its own dedup cache, so hit rates fall and memory multiplies. Results
-        /// are unaffected.
-        /// </para>
-        /// <para>
-        /// Each row is yielded exactly once. A partition read from a wrongly guessed start is discarded before
-        /// any of its rows are yielded, but its cells have already passed through the parser's converters and
-        /// property setters, which must therefore be free of side effects.
-        /// </para>
-        /// </remarks>
-        public static IAsyncEnumerable<T> ParseAsync<T>(
-            string path,
-            ExcelParser<T> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            ArgumentNullException.ThrowIfNull(parser);
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            CsvParallelOptions parallel = ValidatedForTypedParse(options);
-            return ParallelCsvFactory.Create(path, parallel.DegreeOfParallelism, parallel.Reader, parser, ct);
-        }
-
-        /// <summary>
-        /// Parses an in-memory CSV buffer into <typeparamref name="T"/> instances across several threads,
-        /// yielding the same sequence, in the same order, that the sequential <see cref="ExcelParser{T}"/> produces.
-        /// </summary>
-        /// <typeparam name="T">The row model type to bind each CSV record to.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during enumeration.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> locates the header.</param>
-        /// <param name="options">Parallelism and dialect options. Defaults to <see cref="CsvParallelOptions.Default"/>. <see cref="CsvParallelOptions.HeaderRow"/> does not apply here and must be left at <c>0</c>.</param>
-        /// <param name="ct">A token to cancel enumeration.</param>
-        /// <remarks>Carries the same fallback, <see cref="CsvReaderOptions.InternStrings"/> and exactly-once caveats as the path-based overload.</remarks>
-        public static IAsyncEnumerable<T> ParseAsync<T>(
-            ReadOnlyMemory<byte> data,
-            ExcelParser<T> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            ArgumentNullException.ThrowIfNull(parser);
-            CsvParallelOptions parallel = ValidatedForTypedParse(options);
-            return ParallelCsvFactory.Create(data, parallel.DegreeOfParallelism, parallel.Reader, parser, ct);
-        }
-
-        /// <summary>
-        /// Parses a CSV stream into <typeparamref name="T"/> instances, in parallel where the stream can be
-        /// partitioned, yielding the same sequence, in the same order, that the sequential
-        /// <see cref="ExcelParser{T}"/> produces.
-        /// </summary>
-        /// <typeparam name="T">The row model type to bind each CSV record to.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> locates the header.</param>
-        /// <param name="options">Parallelism and dialect options. Defaults to <see cref="CsvParallelOptions.Default"/>. <see cref="CsvParallelOptions.HeaderRow"/> does not apply here and must be left at <c>0</c>.</param>
-        /// <param name="ct">A token to cancel enumeration.</param>
-        /// <remarks>
-        /// <para>
-        /// Only a <see cref="FileStream"/>, or a <see cref="MemoryStream"/> whose buffer is publicly
-        /// visible, can be partitioned; every other stream — including seekable ones — parses sequentially,
-        /// with identical results. A stream exposes a single mutable position, and a seek can be
-        /// arbitrarily expensive, so this overload partitions only what it can read positionally and
-        /// cheaply rather than promising parallelism it cannot deliver.
-        /// </para>
-        /// <para>
-        /// Passing a <see cref="FileStream"/> reads its <see cref="FileStream.SafeFileHandle"/>, which
-        /// flushes that stream's internal buffer and disables its subsequent buffering optimizations. The
-        /// stream's position is not moved. Prefer the path-based overload where a path is available.
-        /// </para>
-        /// <para>Carries the same <see cref="CsvReaderOptions.InternStrings"/> and exactly-once caveats as the other overloads.</para>
-        /// </remarks>
-        public static IAsyncEnumerable<T> ParseAsync<T>(
-            Stream stream,
-            ExcelParser<T> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            ArgumentNullException.ThrowIfNull(parser);
-            ArgumentNullException.ThrowIfNull(stream);
-            CsvParallelOptions parallel = ValidatedForTypedParse(options);
-            return ParallelCsvFactory.Create(stream, parallel.DegreeOfParallelism, parallel.Reader, parser, ct);
-        }
-
-        /// <summary>
-        /// Reads an in-memory CSV buffer across several threads, parses every record into a
-        /// <typeparamref name="TRecord"/> and folds it into a <typeparamref name="TAccumulator"/>, one
-        /// instance per partition, merged in buffer order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <remarks>
-        /// <para>
-        /// Partitions start at guessed record boundaries; one whose guess landed inside a quoted field
-        /// spanning lines is read again into a new accumulator. The result holds every record exactly once,
-        /// but <see cref="IRowRecord{TSelf}.TryParse"/> and <see cref="IRowAccumulator{TSelf, TModel}.Add"/>
-        /// may already have run for the discarded pass's records, as <see cref="IRowAccumulator{TSelf, TModel}"/> describes.
-        /// </para>
-        /// <para>
-        /// Falls back to one sequential pass, with a single accumulator and no call to
-        /// <see cref="IRowAccumulator{TSelf, TModel}.Merge"/>, when the source is too small to partition usefully
-        /// or when <see cref="CsvReaderOptions.Encoding"/> is set to a non-UTF-8 encoding.
-        /// </para>
-        /// </remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
-            ReadOnlyMemory<byte> data,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            return ParallelCsvProcessor.RunAsync(data, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV file across several threads, parses every record into a <typeparamref name="TRecord"/>
-        /// and folds it into a <typeparamref name="TAccumulator"/>, one instance per partition, merged in file order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <remarks>Carries the same contract and fallbacks as the in-memory overload.</remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
-            string path,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            return ParallelCsvProcessor.RunAsync(path, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV stream, in parallel where the stream can be partitioned, parses every record into a
-        /// <typeparamref name="TRecord"/> and folds it into a <typeparamref name="TAccumulator"/>, one instance
-        /// per partition, merged in stream order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <remarks>
-        /// Carries the same contract and fallbacks as the in-memory overload, and partitions only a
-        /// <see cref="FileStream"/> or a <see cref="MemoryStream"/> whose buffer is publicly visible;
-        /// every other stream is read sequentially.
-        /// </remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
-            Stream stream,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TRecord>, new()
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(stream);
-            return ParallelCsvProcessor.RunAsync(stream, RecordAggregation<TAccumulator, TRecord>.Instance, null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV file across several threads, parses every record into a <typeparamref name="TRecord"/>
-        /// and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <remarks>
-        /// <para>
-        /// <paramref name="body"/> runs concurrently on worker threads and must be safe to call from
-        /// several at once; the caller owns any synchronization. Records arrive in no particular order.
-        /// </para>
-        /// <para>
-        /// Delivery is at least once, not exactly once: <paramref name="body"/> may be invoked more than once
-        /// for the same record. A partition whose start was guessed wrongly is read again from the confirmed
-        /// offset, and the discarded speculative pass may already have delivered a whole partition's worth of
-        /// records — 1 MiB to 64 MiB of them, not just a few near the seam. Those records may also be misparsed:
-        /// a wrong start shifts every field boundary, so a quoted field holding a delimiter can split into values
-        /// that appear nowhere in the source. An exception <paramref name="body"/> throws during a discarded
-        /// pass is discarded with it.
-        /// </para>
-        /// <para>
-        /// A <paramref name="body"/> with side effects must therefore be idempotent, and must also tolerate
-        /// records that do not exist; deduplicating on a key does not filter those out. A start is only guessed
-        /// wrongly when it falls inside a quoted field, so a source in which the quote character never appears
-        /// delivers every record exactly once. For that guarantee on any source, use
-        /// <see cref="AggregateAsync{TAccumulator, TRecord}(string, CsvParallelOptions?, CancellationToken)"/>,
-        /// where the discarded partition's accumulator is thrown away, and apply the side effects once it returns.
-        /// </para>
-        /// <para>
-        /// A <see cref="ReadOnlySpan{T}"/> column points into a pooled buffer the worker reuses once
-        /// <paramref name="body"/> returns. Copy anything that must outlive the call.
-        /// </para>
-        /// <para>
-        /// Falls back to one sequential pass, delivering records once each in source order on a single
-        /// thread, when the source is too small to partition usefully or when
-        /// <see cref="CsvReaderOptions.Encoding"/> is set to a non-UTF-8 encoding.
-        /// </para>
-        /// </remarks>
-        public static Task ForEachAsync<TRecord>(
-            string path,
-            Action<TRecord> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            ArgumentNullException.ThrowIfNull(body);
-            return ParallelCsvProcessor.RunAsync(path, RecordCallback<TRecord>.For(body), null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads an in-memory CSV buffer across several threads, parses every record into a
-        /// <typeparamref name="TRecord"/> and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <remarks>Carries the same contract and fallbacks as the path-based overload.</remarks>
-        public static Task ForEachAsync<TRecord>(
-            ReadOnlyMemory<byte> data,
-            Action<TRecord> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(body);
-            return ParallelCsvProcessor.RunAsync(data, RecordCallback<TRecord>.For(body), null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV stream, in parallel where the stream can be partitioned, parses every record into a
-        /// <typeparamref name="TRecord"/> and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TRecord">The record type. A record whose <see cref="IRowRecord{TSelf}.TryParse"/> returns <see langword="false"/> is skipped.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="stream"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <remarks>
-        /// Carries the same contract and fallbacks as the path-based overload, and partitions only a
-        /// <see cref="FileStream"/> or a <see cref="MemoryStream"/> whose buffer is publicly visible;
-        /// every other stream is read sequentially.
-        /// </remarks>
-        public static Task ForEachAsync<TRecord>(
-            Stream stream,
-            Action<TRecord> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TRecord : IRowRecord<TRecord>, allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(stream);
-            ArgumentNullException.ThrowIfNull(body);
-            return ParallelCsvProcessor.RunAsync(stream, RecordCallback<TRecord>.For(body), null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV file across several threads, binds every record to a <typeparamref name="TModel"/>
-        /// through <paramref name="parser"/> and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TModel">The model type. May be a <see langword="ref struct"/> with <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> properties.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="parser"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>
-        /// <para>
-        /// Carries the same concurrency, repeat-invocation and span-lifetime contract as the
-        /// <see cref="IRowRecord{TSelf}"/> overloads. A property that fails to parse keeps its default
-        /// unless <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing
-        /// <c>[ExcelRequired]</c> column or value throws <see cref="ExcelParseException"/>; empty
-        /// records are skipped.
-        /// </para>
-        /// <para>
-        /// <see cref="ExcelParseException.Row"/> is exact when the source is read sequentially and
-        /// 0 when it is partitioned, since a partition does not know how many records precede it.
-        /// </para>
-        /// </remarks>
-        public static Task ForEachAsync<TModel>(
-            string path,
-            ExcelParser<TModel> parser,
-            Action<TModel> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TModel : allows ref struct
-        {
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(path, MappedCallback<TModel>.Unbound, BoundCallback(parser, body, validated), validated, ct);
-        }
-
-        /// <summary>
-        /// Reads an in-memory CSV buffer across several threads, binds every record to a
-        /// <typeparamref name="TModel"/> through <paramref name="parser"/> and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TModel">The model type. May be a <see langword="ref struct"/> with <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> properties.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="parser"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>Carries the same contract and fallbacks as the path-based overload.</remarks>
-        public static Task ForEachAsync<TModel>(
-            ReadOnlyMemory<byte> data,
-            ExcelParser<TModel> parser,
-            Action<TModel> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TModel : allows ref struct
-        {
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(data, MappedCallback<TModel>.Unbound, BoundCallback(parser, body, validated), validated, ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV stream, in parallel where the stream can be partitioned, binds every record to a
-        /// <typeparamref name="TModel"/> through <paramref name="parser"/> and hands it to <paramref name="body"/>.
-        /// </summary>
-        /// <typeparam name="TModel">The model type. May be a <see langword="ref struct"/> with <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> properties.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>A task that completes when every record has been delivered.</returns>
-        /// <exception cref="ArgumentNullException"><paramref name="stream"/>, <paramref name="parser"/> or <paramref name="body"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>
-        /// Carries the same contract and fallbacks as the path-based overload, and the stream restrictions
-        /// of the <see cref="IRowRecord{TSelf}"/> stream overload.
-        /// </remarks>
-        public static Task ForEachAsync<TModel>(
-            Stream stream,
-            ExcelParser<TModel> parser,
-            Action<TModel> body,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TModel : allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(stream);
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(stream, MappedCallback<TModel>.Unbound, BoundCallback(parser, body, validated), validated, ct);
-        }
-
-        /// <summary>
-        /// Reads an in-memory CSV buffer across several threads, binds every record to a
-        /// <typeparamref name="TModel"/> through <paramref name="parser"/> and folds it into a
-        /// <typeparamref name="TAccumulator"/>, one instance per partition, merged in buffer order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TModel">The model type.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>
-        /// <para>
-        /// The header is bound once, before any record is folded. A property that fails to parse keeps its
-        /// default unless <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing
-        /// <c>[ExcelRequired]</c> column or value throws <see cref="ExcelParseException"/>; empty records are skipped.
-        /// </para>
-        /// <para>
-        /// <see cref="ExcelParseException.Row"/> is exact when the source is read sequentially and 0 when it is
-        /// partitioned, since a partition does not know how many records precede it.
-        /// </para>
-        /// <para>Otherwise carries the same contract and fallbacks as the <see cref="IRowRecord{TSelf}"/> overloads.</para>
-        /// </remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
-            ReadOnlyMemory<byte> data,
-            ExcelParser<TModel> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
-            where TModel : allows ref struct
-        {
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(data, MappedAggregation<TAccumulator, TModel>.Unbound, Bound<TAccumulator, TModel>(parser, validated), validated, ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV file across several threads, binds every record to a <typeparamref name="TModel"/>
-        /// through <paramref name="parser"/> and folds it into a <typeparamref name="TAccumulator"/>, one instance
-        /// per partition, merged in file order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TModel">The model type.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>Carries the same contract and fallbacks as the in-memory overload.</remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
-            string path,
-            ExcelParser<TModel> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
-            where TModel : allows ref struct
-        {
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(path, MappedAggregation<TAccumulator, TModel>.Unbound, Bound<TAccumulator, TModel>(parser, validated), validated, ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV stream, in parallel where the stream can be partitioned, binds every record to a
-        /// <typeparamref name="TModel"/> through <paramref name="parser"/> and folds it into a
-        /// <typeparamref name="TAccumulator"/>, one instance per partition, merged in stream order.
-        /// </summary>
-        /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
-        /// <typeparam name="TModel">The model type.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="CsvParallelOptions.HeaderRow"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The accumulator holding every record.</returns>
-        /// <exception cref="ArgumentException"><paramref name="parser"/> binds columns by header name and <see cref="CsvParallelOptions.HeaderRow"/> is 0.</exception>
-        /// <remarks>Carries the same contract and fallbacks as the in-memory overload, and the stream restrictions of the <see cref="IRowRecord{TSelf}"/> stream overload.</remarks>
-        public static Task<TAccumulator> AggregateAsync<TAccumulator, TModel>(
-            Stream stream,
-            ExcelParser<TModel> parser,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
-            where TModel : allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(stream);
-            CsvParallelOptions validated = Validated(options);
-            return ParallelCsvProcessor.RunAsync(stream, MappedAggregation<TAccumulator, TModel>.Unbound, Bound<TAccumulator, TModel>(parser, validated), validated, ct);
-        }
-
-        private static RowActionFactory<TAccumulator> Bound<TAccumulator, TModel>(ExcelParser<TModel> parser, CsvParallelOptions options)
-            where TAccumulator : IRowAccumulator<TAccumulator, TModel>, new()
-            where TModel : allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(parser);
-            if (options.HeaderRow == 0 && !parser.CsvInfo.IsIndexBased)
-            {
-                throw new ArgumentException("A parser that binds columns by header name needs CsvParallelOptions.HeaderRow of at least 1.", nameof(parser));
-            }
-            return MappedAggregation<TAccumulator, TModel>.Binder(parser, parser.CsvInfo, false, options.HeaderRow);
-        }
-
-        private static RowActionFactory<byte> BoundCallback<TModel>(
-            ExcelParser<TModel> parser, Action<TModel> body, CsvParallelOptions options)
-            where TModel : allows ref struct
-        {
-            ArgumentNullException.ThrowIfNull(parser);
-            ArgumentNullException.ThrowIfNull(body);
-            if (options.HeaderRow == 0 && !parser.CsvInfo.IsIndexBased)
-            {
-                throw new ArgumentException("A parser that binds columns by header name needs CsvParallelOptions.HeaderRow of at least 1.", nameof(parser));
-            }
-            return MappedCallback<TModel>.Binder(parser, parser.CsvInfo, false, options.HeaderRow, body);
-        }
-
-        /// <summary>
-        /// Reads an in-memory CSV buffer across several threads and folds every record with the functions of
-        /// <paramref name="aggregation"/>, one accumulator per partition, combined in buffer order.
-        /// </summary>
-        /// <typeparam name="TState">The accumulator type.</typeparam>
-        /// <param name="data">The CSV bytes. The caller keeps ownership; the buffer must not be mutated during processing.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks as the <see cref="IRowAccumulator{TSelf, TModel}"/> overloads.</remarks>
-        public static Task<TState> AggregateAsync<TState>(
-            ReadOnlyMemory<byte> data,
-            RowAggregation<TState> aggregation,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            return ParallelCsvProcessor.RunAsync(data, Validated(aggregation), null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV file across several threads and folds every record with the functions of
-        /// <paramref name="aggregation"/>, one accumulator per partition, combined in file order.
-        /// </summary>
-        /// <typeparam name="TState">The accumulator type.</typeparam>
-        /// <param name="path">The path of the CSV file to read.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks as the <see cref="IRowAccumulator{TSelf, TModel}"/> overloads.</remarks>
-        public static Task<TState> AggregateAsync<TState>(
-            string path,
-            RowAggregation<TState> aggregation,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            ArgumentException.ThrowIfNullOrEmpty(path);
-            return ParallelCsvProcessor.RunAsync(path, Validated(aggregation), null, Validated(options), ct);
-        }
-
-        /// <summary>
-        /// Reads a CSV stream, in parallel where the stream can be partitioned, and folds every record with the
-        /// functions of <paramref name="aggregation"/>, one accumulator per partition, combined in stream order.
-        /// </summary>
-        /// <typeparam name="TState">The accumulator type.</typeparam>
-        /// <param name="stream">The CSV stream, read from its current position. The caller keeps ownership and must not read from it concurrently.</param>
-        /// <param name="aggregation">The seed, accumulate and combine functions. They carry the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>.</param>
-        /// <param name="options">Parallelism, dialect and header options. Defaults to <see cref="CsvParallelOptions.Default"/>.</param>
-        /// <param name="ct">A token to cancel processing.</param>
-        /// <returns>The combined accumulator.</returns>
-        /// <remarks>Carries the same fallbacks and stream restrictions as the <see cref="IRowAccumulator{TSelf, TModel}"/> stream overload.</remarks>
-        public static Task<TState> AggregateAsync<TState>(
-            Stream stream,
-            RowAggregation<TState> aggregation,
-            CsvParallelOptions? options = null,
-            CancellationToken ct = default)
-        {
-            ArgumentNullException.ThrowIfNull(stream);
-            return ParallelCsvProcessor.RunAsync(stream, Validated(aggregation), null, Validated(options), ct);
-        }
-
-        private static RowAggregation<TState> Validated<TState>(RowAggregation<TState> aggregation)
-        {
-            ArgumentNullException.ThrowIfNull(aggregation);
-            ArgumentNullException.ThrowIfNull(aggregation.Seed, nameof(aggregation));
-            ArgumentNullException.ThrowIfNull(aggregation.Accumulate, nameof(aggregation));
-            ArgumentNullException.ThrowIfNull(aggregation.Combine, nameof(aggregation));
-            return aggregation;
-        }
-
-        private static CsvParallelOptions Validated(CsvParallelOptions? options)
-        {
-            options ??= CsvParallelOptions.Default;
-            ArgumentOutOfRangeException.ThrowIfNegative(options.DegreeOfParallelism, nameof(options));
-            ArgumentOutOfRangeException.ThrowIfNegative(options.HeaderRow, nameof(options));
-            ArgumentNullException.ThrowIfNull(options.Reader, nameof(options));
-            return options;
-        }
-
-        private static CsvParallelOptions ValidatedForTypedParse(CsvParallelOptions? options)
-        {
-            CsvParallelOptions validated = Validated(options);
-            if (validated.HeaderRow != 0)
-            {
-                throw new ArgumentException(
-                    $"{nameof(CsvParallelOptions)}.{nameof(CsvParallelOptions.HeaderRow)} does not apply to typed parsing; set {nameof(ExcelParserConfig)}.{nameof(ExcelParserConfig.HeaderRow)} instead.",
-                    nameof(options));
-            }
-            return validated;
-        }
-    }
-}
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvParallelOptions.cs b/src/ExcelReader.Core/Reader/Csv/CsvParallelOptions.cs
deleted file mode 100644
index 62a43107..00000000
--- a/src/ExcelReader.Core/Reader/Csv/CsvParallelOptions.cs
+++ /dev/null
@@ -1,21 +0,0 @@
-namespace ExcelReader.Core.Reader.Csv
-{
-    /// <summary>Options for reading a CSV source across several threads.</summary>
-    public sealed class CsvParallelOptions
-    {
-        /// <summary>Gets the default options: one thread per processor, the default dialect, no header.</summary>
-        public static CsvParallelOptions Default { get; } = new();
-
-        /// <summary>Gets the maximum number of reading threads. <c>0</c>, the default, means <see cref="Environment.ProcessorCount"/>; <c>1</c> reads sequentially.</summary>
-        public int DegreeOfParallelism { get; init; }
-
-        /// <summary>Gets the CSV dialect options. Defaults to <see cref="CsvReaderOptions.Default"/>.</summary>
-        public CsvReaderOptions Reader { get; init; } = CsvReaderOptions.Default;
-
-        /// <summary>
-        /// Gets the 1-based number of the header record; it and every record before it are skipped.
-        /// <c>0</c>, the default, means the source has no header.
-        /// </summary>
-        public int HeaderRow { get; init; }
-    }
-}
diff --git a/src/ExcelReader.Core/Reader/IRowAccumulator.cs b/src/ExcelReader.Core/Reader/IRowAccumulator.cs
index ea0bcfdf..ec30d5b2 100644
--- a/src/ExcelReader.Core/Reader/IRowAccumulator.cs
+++ b/src/ExcelReader.Core/Reader/IRowAccumulator.cs
@@ -1,35 +1,34 @@
-using ExcelReader.Core.Reader.Csv;
-
 namespace ExcelReader.Core.Reader
 {
     /// <summary>
-    /// Folds typed CSV records read by <c>CsvParallel.AggregateAsync</c> into a result. Each partition
-    /// of the source gets its own instance.
+    /// Folds typed rows read by <c>SheetParallel.AggregateAsync</c> into a result. Each partition
+    /// of the sheet gets its own instance.
     /// </summary>
     /// <typeparam name="TSelf">The implementing type.</typeparam>
     /// <typeparam name="TModel">The record type, produced by <see cref="IRowRecord{TSelf}.TryParse"/> or by an <see cref="Parser.ExcelParser{T}"/>.</typeparam>
     /// <remarks>
     /// <para>
     /// <see cref="Add"/> runs concurrently across instances on worker threads, and must mutate only the
-    /// instance it is called on. A partition that started at a misguessed record boundary is read again
-    /// into a new instance and the first one is discarded, so an instance may see records that are later
-    /// thrown away — including records whose parse or <see cref="Add"/> threw, and records misparsed from
-    /// the wrong start that appear nowhere in the source. A side effect outside the instance is not undone.
+    /// instance it is called on. For CSV, a partition that started at a misguessed row boundary is read again
+    /// into a new instance and the first one is discarded, so an instance may see rows that are later
+    /// thrown away — including rows whose parse or <see cref="Add"/> threw, and rows misparsed from
+    /// the wrong start that appear nowhere in the sheet. A side effect outside the instance is not undone.
+    /// XLSX and XLSB never re-read a partition.
     /// </para>
     /// <para>
-    /// <see cref="Merge"/> runs on a single thread, left to right in source order, folding each later
-    /// partition into the accumulator of everything before it. It may receive an instance that saw no records.
+    /// <see cref="Merge"/> runs on a single thread, left to right in sheet order, folding each later
+    /// partition into the accumulator of everything before it. It may receive an instance that saw no rows.
     /// </para>
     /// </remarks>
     public interface IRowAccumulator<TSelf, TModel>
         where TSelf : IRowAccumulator<TSelf, TModel>
         where TModel : allows ref struct
     {
-        /// <summary>Folds one record into this instance.</summary>
-        /// <param name="model">The record. Spans it holds are valid only for the duration of the call.</param>
+        /// <summary>Folds one row into this instance.</summary>
+        /// <param name="model">The row. Spans it holds are valid only for the duration of the call.</param>
         void Add(TModel model);
 
-        /// <summary>Folds the records of the partition that immediately follows this one into this instance.</summary>
+        /// <summary>Folds the rows of the partition that immediately follows this one into this instance.</summary>
         /// <param name="following">The accumulator of the following partition. It is not used again afterwards.</param>
         void Merge(TSelf following);
     }
diff --git a/src/ExcelReader.Core/Reader/IRowRecord.cs b/src/ExcelReader.Core/Reader/IRowRecord.cs
index 0706fdb3..9f637ba9 100644
--- a/src/ExcelReader.Core/Reader/IRowRecord.cs
+++ b/src/ExcelReader.Core/Reader/IRowRecord.cs
@@ -1,19 +1,17 @@
-using ExcelReader.Core.Reader.Csv;
-
 namespace ExcelReader.Core.Reader
 {
     /// <summary>
-    /// A typed CSV record that parses itself from a <see cref="Row"/>, for
-    /// <see cref="CsvParallel.AggregateAsync{TAccumulator, TRecord}(ReadOnlyMemory{byte}, CsvParallelOptions?, CancellationToken)"/>.
+    /// A typed row that parses itself from a <see cref="Row"/>, for
+    /// <see cref="SheetParallel.AggregateAsync{TAccumulator, TRecord}(IExcelSheet, SheetParallelOptions?, CancellationToken)"/>.
     /// </summary>
     /// <typeparam name="TSelf">The implementing type. May be a <see langword="ref struct"/> holding spans taken from the row.</typeparam>
     public interface IRowRecord<TSelf>
         where TSelf : IRowRecord<TSelf>, allows ref struct
     {
-        /// <summary>Parses one record.</summary>
-        /// <param name="row">The record. Spans taken from it stay valid only until the accumulator's <c>Add</c> returns.</param>
-        /// <param name="record">The parsed record.</param>
-        /// <returns><see langword="false"/> to skip the record.</returns>
+        /// <summary>Parses one row.</summary>
+        /// <param name="row">The row. Spans taken from it stay valid only until the accumulator's <c>Add</c> returns.</param>
+        /// <param name="record">The parsed row.</param>
+        /// <returns><see langword="false"/> to skip the row.</returns>
         static abstract bool TryParse(Row row, out TSelf record);
     }
 }
diff --git a/src/ExcelReader.Core/Reader/RowAction.cs b/src/ExcelReader.Core/Reader/RowAction.cs
index 4557fa70..ae8a6698 100644
--- a/src/ExcelReader.Core/Reader/RowAction.cs
+++ b/src/ExcelReader.Core/Reader/RowAction.cs
@@ -1,10 +1,8 @@
-using ExcelReader.Core.Reader.Csv;
-
 namespace ExcelReader.Core.Reader
 {
-    /// <summary>Processes one CSV record into the state owned by the partition that read it.</summary>
+    /// <summary>Processes one row into the state owned by the partition that read it.</summary>
     /// <typeparam name="TState">The per-partition accumulator type.</typeparam>
-    /// <param name="state">The accumulator of the partition the record belongs to. Mutate only this.</param>
-    /// <param name="row">The record. Valid only for the duration of the call.</param>
+    /// <param name="state">The accumulator of the partition the row belongs to. Mutate only this.</param>
+    /// <param name="row">The row. Valid only for the duration of the call.</param>
     public delegate void RowAction<TState>(ref TState state, Row row);
 }
diff --git a/src/ExcelReader.Core/Reader/RowAggregation.cs b/src/ExcelReader.Core/Reader/RowAggregation.cs
index b23e0e18..c09269db 100644
--- a/src/ExcelReader.Core/Reader/RowAggregation.cs
+++ b/src/ExcelReader.Core/Reader/RowAggregation.cs
@@ -1,22 +1,20 @@
-using ExcelReader.Core.Reader.Csv;
-
 namespace ExcelReader.Core.Reader
 {
     /// <summary>
-    /// A fold over CSV records expressed as three functions, for
-    /// <see cref="CsvParallel.AggregateAsync{TState}(ReadOnlyMemory{byte}, RowAggregation{TState}, CsvParallelOptions?, CancellationToken)"/>.
+    /// A fold over rows expressed as three functions, for
+    /// <see cref="SheetParallel.AggregateAsync{TState}(IExcelSheet, RowAggregation{TState}, SheetParallelOptions?, CancellationToken)"/>.
     /// Carries the same contract as <see cref="IRowAccumulator{TSelf, TModel}"/>, without requiring a type.
     /// </summary>
-    /// <typeparam name="TState">The accumulator type. Each partition of the source owns one instance.</typeparam>
+    /// <typeparam name="TState">The accumulator type. Each partition of the sheet owns one instance.</typeparam>
     public sealed class RowAggregation<TState>
     {
         /// <summary>Gets the function that creates an empty accumulator. Called once per partition, possibly more.</summary>
         public required Func<TState> Seed { get; init; }
 
-        /// <summary>Gets the function that folds one record into its partition's accumulator. Runs concurrently on worker threads and must mutate only the accumulator it is given.</summary>
+        /// <summary>Gets the function that folds one row into its partition's accumulator. Runs concurrently on worker threads and must mutate only the accumulator it is given.</summary>
         public required RowAction<TState> Accumulate { get; init; }
 
-        /// <summary>Gets the function that folds the following partition's accumulator into the preceding one. Called on one thread, left to right in source order.</summary>
+        /// <summary>Gets the function that folds the following partition's accumulator into the preceding one. Called on one thread, left to right in sheet order.</summary>
         public required Func<TState, TState, TState> Combine { get; init; }
     }
 }
diff --git a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
index c3fc08f3..213e9a13 100644
--- a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
+++ b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
@@ -65,7 +65,7 @@ internal static int AggregateCsvFile(
         {
             NativeApi.ClearLastError();
             result = 0;
-            int status = NativeCsvAggregateOptions.Translate(rawOptions, out CsvParallelOptions options);
+            int status = NativeCsvAggregateOptions.Translate(rawOptions, out SheetParallelOptions options, out CsvReaderOptions reader);
             if (status != NativeStatus.Ok)
             {
                 return status;
@@ -73,10 +73,7 @@ internal static int AggregateCsvFile(
 
             string path = Encoding.UTF8.GetString(utf8Path);
             CsvAggregateContext context = new(aggregation);
-            return Run(
-                context,
-                Task.Run(() => CsvParallel.AggregateAsync(path, Build(context), options, CancellationToken.None)),
-                out result);
+            return Run(context, Task.Run(() => CsvAggregateFile.AggregateAsync(path, reader, Build(context), options)), out result);
         }
 
         internal static int AggregateCsvMemory(
@@ -85,18 +82,24 @@ internal static int AggregateCsvMemory(
         {
             NativeApi.ClearLastError();
             result = 0;
-            int status = NativeCsvAggregateOptions.Translate(rawOptions, out CsvParallelOptions options);
+            int status = NativeCsvAggregateOptions.Translate(rawOptions, out SheetParallelOptions options, out CsvReaderOptions reader);
             if (status != NativeStatus.Ok)
             {
                 return status;
             }
 
-            using PointerMemoryManager manager = new(data, dataLength);
-            CsvAggregateContext context = new(aggregation);
-            return Run(
-                context,
-                Task.Run(() => CsvParallel.AggregateAsync(manager.Memory, Build(context), options, CancellationToken.None)),
-                out result);
+            try
+            {
+                using PointerMemoryManager manager = new(data, dataLength);
+                CsvAggregateContext context = new(aggregation);
+                using CsvReader csv = Excel.FromCsv(manager.Memory, reader);
+                return Run(context, Task.Run(() => SheetParallel.AggregateAsync(csv.FirstSheet, Build(context), options, CancellationToken.None)), out result);
+            }
+            catch (Exception exception)
+            {
+                NativeApi.SetLastError(exception.Message);
+                return NativeStatus.Error;
+            }
         }
 
         private static RowAggregation<CsvAggregateState> Build(CsvAggregateContext context)
@@ -175,4 +178,17 @@ private static void Sweep(CsvAggregateContext context, CsvAggregateState? winner
             }
         }
     }
+
+    internal static class CsvAggregateFile
+    {
+        internal static async Task<CsvAggregateState> AggregateAsync(
+            string path, CsvReaderOptions reader, RowAggregation<CsvAggregateState> aggregation, SheetParallelOptions options)
+        {
+            CsvReader csv = await Excel.FromCsvFileAsync(path, reader, CancellationToken.None).ConfigureAwait(false);
+            await using (csv.ConfigureAwait(false))
+            {
+                return await SheetParallel.AggregateAsync(csv.FirstSheet, aggregation, options, CancellationToken.None).ConfigureAwait(false);
+            }
+        }
+    }
 }
diff --git a/src/ExcelReader.Native/Csv/NativeCsvAggregateOptions.cs b/src/ExcelReader.Native/Csv/NativeCsvAggregateOptions.cs
index 1d6a2667..8773fe62 100644
--- a/src/ExcelReader.Native/Csv/NativeCsvAggregateOptions.cs
+++ b/src/ExcelReader.Native/Csv/NativeCsvAggregateOptions.cs
@@ -1,4 +1,5 @@
 using System.Runtime.InteropServices;
+using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
 namespace ExcelReader.Native.Csv
@@ -30,9 +31,10 @@ internal static unsafe class NativeCsvAggregateOptions
     {
         private const string OptionsName = "csv_parallel_options";
 
-        internal static int Translate(NativeCsvParallelOptionsRaw? raw, out CsvParallelOptions options)
+        internal static int Translate(NativeCsvParallelOptionsRaw? raw, out SheetParallelOptions options, out CsvReaderOptions reader)
         {
-            options = CsvParallelOptions.Default;
+            options = SheetParallelOptions.Default;
+            reader = CsvReaderOptions.Default;
             if (raw is null)
             {
                 return NativeStatus.Ok;
@@ -69,7 +71,6 @@ internal static int Translate(NativeCsvParallelOptionsRaw? raw, out CsvParallelO
                 return NativeStatus.InvalidArgument;
             }
 
-            CsvReaderOptions reader = CsvReaderOptions.Default;
             if (delimiter is byte d)
             {
                 reader = reader with { Delimiter = d };
@@ -87,11 +88,10 @@ internal static int Translate(NativeCsvParallelOptionsRaw? raw, out CsvParallelO
                 reader = reader with { MaxCellBytes = value.MaxCellBytes };
             }
 
-            options = new CsvParallelOptions
+            options = new SheetParallelOptions
             {
                 DegreeOfParallelism = value.DegreeOfParallelism,
                 HeaderRow = value.HeaderRow,
-                Reader = reader,
             };
             return NativeStatus.Ok;
         }
diff --git a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
index cf84a0ca..64ac899b 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
@@ -63,9 +63,8 @@ private static int ParseCsvInParallel(NativeHandle handle, CsvChunkSource source
                     Accumulate = (ref PartitionTable state, Row row) => state.Append(row, columnIndices, isDate1904),
                     Combine = PartitionTable.Combine,
                 };
-                CsvParallelOptions options = new() { DegreeOfParallelism = degreeOfParallelism, HeaderRow = headerRow, Reader = reader };
                 PartitionTable merged = Task.Run(() => ParallelCsvProcessor.RunPartitionedAsync(
-                    source, aggregation, options, chunkSizeOverride, CancellationToken.None)).GetAwaiter().GetResult();
+                    source, aggregation, reader, headerRow, degreeOfParallelism, chunkSizeOverride, CancellationToken.None)).GetAwaiter().GetResult();
                 try
                 {
                     if (merged.FailedColumn >= 0)
diff --git a/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs b/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
index e0c20d3d..e2430e70 100644
--- a/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Parse/CsvParallelParseBenchmark.cs
@@ -66,7 +66,8 @@ public void Cleanup()
         public async Task<long> ConversionHeavy()
         {
             long n = 0;
-            await foreach (WideRow row in CsvParallel.ParseAsync(_wide, ExcelParser.FromAttributes<WideRow>(), new CsvParallelOptions { DegreeOfParallelism = Dop }))
+            using CsvReader csv = Excel.FromCsvFile(_wide);
+            await foreach (WideRow row in SheetParallel.ParseAsync(csv.FirstSheet, ExcelParser.FromAttributes<WideRow>(), new SheetParallelOptions { DegreeOfParallelism = Dop }))
             {
                 n += row.Units;
             }
@@ -77,7 +78,8 @@ public async Task<long> ConversionHeavy()
         public async Task<long> NarrowInt()
         {
             long n = 0;
-            await foreach (NarrowRow row in CsvParallel.ParseAsync(_narrow, ExcelParser.FromAttributes<NarrowRow>(), new CsvParallelOptions { DegreeOfParallelism = Dop }))
+            using CsvReader csv = Excel.FromCsvFile(_narrow);
+            await foreach (NarrowRow row in SheetParallel.ParseAsync(csv.FirstSheet, ExcelParser.FromAttributes<NarrowRow>(), new SheetParallelOptions { DegreeOfParallelism = Dop }))
             {
                 n += row.A;
             }
@@ -115,9 +117,10 @@ public void Merge(AggregationNarrow following)
         [Benchmark]
         public async Task<long> ConversionHeavyAggregate()
         {
-            CsvParallelOptions options = new() { DegreeOfParallelism = Dop, HeaderRow = 1 };
+            SheetParallelOptions options = new() { DegreeOfParallelism = Dop, HeaderRow = 1 };
             ExcelParser<WideRowRef> map = ExcelParser.FromAttributes<WideRowRef>();
-            var aggregation = await CsvParallel.AggregateAsync<Aggregation, WideRowRef>(_wide, map, options);
+            using CsvReader csv = Excel.FromCsvFile(_wide);
+            var aggregation = await SheetParallel.AggregateAsync<Aggregation, WideRowRef>(csv.FirstSheet, map, options);
             if (aggregation.Units == 0)
             {
                 throw new InvalidOperationException("WideRowRef bound no columns; the aggregate benchmark is measuring nothing.");
@@ -128,9 +131,10 @@ public async Task<long> ConversionHeavyAggregate()
         [Benchmark]
         public async Task<long> NarrowIntAggregate()
         {
-            CsvParallelOptions options = new() { DegreeOfParallelism = Dop, HeaderRow = 1 };
+            SheetParallelOptions options = new() { DegreeOfParallelism = Dop, HeaderRow = 1 };
             ExcelParser<NarrowRowStruct> map = ExcelParser.FromAttributes<NarrowRowStruct>();
-            var aggregation = await CsvParallel.AggregateAsync<AggregationNarrow, NarrowRowStruct>(_narrow, map, options);
+            using CsvReader csv = Excel.FromCsvFile(_narrow);
+            var aggregation = await SheetParallel.AggregateAsync<AggregationNarrow, NarrowRowStruct>(csv.FirstSheet, map, options);
             if (aggregation.Units == 0)
             {
                 throw new InvalidOperationException("NarrowRowStruct bound no columns; the aggregate benchmark is measuring nothing.");
diff --git a/tests/ExcelReader.Benchmarks/Parse/CsvParallelVsSepBenchmark.cs b/tests/ExcelReader.Benchmarks/Parse/CsvParallelVsSepBenchmark.cs
index 78201f19..2174dce9 100644
--- a/tests/ExcelReader.Benchmarks/Parse/CsvParallelVsSepBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Parse/CsvParallelVsSepBenchmark.cs
@@ -142,15 +142,16 @@ private async Task<long> ReadExcelReaderAsync(int degreeOfParallelism)
                 return seqAcc;
             }
             long acc = 0;
+            using CsvReader csv = Excel.FromCsvFile(Path);
             if (Corpus == ParallelCorpus.NarrowInt)
             {
-                await foreach (NarrowRow row in CsvParallel.ParseAsync(Path, ExcelParser.FromAttributes<NarrowRow>(), new CsvParallelOptions { DegreeOfParallelism = degreeOfParallelism }))
+                await foreach (NarrowRow row in SheetParallel.ParseAsync(csv.FirstSheet, ExcelParser.FromAttributes<NarrowRow>(), new SheetParallelOptions { DegreeOfParallelism = degreeOfParallelism }))
                 {
                     acc += row.A;
                 }
                 return acc;
             }
-            await foreach (WideRow row in CsvParallel.ParseAsync(Path, ExcelParser.FromAttributes<WideRow>(), new CsvParallelOptions { DegreeOfParallelism = degreeOfParallelism }))
+            await foreach (WideRow row in SheetParallel.ParseAsync(csv.FirstSheet, ExcelParser.FromAttributes<WideRow>(), new SheetParallelOptions { DegreeOfParallelism = degreeOfParallelism }))
             {
                 acc += row.Units;
             }
diff --git a/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs b/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
index 1602d4a0..eb3f5c86 100644
--- a/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
+++ b/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
@@ -14,15 +14,15 @@ public sealed unsafe class CsvAggregateNativeTests
         [Fact]
         public void Translate_Should_Return_Defaults_When_Options_Are_Absent()
         {
-            int status = NativeCsvAggregateOptions.Translate(null, out CsvParallelOptions options);
+            int status = NativeCsvAggregateOptions.Translate(null, out SheetParallelOptions options, out CsvReaderOptions reader);
 
             Assert.Equal(NativeStatus.Ok, status);
             Assert.Equal(0, options.DegreeOfParallelism);
             Assert.Equal(0, options.HeaderRow);
-            Assert.Equal((byte)',', options.Reader.Delimiter);
-            Assert.Equal((byte)'"', options.Reader.Quote);
-            Assert.True(options.Reader.DetectEncodingFromByteOrderMark);
-            Assert.Equal(32 * 1024 * 1024, options.Reader.MaxCellBytes);
+            Assert.Equal((byte)',', reader.Delimiter);
+            Assert.Equal((byte)'"', reader.Quote);
+            Assert.True(reader.DetectEncodingFromByteOrderMark);
+            Assert.Equal(32 * 1024 * 1024, reader.MaxCellBytes);
         }
 
         [Fact]
@@ -39,15 +39,15 @@ public void Translate_Should_Apply_Dialect_When_Fields_Are_Set()
                 MaxCellBytes = 4096,
             };
 
-            int status = NativeCsvAggregateOptions.Translate(raw, out CsvParallelOptions options);
+            int status = NativeCsvAggregateOptions.Translate(raw, out SheetParallelOptions options, out CsvReaderOptions reader);
 
             Assert.Equal(NativeStatus.Ok, status);
             Assert.Equal(4, options.DegreeOfParallelism);
             Assert.Equal(1, options.HeaderRow);
-            Assert.Equal((byte)';', options.Reader.Delimiter);
-            Assert.Equal((byte)'\'', options.Reader.Quote);
-            Assert.False(options.Reader.DetectEncodingFromByteOrderMark);
-            Assert.Equal(4096, options.Reader.MaxCellBytes);
+            Assert.Equal((byte)';', reader.Delimiter);
+            Assert.Equal((byte)'\'', reader.Quote);
+            Assert.False(reader.DetectEncodingFromByteOrderMark);
+            Assert.Equal(4096, reader.MaxCellBytes);
         }
 
         [Theory]
@@ -71,7 +71,7 @@ public void Translate_Should_Reject_When_A_Field_Is_Out_Of_Range(
                 MaxCellBytes = maxCellBytes,
             };
 
-            int status = NativeCsvAggregateOptions.Translate(raw, out _);
+            int status = NativeCsvAggregateOptions.Translate(raw, out _, out _);
 
             Assert.Equal(NativeStatus.InvalidArgument, status);
         }
@@ -83,7 +83,7 @@ public void Translate_Should_Reject_When_StructSize_Is_Invalid(int structSize)
         {
             NativeCsvParallelOptionsRaw raw = new() { StructSize = structSize };
 
-            int status = NativeCsvAggregateOptions.Translate(raw, out _);
+            int status = NativeCsvAggregateOptions.Translate(raw, out _, out _);
 
             Assert.Equal(NativeStatus.InvalidArgument, status);
         }
@@ -94,7 +94,7 @@ public void Translate_Should_Explain_Why_A_Zeroed_Options_Struct_Is_Rejected()
             NativeApi.ClearLastError();
             NativeCsvParallelOptionsRaw raw = default;
 
-            int status = NativeCsvAggregateOptions.Translate(raw, out _);
+            int status = NativeCsvAggregateOptions.Translate(raw, out _, out _);
 
             Assert.Equal(NativeStatus.InvalidArgument, status);
             string message = NativeApi.LastErrorText();
@@ -112,7 +112,7 @@ public void Translate_Should_Explain_Which_Dialect_Field_Was_Rejected()
                 Delimiter = 9000,
             };
 
-            int status = NativeCsvAggregateOptions.Translate(raw, out _);
+            int status = NativeCsvAggregateOptions.Translate(raw, out _, out _);
 
             Assert.Equal(NativeStatus.InvalidArgument, status);
             Assert.Contains("csv_parallel_options.delimiter", NativeApi.LastErrorText(), StringComparison.Ordinal);
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
index bc24b5ea..65508c2a 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
@@ -108,7 +108,9 @@ private static Task<PeopleLog> Chunked(byte[] csv, ExcelParser<Person> map, int
                 csv.AsMemory(),
                 MappedAggregation<PeopleLog, Person>.Unbound,
                 MappedAggregation<PeopleLog, Person>.Binder(map, map.CsvInfo, false, headerRow),
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = headerRow },
+                CsvReaderOptions.Default,
+                headerRow,
+                dop,
                 chunkSize,
                 TestContext.Current.CancellationToken);
         }
@@ -119,7 +121,9 @@ private static Task<PeopleLog> Chunked(byte[] csv, ExcelParser<IdOnly> map, int
                 csv.AsMemory(),
                 MappedAggregation<PeopleLog, IdOnly>.Unbound,
                 MappedAggregation<PeopleLog, IdOnly>.Binder(map, map.CsvInfo, false, headerRow),
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = headerRow },
+                CsvReaderOptions.Default,
+                headerRow,
+                dop,
                 chunkSize,
                 TestContext.Current.CancellationToken);
         }
@@ -165,21 +169,29 @@ public async Task EveryPublicOverloadMatchesSequential()
         {
             byte[] csv = PeopleCsv(rows: 60_000);
             List<string> expected = Sequential(csv, headerRow: 1);
-            var options = new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
+            var options = new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
             CancellationToken ct = TestContext.Current.CancellationToken;
             ExcelParser<Person> map = ExcelParser.Generated<Person>();
             string path = Path.Combine(Path.GetTempPath(), $"exr-model-{Guid.NewGuid():N}.csv");
             await File.WriteAllBytesAsync(path, csv, ct);
             try
             {
-                Assert.Equal(expected, (await CsvParallel.AggregateAsync<PeopleLog, Person>(csv.AsMemory(), map, options, ct)).Rows);
-                Assert.Equal(expected, (await CsvParallel.AggregateAsync<PeopleLog, Person>(path, map, options, ct)).Rows);
+                using (CsvReader memory = Excel.FromCsv(csv))
+                {
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<PeopleLog, Person>(memory.FirstSheet, map, options, ct)).Rows);
+                }
+                using (CsvReader fromPath = Excel.FromCsvFile(path))
+                {
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<PeopleLog, Person>(fromPath.FirstSheet, map, options, ct)).Rows);
+                }
                 await using (var file = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true))
                 {
-                    Assert.Equal(expected, (await CsvParallel.AggregateAsync<PeopleLog, Person>(file, map, options, ct)).Rows);
+                    using CsvReader fromFile = Excel.FromCsv(file, leaveOpen: true);
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<PeopleLog, Person>(fromFile.FirstSheet, map, options, ct)).Rows);
                 }
                 using var unseekable = new BufferedStream(new MemoryStream(csv, writable: false));
-                Assert.Equal(expected, (await CsvParallel.AggregateAsync<PeopleLog, Person>(unseekable, map, options, ct)).Rows);
+                using CsvReader fromBuffered = Excel.FromCsv(unseekable, leaveOpen: true);
+                Assert.Equal(expected, (await SheetParallel.AggregateAsync<PeopleLog, Person>(fromBuffered.FirstSheet, map, options, ct)).Rows);
             }
             finally
             {
@@ -200,7 +212,9 @@ public async Task BindsReorderedAndAliasedColumns()
                 .Property(["Identifier", "Id"], ExcelCellReaders.Parsable, static (ref Person m, int v) => m.Id = v)
                 .Property(["Note"], ExcelCellReaders.String, static (ref Person m, string v) => m.Note = v));
 
-            PeopleLog log = await CsvParallel.AggregateAsync<PeopleLog, Person>(csv, map, new CsvParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
+            using CsvReader reader = Excel.FromCsv(csv);
+
+            PeopleLog log = await SheetParallel.AggregateAsync<PeopleLog, Person>(reader.FirstSheet, map, new SheetParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
 
             Assert.Equal(["ada|1|n1", "bob|2|n2"], log.Rows);
         }
@@ -209,8 +223,9 @@ public async Task BindsReorderedAndAliasedColumns()
         public async Task AMissingRequiredColumnThrows()
         {
             byte[] csv = "Name,Note\nada,n1\n"u8.ToArray();
-            await Assert.ThrowsAsync<ExcelParseException>(() => CsvParallel.AggregateAsync<PeopleLog, Person>(
-                csv, ExcelParser.Generated<Person>(), new CsvParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken));
+            using CsvReader reader = Excel.FromCsv(csv);
+            await Assert.ThrowsAsync<ExcelParseException>(() => SheetParallel.AggregateAsync<PeopleLog, Person>(
+                reader.FirstSheet, ExcelParser.Generated<Person>(), new SheetParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken));
         }
 
         [Fact]
@@ -218,14 +233,15 @@ public async Task ANameMapWithoutAHeaderRowIsRejectedAndAnIndexMapIsNot()
         {
             byte[] csv = "ada,1\nbob,2\n"u8.ToArray();
             CancellationToken ct = TestContext.Current.CancellationToken;
-            await Assert.ThrowsAsync<ArgumentException>(() => CsvParallel.AggregateAsync<PeopleLog, Person>(
-                csv, ExcelParser.Generated<Person>(), new CsvParallelOptions { HeaderRow = 0 }, ct));
+            using CsvReader reader = Excel.FromCsv(csv);
+            await Assert.ThrowsAsync<ArgumentException>(() => SheetParallel.AggregateAsync<PeopleLog, Person>(
+                reader.FirstSheet, ExcelParser.Generated<Person>(), new SheetParallelOptions { HeaderRow = 0 }, ct));
 
-            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync<PeopleLog, Person>(
-                csv, (ExcelParser<Person>)null!, new CsvParallelOptions { HeaderRow = 1 }, ct));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => SheetParallel.AggregateAsync<PeopleLog, Person>(
+                reader.FirstSheet, (ExcelParser<Person>)null!, new SheetParallelOptions { HeaderRow = 1 }, ct));
 
             ExcelParser<IdOnly> byIndex = ExcelParser.Build<IdOnly>(static b => b.PropertyAt(1, ExcelCellReaders.Parsable, static (ref IdOnly m, int v) => m.Id = v));
-            PeopleLog log = await CsvParallel.AggregateAsync<PeopleLog, IdOnly>(csv, byIndex, new CsvParallelOptions { HeaderRow = 0 }, ct);
+            PeopleLog log = await SheetParallel.AggregateAsync<PeopleLog, IdOnly>(reader.FirstSheet, byIndex, new SheetParallelOptions { HeaderRow = 0 }, ct);
             Assert.Equal(["1", "2"], log.Rows);
         }
 
@@ -248,8 +264,9 @@ public async Task AnIndexMapRunsThroughThePartitionedPathForBothHeaderRowSetting
         public async Task SkipsEmptyRecords()
         {
             byte[] csv = "Name,Id,Note\nada,1,n\n\nbob,2,m\n"u8.ToArray();
-            PeopleLog log = await CsvParallel.AggregateAsync<PeopleLog, Person>(
-                csv, ExcelParser.Generated<Person>(), new CsvParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
+            using CsvReader reader = Excel.FromCsv(csv);
+            PeopleLog log = await SheetParallel.AggregateAsync<PeopleLog, Person>(
+                reader.FirstSheet, ExcelParser.Generated<Person>(), new SheetParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
             Assert.Equal(["ada|1|n", "bob|2|m"], log.Rows);
         }
 
@@ -259,8 +276,9 @@ public async Task ReportsTheExactRowSequentiallyAndZeroWhenPartitioned()
             byte[] csv = "Name,Id,Note\nada,1,n\nbob,2,n\ncid,oops,n\ndan,4,n\n"u8.ToArray();
             ExcelParser<Person> map = ExcelParser.Generated<Person>(new ExcelParserConfig { ThrowOnParseFailure = true });
 
-            ExcelParseException sequential = await Assert.ThrowsAsync<ExcelParseException>(() => CsvParallel.AggregateAsync<PeopleLog, Person>(
-                csv, map, new CsvParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 }, TestContext.Current.CancellationToken));
+            using CsvReader reader = Excel.FromCsv(csv);
+            ExcelParseException sequential = await Assert.ThrowsAsync<ExcelParseException>(() => SheetParallel.AggregateAsync<PeopleLog, Person>(
+                reader.FirstSheet, map, new SheetParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 }, TestContext.Current.CancellationToken));
             Assert.Equal(4, sequential.Row);
 
             ExcelParseException partitioned = await Assert.ThrowsAsync<ExcelParseException>(() => Chunked(csv, map, dop: 4, chunkSize: 8, headerRow: 1));
@@ -387,8 +405,9 @@ public async Task ATrackedMapWiderThanTheStackallocLimitStillBinds()
                 b.Property([$"c{columns - 1}"], ExcelCellReaders.Parsable, static (ref WideRow m, int v) => m.Last = v, isRequired: true, requireValue: true);
             });
 
-            WideLog log = await CsvParallel.AggregateAsync<WideLog, WideRow>(
-                csv, map, new CsvParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
+            using CsvReader reader = Excel.FromCsv(csv);
+            WideLog log = await SheetParallel.AggregateAsync<WideLog, WideRow>(
+                reader.FirstSheet, map, new SheetParallelOptions { HeaderRow = 1 }, TestContext.Current.CancellationToken);
 
             Assert.Equal([7, 7], log.Values);
         }
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
index 34c8c029..144f8c3c 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvParallelTests.cs
@@ -89,13 +89,21 @@ private static List<string> Sequential(byte[] csv, int headerRow = 0)
             return rows.Count > headerRow ? rows[headerRow..] : [];
         }
 
+        private static async Task<List<string>> RunSequentialAsync(byte[] csv, RowActionFactory<List<string>> factory, CancellationToken ct)
+        {
+            using CsvReader reader = Excel.FromCsv(csv);
+            return await ParallelCsvProcessor.RunAsync(reader, Collecting, factory, new SheetParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 }, ct);
+        }
+
         private static Task<List<string>> WithChunkSize(byte[] csv, int dop, int chunkSize, int headerRow = 0, RowAggregation<List<string>>? aggregation = null)
         {
             return ParallelCsvProcessor.RunWithChunkSizeAsync(
                 csv.AsMemory(),
                 aggregation ?? Collecting,
                 null,
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = headerRow },
+                CsvReaderOptions.Default,
+                headerRow,
+                dop,
                 chunkSize,
                 TestContext.Current.CancellationToken);
         }
@@ -194,7 +202,7 @@ public async Task SurfacesAnExceptionThrownForARealRecord()
             };
 
             var ex = await Assert.ThrowsAsync<InvalidOperationException>(() => ParallelCsvProcessor.RunWithChunkSizeAsync(
-                csv.AsMemory(), failAt150, null, new CsvParallelOptions { DegreeOfParallelism = 4 }, 64, TestContext.Current.CancellationToken));
+                csv.AsMemory(), failAt150, null, CsvReaderOptions.Default, 0, 4, 64, TestContext.Current.CancellationToken));
 
             Assert.Equal("r150", ex.Message);
         }
@@ -213,24 +221,38 @@ public async Task EveryPublicOverloadMatchesSequentialOnAPartitionableSource()
         {
             byte[] csv = LargeCsv(rows: 150_000);
             List<string> expected = Sequential(csv, headerRow: 1);
-            var options = new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
+            var options = new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 };
             CancellationToken ct = TestContext.Current.CancellationToken;
             string path = Path.Combine(Path.GetTempPath(), $"exr-aggregate-{Guid.NewGuid():N}.csv");
             await File.WriteAllBytesAsync(path, csv, ct);
             try
             {
-                Assert.Equal(expected, await CsvParallel.AggregateAsync(csv.AsMemory(), Collecting, options, ct));
-                Assert.Equal(expected, (await CsvParallel.AggregateAsync<RowLog, RowText>(csv.AsMemory(), options, ct)).Rows);
-                Assert.Equal(expected, await CsvParallel.AggregateAsync(path, Collecting, options, ct));
-                Assert.Equal(expected, (await CsvParallel.AggregateAsync<RowLog, RowText>(path, options, ct)).Rows);
+                using (CsvReader memory = Excel.FromCsv(csv))
+                {
+                    Assert.Equal(expected, await SheetParallel.AggregateAsync(memory.FirstSheet, Collecting, options, ct));
+                }
+                using (CsvReader memory = Excel.FromCsv(csv))
+                {
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<RowLog, RowText>(memory.FirstSheet, options, ct)).Rows);
+                }
+                using (CsvReader fromPath = Excel.FromCsvFile(path))
+                {
+                    Assert.Equal(expected, await SheetParallel.AggregateAsync(fromPath.FirstSheet, Collecting, options, ct));
+                }
+                using (CsvReader fromPath = Excel.FromCsvFile(path))
+                {
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<RowLog, RowText>(fromPath.FirstSheet, options, ct)).Rows);
+                }
 
                 await using (var file = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true))
                 {
-                    Assert.Equal(expected, await CsvParallel.AggregateAsync(file, Collecting, options, ct));
+                    using CsvReader fromFile = Excel.FromCsv(file, leaveOpen: true);
+                    Assert.Equal(expected, await SheetParallel.AggregateAsync(fromFile.FirstSheet, Collecting, options, ct));
                 }
                 await using (var file = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true))
                 {
-                    Assert.Equal(expected, (await CsvParallel.AggregateAsync<RowLog, RowText>(file, options, ct)).Rows);
+                    using CsvReader fromFile = Excel.FromCsv(file, leaveOpen: true);
+                    Assert.Equal(expected, (await SheetParallel.AggregateAsync<RowLog, RowText>(fromFile.FirstSheet, options, ct)).Rows);
                 }
             }
             finally
@@ -246,21 +268,24 @@ public async Task FallsBackToOneSequentialPassWithTheSameResult()
             List<string> expected = Sequential(csv, headerRow: 1);
             CancellationToken ct = TestContext.Current.CancellationToken;
 
-            var sequential = new CsvParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 };
-            Assert.Equal(expected, await CsvParallel.AggregateAsync(csv.AsMemory(), Collecting, sequential, ct));
+            var sequential = new SheetParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 };
+            using CsvReader memory = Excel.FromCsv(csv);
+            Assert.Equal(expected, await SheetParallel.AggregateAsync(memory.FirstSheet, Collecting, sequential, ct));
 
             using var unpartitionable = new BufferedStream(new MemoryStream(csv, writable: false));
-            Assert.Equal(expected, (await CsvParallel.AggregateAsync<RowLog, RowText>(unpartitionable, new CsvParallelOptions { HeaderRow = 1 }, ct)).Rows);
+            using CsvReader buffered = Excel.FromCsv(unpartitionable, leaveOpen: true);
+            Assert.Equal(expected, (await SheetParallel.AggregateAsync<RowLog, RowText>(buffered.FirstSheet, new SheetParallelOptions { HeaderRow = 1 }, ct)).Rows);
         }
 
         [Fact]
         public async Task RejectsInvalidOptionsAndAggregations()
         {
             byte[] csv = "a\n"u8.ToArray();
-            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => CsvParallel.AggregateAsync<RowLog, RowText>(csv, new CsvParallelOptions { DegreeOfParallelism = -1 }, TestContext.Current.CancellationToken));
-            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => CsvParallel.AggregateAsync<RowLog, RowText>(csv, new CsvParallelOptions { HeaderRow = -1 }, TestContext.Current.CancellationToken));
-            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, (RowAggregation<int>)null!, null, TestContext.Current.CancellationToken));
-            await Assert.ThrowsAsync<ArgumentNullException>(() => CsvParallel.AggregateAsync(csv, new RowAggregation<int> { Seed = null!, Accumulate = static (ref int s, Row r) => s++, Combine = static (a, b) => a + b }, null, TestContext.Current.CancellationToken));
+            using CsvReader reader = Excel.FromCsv(csv);
+            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => SheetParallel.AggregateAsync<RowLog, RowText>(reader.FirstSheet, new SheetParallelOptions { DegreeOfParallelism = -1 }, TestContext.Current.CancellationToken));
+            await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => SheetParallel.AggregateAsync<RowLog, RowText>(reader.FirstSheet, new SheetParallelOptions { HeaderRow = -1 }, TestContext.Current.CancellationToken));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => SheetParallel.AggregateAsync(reader.FirstSheet, (RowAggregation<int>)null!, null, TestContext.Current.CancellationToken));
+            await Assert.ThrowsAsync<ArgumentNullException>(() => SheetParallel.AggregateAsync(reader.FirstSheet, new RowAggregation<int> { Seed = null!, Accumulate = static (ref int s, Row r) => s++, Combine = static (a, b) => a + b }, null, TestContext.Current.CancellationToken));
         }
 
         [Fact]
@@ -269,9 +294,10 @@ public async Task ACanceledTokenStopsProcessing()
             byte[] csv = LargeCsv(rows: 150_000);
             using var cts = new CancellationTokenSource();
             await cts.CancelAsync();
+            using CsvReader reader = Excel.FromCsv(csv);
 
             await Assert.ThrowsAnyAsync<OperationCanceledException>(
-                () => CsvParallel.AggregateAsync<RowLog, RowText>(csv, new CsvParallelOptions { DegreeOfParallelism = 4 }, cts.Token));
+                () => SheetParallel.AggregateAsync<RowLog, RowText>(reader.FirstSheet, new SheetParallelOptions { DegreeOfParallelism = 4 }, cts.Token));
         }
 
         [Fact]
@@ -290,8 +316,8 @@ public async Task CallsTheFactoryOnceWithTheHeaderRecord()
                     return Collecting.Accumulate;
                 };
                 List<string> rows = partitioned
-                    ? await ParallelCsvProcessor.RunWithChunkSizeAsync(csv.AsMemory(), Collecting, factory, new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 }, 4096, ct)
-                    : await ParallelCsvProcessor.RunAsync(csv.AsMemory(), Collecting, factory, new CsvParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 }, ct);
+                    ? await ParallelCsvProcessor.RunWithChunkSizeAsync(csv.AsMemory(), Collecting, factory, CsvReaderOptions.Default, 1, 4, 4096, ct)
+                    : await RunSequentialAsync(csv, factory, ct);
 
                 Assert.Equal(expected, rows);
                 (string header, bool sequentialCall) = Assert.Single(calls);
@@ -312,7 +338,7 @@ public async Task CallsTheFactoryWithAnEmptyHeaderWhenThereIsNoHeaderRow()
                 return Collecting.Accumulate;
             };
 
-            List<string> rows = await ParallelCsvProcessor.RunWithChunkSizeAsync(csv.AsMemory(), Collecting, factory, new CsvParallelOptions { DegreeOfParallelism = 4 }, 1024, ct);
+            List<string> rows = await ParallelCsvProcessor.RunWithChunkSizeAsync(csv.AsMemory(), Collecting, factory, CsvReaderOptions.Default, 0, 4, 1024, ct);
 
             Assert.Equal(Sequential(csv), rows);
             Assert.Equal(0, Assert.Single(columnCounts));
@@ -328,7 +354,7 @@ public async Task DoesNotCallTheFactoryWhenTheInputEndsBeforeTheHeader()
                 return Collecting.Accumulate;
             };
 
-            Assert.Empty(await ParallelCsvProcessor.RunWithChunkSizeAsync(ReadOnlyMemory<byte>.Empty, Collecting, factory, new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 }, 4, TestContext.Current.CancellationToken));
+            Assert.Empty(await ParallelCsvProcessor.RunWithChunkSizeAsync(ReadOnlyMemory<byte>.Empty, Collecting, factory, CsvReaderOptions.Default, 1, 4, 4, TestContext.Current.CancellationToken));
             Assert.Equal(0, calls);
         }
 
@@ -344,7 +370,7 @@ public async Task RecordAccumulatorMatchesSequentialAcrossChunkSizes()
                 {
                     RowLog log = await ParallelCsvProcessor.RunWithChunkSizeAsync(
                         csv.AsMemory(), RecordAggregation<RowLog, RowText>.Instance, null,
-                        new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 }, chunkSize, ct);
+                        CsvReaderOptions.Default, 1, dop, chunkSize, ct);
                     Assert.Equal(expected, log.Rows);
                 }
             }
@@ -359,7 +385,7 @@ public async Task SkipsRecordsWhoseTryParseReturnsFalseAndKeepsSpansValidDuringA
             {
                 RowLog log = await ParallelCsvProcessor.RunWithChunkSizeAsync(
                     csv.AsMemory(), RecordAggregation<RowLog, NumberedRow>.Instance, null,
-                    new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 }, chunkSize, ct);
+                    CsvReaderOptions.Default, 1, 4, chunkSize, ct);
                 Assert.Equal(["ada#1", "cid\nmulti#3"], log.Rows);
             }
         }
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
index ee7d91b6..af77f2b0 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvReaderChunkSourceTests.cs
@@ -88,9 +88,7 @@ public async Task RunPartitionedAsync_Should_Deliver_Every_Record_After_The_Head
                 Accumulate = (ref long seen, Row _) => seen++,
                 Combine = (left, right) => left + right,
             };
-            CsvParallelOptions options = new() { DegreeOfParallelism = 4, HeaderRow = 1, Reader = reader.Options };
-
-            long rows = await ParallelCsvProcessor.RunPartitionedAsync(source, count, options, chunkSizeOverride: 4096, CancellationToken.None);
+            long rows = await ParallelCsvProcessor.RunPartitionedAsync(source, count, reader.Options, headerRow: 1, degreeOfParallelism: 4, chunkSizeOverride: 4096, CancellationToken.None);
 
             Assert.Equal(50_000, rows);
         }
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
index d4931d0d..75358416 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ForEachCsvParallelTests.cs
@@ -61,10 +61,11 @@ public async Task ForEachRecord_Memory_SeesEveryRecordExactlyOnce(int dop)
             byte[] csv = SalesCsv(rows);
             long total = 0;
             long count = 0;
-            var options = new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 };
+            var options = new SheetParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 };
+            using CsvReader reader = Excel.FromCsv(csv);
 
-            await CsvParallel.ForEachAsync<Sale>(
-                csv.AsMemory(),
+            await SheetParallel.ForEachAsync<Sale>(
+                reader.FirstSheet,
                 sale =>
                 {
                     Interlocked.Add(ref total, sale.Units);
@@ -86,10 +87,11 @@ public async Task ForEachRecord_Path_MatchesMemory()
             long total = 0;
             try
             {
-                await CsvParallel.ForEachAsync<Sale>(
-                    path,
+                using CsvReader reader = Excel.FromCsvFile(path);
+                await SheetParallel.ForEachAsync<Sale>(
+                    reader.FirstSheet,
                     sale => Interlocked.Add(ref total, sale.Units),
-                    new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
+                    new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
                     TestContext.Current.CancellationToken);
             }
             finally
@@ -107,10 +109,12 @@ public async Task ForEachRecord_Stream_MatchesMemory()
             using var stream = new MemoryStream(SalesCsv(rows), writable: false);
             long total = 0;
 
-            await CsvParallel.ForEachAsync<Sale>(
-                stream,
+            using CsvReader reader = Excel.FromCsv(stream, leaveOpen: true);
+
+            await SheetParallel.ForEachAsync<Sale>(
+                reader.FirstSheet,
                 sale => Interlocked.Add(ref total, sale.Units),
-                new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
+                new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
                 TestContext.Current.CancellationToken);
 
             Assert.Equal(ExpectedUnits(rows), total);
@@ -122,10 +126,12 @@ public async Task ForEachRecord_TinySource_FallsBackToSequentialInOrder()
             byte[] csv = SalesCsv(5);
             var seen = new List<int>();
 
-            await CsvParallel.ForEachAsync<Sale>(
-                csv.AsMemory(),
+            using CsvReader reader = Excel.FromCsv(csv);
+
+            await SheetParallel.ForEachAsync<Sale>(
+                reader.FirstSheet,
                 sale => seen.Add(sale.Units),
-                new CsvParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 },
+                new SheetParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 },
                 TestContext.Current.CancellationToken);
 
             Assert.Equal([1, 2, 3, 4, 5], seen);
@@ -135,20 +141,22 @@ await CsvParallel.ForEachAsync<Sale>(
         public async Task ForEachRecord_NullBody_Throws()
         {
             byte[] csv = SalesCsv(4);
+            using CsvReader reader = Excel.FromCsv(csv);
             await Assert.ThrowsAsync<ArgumentNullException>(
-                () => CsvParallel.ForEachAsync<Sale>(csv.AsMemory(), null!, null, TestContext.Current.CancellationToken));
+                () => SheetParallel.ForEachAsync<Sale>(reader.FirstSheet, null!, null, TestContext.Current.CancellationToken));
         }
 
         [Fact]
         public async Task ForEachRecord_BodyThrows_SurfacesFromTask()
         {
             byte[] csv = SalesCsv(20_000);
+            using CsvReader reader = Excel.FromCsv(csv);
 
             await Assert.ThrowsAsync<InvalidOperationException>(
-                () => CsvParallel.ForEachAsync<Sale>(
-                    csv.AsMemory(),
+                () => SheetParallel.ForEachAsync<Sale>(
+                    reader.FirstSheet,
                     static _ => throw new InvalidOperationException("boom"),
-                    new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
+                    new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
                     TestContext.Current.CancellationToken));
         }
 
@@ -157,12 +165,13 @@ public async Task ForEachRecord_Cancelled_Throws()
         {
             byte[] csv = SalesCsv(200_000);
             using var cts = new CancellationTokenSource();
+            using CsvReader reader = Excel.FromCsv(csv);
 
             await Assert.ThrowsAnyAsync<OperationCanceledException>(
-                () => CsvParallel.ForEachAsync<Sale>(
-                    csv.AsMemory(),
+                () => SheetParallel.ForEachAsync<Sale>(
+                    reader.FirstSheet,
                     _ => cts.Cancel(),
-                    new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
+                    new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 },
                     cts.Token));
         }
 
@@ -197,9 +206,10 @@ public async Task ForEachMapped_BindsEveryColumn(int dop)
             long units = 0;
             long regionBytes = 0;
             long count = 0;
+            using CsvReader reader = Excel.FromCsv(csv);
 
-            await CsvParallel.ForEachAsync(
-                csv.AsMemory(),
+            await SheetParallel.ForEachAsync(
+                reader.FirstSheet,
                 ExcelParser.FromAttributes<Order>(),
                 order =>
                 {
@@ -207,7 +217,7 @@ await CsvParallel.ForEachAsync(
                     Interlocked.Add(ref regionBytes, order.Region.Length);
                     Interlocked.Increment(ref count);
                 },
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 },
+                new SheetParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 },
                 TestContext.Current.CancellationToken);
 
             Assert.Equal(rows, count);
@@ -221,20 +231,22 @@ public async Task ForEachMapped_MatchesSequentialParser()
             const int rows = 20_000;
             byte[] csv = OrdersCsv(rows);
             long parallel = 0;
+            using CsvReader reader = Excel.FromCsv(csv);
 
-            await CsvParallel.ForEachAsync(
-                csv.AsMemory(),
+            await SheetParallel.ForEachAsync(
+                reader.FirstSheet,
                 ExcelParser.FromAttributes<Order>(),
                 order => Interlocked.Add(ref parallel, order.Units),
-                new CsvParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 },
+                new SheetParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 },
                 TestContext.Current.CancellationToken);
 
             long sequential = 0;
-            await CsvParallel.ForEachAsync(
-                csv.AsMemory(),
+            using CsvReader sequentialReader = Excel.FromCsv(csv);
+            await SheetParallel.ForEachAsync(
+                sequentialReader.FirstSheet,
                 ExcelParser.FromAttributes<Order>(),
                 order => sequential += order.Units,
-                new CsvParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 },
+                new SheetParallelOptions { DegreeOfParallelism = 1, HeaderRow = 1 },
                 TestContext.Current.CancellationToken);
 
             Assert.Equal(sequential, parallel);
@@ -245,13 +257,14 @@ await CsvParallel.ForEachAsync(
         public async Task ForEachMapped_HeaderRowZeroWithNamedMap_Throws()
         {
             byte[] csv = OrdersCsv(8);
+            using CsvReader reader = Excel.FromCsv(csv);
 
             await Assert.ThrowsAsync<ArgumentException>(
-                () => CsvParallel.ForEachAsync(
-                    csv.AsMemory(),
+                () => SheetParallel.ForEachAsync(
+                    reader.FirstSheet,
                     ExcelParser.FromAttributes<Order>(),
                     static _ => { },
-                    new CsvParallelOptions { DegreeOfParallelism = 4, HeaderRow = 0 },
+                    new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 0 },
                     TestContext.Current.CancellationToken));
         }
 
@@ -259,10 +272,11 @@ await Assert.ThrowsAsync<ArgumentException>(
         public async Task ForEachMapped_NullMap_Throws()
         {
             byte[] csv = OrdersCsv(8);
+            using CsvReader reader = Excel.FromCsv(csv);
 
             await Assert.ThrowsAsync<ArgumentNullException>(
-                () => CsvParallel.ForEachAsync<Order>(
-                    csv.AsMemory(),
+                () => SheetParallel.ForEachAsync<Order>(
+                    reader.FirstSheet,
                     null!,
                     static _ => { },
                     null,
@@ -297,7 +311,9 @@ private static Task<byte> ChunkedRecord(byte[] csv, Action<Sale> body, ChunkProb
                 csv.AsMemory(),
                 probe.Wrap(RecordCallback<Sale>.For(body)),
                 null,
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 },
+                CsvReaderOptions.Default,
+                1,
+                dop,
                 chunkSize,
                 TestContext.Current.CancellationToken);
         }
@@ -309,7 +325,9 @@ private static Task<byte> ChunkedMapped(byte[] csv, Action<Order> body, ChunkPro
                 csv.AsMemory(),
                 probe.Wrap(MappedCallback<Order>.Unbound),
                 MappedCallback<Order>.Binder(order, order.CsvInfo, false, 1, body),
-                new CsvParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 },
+                CsvReaderOptions.Default,
+                1,
+                dop,
                 chunkSize,
                 TestContext.Current.CancellationToken);
         }
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
index 7cda722e..8ebd9fdb 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
@@ -41,7 +41,8 @@ public async Task MemoryOverloadMatchesTheSequentialParser()
             using var reader = Excel.FromCsv(csv);
             List<Row> expected = [.. ExcelParser.FromAttributes<Row>().Parse(reader.FirstSheet)];
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(csv);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(expected.Count, actual.Count);
             for (int i = 0; i < expected.Count; i++)
@@ -62,7 +63,8 @@ public async Task FileOverloadMatchesTheSequentialParser()
                 using var reader = Excel.FromCsvFile(path);
                 List<Row> expected = [.. ExcelParser.FromAttributes<Row>().Parse(reader.FirstSheet)];
 
-                List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(path, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
+                using CsvReader source = Excel.FromCsvFile(path);
+                List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
                 Assert.Equal(expected.Count, actual.Count);
                 Assert.Equal(expected[^1].Name, actual[^1].Name);
@@ -79,7 +81,8 @@ public async Task ATinySourceStillProducesTheRightRowsThroughTheSequentialFallba
         {
             byte[] csv = BuildCsv(3);
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(csv);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(3, actual.Count);
             Assert.Equal("name00000", actual[0].Name);
@@ -93,8 +96,10 @@ public async Task ANonUtf8EncodingFallsBackAndStillDecodesCorrectly()
             byte[] csv = latin1.GetBytes("Name,Age\nJosé,30\nRenée,41\n");
             var options = new CsvReaderOptions { Encoding = latin1 };
 
+            using CsvReader source = Excel.FromCsv(csv, options);
+
             List<Row> actual = await DrainAsync(
-                CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8, Reader = options }, ct: TestContext.Current.CancellationToken));
+                SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(2, actual.Count);
             Assert.Equal("José", actual[0].Name);
@@ -106,7 +111,8 @@ public async Task ADegreeOfOneIsTheSequentialPath()
         {
             byte[] csv = BuildCsv(5_000);
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 1 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(csv);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 1 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(5_000, actual.Count);
             Assert.Equal(4_999, actual[^1].Age);
@@ -117,8 +123,10 @@ public void ANegativeDegreeOfParallelismThrows()
         {
             byte[] csv = BuildCsv(10);
 
+            using CsvReader source = Excel.FromCsv(csv);
+
             Assert.Throws<ArgumentOutOfRangeException>(
-                () => CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = -1 }, ct: TestContext.Current.CancellationToken));
+                () => SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = -1 }, ct: TestContext.Current.CancellationToken));
         }
 
         [Fact]
@@ -126,8 +134,10 @@ public void AHeaderRowOnTheParallelOptionsThrowsBecauseTypedParsingReadsItFromTh
         {
             byte[] csv = BuildCsv(10);
 
+            using CsvReader source = Excel.FromCsv(csv);
+
             ArgumentException exception = Assert.Throws<ArgumentException>(
-                () => CsvParallel.ParseAsync(csv.AsMemory(), ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { HeaderRow = 2 }, ct: TestContext.Current.CancellationToken));
+                () => SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { HeaderRow = 2 }, ct: TestContext.Current.CancellationToken));
             Assert.Contains(nameof(ExcelParserConfig.HeaderRow), exception.Message, StringComparison.Ordinal);
         }
 
@@ -137,7 +147,8 @@ public async Task AMemoryStreamWithAnExposedBufferIsUnwrappedAndParallelized()
             byte[] csv = BuildCsv(20_000);
             using var ms = new MemoryStream(csv, 0, csv.Length, writable: false, publiclyVisible: true);
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(ms, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(ms, leaveOpen: true);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(20_000, actual.Count);
             Assert.Equal("name00000", actual[0].Name);
@@ -150,7 +161,8 @@ public async Task AMemoryStreamWithoutAnExposedBufferStillProducesTheRightRows()
             byte[] csv = BuildCsv(20_000);
             using var ms = new MemoryStream(csv, 0, csv.Length, writable: false, publiclyVisible: false);
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(ms, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(ms, leaveOpen: true);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 4 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(20_000, actual.Count);
             Assert.Equal(19_999, actual[^1].Age);
@@ -166,7 +178,8 @@ public async Task AFileStreamIsUnwrappedToItsHandleAndParallelized()
             {
                 await using var fs = new FileStream(path, FileMode.Open, FileAccess.Read);
 
-                List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(fs, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
+                using CsvReader source = Excel.FromCsv(fs, leaveOpen: true);
+                List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
                 Assert.Equal(20_000, actual.Count);
                 Assert.Equal(19_999, actual[^1].Age);
@@ -189,7 +202,8 @@ public async Task AnUnwrappableStreamFallsBackWithoutThrowing()
                 await using var fs = new FileStream(path, FileMode.Open, FileAccess.Read);
                 await using var buffered = new BufferedStream(fs);
 
-                List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(buffered, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
+                using CsvReader source = Excel.FromCsv(buffered, leaveOpen: true);
+                List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
                 Assert.Equal(20_000, actual.Count);
                 Assert.Equal(19_999, actual[^1].Age);
@@ -206,7 +220,8 @@ public async Task ANonSeekableStreamFallsBackWithoutThrowing()
             byte[] csv = BuildCsv(20_000);
             await using var pipe = new NonSeekableStream(csv);
 
-            List<Row> actual = await DrainAsync(CsvParallel.ParseAsync(pipe, ExcelParser.FromAttributes<Row>(), options: new CsvParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
+            using CsvReader source = Excel.FromCsv(pipe, leaveOpen: true);
+            List<Row> actual = await DrainAsync(SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
 
             Assert.Equal(20_000, actual.Count);
             Assert.Equal(19_999, actual[^1].Age);
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
index 8f38b216..c8f8f657 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
@@ -173,14 +173,11 @@ public async Task Should_InferDelimiter_When_SniffingOnTheParallelPath()
             string path = WriteTemp(sb.ToString());
             try
             {
-                var options = new CsvParallelOptions
-                {
-                    DegreeOfParallelism = 4,
-                    Reader = CsvReaderOptions.Default with { SniffDialect = true },
-                };
+                var options = new SheetParallelOptions { DegreeOfParallelism = 4 };
+                using CsvReader reader = Excel.FromCsvFile(path, CsvReaderOptions.Default with { SniffDialect = true });
 
                 var rows = new List<Person>();
-                await foreach (Person person in CsvParallel.ParseAsync(path, ExcelParser.FromAttributes<Person>(), options, ct: TestContext.Current.CancellationToken))
+                await foreach (Person person in SheetParallel.ParseAsync(reader.FirstSheet, ExcelParser.FromAttributes<Person>(), options, ct: TestContext.Current.CancellationToken))
                 {
                     rows.Add(person);
                 }

From 6b4905672976694bb8db3c475477359ad908db0e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 22:11:55 -0300
Subject: [PATCH 067/115] feat(reader): let XLSX and XLSB enumerators parse a
 slice of inflated sheet bytes in place

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 src/ExcelReader.Core/Reader/Xlsb/XlsbSheet.cs |   6 +-
 .../Reader/Xlsb/XlsbWorkbook.Enumerator.cs    |  17 ++
 .../Reader/Xlsb/XlsbWorkbook.cs               |  31 +++
 src/ExcelReader.Core/Reader/Xlsx/XlsxSheet.cs |   6 +-
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |  38 +++-
 .../Reader/Xlsx/XlsxWorkbook.cs               |  32 +++
 .../Reader/ChunkEnumeratorTests.cs            | 182 ++++++++++++++++++
 7 files changed, 305 insertions(+), 7 deletions(-)
 create mode 100644 tests/ExcelReader.Tests/Reader/ChunkEnumeratorTests.cs

diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbSheet.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbSheet.cs
index 69a57008..ee0f9ec4 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbSheet.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbSheet.cs
@@ -26,7 +26,7 @@ internal XlsbSheet(XlsbWorkbook workbook, int index, string name, ExcelSheetVisi
         /// <inheritdoc/>
         public bool IsDate1904 { get; }
 
-        private XlsbWorkbook Workbook
+        internal XlsbWorkbook Owner
         {
             get
             {
@@ -37,13 +37,13 @@ private XlsbWorkbook Workbook
         /// <inheritdoc/>
         public XlsbWorkbook.Enumerator GetEnumerator()
         {
-            return Workbook.OpenSheet(Index);
+            return Owner.OpenSheet(Index);
         }
 
         /// <inheritdoc/>
         public XlsbWorkbook.Enumerator GetAsyncEnumerator(CancellationToken ct = default)
         {
-            return Workbook.OpenSheetAsync(Index, ct);
+            return Owner.OpenSheetAsync(Index, ct);
         }
 
         IExcelRowEnumerator IExcelSheet<IExcelRowEnumerator>.GetEnumerator()
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
index f3bbf1e0..cd1fb5fc 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
@@ -52,6 +52,16 @@ internal Enumerator(XlsbWorkbook reader, ZipEntryRef entry, CancellationToken ct
                 _lease = reader.Lifetime;
             }
 
+            internal Enumerator(XlsbWorkbook reader, ReadOnlyMemory<byte> chunk, bool rowOpen, CancellationToken ct)
+                : base(chunk, reader._options.MaxCellBytes, nameof(ExcelReaderOptions.MaxCellBytes), ct)
+            {
+                _reader = reader;
+                _styleIsDate = reader._styleIsDate;
+                _sharedOffsets = reader._sharedOffsets;
+                _contentCache = reader._options.InternStrings ? new Utf8StringCache() : null;
+                _pendingRowHdr = rowOpen;
+            }
+
             private protected override Stream OpenSource()
             {
                 return _reader._zip!.OpenEntryStream(_entry, _reader._decompressedBytes, _reader._options);
@@ -66,6 +76,13 @@ private protected override async ValueTask<Stream> OpenSourceAsync()
             public Row Current =>
                 new(_acc.CellSpan, _acc.ValueSpan, _reader.SharedSpan, rowBuffer: default, _reader.SharedStringCache, _contentCache);
 
+            internal long Offset => _io.BaseOffset + _pos;
+
+            // The last MoveNext stopped just past the next row's header record, so that row is already open.
+            internal bool RowOpen => _pendingRowHdr;
+
+            internal bool Ended => _ended;
+
             int IRowIndexedEnumerator.RowIndex
             {
                 get
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
index 089307a1..a51ef242 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
@@ -287,6 +287,37 @@ internal Enumerator OpenSheet(int index)
             }
         }
 
+        internal int MaxCellBytes => _options.MaxCellBytes;
+
+        private ExcelReaderOptions WithoutPrefetch => _options.PrefetchDecompression ? _options with { PrefetchDecompression = false } : _options;
+
+        internal long SheetUncompressedSize(int index)
+        {
+            Lifetime.ThrowIfClosed(this);
+            return WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path).UncompressedSize;
+        }
+
+        internal Enumerator OpenSheetWithoutPrefetch(int index)
+        {
+            Lifetime.Acquire(this);
+            try
+            {
+                ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path);
+                return new Enumerator(this, _zip!.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch), entry.UncompressedSize);
+            }
+            catch
+            {
+                Lifetime.Release();
+                throw;
+            }
+        }
+
+        internal Stream OpenSheetStream(int index)
+        {
+            ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path);
+            return _zip!.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch);
+        }
+
         internal Enumerator OpenSheetAsync(int index, CancellationToken ct)
         {
             if (_zip!.HasMemory)
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxSheet.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxSheet.cs
index 866237f9..d9aafa65 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxSheet.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxSheet.cs
@@ -26,7 +26,7 @@ internal XlsxSheet(XlsxWorkbook workbook, int index, string name, ExcelSheetVisi
         /// <inheritdoc/>
         public bool IsDate1904 { get; }
 
-        private XlsxWorkbook Workbook
+        internal XlsxWorkbook Owner
         {
             get
             {
@@ -37,13 +37,13 @@ private XlsxWorkbook Workbook
         /// <inheritdoc/>
         public XlsxWorkbook.Enumerator GetEnumerator()
         {
-            return Workbook.OpenSheet(Index);
+            return Owner.OpenSheet(Index);
         }
 
         /// <inheritdoc/>
         public XlsxWorkbook.Enumerator GetAsyncEnumerator(CancellationToken ct = default)
         {
-            return Workbook.OpenSheetAsync(Index, ct);
+            return Owner.OpenSheetAsync(Index, ct);
         }
 
         IExcelRowEnumerator IExcelSheet<IExcelRowEnumerator>.GetEnumerator()
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index eef45f84..1f7c928d 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -25,6 +25,8 @@ public sealed class Enumerator : PooledStreamRowEnumerator, IExcelRowEnumerator,
             private int _nextCol;
             private bool _trackRowIndex;
             private int _rowIndex = -1;
+            private bool _reachedEnd;
+            private bool _endedMidMarkup;
 
             private NsTokens? _ns;
             private bool _nsChecked;
@@ -54,6 +56,17 @@ internal Enumerator(XlsxWorkbook reader, ZipEntryRef entry, CancellationToken ct
                 _lease = reader.Lifetime;
             }
 
+            internal Enumerator(XlsxWorkbook reader, ReadOnlyMemory<byte> chunk, NsTokens? ns, CancellationToken ct)
+                : base(chunk, reader._options.MaxCellBytes, nameof(ExcelReaderOptions.MaxCellBytes), ct)
+            {
+                _reader = reader;
+                _styleIsDate = reader._styleIsDate;
+                _sharedOffsets = reader._sharedOffsets;
+                _contentCache = reader._options.InternStrings ? new Utf8StringCache() : null;
+                _ns = ns;
+                _nsChecked = true;
+            }
+
             private protected override Stream OpenSource()
             {
                 _reader.EnsureSharedLoaded();
@@ -72,6 +85,25 @@ private protected override async ValueTask<Stream> OpenSourceAsync()
             public Row Current =>
                 new(_acc.CellSpan, _acc.ValueSpan, _reader.SharedSpan, _buf.AsSpan(0, _len), _reader.SharedStringCache, _contentCache);
 
+            internal NsTokens? Namespace
+            {
+                get
+                {
+                    if (!_nsChecked)
+                    {
+                        DetectNamespace();
+                    }
+                    return _ns;
+                }
+            }
+
+            internal long Offset => _io.BaseOffset + _pos;
+
+            internal bool ReachedEnd => _reachedEnd;
+
+            // True once the end of the input cut a row or a tag short: what was read last is not what a longer input would give.
+            internal bool EndedMidMarkup => _endedMidMarkup;
+
             int IRowIndexedEnumerator.RowIndex
             {
                 get
@@ -104,6 +136,7 @@ public bool MoveNext()
                     switch (ClassifyHead())
                     {
                         case HeadKind.End:
+                            _reachedEnd = true;
                             return false;
                         case HeadKind.Row:
                             if (!BeginRow())
@@ -114,6 +147,7 @@ public bool MoveNext()
                         default:
                             if (!SkipMarkup())
                             {
+                                _endedMidMarkup = true;
                                 return false;
                             }
                             break;
@@ -283,6 +317,7 @@ private void RestartRowAt(int rowStart)
 
             private void ParseTruncatedRow(int rowStart)
             {
+                _endedMidMarkup = true;
                 RestartRowAt(rowStart);
                 ParseRow(_len);
             }
@@ -587,6 +622,7 @@ private bool BeginRowAt(int gt)
 
             private bool MissingRowOpenTag()
             {
+                _endedMidMarkup = true;
                 if (_trackRowIndex)
                 {
                     _rowIndex++;
@@ -1016,7 +1052,7 @@ private static bool SkipMarkupSpan(byte[] buf, int len, ref int p)
                 return true;
             }
 
-            private static bool IsBoundary(byte b)
+            internal static bool IsBoundary(byte b)
             {
                 return b is (byte)' ' or (byte)'>' or (byte)'/' or (byte)'\t' or (byte)'\r' or (byte)'\n';
             }
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
index 89ff1512..c684f478 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
@@ -218,6 +218,38 @@ internal Enumerator OpenSheet(int index)
             }
         }
 
+        internal int MaxCellBytes => _options.MaxCellBytes;
+
+        private ExcelReaderOptions WithoutPrefetch => _options.PrefetchDecompression ? _options with { PrefetchDecompression = false } : _options;
+
+        internal long SheetUncompressedSize(int index)
+        {
+            Lifetime.ThrowIfClosed(this);
+            return WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path).UncompressedSize;
+        }
+
+        internal Enumerator OpenSheetWithoutPrefetch(int index)
+        {
+            Lifetime.Acquire(this);
+            try
+            {
+                EnsureSharedLoaded();
+                ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path);
+                return new Enumerator(this, _zip.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch), entry.UncompressedSize);
+            }
+            catch
+            {
+                Lifetime.Release();
+                throw;
+            }
+        }
+
+        internal Stream OpenSheetStream(int index)
+        {
+            ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path);
+            return _zip.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch);
+        }
+
         internal Enumerator OpenSheetAsync(int index, CancellationToken ct)
         {
             if (_zip.HasMemory)
diff --git a/tests/ExcelReader.Tests/Reader/ChunkEnumeratorTests.cs b/tests/ExcelReader.Tests/Reader/ChunkEnumeratorTests.cs
new file mode 100644
index 00000000..57b4f603
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/ChunkEnumeratorTests.cs
@@ -0,0 +1,182 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Reader.Xlsx;
+using ExcelReader.Core.Writer.Xlsb;
+
+namespace ExcelReader.Tests.Reader
+{
+    public class ChunkEnumeratorTests
+    {
+        private static string Render(Row row)
+        {
+            var sb = new StringBuilder();
+            foreach (RowCell cell in row.Cells)
+            {
+                sb.Append(cell.ColumnIndex).Append(':').Append(cell.Value.GetString()).Append('|');
+            }
+            return sb.ToString();
+        }
+
+        private static string Rows(int count)
+        {
+            var sb = new StringBuilder();
+            for (int r = 1; r <= count; r++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c r=\"A{r}\" t=\"inlineStr\"><is><t>n{r}</t></is></c><c r=\"B{r}\"><v>{r}</v></c></row>");
+            }
+            return sb.ToString();
+        }
+
+        private static byte[] Inflated(XlsxWorkbook workbook)
+        {
+            using Stream stream = workbook.OpenSheetStream(0);
+            using var copy = new MemoryStream();
+            stream.CopyTo(copy);
+            return copy.ToArray();
+        }
+
+        [Fact]
+        public void AnXlsxChunkParsesLikeTheSameRowsReadSequentially()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(50));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            var expected = new List<string>();
+            long dataStart;
+            NsTokens? ns;
+            using (XlsxWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(0))
+            {
+                ns = rows.Namespace;
+                Assert.True(rows.MoveNext());
+                dataStart = rows.Offset;
+                while (rows.MoveNext())
+                {
+                    expected.Add(Render(rows.Current));
+                }
+            }
+            byte[] inflated = Inflated(workbook);
+
+            var actual = new List<string>();
+            using var chunk = new XlsxWorkbook.Enumerator(workbook, inflated.AsMemory((int)dataStart), ns, CancellationToken.None);
+            while (chunk.MoveNext())
+            {
+                actual.Add(Render(chunk.Current));
+            }
+
+            Assert.Equal(expected, actual);
+            Assert.True(chunk.ReachedEnd);
+            Assert.False(chunk.EndedMidMarkup);
+        }
+
+        [Fact]
+        public void AnXlsxChunkCutBetweenRowsEndsCleanly()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(10));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            using (workbook.OpenSheetWithoutPrefetch(0))
+            {
+            }
+            byte[] inflated = Inflated(workbook);
+            int first = inflated.AsSpan().IndexOf("<row r=\"1\""u8);
+            int sixth = inflated.AsSpan().IndexOf("<row r=\"6\""u8);
+
+            using var chunk = new XlsxWorkbook.Enumerator(workbook, inflated.AsMemory(first, sixth - first), null, CancellationToken.None);
+            int rows = 0;
+            while (chunk.MoveNext())
+            {
+                rows++;
+            }
+
+            Assert.Equal(5, rows);
+            Assert.False(chunk.ReachedEnd);
+            Assert.False(chunk.EndedMidMarkup);
+        }
+
+        [Fact]
+        public void AnXlsxChunkCutInsideARowReportsIt()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(10));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            using (workbook.OpenSheetWithoutPrefetch(0))
+            {
+            }
+            byte[] inflated = Inflated(workbook);
+            int first = inflated.AsSpan().IndexOf("<row r=\"1\""u8);
+            int insideSixth = inflated.AsSpan().IndexOf("<row r=\"6\""u8) + 20;
+
+            using var chunk = new XlsxWorkbook.Enumerator(workbook, inflated.AsMemory(first, insideSixth - first), null, CancellationToken.None);
+            int complete = 0;
+            while (chunk.MoveNext() && !chunk.EndedMidMarkup)
+            {
+                complete++;
+            }
+
+            Assert.Equal(5, complete);
+            Assert.True(chunk.EndedMidMarkup);
+        }
+
+        [Fact]
+        public void APrefixedXlsxSheetReportsItsNamespaceTokens()
+        {
+            using MemoryStream ms = WorkbookBuilder.BuildPrefixed("x", "<x:row r=\"1\"><x:c r=\"A1\"><x:v>1</x:v></x:c></x:row>");
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            using XlsxWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(0);
+
+            Assert.NotNull(rows.Namespace);
+            Assert.Equal("<x:row"u8.ToArray(), rows.Namespace.RowOpen);
+        }
+
+        [Fact]
+        public async Task AnXlsbChunkResumesInsideTheRowTheHeaderReadLeftOpen()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var ms = new MemoryStream();
+            await using (XlsbWorkbookWriter wb = XlsbWorkbookWriter.Create(ms, leaveOpen: true))
+            {
+                XlsbSheetWriter sheet = wb.AddSheet("S1");
+                for (int r = 0; r < 30; r++)
+                {
+                    await using XlsbRowWriter row = await sheet.StartRowAsync(ct);
+                    row.Write("n" + r.ToString(CultureInfo.InvariantCulture));
+                    row.Write(r);
+                }
+                await sheet.EndAsync(ct);
+                await wb.EndAsync(ct);
+            }
+            ms.Position = 0;
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+            var expected = new List<string>();
+            long dataStart;
+            bool rowOpen;
+            using (XlsbWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(0))
+            {
+                Assert.True(rows.MoveNext());
+                dataStart = rows.Offset;
+                rowOpen = rows.RowOpen;
+                while (rows.MoveNext())
+                {
+                    expected.Add(Render(rows.Current));
+                }
+            }
+            byte[] inflated;
+            using (Stream stream = workbook.OpenSheetStream(0))
+            using (var copy = new MemoryStream())
+            {
+                await stream.CopyToAsync(copy, ct);
+                inflated = copy.ToArray();
+            }
+
+            var actual = new List<string>();
+            using var chunk = new XlsbWorkbook.Enumerator(workbook, inflated.AsMemory((int)dataStart), rowOpen, CancellationToken.None);
+            while (chunk.MoveNext())
+            {
+                actual.Add(Render(chunk.Current));
+            }
+
+            Assert.True(rowOpen);
+            Assert.Equal(29, expected.Count);
+            Assert.Equal(expected, actual);
+        }
+    }
+}

From ddac3c831821eba2df2350cd2de2204cee512437 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 22:16:11 -0300
Subject: [PATCH 068/115] feat: cut an inflated sheet stream into row-aligned
 chunks

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Parser/SheetPipeline/ChunkProducer.cs     |  78 ++++++++++++
 .../Parser/SheetPipeline/RowCutter.cs         |  73 +++++++++++
 .../SheetPipeline/ChunkProducerTests.cs       | 119 ++++++++++++++++++
 3 files changed, 270 insertions(+)
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/ChunkProducer.cs
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
 create mode 100644 tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/ChunkProducer.cs b/src/ExcelReader.Core/Parser/SheetPipeline/ChunkProducer.cs
new file mode 100644
index 00000000..807342ad
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/ChunkProducer.cs
@@ -0,0 +1,78 @@
+using System.Buffers;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal readonly record struct SheetChunk(byte[] Buffer, int Length);
+
+    internal static class ChunkProducer
+    {
+        internal static async Task RunAsync(
+            Stream source, RowCutter cutter, int chunkBytes, int maxCellBytes, Func<SheetChunk, ValueTask> emit, CancellationToken ct)
+        {
+            byte[]? buffer = ArrayPool<byte>.Shared.Rent(chunkBytes);
+            int target = chunkBytes;
+            int filled = 0;
+            try
+            {
+                while (true)
+                {
+                    bool eof = false;
+                    while (filled < target)
+                    {
+                        int read = await source.ReadAsync(buffer.AsMemory(filled, target - filled), ct).ConfigureAwait(false);
+                        if (read == 0)
+                        {
+                            eof = true;
+                            break;
+                        }
+                        filled += read;
+                    }
+
+                    int cut = cutter.Cut(buffer.AsSpan(0, filled), out bool ended);
+                    if (ended || eof)
+                    {
+                        int length = ended ? cut : filled;
+                        if (length > 0)
+                        {
+                            byte[] last = buffer;
+                            buffer = null;
+                            await emit(new SheetChunk(last, length)).ConfigureAwait(false);
+                        }
+                        return;
+                    }
+                    if (cut < 0)
+                    {
+                        target = LimitChecks.NextBufferSize(maxCellBytes, nameof(ExcelReaderOptions.MaxCellBytes), target, target + 1);
+                        if (buffer.Length < target)
+                        {
+                            byte[] bigger = ArrayPool<byte>.Shared.Rent(target);
+                            buffer.AsSpan(0, filled).CopyTo(bigger);
+                            ArrayPool<byte>.Shared.Return(buffer);
+                            buffer = bigger;
+                        }
+                        continue;
+                    }
+
+                    int tail = filled - cut;
+                    byte[] next = ArrayPool<byte>.Shared.Rent(Math.Max(chunkBytes, tail));
+                    buffer.AsSpan(cut, tail).CopyTo(next);
+                    byte[] full = buffer;
+                    buffer = next;
+                    filled = tail;
+                    target = Math.Max(chunkBytes, tail);
+                    cutter.Rebase(cut);
+                    await emit(new SheetChunk(full, cut)).ConfigureAwait(false);
+                }
+            }
+            finally
+            {
+                if (buffer is not null)
+                {
+                    ArrayPool<byte>.Shared.Return(buffer);
+                }
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs b/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
new file mode 100644
index 00000000..0ac1e0d2
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
@@ -0,0 +1,73 @@
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal abstract class RowCutter
+    {
+        // The offset of the last row start past offset 0, or -1 when there is none yet. When `ended` is
+        // set, the sheet's rows end at the returned offset and nothing after it is to be read.
+        internal abstract int Cut(ReadOnlySpan<byte> data, out bool ended);
+
+        internal virtual void Rebase(int cut)
+        {
+        }
+    }
+
+    internal sealed class XlsxRowCutter(byte[] rowOpen) : RowCutter
+    {
+        internal override int Cut(ReadOnlySpan<byte> data, out bool ended)
+        {
+            ended = false;
+            ReadOnlySpan<byte> search = data;
+            while (true)
+            {
+                int at = search.LastIndexOf(rowOpen);
+                if (at <= 0)
+                {
+                    return -1;
+                }
+                int after = at + rowOpen.Length;
+                if (after < data.Length && XlsxWorkbook.Enumerator.IsBoundary(data[after]))
+                {
+                    return at;
+                }
+                search = search[..at];
+            }
+        }
+    }
+
+    internal sealed class XlsbRowCutter : RowCutter
+    {
+        private int _walked;
+        private int _lastRow = -1;
+
+        internal override int Cut(ReadOnlySpan<byte> data, out bool ended)
+        {
+            var reader = new Biff12RecordReader(data[_walked..]);
+            int before = 0;
+            while (reader.TryReadRecord(out int id, out _))
+            {
+                if (id == Brt.RowHdr)
+                {
+                    _lastRow = _walked + before;
+                }
+                else if (id == Brt.EndSheetData)
+                {
+                    ended = true;
+                    return _walked + reader.Position;
+                }
+                before = reader.Position;
+            }
+            _walked += reader.Position;
+            ended = false;
+            return _lastRow > 0 ? _lastRow : -1;
+        }
+
+        internal override void Rebase(int cut)
+        {
+            _walked -= cut;
+            _lastRow = -1;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs b/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs
new file mode 100644
index 00000000..dec1b32e
--- /dev/null
+++ b/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs
@@ -0,0 +1,119 @@
+using System.Buffers;
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Parser.SheetPipeline;
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Tests.Parser.SheetPipeline
+{
+    public class ChunkProducerTests
+    {
+        private static byte[] Sheet(int rows, int padding = 0)
+        {
+            var sb = new StringBuilder("<worksheet><sheetData>");
+            for (int r = 1; r <= rows; r++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c><v>{r}</v></c>{new string(' ', padding)}</row>");
+            }
+            return Encoding.UTF8.GetBytes(sb.Append("</sheetData></worksheet>").ToString());
+        }
+
+        private static async Task<List<byte[]>> ProduceAsync(byte[] input, int chunkBytes, int maxCellBytes = 0, RowCutter? cutter = null)
+        {
+            var chunks = new List<byte[]>();
+            await ChunkProducer.RunAsync(
+                new MemoryStream(input), cutter ?? new XlsxRowCutter("<row"u8.ToArray()), chunkBytes, maxCellBytes,
+                chunk =>
+                {
+                    chunks.Add(chunk.Buffer.AsSpan(0, chunk.Length).ToArray());
+                    ArrayPool<byte>.Shared.Return(chunk.Buffer);
+                    return ValueTask.CompletedTask;
+                },
+                TestContext.Current.CancellationToken);
+            return chunks;
+        }
+
+        [Theory]
+        [InlineData(64)]
+        [InlineData(100)]
+        [InlineData(4096)]
+        public async Task ChunksConcatenateToTheInputAndStartOnRows(int chunkBytes)
+        {
+            byte[] input = Sheet(200);
+
+            List<byte[]> chunks = await ProduceAsync(input, chunkBytes);
+
+            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.True(chunks.Count > 1);
+            Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
+        }
+
+        [Fact]
+        public async Task AnEmptyStreamProducesNothing()
+        {
+            Assert.Empty(await ProduceAsync([], 64));
+        }
+
+        [Fact]
+        public async Task ARowLongerThanTheChunkGrowsTheBuffer()
+        {
+            byte[] input = Sheet(5, padding: 500);
+
+            List<byte[]> chunks = await ProduceAsync(input, 64);
+
+            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
+        }
+
+        [Fact]
+        public async Task GrowthStopsAtMaxCellBytes()
+        {
+            byte[] input = Sheet(5, padding: 5000);
+
+            await Assert.ThrowsAsync<ExcelLimitExceededException>(() => ProduceAsync(input, 64, maxCellBytes: 1024));
+        }
+
+        [Fact]
+        public async Task ARowLikeNameIsNotACut()
+        {
+            byte[] input = Encoding.UTF8.GetBytes("<sheetData><row r=\"1\"><c><v>1</v></c></row><rowBreaks count=\"1\"/><rowBreaks count=\"2\"/><rowBreaks count=\"3\"/></sheetData>");
+
+            List<byte[]> chunks = await ProduceAsync(input, 48);
+
+            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
+        }
+
+        private static byte[] Record(int id, int payload)
+        {
+            byte[] record = new byte[2 + payload];
+            record[0] = (byte)id;
+            record[1] = (byte)payload;
+            return record;
+        }
+
+        [Fact]
+        public async Task XlsbChunksStartOnRowHeadersAndStopAtEndSheetData()
+        {
+            const int Cell = 7;
+            const int EndSheetData = 146;
+            var input = new List<byte>();
+            for (int r = 0; r < 40; r++)
+            {
+                input.AddRange(Record(0, 8));
+                input.AddRange(Record(Cell, 12));
+                input.AddRange(Record(Cell, 12));
+            }
+            byte[] end = [(byte)((EndSheetData & 0x7F) | 0x80), (byte)(EndSheetData >> 7), 0];
+            input.AddRange(end);
+            int dataLength = input.Count;
+            input.AddRange(Record(0, 8));
+
+            List<byte[]> chunks = await ProduceAsync([.. input], 96, cutter: new XlsbRowCutter());
+
+            Assert.Equal(input.Take(dataLength), chunks.SelectMany(c => c));
+            Assert.True(chunks.Count > 1);
+            Assert.All(chunks, chunk => Assert.Equal(0, chunk[0]));
+        }
+    }
+}

From c2ec1c12dd4dc85ebcb97518c0ef5d2de34cfb1a Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 22:22:08 -0300
Subject: [PATCH 069/115] fix: stop the XLSX chunk producer at the end of sheet
 data

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Parser/SheetPipeline/RowCutter.cs         | 14 ++++-
 .../SheetPipeline/ChunkProducerTests.cs       | 51 +++++++++++++++++--
 2 files changed, 60 insertions(+), 5 deletions(-)

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs b/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
index 0ac1e0d2..e3b24170 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/RowCutter.cs
@@ -14,11 +14,23 @@ internal virtual void Rebase(int cut)
         }
     }
 
-    internal sealed class XlsxRowCutter(byte[] rowOpen) : RowCutter
+    internal sealed class XlsxRowCutter(byte[] rowOpen, byte[] sheetDataEnd) : RowCutter
     {
         internal override int Cut(ReadOnlySpan<byte> data, out bool ended)
         {
+            int at = LastRowStart(data);
+            int end = data[Math.Max(at, 0)..].IndexOf(sheetDataEnd);
+            if (end >= 0)
+            {
+                ended = true;
+                return Math.Max(at, 0) + end + sheetDataEnd.Length;
+            }
             ended = false;
+            return at;
+        }
+
+        private int LastRowStart(ReadOnlySpan<byte> data)
+        {
             ReadOnlySpan<byte> search = data;
             while (true)
             {
diff --git a/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs b/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs
index dec1b32e..53681daf 100644
--- a/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs
+++ b/tests/ExcelReader.Tests/Parser/SheetPipeline/ChunkProducerTests.cs
@@ -18,11 +18,16 @@ private static byte[] Sheet(int rows, int padding = 0)
             return Encoding.UTF8.GetBytes(sb.Append("</sheetData></worksheet>").ToString());
         }
 
+        private static byte[] UpToSheetDataEnd(byte[] input, string token = "</sheetData")
+        {
+            return input[..(input.AsSpan().IndexOf(Encoding.UTF8.GetBytes(token)) + token.Length)];
+        }
+
         private static async Task<List<byte[]>> ProduceAsync(byte[] input, int chunkBytes, int maxCellBytes = 0, RowCutter? cutter = null)
         {
             var chunks = new List<byte[]>();
             await ChunkProducer.RunAsync(
-                new MemoryStream(input), cutter ?? new XlsxRowCutter("<row"u8.ToArray()), chunkBytes, maxCellBytes,
+                new MemoryStream(input), cutter ?? new XlsxRowCutter("<row"u8.ToArray(), "</sheetData"u8.ToArray()), chunkBytes, maxCellBytes,
                 chunk =>
                 {
                     chunks.Add(chunk.Buffer.AsSpan(0, chunk.Length).ToArray());
@@ -43,7 +48,7 @@ public async Task ChunksConcatenateToTheInputAndStartOnRows(int chunkBytes)
 
             List<byte[]> chunks = await ProduceAsync(input, chunkBytes);
 
-            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.Equal(UpToSheetDataEnd(input), chunks.SelectMany(c => c).ToArray());
             Assert.True(chunks.Count > 1);
             Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
         }
@@ -61,7 +66,7 @@ public async Task ARowLongerThanTheChunkGrowsTheBuffer()
 
             List<byte[]> chunks = await ProduceAsync(input, 64);
 
-            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.Equal(UpToSheetDataEnd(input), chunks.SelectMany(c => c).ToArray());
             Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
         }
 
@@ -80,10 +85,48 @@ public async Task ARowLikeNameIsNotACut()
 
             List<byte[]> chunks = await ProduceAsync(input, 48);
 
-            Assert.Equal(input, chunks.SelectMany(c => c).ToArray());
+            Assert.Equal(UpToSheetDataEnd(input), chunks.SelectMany(c => c).ToArray());
             Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
         }
 
+        [Fact]
+        public async Task AnXlsxTrailerAfterSheetDataIsNotBuffered()
+        {
+            string rows = Encoding.UTF8.GetString(Sheet(20))[..^"</worksheet>".Length];
+            byte[] input = Encoding.UTF8.GetBytes(rows + string.Concat(Enumerable.Repeat("<mergeCell ref=\"A1:B2\"/>", 3000)) + "</worksheet>");
+            Assert.True(input.Length > 50_000);
+
+            List<byte[]> chunks = await ProduceAsync(input, 64, maxCellBytes: 1024);
+
+            Assert.Equal(UpToSheetDataEnd(input), chunks.SelectMany(c => c).ToArray());
+        }
+
+        [Fact]
+        public async Task APrefixedSheetEndsAtItsPrefixedTag()
+        {
+            var sb = new StringBuilder("<x:worksheet><x:sheetData>");
+            for (int r = 1; r <= 20; r++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<x:row r=\"{r}\"><x:c><x:v>{r}</x:v></x:c></x:row>");
+            }
+            sb.Append("</x:sheetData>").Append(string.Concat(Enumerable.Repeat("<x:mergeCell ref=\"A1:B2\"/>", 3000))).Append("</x:worksheet>");
+            byte[] input = Encoding.UTF8.GetBytes(sb.ToString());
+            var chunks = new List<byte[]>();
+
+            await ChunkProducer.RunAsync(
+                new MemoryStream(input), new XlsxRowCutter("<x:row"u8.ToArray(), "</x:sheetData"u8.ToArray()), 64, 1024,
+                chunk =>
+                {
+                    chunks.Add(chunk.Buffer.AsSpan(0, chunk.Length).ToArray());
+                    ArrayPool<byte>.Shared.Return(chunk.Buffer);
+                    return ValueTask.CompletedTask;
+                },
+                TestContext.Current.CancellationToken);
+
+            Assert.Equal(UpToSheetDataEnd(input, "</x:sheetData"), chunks.SelectMany(c => c).ToArray());
+            Assert.All(chunks.Skip(1), chunk => Assert.StartsWith("<x:row ", Encoding.UTF8.GetString(chunk), StringComparison.Ordinal));
+        }
+
         private static byte[] Record(int id, int payload)
         {
             byte[] record = new byte[2 + payload];

From 8aa85e82100433a5428154790491f9ffcd7917d2 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 22:49:46 -0300
Subject: [PATCH 070/115] feat: add the sheet pipeline, reading XLSX rows on
 several threads

---
 .../SheetPipeline/SheetPipelineRunner.cs      | 173 ++++++++++++++
 .../SheetPipeline/SheetPipelineSource.cs      |  87 +++++++
 .../SheetPipeline/XlsxPipelineSource.cs       | 107 +++++++++
 .../Parser/SheetPipeline/XlsxPipelineTests.cs | 213 ++++++++++++++++++
 4 files changed, 580 insertions(+)
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/XlsxPipelineSource.cs
 create mode 100644 tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
new file mode 100644
index 00000000..1af580fa
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
@@ -0,0 +1,173 @@
+using System.Buffers;
+using System.Diagnostics.CodeAnalysis;
+using System.Runtime.CompilerServices;
+using System.Runtime.ExceptionServices;
+using System.Threading.Channels;
+using ExcelReader.Core.Parser.Internal;
+using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal static class SheetPipelineRunner
+    {
+        private readonly record struct Work<TState>(SheetChunk Chunk, bool First, TaskCompletionSource<ChunkOutcome<TState>> Done);
+
+        internal static async Task<TState> AggregateAsync<TState>(
+            SheetPipelineSource source, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory,
+            int headerRow, int dop, int chunkBytes, CancellationToken ct)
+        {
+            TState merged = default!;
+            bool any = false;
+            await foreach (TState state in RunAsync(source, aggregation, factory, headerRow, dop, chunkBytes, ct).ConfigureAwait(false))
+            {
+                merged = any ? aggregation.Combine(merged, state) : state;
+                any = true;
+            }
+            return any ? merged : aggregation.Seed();
+        }
+
+        internal static async IAsyncEnumerable<TState> RunAsync<TState>(
+            SheetPipelineSource source, RowAggregation<TState> aggregation, RowActionFactory<TState>? factory,
+            int headerRow, int dop, int chunkBytes, [EnumeratorCancellation] CancellationToken cancellationToken)
+        {
+            source.Lifetime.Acquire(source.Owner);
+            try
+            {
+                RowAction<TState>? bound = factory is not null && headerRow == 0 ? factory(default, sequential: false) : null;
+                PipelineStart? start = source.Begin(headerRow, factory is null || headerRow == 0 ? null : header => bound = factory(header, sequential: false));
+                if (start is null)
+                {
+                    yield break;
+                }
+                if (bound is not null)
+                {
+                    aggregation = new RowAggregation<TState> { Seed = aggregation.Seed, Accumulate = bound, Combine = aggregation.Combine };
+                }
+
+                using var cts = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken);
+                CancellationToken ct = cts.Token;
+                int workers = Math.Max(1, dop - 1);
+                var work = Channel.CreateBounded<Work<TState>>(workers * 2);
+                var ordered = Channel.CreateBounded<Task<ChunkOutcome<TState>>>(
+                    new BoundedChannelOptions(workers * 2) { SingleReader = true, SingleWriter = true });
+
+                var tasks = new Task[workers + 1];
+                tasks[0] = Task.Run(() => ProduceAsync(start, chunkBytes, source.MaxCellBytes, work.Writer, ordered.Writer, ct), CancellationToken.None);
+                for (int w = 1; w <= workers; w++)
+                {
+                    tasks[w] = Task.Run(() => WorkAsync(source, aggregation, work.Reader, ct), CancellationToken.None);
+                }
+
+                long rows = 0;
+                bool recover = false;
+                try
+                {
+                    await foreach (Task<ChunkOutcome<TState>> pending in ordered.Reader.ReadAllAsync(ct).ConfigureAwait(false))
+                    {
+                        ChunkOutcome<TState> outcome = await pending.WaitAsync(ct).ConfigureAwait(false);
+                        if (outcome.Failure is not null)
+                        {
+                            ThrowRenumbered(outcome.Failure, headerRow + rows);
+                        }
+                        rows += outcome.Rows;
+                        yield return outcome.State;
+                        if (!outcome.Clean)
+                        {
+                            recover = true;
+                            break;
+                        }
+                        if (outcome.ReachedEnd)
+                        {
+                            break;
+                        }
+                    }
+                    cancellationToken.ThrowIfCancellationRequested();
+                }
+                finally
+                {
+                    await cts.CancelAsync().ConfigureAwait(false);
+                    await Task.WhenAll(tasks).ConfigureAwait(ConfigureAwaitOptions.SuppressThrowing);
+                }
+
+                if (recover)
+                {
+                    yield return source.ParseTail(headerRow, rows, aggregation, cancellationToken);
+                }
+            }
+            finally
+            {
+                source.Lifetime.Release();
+            }
+        }
+
+        [SuppressMessage("Design", "CA1031:Do not catch general exception types",
+            Justification = "The exception is recorded and delivered to the merge through the ordered channel's completion.")]
+        private static async Task ProduceAsync<TState>(
+            PipelineStart start, int chunkBytes, int maxCellBytes, ChannelWriter<Work<TState>> work,
+            ChannelWriter<Task<ChunkOutcome<TState>>> ordered, CancellationToken ct)
+        {
+            Exception? failure = null;
+            try
+            {
+                bool first = true;
+                await ChunkProducer.RunAsync(
+                    start.Stream, start.Cutter, chunkBytes, maxCellBytes,
+                    async chunk =>
+                    {
+                        var done = new TaskCompletionSource<ChunkOutcome<TState>>(TaskCreationOptions.RunContinuationsAsynchronously);
+                        await ordered.WriteAsync(done.Task, ct).ConfigureAwait(false);
+                        await work.WriteAsync(new Work<TState>(chunk, first, done), ct).ConfigureAwait(false);
+                        first = false;
+                    },
+                    ct).ConfigureAwait(false);
+            }
+            catch (OperationCanceledException)
+            {
+            }
+            catch (Exception ex)
+            {
+                failure = ex;
+            }
+            finally
+            {
+                await start.Stream.DisposeAsync().ConfigureAwait(false);
+                work.Complete();
+                ordered.Complete(failure);
+            }
+        }
+
+        private static async Task WorkAsync<TState>(
+            SheetPipelineSource source, RowAggregation<TState> aggregation, ChannelReader<Work<TState>> work, CancellationToken ct)
+        {
+            await foreach (Work<TState> item in work.ReadAllAsync(ct).ConfigureAwait(false))
+            {
+                try
+                {
+                    item.Done.SetResult(source.ParseChunk(item.Chunk.Buffer.AsMemory(0, item.Chunk.Length), item.First, aggregation, ct));
+                }
+                catch (Exception ex)
+                {
+                    item.Done.TrySetException(ex);
+                    throw;
+                }
+                finally
+                {
+                    ArrayPool<byte>.Shared.Return(item.Chunk.Buffer);
+                }
+            }
+        }
+
+        private static void ThrowRenumbered(ExceptionDispatchInfo failure, long rowsBefore)
+        {
+            if (failure.SourceException is ExcelParseException { Row: > 0 } parse)
+            {
+                int row = (int)(rowsBefore + parse.Row);
+                throw parse.RawValue.Length == 0
+                    ? ProjectionRules.MissingRequiredValue(parse.ColumnName, row)
+                    : new ExcelParseException(row, parse.ColumnName, parse.RawValue);
+            }
+            failure.Throw();
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
new file mode 100644
index 00000000..f1f1731d
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
@@ -0,0 +1,87 @@
+using System.Buffers;
+using System.Runtime.ExceptionServices;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal delegate void HeaderVisitor(Row header);
+
+    internal sealed record PipelineStart(Stream Stream, RowCutter Cutter);
+
+    internal sealed class ChunkOutcome<TState>(TState state)
+    {
+        public TState State = state;
+        public long Rows;
+
+        // False when the chunk did not end between rows: its rows are valid, but what follows must be read sequentially.
+        public bool Clean = true;
+        public bool ReachedEnd;
+        public ExceptionDispatchInfo? Failure;
+    }
+
+    internal abstract class SheetPipelineSource
+    {
+        internal const long MinBytes = 256 * 1024;
+        internal const int DefaultChunkBytes = 1024 * 1024;
+        private protected const int RowsPerCancellationCheck = 4096;
+
+        internal abstract object Owner { get; }
+
+        internal abstract ReaderLifetime Lifetime { get; }
+
+        internal abstract int MaxCellBytes { get; }
+
+        internal abstract long UncompressedSize { get; }
+
+        // Null when the sheet ends at or before headerRow; otherwise the stream is positioned at the first data row.
+        internal abstract PipelineStart? Begin(int headerRow, HeaderVisitor? onHeader);
+
+        internal abstract ChunkOutcome<TState> ParseChunk<TState>(
+            ReadOnlyMemory<byte> chunk, bool first, RowAggregation<TState> aggregation, CancellationToken ct);
+
+        // Reads the sheet again from its start: skipRows counts data rows, after the header.
+        internal abstract TState ParseTail<TState>(int headerRow, long skipRows, RowAggregation<TState> aggregation, CancellationToken ct);
+
+        internal static SheetPipelineSource? Create(IExcelSheet sheet)
+        {
+            return sheet switch
+            {
+                XlsxSheet xlsx => new XlsxPipelineSource(xlsx.Owner, xlsx.Index),
+                _ => null,
+            };
+        }
+
+        internal static SheetPipelineSource? TryCreate(IExcelSheet sheet, int dop)
+        {
+            if (dop <= 1)
+            {
+                return null;
+            }
+            SheetPipelineSource? source = Create(sheet);
+            return source is not null && source.UncompressedSize >= MinBytes ? source : null;
+        }
+
+        private protected static void Skip(Stream stream, long count)
+        {
+            byte[] scratch = ArrayPool<byte>.Shared.Rent(64 * 1024);
+            try
+            {
+                while (count > 0)
+                {
+                    int read = stream.Read(scratch, 0, (int)Math.Min(count, scratch.Length));
+                    if (read == 0)
+                    {
+                        return;
+                    }
+                    count -= read;
+                }
+            }
+            finally
+            {
+                ArrayPool<byte>.Shared.Return(scratch);
+            }
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/XlsxPipelineSource.cs b/src/ExcelReader.Core/Parser/SheetPipeline/XlsxPipelineSource.cs
new file mode 100644
index 00000000..ef852c05
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/XlsxPipelineSource.cs
@@ -0,0 +1,107 @@
+using System.Runtime.ExceptionServices;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal sealed class XlsxPipelineSource(XlsxWorkbook workbook, int index) : SheetPipelineSource
+    {
+        private NsTokens? _ns;
+
+        internal override object Owner => workbook;
+
+        internal override ReaderLifetime Lifetime => workbook.Lifetime;
+
+        internal override int MaxCellBytes => workbook.MaxCellBytes;
+
+        internal override long UncompressedSize => workbook.SheetUncompressedSize(index);
+
+        internal override PipelineStart? Begin(int headerRow, HeaderVisitor? onHeader)
+        {
+            long offset;
+            using (XlsxWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(index))
+            {
+                _ns = rows.Namespace;
+                for (int row = 1; row <= headerRow; row++)
+                {
+                    if (!rows.MoveNext())
+                    {
+                        return null;
+                    }
+                    if (row == headerRow)
+                    {
+                        onHeader?.Invoke(rows.Current);
+                    }
+                }
+                offset = rows.Offset;
+            }
+
+            Stream stream = workbook.OpenSheetStream(index);
+            try
+            {
+                Skip(stream, offset);
+            }
+            catch
+            {
+                stream.Dispose();
+                throw;
+            }
+            return new PipelineStart(stream, new XlsxRowCutter(_ns?.RowOpen ?? "<row"u8.ToArray(), _ns?.SheetDataEnd ?? "</sheetData"u8.ToArray()));
+        }
+
+        internal override ChunkOutcome<TState> ParseChunk<TState>(
+            ReadOnlyMemory<byte> chunk, bool first, RowAggregation<TState> aggregation, CancellationToken ct)
+        {
+            var outcome = new ChunkOutcome<TState>(aggregation.Seed());
+            var rows = new XlsxWorkbook.Enumerator(workbook, chunk, _ns, ct);
+            try
+            {
+                RowAction<TState> accumulate = aggregation.Accumulate;
+                while (rows.MoveNext() && !rows.EndedMidMarkup)
+                {
+                    if (++outcome.Rows % RowsPerCancellationCheck == 0)
+                    {
+                        ct.ThrowIfCancellationRequested();
+                    }
+                    accumulate(ref outcome.State, rows.Current);
+                }
+                outcome.Clean = !rows.EndedMidMarkup;
+                outcome.ReachedEnd = rows.ReachedEnd;
+            }
+            catch (Exception ex) when (ex is not OperationCanceledException)
+            {
+                outcome.Failure = ExceptionDispatchInfo.Capture(ex);
+            }
+            finally
+            {
+                rows.Dispose();
+            }
+            return outcome;
+        }
+
+        internal override TState ParseTail<TState>(int headerRow, long skipRows, RowAggregation<TState> aggregation, CancellationToken ct)
+        {
+            TState state = aggregation.Seed();
+            using XlsxWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(index);
+            for (long skipped = 0; skipped < headerRow + skipRows; skipped++)
+            {
+                if (!rows.MoveNext())
+                {
+                    return state;
+                }
+            }
+            RowAction<TState> accumulate = aggregation.Accumulate;
+            long delivered = 0;
+            while (rows.MoveNext())
+            {
+                if (++delivered % RowsPerCancellationCheck == 0)
+                {
+                    ct.ThrowIfCancellationRequested();
+                }
+                accumulate(ref state, rows.Current);
+            }
+            return state;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs
new file mode 100644
index 00000000..45e949b6
--- /dev/null
+++ b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs
@@ -0,0 +1,213 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Parser.SheetPipeline;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Tests.Parser.SheetPipeline
+{
+    public class XlsxPipelineTests
+    {
+        private static readonly RowAggregation<List<string>> Collecting = new()
+        {
+            Seed = static () => [],
+            Accumulate = static (ref List<string> rows, Row row) => rows.Add(Render(row)),
+            Combine = static (left, right) =>
+            {
+                left.AddRange(right);
+                return left;
+            },
+        };
+
+        private static string Render(Row row)
+        {
+            var sb = new StringBuilder();
+            foreach (RowCell cell in row.Cells)
+            {
+                sb.Append(cell.ColumnIndex).Append(':').Append(cell.Value.GetString()).Append('|');
+            }
+            return sb.ToString();
+        }
+
+        private static string Rows(int count, Func<int, string>? text = null)
+        {
+            var sb = new StringBuilder();
+            for (int r = 1; r <= count; r++)
+            {
+                string value = text?.Invoke(r) ?? string.Create(CultureInfo.InvariantCulture, $"n{r}");
+                sb.Append(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c r=\"A{r}\" t=\"inlineStr\"><is><t>{value}</t></is></c><c r=\"B{r}\"><v>{r}</v></c></row>");
+            }
+            return sb.ToString();
+        }
+
+        private static List<string> Sequential(XlsxWorkbook workbook, int headerRow)
+        {
+            var rows = new List<string>();
+            foreach (Row row in workbook.FirstSheet)
+            {
+                rows.Add(Render(row));
+            }
+            return rows.Count > headerRow ? rows[headerRow..] : [];
+        }
+
+        private static Task<List<string>> PipelineAsync(XlsxWorkbook workbook, int headerRow, int dop, int chunkBytes, RowActionFactory<List<string>>? factory = null)
+        {
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+            return SheetPipelineRunner.AggregateAsync(source, Collecting, factory, headerRow, dop, chunkBytes, TestContext.Current.CancellationToken);
+        }
+
+        public static TheoryData<int, int> Shapes()
+        {
+            var data = new TheoryData<int, int>();
+            foreach (int dop in new[] { 2, 4, 8 })
+            {
+                foreach (int chunk in new[] { 64, 200, 1000, 1 << 20 })
+                {
+                    data.Add(dop, chunk);
+                }
+            }
+            return data;
+        }
+
+        [Theory]
+        [MemberData(nameof(Shapes))]
+        public async Task MatchesSequential(int dop, int chunkBytes)
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(500));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Equal(Sequential(workbook, 0), await PipelineAsync(workbook, 0, dop, chunkBytes));
+            Assert.Equal(Sequential(workbook, 1), await PipelineAsync(workbook, 1, dop, chunkBytes));
+            Assert.Equal(Sequential(workbook, 3), await PipelineAsync(workbook, 3, dop, chunkBytes));
+        }
+
+        [Theory]
+        [InlineData("")]
+        [InlineData("<row r=\"1\"><c r=\"A1\"><v>1</v></c></row>")]
+        public async Task ShortSheetsYieldNothing(string rows)
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(rows);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Empty(await PipelineAsync(workbook, 1, 4, 64));
+            Assert.Empty(await PipelineAsync(workbook, 5, 4, 64));
+        }
+
+        [Fact]
+        public async Task TheHeaderRowReachesTheFactoryOnce()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(300));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            int calls = 0;
+            string? header = null;
+            RowActionFactory<List<string>> factory = (Row row, bool sequential) =>
+            {
+                Interlocked.Increment(ref calls);
+                header = Render(row);
+                Assert.False(sequential);
+                return Collecting.Accumulate;
+            };
+
+            List<string> rows = await PipelineAsync(workbook, 2, 4, 128, factory);
+
+            Assert.Equal(1, calls);
+            Assert.Equal(Sequential(workbook, 0)[1], header);
+            Assert.Equal(Sequential(workbook, 2), rows);
+        }
+
+        [Fact]
+        public async Task APrefixedSheetMatchesSequential()
+        {
+            var sb = new StringBuilder();
+            for (int r = 1; r <= 200; r++)
+            {
+                sb.Append(CultureInfo.InvariantCulture, $"<x:row r=\"{r}\"><x:c r=\"A{r}\"><x:v>{r}</x:v></x:c></x:row>");
+            }
+            using MemoryStream ms = WorkbookBuilder.BuildPrefixed("x", sb.ToString());
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+
+            Assert.Equal(Sequential(workbook, 0), await PipelineAsync(workbook, 0, 4, 96));
+        }
+
+        [Theory]
+        [InlineData("<![CDATA[ <row r=\"9\"> ]]>")]
+        [InlineData("</t></is></c><!-- <row r=\"9\"> --><c t=\"inlineStr\"><is><t>z")]
+        public async Task ARowLikeTagInsideARowMatchesSequential(string poison)
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(120, r => r % 10 == 0 ? poison : "n"));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            List<string> expected = Sequential(workbook, 0);
+
+            foreach (int chunkBytes in new[] { 64, 90, 150, 400 })
+            {
+                Assert.Equal(expected, await PipelineAsync(workbook, 0, 4, chunkBytes));
+                Assert.Equal(expected[1..], await PipelineAsync(workbook, 1, 4, chunkBytes));
+            }
+        }
+
+        [Fact]
+        public async Task RowsAfterTheEndOfSheetDataAreIgnored()
+        {
+            string rows = Rows(60) + "</sheetData><extLst>" + Rows(60) + "</extLst><sheetData>";
+            using MemoryStream ms = WorkbookBuilder.Build(rows);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            List<string> expected = Sequential(workbook, 0);
+
+            Assert.Equal(60, expected.Count);
+            Assert.Equal(expected, await PipelineAsync(workbook, 0, 4, 80));
+        }
+
+        [Fact]
+        public async Task AnAccumulateExceptionSurfaces()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(300));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            var failing = new RowAggregation<int>
+            {
+                Seed = static () => 0,
+                Accumulate = static (ref int count, Row row) =>
+                {
+                    if (row[1].TryGetDouble(out double value) && value == 150)
+                    {
+                        throw new InvalidOperationException("boom");
+                    }
+                    count++;
+                },
+                Combine = static (left, right) => left + right,
+            };
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            InvalidOperationException ex = await Assert.ThrowsAsync<InvalidOperationException>(
+                () => SheetPipelineRunner.AggregateAsync(source, failing, null, 0, 4, 128, TestContext.Current.CancellationToken));
+
+            Assert.Equal("boom", ex.Message);
+        }
+
+        [Fact]
+        public async Task CancellationStopsTheRead()
+        {
+            using MemoryStream ms = WorkbookBuilder.Build(Rows(2000));
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            using var cts = CancellationTokenSource.CreateLinkedTokenSource(TestContext.Current.CancellationToken);
+            int seen = 0;
+            var cancelling = new RowAggregation<int>
+            {
+                Seed = static () => 0,
+                Accumulate = (ref int count, Row _) =>
+                {
+                    count++;
+                    if (Interlocked.Increment(ref seen) == 5)
+                    {
+                        cts.Cancel();
+                    }
+                },
+                Combine = static (left, right) => left + right,
+            };
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            await Assert.ThrowsAnyAsync<OperationCanceledException>(
+                () => SheetPipelineRunner.AggregateAsync(source, cancelling, null, 0, 4, 64, cts.Token));
+        }
+    }
+}

From 5b3d75506a8caed786e93125fbececa136fe3cda Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:03:01 -0300
Subject: [PATCH 071/115] feat: read XLSX sheets in parallel through
 SheetParallel

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../SheetPipeline/SheetRowProjection.cs       |  60 ++++
 .../Parser/SheetPipeline/SheetRunner.cs       |  12 +
 .../Parser/SheetParallelXlsxTests.cs          | 298 ++++++++++++++++++
 3 files changed, 370 insertions(+)
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
 create mode 100644 tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
new file mode 100644
index 00000000..0bab5264
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
@@ -0,0 +1,60 @@
+using System.Runtime.CompilerServices;
+using ExcelReader.Core.Parser.Internal;
+using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Reader;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal static class SheetRowProjection<T>
+    {
+        internal sealed class Chunk
+        {
+            public readonly List<T> Items = [];
+            public int Rows;
+            public bool[]? Seen;
+        }
+
+        private static readonly RowAggregation<Chunk> Unbound = new()
+        {
+            Seed = static () => new Chunk(),
+            Accumulate = static (ref _, _) => throw new InvalidOperationException("The model map was not bound before the first row."),
+            Combine = static (left, _) => left,
+        };
+
+        internal static async IAsyncEnumerable<T> ParseAsync(
+            SheetPipelineSource source, ExcelParser<T> parser, bool isDate1904, int dop, int chunkBytes, [EnumeratorCancellation] CancellationToken ct)
+        {
+            TypeMapInfo<T> info = parser.Info;
+            int headerRow = info.IsIndexBased ? 0 : parser.Config.HeaderRow;
+            await foreach (Chunk chunk in SheetPipelineRunner.RunAsync(source, Unbound, Binder(parser, info, isDate1904), headerRow, dop, chunkBytes, ct).ConfigureAwait(false))
+            {
+                foreach (T item in chunk.Items)
+                {
+                    yield return item;
+                }
+            }
+        }
+
+        private static RowActionFactory<Chunk> Binder(ExcelParser<T> parser, TypeMapInfo<T> info, bool isDate1904)
+        {
+            return (Row header, bool _) =>
+            {
+                ExcelParserConfig config = parser.Config;
+                ColumnBinding<T>[] bindings = info.IsIndexBased
+                    ? info.IndexBindings
+                    : SparseRowProjection.BuildColumnMap(in header, info, config.ColumnNameComparer, config.HeaderNormalization, out int _);
+                bool track = bindings.Any(static binding => binding.RequireValue);
+                IFormatProvider provider = config.Culture;
+                bool throwOnParseFailure = config.ThrowOnParseFailure;
+                return (ref Chunk chunk, Row row) =>
+                {
+                    int rowInChunk = ++chunk.Rows;
+                    T model = info.CreateInstance();
+                    Span<bool> seen = track ? (chunk.Seen ??= new bool[bindings.Length]) : default;
+                    SparseRowProjection.ParseRow(in row, bindings, seen, track, isDate1904, provider, throwOnParseFailure, rowInChunk, ref model);
+                    chunk.Items.Add(model);
+                };
+            };
+        }
+    }
+}
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
index 2e555b1c..13a8a390 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRunner.cs
@@ -19,6 +19,12 @@ internal static Task<TState> RunAsync<TState>(
             {
                 return ParallelCsvProcessor.RunAsync(csv.Reader, aggregation, factory, options, ct);
             }
+            int dop = ParallelCsvFactory.Normalize(options.DegreeOfParallelism);
+            SheetPipelineSource? pipeline = SheetPipelineSource.TryCreate(sheet, dop);
+            if (pipeline is not null)
+            {
+                return SheetPipelineRunner.AggregateAsync(pipeline, aggregation, factory, options.HeaderRow, dop, SheetPipelineSource.DefaultChunkBytes, ct);
+            }
             return SequentialAsync(sheet, aggregation, factory, options.HeaderRow, ct);
         }
 
@@ -28,6 +34,12 @@ internal static IAsyncEnumerable<T> Parse<T>(IExcelSheet sheet, ExcelParser<T> p
             {
                 return ParallelCsvFactory.Create(csv.Reader, degreeOfParallelism, parser, ct);
             }
+            int dop = ParallelCsvFactory.Normalize(degreeOfParallelism);
+            SheetPipelineSource? pipeline = SheetPipelineSource.TryCreate(sheet, dop);
+            if (pipeline is not null)
+            {
+                return SheetRowProjection<T>.ParseAsync(pipeline, parser, sheet.IsDate1904, dop, SheetPipelineSource.DefaultChunkBytes, ct);
+            }
             return Sequential(sheet, parser, ct);
         }
 
diff --git a/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
new file mode 100644
index 00000000..6f1f7fc7
--- /dev/null
+++ b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
@@ -0,0 +1,298 @@
+using System.Collections.Concurrent;
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Parser.SheetPipeline;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Tests.Parser
+{
+    public class SheetParallelXlsxTests
+    {
+        private sealed class Sale
+        {
+            [ExcelColumn("Name")]
+            public string? Name { get; set; }
+
+            [ExcelColumn("Qty")]
+            public int Qty { get; set; }
+
+            [ExcelColumn("Day")]
+            public DateTime Day { get; set; }
+        }
+
+        private readonly struct NameOnly : IRowRecord<NameOnly>
+        {
+            public string Name { get; init; }
+
+            public static bool TryParse(Row row, out NameOnly record)
+            {
+                record = new NameOnly { Name = row[0].GetString() };
+                return true;
+            }
+        }
+
+        private sealed class Names : IRowAccumulator<Names, NameOnly>, IRowAccumulator<Names, Sale>
+        {
+            public List<string?> Items { get; } = [];
+
+            public void Add(NameOnly model)
+            {
+                Items.Add(model.Name);
+            }
+
+            public void Add(Sale model)
+            {
+                Items.Add(model.Name);
+            }
+
+            public void Merge(Names following)
+            {
+                Items.AddRange(following.Items);
+            }
+        }
+
+        private static async Task<MemoryStream> BuildAsync(int rows)
+        {
+            object?[][] data = new object?[rows + 1][];
+            data[0] = ["Name", "Qty", "Day"];
+            for (int i = 0; i < rows; i++)
+            {
+                data[i + 1] = [string.Create(CultureInfo.InvariantCulture, $"item{i:D6}"), i, new DateTime(2024, 1, 1).AddDays(i % 400)];
+            }
+            return await TypedWorkbook.BuildAsync(data);
+        }
+
+        private static IEnumerable<(string?, int, DateTime)> Keys(IEnumerable<Sale> sales)
+        {
+            return sales.Select(s => (s.Name, s.Qty, s.Day));
+        }
+
+        [Theory]
+        [InlineData(2)]
+        [InlineData(4)]
+        [InlineData(8)]
+        [InlineData(0)]
+        public async Task EveryFamilyMatchesSequential(int dop)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(30_000);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            Assert.NotNull(SheetPipelineSource.TryCreate(workbook.FirstSheet, 2));
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+            List<Sale> expected = [.. parser.Parse(workbook.FirstSheet)];
+            var withHeader = new SheetParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 };
+
+            var parsed = new List<Sale>();
+            await foreach (Sale sale in SheetParallel.ParseAsync(workbook.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = dop }, ct))
+            {
+                parsed.Add(sale);
+            }
+            Assert.Equal(Keys(expected), Keys(parsed));
+
+            Names byRecord = await SheetParallel.AggregateAsync<Names, NameOnly>(workbook.FirstSheet, withHeader, ct);
+            Assert.Equal(expected.Select(s => s.Name), byRecord.Items, StringComparer.Ordinal);
+
+            Names byModel = await SheetParallel.AggregateAsync<Names, Sale>(workbook.FirstSheet, parser, withHeader, ct);
+            Assert.Equal(expected.Select(s => s.Name), byModel.Items, StringComparer.Ordinal);
+
+            var each = new ConcurrentBag<(string?, int, DateTime)>();
+            await SheetParallel.ForEachAsync(workbook.FirstSheet, parser, (Sale s) => each.Add((s.Name, s.Qty, s.Day)), withHeader, ct);
+            Assert.Equal(Keys(expected).Order(), each.Order());
+
+            var eachRecord = new ConcurrentBag<string>();
+            await SheetParallel.ForEachAsync<NameOnly>(workbook.FirstSheet, r => eachRecord.Add(r.Name), withHeader, ct);
+            Assert.Equal(expected.Select(s => s.Name).Order(StringComparer.Ordinal), eachRecord.Order(StringComparer.Ordinal));
+        }
+
+        [Fact]
+        public async Task ParseAtSmallChunksMatchesSequentialIncludingEmptyRows()
+        {
+            var sb = new StringBuilder("<row r=\"1\"><c r=\"A1\" t=\"inlineStr\"><is><t>Name</t></is></c><c r=\"B1\" t=\"inlineStr\"><is><t>Qty</t></is></c></row>");
+            for (int r = 2; r <= 400; r++)
+            {
+                sb.Append(r % 7 == 0
+                    ? string.Create(CultureInfo.InvariantCulture, $"<row r=\"{r}\"/>")
+                    : string.Create(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c r=\"A{r}\" t=\"inlineStr\"><is><t>n{r}</t></is></c><c r=\"B{r}\"><v>{r}</v></c></row>"));
+            }
+            using MemoryStream ms = WorkbookBuilder.Build(sb.ToString());
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+            List<Sale> expected = [.. parser.Parse(workbook.FirstSheet)];
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            var actual = new List<Sale>();
+            await foreach (Sale sale in SheetRowProjection<Sale>.ParseAsync(source, parser, isDate1904: false, 4, 96, TestContext.Current.CancellationToken))
+            {
+                actual.Add(sale);
+            }
+
+            Assert.Equal(399, expected.Count);
+            Assert.Equal(Keys(expected), Keys(actual));
+        }
+
+        [Fact]
+        public async Task AParseFailureReportsTheSheetRow()
+        {
+            var sb = new StringBuilder("<row r=\"1\"><c r=\"A1\" t=\"inlineStr\"><is><t>Name</t></is></c><c r=\"B1\" t=\"inlineStr\"><is><t>Qty</t></is></c></row>");
+            for (int r = 2; r <= 300; r++)
+            {
+                string qty = r == 211 ? "<c r=\"B211\" t=\"inlineStr\"><is><t>oops</t></is></c>" : string.Create(CultureInfo.InvariantCulture, $"<c r=\"B{r}\"><v>{r}</v></c>");
+                sb.Append(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c r=\"A{r}\" t=\"inlineStr\"><is><t>n{r}</t></is></c>{qty}</row>");
+            }
+            using MemoryStream ms = WorkbookBuilder.Build(sb.ToString());
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParseException sequential = Assert.Throws<ExcelParseException>(() => parser.Parse(workbook.FirstSheet).ToList());
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            ExcelParseException parallel = await Assert.ThrowsAsync<ExcelParseException>(async () =>
+            {
+                await foreach (Sale _ in SheetRowProjection<Sale>.ParseAsync(source, parser, isDate1904: false, 4, 128, TestContext.Current.CancellationToken))
+                {
+                }
+            });
+
+            Assert.Equal(211, sequential.Row);
+            Assert.Equal(sequential.Row, parallel.Row);
+            Assert.Equal(sequential.ColumnName, parallel.ColumnName);
+        }
+
+        [Fact]
+        public async Task ACallbackExceptionReachesTheCaller()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(30_000);
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+
+            InvalidOperationException ex = await Assert.ThrowsAsync<InvalidOperationException>(() => SheetParallel.ForEachAsync(
+                workbook.FirstSheet, parser,
+                (Sale s) =>
+                {
+                    if (s.Qty == 12_345)
+                    {
+                        throw new InvalidOperationException("boom");
+                    }
+                },
+                new SheetParallelOptions { DegreeOfParallelism = 4, HeaderRow = 1 }, ct));
+
+            Assert.Equal("boom", ex.Message);
+        }
+
+        [Fact]
+        public async Task LeavingTheEnumerationEarlyStopsThePipeline()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var tracked = new TrackingStream();
+            using (MemoryStream built = await BuildAsync(30_000))
+            {
+                await built.CopyToAsync(tracked, ct);
+            }
+            tracked.Position = 0;
+            XlsxWorkbook workbook = Excel.FromXlsx(tracked, leaveOpen: false);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+
+            await foreach (Sale _ in SheetParallel.ParseAsync(workbook.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct))
+            {
+                break;
+            }
+            workbook.Dispose();
+
+            Assert.True(tracked.Disposed);
+        }
+
+        [Fact]
+        public async Task DisposingTheWorkbookMidReadIsSafe()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(30_000);
+            XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+            IExcelSheet sheet = workbook.FirstSheet;
+            List<Sale> expected = [.. parser.Parse(workbook.FirstSheet)];
+
+            var actual = new List<Sale>();
+            await foreach (Sale sale in SheetParallel.ParseAsync(sheet, parser, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct))
+            {
+                actual.Add(sale);
+                if (actual.Count == 1)
+                {
+                    workbook.Dispose();
+                }
+            }
+            Assert.Equal(Keys(expected), Keys(actual));
+
+            await Assert.ThrowsAsync<ObjectDisposedException>(async () =>
+            {
+                await foreach (Sale _ in SheetParallel.ParseAsync(sheet, parser, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct))
+                {
+                }
+            });
+        }
+
+        private static readonly RowAggregation<int> Counting = new()
+        {
+            Seed = static () => 0,
+            Accumulate = static (ref int count, Row _) => count++,
+            Combine = static (left, right) => left + right,
+        };
+
+        private static string Outcome(Func<int> read)
+        {
+            try
+            {
+                return string.Create(CultureInfo.InvariantCulture, $"rows={read()}");
+            }
+            catch (Exception ex) when (ex is InvalidDataException or ExcelLimitExceededException)
+            {
+                return ex.GetType().Name;
+            }
+        }
+
+        private static int CountSequentially(XlsxWorkbook workbook)
+        {
+            int count = 0;
+            foreach (Row _ in workbook.FirstSheet)
+            {
+                count++;
+            }
+            return count;
+        }
+
+        [Fact]
+        public async Task ACorruptSheetEntryEndsLikeTheSequentialRead()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(30_000);
+            byte[] bytes = ms.ToArray();
+            int entry = bytes.AsSpan().IndexOf("xl/worksheets/sheet1.xml"u8);
+            Array.Fill(bytes, (byte)0xFF, entry + 300_000, 512);
+            using XlsxWorkbook sequentialWorkbook = Excel.FromXlsx(bytes);
+            using XlsxWorkbook parallelWorkbook = Excel.FromXlsx(bytes);
+            var options = new SheetParallelOptions { DegreeOfParallelism = 4 };
+
+            string sequential = Outcome(() => CountSequentially(sequentialWorkbook));
+            string parallel = Outcome(() => SheetParallel.AggregateAsync(parallelWorkbook.FirstSheet, Counting, options, ct).GetAwaiter().GetResult());
+
+            Assert.Equal(sequential, parallel);
+            Assert.Equal(nameof(InvalidDataException), sequential);
+        }
+
+        [Fact]
+        public async Task ExceedingTheDecompressedLimitMidSheetThrows()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(30_000);
+            byte[] bytes = ms.ToArray();
+            var limits = new ExcelReaderOptions { MaxTotalDecompressedBytes = 600 * 1024 };
+            using XlsxWorkbook sequentialWorkbook = Excel.FromXlsx(bytes, limits);
+            using XlsxWorkbook parallelWorkbook = Excel.FromXlsx(bytes, limits);
+
+            Assert.Throws<ExcelLimitExceededException>(() => CountSequentially(sequentialWorkbook));
+            await Assert.ThrowsAsync<ExcelLimitExceededException>(
+                () => SheetParallel.AggregateAsync(parallelWorkbook.FirstSheet, Counting, new SheetParallelOptions { DegreeOfParallelism = 4 }, ct));
+        }
+    }
+}

From 6749b9eb3027adbf8d5c64c7bcd11d352431cba2 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:08:30 -0300
Subject: [PATCH 072/115] fix: report the sheet row for a parse failure after
 pipeline recovery

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../SheetPipeline/SheetPipelineRunner.cs      | 11 ++++++-
 .../Parser/SheetParallelXlsxTests.cs          | 30 +++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
index 1af580fa..88413e03 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
@@ -92,7 +92,16 @@ internal static async IAsyncEnumerable<TState> RunAsync<TState>(
 
                 if (recover)
                 {
-                    yield return source.ParseTail(headerRow, rows, aggregation, cancellationToken);
+                    TState tail = default!;
+                    try
+                    {
+                        tail = source.ParseTail(headerRow, rows, aggregation, cancellationToken);
+                    }
+                    catch (ExcelParseException ex)
+                    {
+                        ThrowRenumbered(ExceptionDispatchInfo.Capture(ex), headerRow + rows);
+                    }
+                    yield return tail;
                 }
             }
             finally
diff --git a/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
index 6f1f7fc7..e3f8a859 100644
--- a/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
+++ b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
@@ -159,6 +159,36 @@ public async Task AParseFailureReportsTheSheetRow()
             Assert.Equal(sequential.ColumnName, parallel.ColumnName);
         }
 
+        [Fact]
+        public async Task AParseFailureAfterPipelineRecoveryReportsTheSheetRow()
+        {
+            var sb = new StringBuilder("<row r=\"1\"><c r=\"A1\" t=\"inlineStr\"><is><t>Name</t></is></c><c r=\"B1\" t=\"inlineStr\"><is><t>Qty</t></is></c></row>");
+            for (int r = 2; r <= 300; r++)
+            {
+                string name = r == 20 ? "<![CDATA[ <row r=\"9\"> ]]>" : string.Create(CultureInfo.InvariantCulture, $"n{r}");
+                string qty = r == 211 ? "<c r=\"B211\" t=\"inlineStr\"><is><t>oops</t></is></c>" : string.Create(CultureInfo.InvariantCulture, $"<c r=\"B{r}\"><v>{r}</v></c>");
+                sb.Append(CultureInfo.InvariantCulture, $"<row r=\"{r}\"><c r=\"A{r}\" t=\"inlineStr\"><is><t>{name}</t></is></c>{qty}</row>");
+            }
+            using MemoryStream ms = WorkbookBuilder.Build(sb.ToString());
+            using XlsxWorkbook workbook = Excel.FromXlsx(ms);
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParseException sequential = Assert.Throws<ExcelParseException>(() => parser.Parse(workbook.FirstSheet).ToList());
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+            Assert.Equal(211, sequential.Row);
+
+            foreach (int chunkBytes in new[] { 64, 90, 96, 150, 400 })
+            {
+                ExcelParseException parallel = await Assert.ThrowsAsync<ExcelParseException>(async () =>
+                {
+                    await foreach (Sale _ in SheetRowProjection<Sale>.ParseAsync(source, parser, isDate1904: false, 4, chunkBytes, TestContext.Current.CancellationToken))
+                    {
+                    }
+                });
+                Assert.Equal(sequential.Row, parallel.Row);
+                Assert.Equal(sequential.ColumnName, parallel.ColumnName);
+            }
+        }
+
         [Fact]
         public async Task ACallbackExceptionReachesTheCaller()
         {

From 04e084c81356138bb9a3f764211e4173bd867c85 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:16:24 -0300
Subject: [PATCH 073/115] feat: read XLSB sheets in parallel through
 SheetParallel

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../SheetPipeline/SheetPipelineSource.cs      |   2 +
 .../SheetPipeline/XlsbPipelineSource.cs       |  90 +++++++++++
 .../Parser/SheetPipeline/XlsbPipelineTests.cs | 140 ++++++++++++++++++
 3 files changed, 232 insertions(+)
 create mode 100644 src/ExcelReader.Core/Parser/SheetPipeline/XlsbPipelineSource.cs
 create mode 100644 tests/ExcelReader.Tests/Parser/SheetPipeline/XlsbPipelineTests.cs

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
index f1f1731d..74f0b081 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
@@ -2,6 +2,7 @@
 using System.Runtime.ExceptionServices;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsb;
 using ExcelReader.Core.Reader.Xlsx;
 
 namespace ExcelReader.Core.Parser.SheetPipeline
@@ -49,6 +50,7 @@ internal abstract ChunkOutcome<TState> ParseChunk<TState>(
             return sheet switch
             {
                 XlsxSheet xlsx => new XlsxPipelineSource(xlsx.Owner, xlsx.Index),
+                XlsbSheet xlsb => new XlsbPipelineSource(xlsb.Owner, xlsb.Index),
                 _ => null,
             };
         }
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/XlsbPipelineSource.cs b/src/ExcelReader.Core/Parser/SheetPipeline/XlsbPipelineSource.cs
new file mode 100644
index 00000000..217efc3b
--- /dev/null
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/XlsbPipelineSource.cs
@@ -0,0 +1,90 @@
+using System.Runtime.ExceptionServices;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Internal;
+using ExcelReader.Core.Reader.Xlsb;
+
+namespace ExcelReader.Core.Parser.SheetPipeline
+{
+    internal sealed class XlsbPipelineSource(XlsbWorkbook workbook, int index) : SheetPipelineSource
+    {
+        private bool _rowOpen;
+
+        internal override object Owner => workbook;
+
+        internal override ReaderLifetime Lifetime => workbook.Lifetime;
+
+        internal override int MaxCellBytes => workbook.MaxCellBytes;
+
+        internal override long UncompressedSize => workbook.SheetUncompressedSize(index);
+
+        internal override PipelineStart? Begin(int headerRow, HeaderVisitor? onHeader)
+        {
+            long offset;
+            using (XlsbWorkbook.Enumerator rows = workbook.OpenSheetWithoutPrefetch(index))
+            {
+                for (int row = 1; row <= headerRow; row++)
+                {
+                    if (!rows.MoveNext())
+                    {
+                        return null;
+                    }
+                    if (row == headerRow)
+                    {
+                        onHeader?.Invoke(rows.Current);
+                    }
+                }
+                if (rows.Ended)
+                {
+                    return null;
+                }
+                _rowOpen = rows.RowOpen;
+                offset = rows.Offset;
+            }
+
+            Stream stream = workbook.OpenSheetStream(index);
+            try
+            {
+                Skip(stream, offset);
+            }
+            catch
+            {
+                stream.Dispose();
+                throw;
+            }
+            return new PipelineStart(stream, new XlsbRowCutter());
+        }
+
+        internal override ChunkOutcome<TState> ParseChunk<TState>(
+            ReadOnlyMemory<byte> chunk, bool first, RowAggregation<TState> aggregation, CancellationToken ct)
+        {
+            var outcome = new ChunkOutcome<TState>(aggregation.Seed());
+            var rows = new XlsbWorkbook.Enumerator(workbook, chunk, first && _rowOpen, ct);
+            try
+            {
+                RowAction<TState> accumulate = aggregation.Accumulate;
+                while (rows.MoveNext())
+                {
+                    if (++outcome.Rows % RowsPerCancellationCheck == 0)
+                    {
+                        ct.ThrowIfCancellationRequested();
+                    }
+                    accumulate(ref outcome.State, rows.Current);
+                }
+            }
+            catch (Exception ex) when (ex is not OperationCanceledException)
+            {
+                outcome.Failure = ExceptionDispatchInfo.Capture(ex);
+            }
+            finally
+            {
+                rows.Dispose();
+            }
+            return outcome;
+        }
+
+        internal override TState ParseTail<TState>(int headerRow, long skipRows, RowAggregation<TState> aggregation, CancellationToken ct)
+        {
+            throw new System.Diagnostics.UnreachableException("An XLSB chunk always ends on a record boundary.");
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsbPipelineTests.cs b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsbPipelineTests.cs
new file mode 100644
index 00000000..69385e61
--- /dev/null
+++ b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsbPipelineTests.cs
@@ -0,0 +1,140 @@
+using System.Globalization;
+using System.Text;
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Parser.SheetPipeline;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Writer.Xlsb;
+
+namespace ExcelReader.Tests.Parser.SheetPipeline
+{
+    public class XlsbPipelineTests
+    {
+        private sealed class Sale
+        {
+            [ExcelColumn("Name")]
+            public string? Name { get; set; }
+
+            [ExcelColumn("Qty")]
+            public int Qty { get; set; }
+
+            [ExcelColumn("Day")]
+            public DateTime Day { get; set; }
+        }
+
+        private static readonly RowAggregation<List<string>> Collecting = new()
+        {
+            Seed = static () => [],
+            Accumulate = static (ref List<string> rows, Row row) => rows.Add(Render(row)),
+            Combine = static (left, right) =>
+            {
+                left.AddRange(right);
+                return left;
+            },
+        };
+
+        private static string Render(Row row)
+        {
+            var sb = new StringBuilder();
+            foreach (RowCell cell in row.Cells)
+            {
+                sb.Append(cell.ColumnIndex).Append(':').Append(cell.Value.GetString()).Append('|');
+            }
+            return sb.ToString();
+        }
+
+        private static async Task<MemoryStream> BuildAsync(int rows)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var ms = new MemoryStream();
+            await using (XlsbWorkbookWriter wb = XlsbWorkbookWriter.Create(ms, leaveOpen: true))
+            {
+                XlsbSheetWriter sheet = wb.AddSheet("S1");
+                await using (XlsbRowWriter header = await sheet.StartRowAsync(ct))
+                {
+                    header.Write("Name");
+                    header.Write("Qty");
+                    header.Write("Day");
+                }
+                for (int i = 0; i < rows; i++)
+                {
+                    await using XlsbRowWriter row = await sheet.StartRowAsync(ct);
+                    row.Write(i % 3 == 0 ? new string('x', 1 + (i % 40)) : string.Create(CultureInfo.InvariantCulture, $"item{i:D6}"));
+                    row.Write(i);
+                    row.Write(new DateTime(2024, 1, 1).AddDays(i % 400));
+                }
+                await sheet.EndAsync(ct);
+                await wb.EndAsync(ct);
+            }
+            ms.Position = 0;
+            return ms;
+        }
+
+        private static List<string> Sequential(XlsbWorkbook workbook, int headerRow)
+        {
+            var rows = new List<string>();
+            foreach (Row row in workbook.FirstSheet)
+            {
+                rows.Add(Render(row));
+            }
+            return rows.Count > headerRow ? rows[headerRow..] : [];
+        }
+
+        [Theory]
+        [InlineData(2, 96)]
+        [InlineData(4, 96)]
+        [InlineData(4, 700)]
+        [InlineData(8, 4096)]
+        [InlineData(4, 1 << 20)]
+        public async Task MatchesSequential(int dop, int chunkBytes)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(2_000);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            foreach (int headerRow in new[] { 0, 1, 4 })
+            {
+                Assert.Equal(Sequential(workbook, headerRow), await SheetPipelineRunner.AggregateAsync(source, Collecting, null, headerRow, dop, chunkBytes, ct));
+            }
+        }
+
+        [Fact]
+        public async Task ShortSheetsYieldNothing()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(0);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+
+            Assert.Empty(await SheetPipelineRunner.AggregateAsync(source, Collecting, null, 1, 4, 96, ct));
+            Assert.Empty(await SheetPipelineRunner.AggregateAsync(source, Collecting, null, 3, 4, 96, ct));
+        }
+
+        [Theory]
+        [InlineData(2)]
+        [InlineData(8)]
+        public async Task ParseAndForEachMatchSequentialThroughThePublicApi(int dop)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            using MemoryStream ms = await BuildAsync(40_000);
+            using XlsbWorkbook workbook = Excel.FromXlsb(ms);
+            Assert.NotNull(SheetPipelineSource.TryCreate(workbook.FirstSheet, 2));
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>();
+            IEnumerable<Sale> sequential = parser.Parse(workbook.FirstSheet);
+            List<(string?, int, DateTime)> expected = [.. sequential.Select(s => (s.Name, s.Qty, s.Day))];
+
+            var parsed = new List<(string?, int, DateTime)>();
+            await foreach (Sale sale in SheetParallel.ParseAsync(workbook.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = dop }, ct))
+            {
+                parsed.Add((sale.Name, sale.Qty, sale.Day));
+            }
+            Assert.Equal(expected, parsed);
+
+            var each = new System.Collections.Concurrent.ConcurrentBag<(string?, int, DateTime)>();
+            await SheetParallel.ForEachAsync(workbook.FirstSheet, parser, (Sale s) => each.Add((s.Name, s.Qty, s.Day)), new SheetParallelOptions { DegreeOfParallelism = dop, HeaderRow = 1 }, ct);
+            Assert.Equal(expected.Count, each.Count);
+            Assert.Equal(expected.Order(), each.Order());
+        }
+    }
+}

From 01369bda2a807f0cb86773fb886e226022fd6218 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:23:50 -0300
Subject: [PATCH 074/115] feat(native): parse XLSX and XLSB typed tables in
 parallel

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../Typed/TypedApi.Parallel.cs                |  71 +++++++++
 tests/ExcelReader.NativePgoTrainer/Program.cs |   5 +
 .../NativeApiTests.ParallelTypedSheets.cs     | 140 ++++++++++++++++++
 3 files changed, 216 insertions(+)
 create mode 100644 tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTypedSheets.cs

diff --git a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
index 64ac899b..6bc96fce 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.Parallel.cs
@@ -1,4 +1,6 @@
+using System.Collections.Concurrent;
 using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Parser.SheetPipeline;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
@@ -30,9 +32,78 @@ internal static int ParseTypedTable(NativeHandle? handle, int sheet, NativeColum
                 LastParseRanInParallel = true;
                 return ParseCsvInParallel(handle, source, csv.Options, specs, headerRow, degreeOfParallelism, chunkSizeOverride, out table);
             }
+            if (dop > 1 && sheet >= 0 && sheet < handle.Workbook.SheetCount
+                && SheetPipelineSource.TryCreate(handle.Workbook.SheetAt(sheet), dop) is { } pipeline)
+            {
+                LastParseRanInParallel = true;
+                return ParseSheetInParallel(handle, sheet, pipeline, specs, headerRow, dop, chunkSizeOverride, out table);
+            }
             return ParseSequential(handle, sheet, specs, headerRow, out table);
         }
 
+        private static int ParseSheetInParallel(NativeHandle handle, int sheet, SheetPipelineSource pipeline, NativeColumnSpec[] specs,
+            int headerRow, int dop, int chunkSizeOverride, out NativeTable table)
+        {
+            table = default;
+            if (!TryValidateArguments(specs, headerRow, out string? argumentError))
+            {
+                NativeApi.SetLastError(argumentError);
+                return NativeStatus.InvalidArgument;
+            }
+            NativeApi.ClearLastError();
+            var seeded = new ConcurrentBag<PartitionTable>();
+            try
+            {
+                int[] columnIndices = new int[specs.Length];
+                using (IExcelRowEnumerator rows = handle.Workbook.SheetAt(sheet).GetEnumerator())
+                {
+                    if (!TryResolveColumns(rows, specs, headerRow, columnIndices, out string? resolveError))
+                    {
+                        NativeApi.SetLastError(resolveError);
+                        return NativeStatus.InvalidArgument;
+                    }
+                }
+
+                bool isDate1904 = handle.Workbook.IsDate1904;
+                RowAggregation<PartitionTable> aggregation = new()
+                {
+                    Seed = () =>
+                    {
+                        var partition = new PartitionTable(specs);
+                        seeded.Add(partition);
+                        return partition;
+                    },
+                    Accumulate = (ref PartitionTable state, Row row) => state.Append(row, columnIndices, isDate1904),
+                    Combine = PartitionTable.Combine,
+                };
+                int chunkBytes = chunkSizeOverride > 0 ? chunkSizeOverride : SheetPipelineSource.DefaultChunkBytes;
+                PartitionTable merged = Task.Run(() => SheetPipelineRunner.AggregateAsync(
+                    pipeline, aggregation, null, headerRow, dop, chunkBytes, CancellationToken.None)).GetAwaiter().GetResult();
+                if (merged.FailedColumn >= 0)
+                {
+                    NativeApi.SetLastError(DescribeFailedColumn(specs, merged.FailedColumn));
+                    return NativeStatus.Error;
+                }
+                table = BuildTable([.. merged.Parts], dop);
+                return NativeStatus.Ok;
+            }
+            catch (Exception exception)
+            {
+                NativeApi.SetLastError(exception.Message);
+                table = default;
+                return NativeStatus.Error;
+            }
+            finally
+            {
+                // The runner drops states on failure and recovery, and Combine folds builders into another state:
+                // every seeded state is disposed, and disposing a builder twice is a no-op.
+                foreach (PartitionTable partition in seeded)
+                {
+                    partition.Dispose();
+                }
+            }
+        }
+
         private static int ParseCsvInParallel(NativeHandle handle, CsvChunkSource source, CsvReaderOptions reader, NativeColumnSpec[] specs,
             int headerRow, int degreeOfParallelism, int chunkSizeOverride, out NativeTable table)
         {
diff --git a/tests/ExcelReader.NativePgoTrainer/Program.cs b/tests/ExcelReader.NativePgoTrainer/Program.cs
index 3a24806c..5f7a48f1 100644
--- a/tests/ExcelReader.NativePgoTrainer/Program.cs
+++ b/tests/ExcelReader.NativePgoTrainer/Program.cs
@@ -51,6 +51,11 @@ private static int Main()
                     {
                         status = TypedApi.ParseTyped(handle, 0, Specs, headerRow: 1, out NativeTable table);
                         TypedApi.FreeTable(ref table);
+                        if (status == NativeStatus.Ok && format != NativeFormat.Csv)
+                        {
+                            status = TypedApi.ParseTypedTable(handle, 0, Specs, headerRow: 1, degreeOfParallelism: 0, out table);
+                            TypedApi.FreeTable(ref table);
+                        }
                         ReadApi.Close(handle);
                     }
                     if (status == NativeStatus.Ok && (status = ReadApi.OpenMemory(bytes, format, out handle)) == NativeStatus.Ok)
diff --git a/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTypedSheets.cs b/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTypedSheets.cs
new file mode 100644
index 00000000..cc04326a
--- /dev/null
+++ b/tests/ExcelReader.Tests/Native/NativeApiTests.ParallelTypedSheets.cs
@@ -0,0 +1,140 @@
+using System.Globalization;
+using ExcelReader.Core.Writer.Xlsb;
+using ExcelReader.Native;
+using ExcelReader.Native.Reading;
+using ExcelReader.Native.Typed;
+
+namespace ExcelReader.Tests.Native
+{
+    public sealed partial class NativeApiTests
+    {
+        private static object?[][] MixedSheetRows(int rows)
+        {
+            object?[][] data = new object?[rows + 1][];
+            data[0] = ["name", "qty", "price", "flag", "day", "note"];
+            for (int i = 0; i < rows; i++)
+            {
+                data[i + 1] =
+                [
+                    string.Create(CultureInfo.InvariantCulture, $"item{i}"),
+                    i % 7 == 0 ? null : i * 3,
+                    i * 0.25,
+                    i % 2 == 0,
+                    new DateTime(2024, 1, 1).AddDays(i % 28),
+                    string.Create(CultureInfo.InvariantCulture, $"n{i}"),
+                ];
+            }
+            return data;
+        }
+
+        private static async Task<byte[]> MixedXlsbAsync(int rows)
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var ms = new MemoryStream();
+            await using (XlsbWorkbookWriter wb = XlsbWorkbookWriter.Create(ms, leaveOpen: true))
+            {
+                XlsbSheetWriter sheet = wb.AddSheet("S1");
+                foreach (object?[] cells in MixedSheetRows(rows))
+                {
+                    await using XlsbRowWriter row = await sheet.StartRowAsync(ct);
+                    foreach (object? cell in cells)
+                    {
+                        switch (cell)
+                        {
+                            case null: row.Write((string?)null); break;
+                            case string s: row.Write(s); break;
+                            case bool b: row.Write(b); break;
+                            case int i: row.Write(i); break;
+                            case double d: row.Write(d); break;
+                            case DateTime dt: row.Write(dt); break;
+                        }
+                    }
+                }
+                await sheet.EndAsync(ct);
+                await wb.EndAsync(ct);
+            }
+            return ms.ToArray();
+        }
+
+        private static (int Status, NativeTable Table, bool Parallel) ParseSheetWith(byte[] workbook, int format, int dop, int chunkBytes)
+        {
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenMemory(workbook, format, out NativeHandle? handle));
+            try
+            {
+                int status = TypedApi.ParseTypedTable(handle, 0, MixedSpecs, 1, dop, out NativeTable table, chunkBytes);
+                return (status, table, TypedApi.LastParseRanInParallel);
+            }
+            finally
+            {
+                ReadApi.Close(handle);
+            }
+        }
+
+        [Theory]
+        [InlineData(2, 0)]
+        [InlineData(8, 0)]
+        [InlineData(4, 4096)]
+        public async Task ParallelXlsxTypedParseMatchesSequential(int dop, int chunkBytes)
+        {
+            using MemoryStream built = await TypedWorkbook.BuildAsync(MixedSheetRows(20_000));
+            byte[] workbook = built.ToArray();
+            (int expectedStatus, NativeTable expected, bool expectedParallel) = ParseSheetWith(workbook, NativeFormat.Xlsx, 1, 0);
+            (int status, NativeTable actual, bool parallel) = ParseSheetWith(workbook, NativeFormat.Xlsx, dop, chunkBytes);
+            try
+            {
+                Assert.Equal(NativeStatus.Ok, expectedStatus);
+                Assert.Equal(NativeStatus.Ok, status);
+                Assert.False(expectedParallel);
+                Assert.True(parallel);
+                AssertSameTable(expected, actual);
+            }
+            finally
+            {
+                TypedApi.FreeTable(ref expected);
+                TypedApi.FreeTable(ref actual);
+            }
+        }
+
+        [Theory]
+        [InlineData(2, 0)]
+        [InlineData(8, 0)]
+        [InlineData(4, 4096)]
+        public async Task ParallelXlsbTypedParseMatchesSequential(int dop, int chunkBytes)
+        {
+            byte[] workbook = await MixedXlsbAsync(40_000);
+            (int expectedStatus, NativeTable expected, _) = ParseSheetWith(workbook, NativeFormat.Xlsb, 1, 0);
+            (int status, NativeTable actual, bool parallel) = ParseSheetWith(workbook, NativeFormat.Xlsb, dop, chunkBytes);
+            try
+            {
+                Assert.Equal(NativeStatus.Ok, expectedStatus);
+                Assert.Equal(NativeStatus.Ok, status);
+                Assert.True(parallel);
+                AssertSameTable(expected, actual);
+            }
+            finally
+            {
+                TypedApi.FreeTable(ref expected);
+                TypedApi.FreeTable(ref actual);
+            }
+        }
+
+        [Fact]
+        public async Task AnInvalidSheetIndexStillFailsTheSameWay()
+        {
+            using MemoryStream built = await TypedWorkbook.BuildAsync(MixedSheetRows(20_000));
+            Assert.Equal(NativeStatus.Ok, ReadApi.OpenMemory(built.ToArray(), NativeFormat.Xlsx, out NativeHandle? handle));
+            try
+            {
+                int sequential = TypedApi.ParseTypedTable(handle, 9, MixedSpecs, 1, 1, out _);
+                int parallel = TypedApi.ParseTypedTable(handle, 9, MixedSpecs, 1, 8, out _);
+
+                Assert.NotEqual(NativeStatus.Ok, sequential);
+                Assert.Equal(sequential, parallel);
+            }
+            finally
+            {
+                ReadApi.Close(handle);
+            }
+        }
+    }
+}

From 06963375524687c23cce35cf8ceccc2f7ff2cdb1 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:28:24 -0300
Subject: [PATCH 075/115] test(fuzz): compare the sheet pipeline with the
 sequential read

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .github/workflows/fuzz.yml           |  2 +-
 tests/ExcelReader.Fuzz/Harnesses.cs  | 84 ++++++++++++++++++++++++++++
 tests/ExcelReader.Fuzz/Program.cs    |  2 +
 tests/ExcelReader.Fuzz/SeedCorpus.cs |  2 +
 4 files changed, 89 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/fuzz.yml b/.github/workflows/fuzz.yml
index 50a4998b..d633c942 100644
--- a/.github/workflows/fuzz.yml
+++ b/.github/workflows/fuzz.yml
@@ -53,7 +53,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        target: [xlsx, xlsx-memory, xlsx-differential, xlsb, xlsb-memory, xlsb-differential, xls, encrypted, csv, csv-sniff, csv-parallel, inflate]
+        target: [xlsx, xlsx-memory, xlsx-differential, xlsx-pipeline, xlsb, xlsb-memory, xlsb-differential, xlsb-pipeline, xls, encrypted, csv, csv-sniff, csv-parallel, inflate]
     steps:
       - name: Checkout
         uses: actions/checkout@v7
diff --git a/tests/ExcelReader.Fuzz/Harnesses.cs b/tests/ExcelReader.Fuzz/Harnesses.cs
index 4e73c04e..81f1fdb8 100644
--- a/tests/ExcelReader.Fuzz/Harnesses.cs
+++ b/tests/ExcelReader.Fuzz/Harnesses.cs
@@ -3,6 +3,7 @@
 using System.Text;
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Parser.ParallelCsv;
+using ExcelReader.Core.Parser.SheetPipeline;
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 using ExcelReader.Core.Reader.Xls;
@@ -100,6 +101,89 @@ internal static void XlsbDifferential(ReadOnlySpan<byte> data)
                 "memory"));
         }
 
+        internal static void XlsxPipeline(ReadOnlySpan<byte> data)
+        {
+            byte[] bytes = data.ToArray();
+            FuzzOracle.Guard(() => ComparePipeline(bytes, static b => Excel.FromXlsx(new ReadOnlyMemory<byte>(b), Limits)));
+        }
+
+        internal static void XlsbPipeline(ReadOnlySpan<byte> data)
+        {
+            byte[] bytes = data.ToArray();
+            FuzzOracle.Guard(() => ComparePipeline(bytes, static b => Excel.FromXlsb(new ReadOnlyMemory<byte>(b), Limits)));
+        }
+
+        private static void ComparePipeline(byte[] bytes, Func<byte[], IExcelWorkbook> open)
+        {
+            int chunkBytes = 48 + ((bytes.Length > 0 ? bytes[^1] : 0) * 8);
+            List<string>? sequential = null;
+            Exception? sequentialFailure = null;
+            try
+            {
+                sequential = RenderAllSheets(open(bytes));
+            }
+            catch (Exception ex) when (ex is not OutOfMemoryException)
+            {
+                sequentialFailure = ex;
+            }
+
+            List<string>? pipeline = null;
+            Exception? pipelineFailure = null;
+            try
+            {
+                pipeline = RenderAllSheetsThroughPipeline(open(bytes), chunkBytes);
+            }
+            catch (Exception ex) when (ex is not OutOfMemoryException)
+            {
+                pipelineFailure = ex;
+            }
+
+            // The two paths count limits at the same seam but not at the same byte, so a limit hit on either proves nothing.
+            if (sequentialFailure is ExcelLimitExceededException || pipelineFailure is ExcelLimitExceededException)
+            {
+                return;
+            }
+            if (sequentialFailure is not null || pipelineFailure is not null)
+            {
+                if (sequentialFailure?.GetType() != pipelineFailure?.GetType())
+                {
+                    throw new InvalidOperationException(
+                        $"Oracle divergence: sequential threw {sequentialFailure?.GetType().Name ?? "nothing"}, " +
+                        $"pipeline threw {pipelineFailure?.GetType().Name ?? "nothing"}.");
+                }
+                return;
+            }
+            AssertSameRows(sequential!, pipeline!, "sequential", "pipeline");
+        }
+
+        private static List<string> RenderAllSheetsThroughPipeline(IExcelWorkbook reader, int chunkBytes)
+        {
+            using (reader)
+            {
+                bool isDate1904 = reader.IsDate1904;
+                RowAggregation<List<string>> collect = new()
+                {
+                    Seed = static () => [],
+                    Accumulate = (ref List<string> list, Row row) => list.Add(RenderRow(row, isDate1904)),
+                    Combine = static (left, right) =>
+                    {
+                        left.AddRange(right);
+                        return left;
+                    },
+                };
+                var rows = new List<string>();
+                int sheets = reader.SheetCount;
+                for (int i = 0; i < sheets; i++)
+                {
+                    rows.Add(string.Create(CultureInfo.InvariantCulture, $"#sheet{i}"));
+                    SheetPipelineSource source = SheetPipelineSource.Create(reader.SheetAt(i))
+                        ?? throw new InvalidOperationException("The fuzzed workbook's sheet has no pipeline source.");
+                    rows.AddRange(SheetPipelineRunner.AggregateAsync(source, collect, null, 0, 4, chunkBytes, CancellationToken.None).GetAwaiter().GetResult());
+                }
+                return rows;
+            }
+        }
+
         internal static void Xls(ReadOnlySpan<byte> data)
         {
             byte[] bytes = data.ToArray();
diff --git a/tests/ExcelReader.Fuzz/Program.cs b/tests/ExcelReader.Fuzz/Program.cs
index f4613d29..f60d1b89 100644
--- a/tests/ExcelReader.Fuzz/Program.cs
+++ b/tests/ExcelReader.Fuzz/Program.cs
@@ -20,9 +20,11 @@ internal static class Program
                 ["xlsx"] = Harnesses.Xlsx,
                 ["xlsx-memory"] = Harnesses.XlsxMemory,
                 ["xlsx-differential"] = Harnesses.XlsxDifferential,
+                ["xlsx-pipeline"] = Harnesses.XlsxPipeline,
                 ["xlsb"] = Harnesses.Xlsb,
                 ["xlsb-memory"] = Harnesses.XlsbMemory,
                 ["xlsb-differential"] = Harnesses.XlsbDifferential,
+                ["xlsb-pipeline"] = Harnesses.XlsbPipeline,
                 ["xls"] = Harnesses.Xls,
                 ["encrypted"] = Harnesses.Encrypted,
                 ["csv"] = Harnesses.Csv,
diff --git a/tests/ExcelReader.Fuzz/SeedCorpus.cs b/tests/ExcelReader.Fuzz/SeedCorpus.cs
index 7b5b4b65..a63119a4 100644
--- a/tests/ExcelReader.Fuzz/SeedCorpus.cs
+++ b/tests/ExcelReader.Fuzz/SeedCorpus.cs
@@ -34,9 +34,11 @@ private static readonly (string Target, string[] Seeds)[] _layout =
             ("xlsx", ["xlsx", "xlsx-multisheet", "xlsx-sharedstrings", "xlsx-blanks", "xlsx-empty-sheet"]),
             ("xlsx-memory", ["xlsx", "xlsx-multisheet", "xlsx-sharedstrings", "xlsx-blanks", "xlsx-empty-sheet"]),
             ("xlsx-differential", ["xlsx", "xlsx-multisheet", "xlsx-sharedstrings", "xlsx-blanks", "xlsx-empty-sheet"]),
+            ("xlsx-pipeline", ["xlsx", "xlsx-multisheet", "xlsx-sharedstrings", "xlsx-blanks", "xlsx-empty-sheet"]),
             ("xlsb", ["xlsb", "xlsb-multisheet"]),
             ("xlsb-memory", ["xlsb", "xlsb-multisheet"]),
             ("xlsb-differential", ["xlsb", "xlsb-multisheet"]),
+            ("xlsb-pipeline", ["xlsb", "xlsb-multisheet"]),
             ("xls", ["xls"]),
             ("encrypted", ["encrypted", "encrypted-multisheet", "encrypted-sharedstrings"]),
             ("csv", ["csv", "csv-semicolon", "csv-tab", "csv-bom-lf", "csv-pipe", "csv-ragged",

From d6b1186042df924badd7faa39fb047d44f87fed3 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sat, 10 Oct 2026 23:51:04 -0300
Subject: [PATCH 076/115] perf: cut sheet pipeline chunks at 256 KB instead of
 1 MB

The last chunk is parsed after inflate finishes, so its size is serial tail
time. Ryzen 7 5700X, 65K real-data corpus, light consumer, min/median of 30
interleaved rounds after 4 warm-up calls, sheet stage only, dop 4:

            1 MB            256 KB
  XLSX   18.12 / 19.62   17.56 / 18.49 ms
  XLSB   13.99 / 14.69   13.32 / 13.88 ms

Typed ParseAsync (FullRow), dop 4: XLSX 20.01 -> 18.85 ms, XLSB 16.21 ->
14.44 ms (min). Published AOT DLL, xl_parse_typed degree 0, median:
XLSX 23.2 -> 22.0 ms, XLSB 18.0 -> 16.5 ms. 2 MB and 4 MB chunks are slower
(XLSX 19.66 / 21.86 ms); 128 KB matches 256 KB.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Parser/SheetPipeline/SheetPipelineSource.cs                 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
index 74f0b081..bf096983 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineSource.cs
@@ -25,7 +25,7 @@ internal sealed class ChunkOutcome<TState>(TState state)
     internal abstract class SheetPipelineSource
     {
         internal const long MinBytes = 256 * 1024;
-        internal const int DefaultChunkBytes = 1024 * 1024;
+        internal const int DefaultChunkBytes = 256 * 1024;
         private protected const int RowsPerCancellationCheck = 4096;
 
         internal abstract object Owner { get; }

From fa57c54d0fc0e7ae5ea3d860b65683effd0cb596 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 00:25:11 -0300
Subject: [PATCH 077/115] perf: benchmark parallel sheet reading and regenerate
 the static PGO profile

Adds SheetParallelBenchmark (realdata group) and a "Parallel sheet reading"
table. The regenerated profile keeps the Xlsb|Biff12 exclusion: through the
published DLL it is neutral against the old one on every format, and
including XLSB methods still makes sequential XLSB ~22% slower (28 -> 34 ms).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/performance/benchmarks.md                |  15 ++++-
 src/ExcelReader.Native/pgo/excelreader.mibc   | Bin 65999 -> 101715 bytes
 .../RealData/SheetParallelBenchmark.cs        |  58 ++++++++++++++++++
 .../benchmark-groups.json                     |   2 +-
 4 files changed, 73 insertions(+), 2 deletions(-)
 create mode 100644 tests/ExcelReader.Benchmarks/RealData/SheetParallelBenchmark.cs

diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index 7d3c6f24..591fd725 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -66,7 +66,7 @@ For raw CSV reads, all three libraries read text through spans. ExcelReader is ~
 
 ### Parallel CSV
 
-`CsvParallel.ParseAsync<T>` and `CsvParallel.AggregateAsync` on generated files (8,000,000 rows of three ints for the narrow corpus, 4,300,000 rows of two strings, a date, two decimals and an int for the conversion-heavy one), by `degreeOfParallelism`. The machine has 8 physical / 16 logical cores.
+`SheetParallel.ParseAsync<T>` and `SheetParallel.AggregateAsync` over a `CsvSheet`, on generated files (8,000,000 rows of three ints for the narrow corpus, 4,300,000 rows of two strings, a date, two decimals and an int for the conversion-heavy one), by `degreeOfParallelism`. The machine has 8 physical / 16 logical cores.
 
 | Dop | Conversion-heavy, typed | Narrow ints, typed | Conversion-heavy, `ref struct` aggregate | Narrow ints, `ref struct` aggregate |
 |---:|---:|---:|---:|---:|
@@ -91,6 +91,19 @@ Against [Sep](https://github.com/nietras/Sep)'s own `ParallelEnumerate` (all cor
 
 Sequentially, ExcelReader's typed parser is ~1.1x faster than Sep on narrow ints (490.6 ms vs. 521.7 ms), and ~1.3x faster on the conversion-heavy corpus. In parallel ExcelReader is ~2.3x (narrow) and ~3.3x (conversion-heavy) faster than Sep's, while yielding rows in file order.
 
+### Parallel sheet reading
+
+`SheetParallel.AggregateAsync<TAccumulator, TModel>` over the first sheet of the real-data workbook (65,535 rows, 14 columns; XLSX 6.7 MB compressed, 34.4 MB sheet XML; XLSB 3.7 MB, 15.9 MB sheet records), folding every row of a typed model into a per-partition sum (`SheetParallelBenchmark`). One thread inflates the sheet and cuts it into row-aligned chunks; `Dop - 1` workers parse them.
+
+| Dop | XLSX | XLSB |
+|---:|---:|---:|
+| 1 | 54.38 ms, 8.02 MB | 36.55 ms, 8.02 MB |
+| 2 | 37.84 ms, 8.13 MB | 25.60 ms, 8.07 MB |
+| 4 | 20.07 ms, 8.11 MB | 14.94 ms, 8.07 MB |
+| 8 | 19.94 ms, 8.16 MB | 15.26 ms, 8.09 MB |
+
+At dop 4 XLSX reads ~2.7x faster than sequentially and XLSB ~2.4x. Dop 2 is a single parse worker running alongside the inflating thread. Past dop 4 nothing improves: the one inflating thread is the floor (~15 ms for XLSX, ~10 ms for XLSB, plus the XLSB record walk that finds row boundaries). Allocation barely moves with dop (8.02 to 8.16 MB): it is the typed model's strings.
+
 ### Real data reads
 
 This benchmark reads a real workbook exported in multiple formats.
diff --git a/src/ExcelReader.Native/pgo/excelreader.mibc b/src/ExcelReader.Native/pgo/excelreader.mibc
index e08a44d4dfa74b918b8adf2966b2cca9a517806c..1a2ce5d016b86cbffd586493f5b857a0dd5e7ccf 100644
GIT binary patch
literal 101715
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%0AlhDY8{vy~OHL7H4RRc0iv
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

literal 65999
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
YO9ci1000010096x0001g0RaF20D6_dtpET3

diff --git a/tests/ExcelReader.Benchmarks/RealData/SheetParallelBenchmark.cs b/tests/ExcelReader.Benchmarks/RealData/SheetParallelBenchmark.cs
new file mode 100644
index 00000000..3f47f560
--- /dev/null
+++ b/tests/ExcelReader.Benchmarks/RealData/SheetParallelBenchmark.cs
@@ -0,0 +1,58 @@
+using BenchmarkDotNet.Attributes;
+using ExcelReader.Core.Parser;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsb;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Benchmarks
+{
+    [MemoryDiagnoser]
+    public class SheetParallelBenchmark
+    {
+        private sealed class Sum : IRowAccumulator<Sum, FullRow>
+        {
+            public long Total;
+
+            public void Add(FullRow model)
+            {
+                Total += model.OrderId + model.UnitsSold + (long)model.TotalRevenue + model.Region.Length;
+            }
+
+            public void Merge(Sum following)
+            {
+                Total += following.Total;
+            }
+        }
+
+        private readonly ExcelParser<FullRow> _parser = ExcelParser.FromAttributes<FullRow>();
+        private byte[] _xlsx = [];
+        private byte[] _xlsb = [];
+
+        [Params(1, 2, 4, 8)]
+        public int Dop { get; set; }
+
+        [GlobalSetup]
+        public void Setup()
+        {
+            string dir = Path.Combine(AppContext.BaseDirectory, "Data");
+            _xlsx = File.ReadAllBytes(Path.Combine(dir, "65K_Records_Data.xlsx"));
+            _xlsb = File.ReadAllBytes(Path.Combine(dir, "65K_Records_Data.xlsb"));
+        }
+
+        [Benchmark]
+        public async Task<long> Xlsx_Aggregate()
+        {
+            using XlsxWorkbook workbook = Excel.FromXlsx(_xlsx);
+            Sum sum = await SheetParallel.AggregateAsync<Sum, FullRow>(workbook.FirstSheet, _parser, new SheetParallelOptions { DegreeOfParallelism = Dop, HeaderRow = 1 });
+            return sum.Total;
+        }
+
+        [Benchmark]
+        public async Task<long> Xlsb_Aggregate()
+        {
+            using XlsbWorkbook workbook = Excel.FromXlsb(_xlsb);
+            Sum sum = await SheetParallel.AggregateAsync<Sum, FullRow>(workbook.FirstSheet, _parser, new SheetParallelOptions { DegreeOfParallelism = Dop, HeaderRow = 1 });
+            return sum.Total;
+        }
+    }
+}
diff --git a/tests/ExcelReader.Benchmarks/benchmark-groups.json b/tests/ExcelReader.Benchmarks/benchmark-groups.json
index 3bce06d0..be6bdae8 100644
--- a/tests/ExcelReader.Benchmarks/benchmark-groups.json
+++ b/tests/ExcelReader.Benchmarks/benchmark-groups.json
@@ -25,7 +25,7 @@
   },
   {
     "name": "realdata",
-    "filter": "ExcelReader.Benchmarks.RealDataReadBenchmark.* ExcelReader.Benchmarks.RealDataTypedParseBenchmark.*",
+    "filter": "ExcelReader.Benchmarks.RealDataReadBenchmark.* ExcelReader.Benchmarks.RealDataTypedParseBenchmark.* ExcelReader.Benchmarks.SheetParallelBenchmark.*",
     "pagesArgs": "--warmupCount 3 --iterationCount 10",
     "prArgs": "--warmupCount 1 --iterationCount 5"
   },

From 580fba697da70bab1bb5b5cf6f4ca0b752e164f2 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 00:28:41 -0300
Subject: [PATCH 078/115] docs: mark the parallel benchmark tables as pending
 an idle rerun

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/performance/benchmarks.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index 591fd725..58598563 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -76,6 +76,8 @@ For raw CSV reads, all three libraries read text through spans. ExcelReader is ~
 | 8 | 285.2 ms, 680.15 MB | 204.7 ms, 254.63 MB | 158.3 ms, 1.54 MB | 94.6 ms, 1.62 MB |
 | 16 | 324.9 ms, 680.32 MB | 189.0 ms, 255.15 MB | 114.4 ms, 1.66 MB | 73.0 ms, 1.69 MB |
 
+These numbers were measured before the rename to `SheetParallel`; the rename did not touch the CSV engine, and a scratch harness comparing the two builds on a 156 MB CSV showed no regression.
+
 The typed path scales ~2.8x on the conversion-heavy corpus (bimodal at dop 16: 86.7 ms standard deviation, median 275.8 ms) and ~2.7x on narrow ints, where it flattens out after dop 4 (217.2 ms vs. 189.0 ms at dop 16). Its ~680 MB is one materialized row object per record, and at dop 16 that costs 42,000 Gen0 plus 41,000 Gen1 collections.
 
 The aggregate columns fold each record into a per-partition accumulator through a `ref struct` model, so text columns stay as `ReadOnlySpan<byte>` and no row object is ever materialized. They scale better than the typed path — ~6.9x (conversion-heavy) and ~6.5x (narrow) at dop 16 — because they are not fighting the allocator: at dop 16 the conversion-heavy aggregate is ~2.8x faster than typed while allocating ~410x less (1.66 MB against 680.32 MB), with **zero** garbage collections at every degree. The remaining allocation is per-partition bookkeeping, not per-row.
@@ -102,6 +104,8 @@ Sequentially, ExcelReader's typed parser is ~1.1x faster than Sep on narrow ints
 | 4 | 20.07 ms, 8.11 MB | 14.94 ms, 8.07 MB |
 | 8 | 19.94 ms, 8.16 MB | 15.26 ms, 8.09 MB |
 
+This run had background load and may read a few percent high: on an idle machine a scratch harness's minimums at dop 4 were 18.85 ms for XLSX (against 20.07 ms here) and 14.44 ms for XLSB (against 14.94 ms); an idle rerun is pending.
+
 At dop 4 XLSX reads ~2.7x faster than sequentially and XLSB ~2.4x. Dop 2 is a single parse worker running alongside the inflating thread. Past dop 4 nothing improves: the one inflating thread is the floor (~15 ms for XLSX, ~10 ms for XLSB, plus the XLSB record walk that finds row boundaries). Allocation barely moves with dop (8.02 to 8.16 MB): it is the typed model's strings.
 
 ### Real data reads

From c9c3dc63d96763647d1a4db72883cb136fa2a779 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 00:35:35 -0300
Subject: [PATCH 079/115] docs: document SheetParallel and the v7 migration

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 ARCHITECTURE.md                        |  78 +++++++++++++++---
 README.md                              |   3 +-
 docs/guide/csv.md                      |   4 +-
 docs/guide/migrating-to-v7.md          |  99 +++++++++++++++++++++++
 docs/guide/parsing.md                  |   2 +-
 docs/guide/reading.md                  | 107 ++++++++++++++++++-------
 docs/performance/reader-performance.md |  47 ++++++++++-
 python/README.md                       |  15 ++--
 rust/excelreader/README.md             |   5 +-
 src/ExcelReader.Native/README.md       |   2 +-
 10 files changed, 308 insertions(+), 54 deletions(-)
 create mode 100644 docs/guide/migrating-to-v7.md

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 2d7c67de..67d45d6e 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -47,13 +47,73 @@ source-generated map) or `ExcelParser.Build` (a runtime-configured map). Its mod
 a `ref struct` model binds directly to `Cell.Value` spans — zero allocation for the container and,
 for span-typed columns, for the values too. It consumes `Row`/`Cell` from any sheet uniformly.
 
-## Parallel CSV parsing
-
-`CsvParallel.ParseAsync<T>` (`src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsv*.cs`) is an opt-in
-alternate path over the same typed-parsing machinery, for sources large enough that partitioning
-pays for itself. `ParallelCsvFactory` decides eligibility — a seekable, UTF-8, large-enough source —
-and falls back to the ordinary sequential `ExcelParser<T>` otherwise, so callers get identical output
-either way.
+## Parallel sheet reading
+
+`SheetParallel` (`src/ExcelReader.Core/Reader/SheetParallel.cs`) reads one sheet on several threads. It is
+opt-in, takes any `IExcelSheet`, validates its arguments and dispatches on the sheet's concrete type:
+
+| sheet | engine |
+|---|---|
+| `CsvSheet` | the CSV engine (`ParallelCsvProcessor`, `ParallelCsvEnumerable`), described below. Its source comes from `CsvReader.TryGetChunkSource`, which the native layer also uses. |
+| `XlsxSheet`, `XlsbSheet` | the pipeline engine (`src/ExcelReader.Core/Parser/SheetPipeline`) |
+| anything else, and every fallback case | one sequential runner over `IExcelRowEnumerator` |
+
+The fallback cases give the same results with no error: a degree of parallelism of 1, a sheet under 256 KB
+uncompressed, XLS, a table view (`ExcelTable.AsSheet`), and a CSV that cannot be partitioned (a non-seekable
+stream or a non-UTF-8 encoding). The caller owns the workbook; the engine holds a `ReaderLifetime` lease
+until the task completes or the enumeration ends.
+
+The CSV engine is not folded into a shared partition abstraction. It is tuned, and its model, a static
+byte-range plan with speculative starts and re-reads, differs from the pipeline's dynamic, exact chunks. What
+the two share is the contract types (`IRowRecord`, `IRowAccumulator`, `RowAggregation`, `RowAction`) and the
+binders in `Parser/ParallelCsv` (`MappedProjection`, `MappedAggregation`, `MappedCallback`, `RecordAggregation`,
+`RecordCallback`), which pick the parser's CSV type map for a `CsvSheet` and the general one otherwise.
+
+### The pipeline engine
+
+```
+zip entry -> producer (1 thread) -> bounded queue -> N workers -> ordered merge
+             inflate, cut at the     row-aligned      parse +      by chunk index
+             last row boundary       chunks, indexed  row action
+```
+
+Inflate is sequential, so the engine splits the work around it instead of through it. One producer thread
+owns the entry stream, opened through `ZipIndex.OpenEntryStream` so the decompressed-byte limits count where
+they do on the sequential path. It inflates into pooled buffers and cuts each at the last row boundary,
+copying the partial tail into the next buffer; chunks default to 256 KB (`SheetPipelineSource.DefaultChunkBytes`).
+In XLSX the boundary is the last `<row` followed by a name boundary, and the producer stops at the sheet-data
+end tag, so the rest of the part is neither inflated nor buffered. XLSB has no sync marker, so the producer walks
+every record with `Biff12RecordReader` and remembers the last `BrtRowHdr`; it stops at `BrtEndSheetData`.
+
+Chunks go through a bounded `System.Threading.Channels` queue, about twice the worker count, so a full queue
+blocks the producer and peak memory is roughly capacity times chunk size whatever the sheet's size. `dop - 1`
+workers (at least one) each parse a chunk in place with the format's own enumerator over `ReadOnlyMemory<byte>`,
+call `Seed()`, then run the row action for each row. Shared strings are loaded before the pipeline starts, and a
+prologue reads up to `HeaderRow` with an ordinary enumerator, so header rows never reach a chunk. The engine's
+one primitive is an async stream of `(index, state, failure)` in chunk order, reordered through a ring of slots as
+`ParallelCsvEnumerable` does; `AggregateAsync` folds the states with `Combine`, `ForEachAsync` ignores them, and
+`ParseAsync` uses a `List<T>` per chunk and yields its items.
+
+The XLSX row boundary is a candidate, not a proof: the same bytes can sit in CDATA, a comment or malformed
+markup. So every chunk enumerator reports whether it ended cleanly, on a row boundary with no row or tag cut
+short. A run of clean chunks equals the sequential read by induction. A chunk that does not end cleanly stops
+before delivering its cut-short row; the merge keeps that chunk's rows, cancels the pipeline and reads the rest
+with one sequential enumerator, skipping the rows already delivered, and later chunks' results are dropped.
+This recovery re-inflates the sheet and only happens on such sheets. It leaves `ParseAsync` and `AggregateAsync`
+exact, but `ForEachAsync` may already have called back for dropped chunks, so it is exactly once only for a
+well-formed XLSX sheet. XLSB frames records from the first byte as the sequential reader does, so it has no
+such case.
+
+The measured gain is bounded by inflate, which stays on one thread: see "Parallel intra-sheet parsing" in
+[reader-performance.md](docs/performance/reader-performance.md). Parallel inflate would replace the producer
+only; the queue, workers and merge stay.
+
+### The CSV engine
+
+`CsvSheet` takes the older path (`src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsv*.cs`), over the same
+typed-parsing machinery, for sources large enough that partitioning pays for itself. `ParallelCsvFactory`
+decides eligibility, a seekable, UTF-8, large-enough source, and falls back to the ordinary sequential
+`ExcelParser<T>` otherwise, so callers get identical output either way.
 
 When it partitions, `CsvChunkPlan` slices the data range into four chunks per worker (not one — see
 the file's comments on why one-per-worker would buffer up to the whole output) and hands them out
@@ -96,8 +156,8 @@ Still unresolved, and untested by any of the above: whether true unordered emiss
 differently. The ordered merge is the safer default and the only mode either public overload can
 reach, so it stays absent a specific reason to revisit.
 
-`CsvParallel.ForEachAsync` exposes the same partitioning to a per-row callback rather than an
-accumulator type. It accepts a `ref struct` row, which the enumerating `CsvParallel.ParseAsync` cannot —
+`SheetParallel.ForEachAsync` exposes the same partitioning to a per-row callback rather than an
+accumulator type. It accepts a `ref struct` row, which the enumerating `SheetParallel.ParseAsync` cannot —
 not because of the interface (`IAsyncEnumerable<T>`'s `T` is declared `allows ref struct` on net9.0+),
 but because a row holding spans into a worker's buffer cannot cross to the consumer thread at all.
 
diff --git a/README.md b/README.md
index 643a01b6..026534bc 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,7 @@ foreach (Row row in workbook.FirstSheet)
 - [Writing workbooks](docs/guide/writing.md) — XLSX, XLSB (BIFF12) and XLS (BIFF8) writers, cell styles, typed records, and prefetch compression.
 - [CSV](docs/guide/csv.md) — reading, dialect sniffing, parallel parsing, and writing delimited text.
 - [Encrypted workbooks](docs/guide/encryption.md) — opening password-protected packages and encrypting written ones.
+- [Migrating to v7](docs/guide/migrating-to-v7.md) — porting `CsvParallel` code to `SheetParallel`, which now reads XLSX and XLSB on several threads too.
 - [Migrating to v6](docs/guide/migrating-to-v6.md) — porting v5 reader code to workbooks and sheets, and reading sheets in parallel.
 - [Benchmarks](docs/performance/benchmarks.md) — throughput and allocation against Sep, Sylvan, OfficeIMO and SpreadCheetah. [Live results](https://gabrielmarquezmatte.github.io/ExcelReader/dev/bench/).
 
@@ -77,7 +78,7 @@ errors to stderr, so `convert` is safe to pipe.
 - Reads `.xlsx`, `.xlsb` (BIFF12), `.xls` (BIFF8), and `.csv`; writes `.xlsx`, `.xlsb`, `.xls`, and `.csv`.
 - `Excel.Open`/`OpenAsync` auto-detect XLSX/XLSB/XLS from the file signature. CSV has none, so pass `ExcelFileFormat.Csv` to open delimited text through the same entry point; `ExcelReaderOptions.Csv` carries the dialect, and `CsvReaderOptions.SniffDialect` infers it from the source.
 - A workbook hands out its sheets: `FirstSheet`, `Sheets[index]` or `SheetAt(index)`, and `TryGetSheet(name)`. CSV is a workbook with one unnamed sheet. Coming from v5? See [Migrating to v6](docs/guide/migrating-to-v6.md).
-- Sheets of one workbook can be read in parallel, one enumerator per thread.
+- Sheets of one workbook can be read in parallel, one enumerator per thread. One sheet of any format (XLSX, XLSB or CSV) can also be read on several threads with `SheetParallel`.
 - `sheet.Visibility` reports whether a sheet is hidden (`Visible`, `Hidden`, `VeryHidden`). Hidden sheets still enumerate their rows — filter on the value if you want them skipped. The writers take the same value via `AddSheet(name, visibility)`, and reject a workbook whose sheets would all be hidden.
 - Missing cells in sparse rows are exposed as empty cells.
 - String conversion allocates only when you call `GetString()`.
diff --git a/docs/guide/csv.md b/docs/guide/csv.md
index 074acf38..dc9a0fc2 100644
--- a/docs/guide/csv.md
+++ b/docs/guide/csv.md
@@ -1,7 +1,7 @@
 # CSV
 
 Reading, dialect sniffing and writing delimited text.
-Parallel CSV parsing is covered in [parsing.md](parsing.md).
+Parallel CSV parsing is covered in [reading.md](reading.md#parallel-reading-opt-in).
 
 ## Read CSV
 
@@ -64,7 +64,7 @@ using var csv = Excel.FromCsvFile("export.csv", CsvReaderOptions.Default.WithDia
 
 `CsvSniffer.Detect` takes a span of bytes or a seekable `Stream`, `DetectFile` takes a path, and `DetectAsync`/`DetectFileAsync` are the async siblings; only the first 64 KiB are examined. The `Stream` overloads require a seekable source — they read a bounded sample and restore the stream's position — so a non-seekable stream throws `ArgumentException`; buffer it first, or pass the bytes as a span instead. Pass `CsvSnifferOptions` to change the candidate delimiters/quotes (and their priority order) or the number of sample lines considered.
 
-`CsvReaderOptions.SniffDialect` does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, `Excel.Open` with `ExcelFileFormat.Csv`, and the parallel CSV entry points:
+`CsvReaderOptions.SniffDialect` does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, and `Excel.Open` with `ExcelFileFormat.Csv`. The dialect of a parallel read is the one the CSV workbook was opened with:
 
 ```csharp
 using var csv = Excel.FromCsvFile("export.csv", CsvReaderOptions.Default with { SniffDialect = true });
diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
new file mode 100644
index 00000000..1bd4f4bd
--- /dev/null
+++ b/docs/guide/migrating-to-v7.md
@@ -0,0 +1,99 @@
+# Migrating from v6 to v7
+
+What changed in parallel reading and how to port v6 code.
+See also [reading.md](reading.md#parallel-reading-opt-in) for the full guide.
+
+## What changed
+
+Parallel reading now takes a sheet, and it works on XLSX and XLSB as well as CSV. `CsvParallel` is gone: its eighteen path, memory and stream methods became six `SheetParallel` methods that take any `IExcelSheet`. You open the workbook yourself, pass its sheet, and the library parallelises as far as the format allows. The contract types lost their `Csv` prefix because they now serve every format.
+
+## Types
+
+| v6 | v7 |
+|---|---|
+| `CsvParallel` | `SheetParallel` |
+| `CsvParallelOptions` | `SheetParallelOptions` (no `Reader` property) |
+| `ICsvRecord<TSelf>` | `IRowRecord<TSelf>` |
+| `ICsvAccumulator<TSelf, TModel>` | `IRowAccumulator<TSelf, TModel>` |
+| `CsvAggregation<TState>` | `RowAggregation<TState>` |
+| `CsvRowAction<TState>` | `RowAction<TState>` |
+
+The old names are removed, with no `[Obsolete]` forwarders. Members, contracts and results are unchanged.
+
+## Before and after
+
+A CSV file:
+
+```csharp
+// v6
+await foreach (Sale s in CsvParallel.ParseAsync(path, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+{
+    Total += s.Revenue;
+}
+
+// v7
+using CsvReader csv = Excel.FromCsvFile(path, dialect);
+await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
+{
+    Total += s.Revenue;
+}
+```
+
+CSV bytes in memory:
+
+```csharp
+// v6
+await foreach (Sale s in CsvParallel.ParseAsync(data, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+{
+    Total += s.Revenue;
+}
+
+// v7
+using CsvReader csv = Excel.FromCsv(data, dialect);
+await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
+{
+    Total += s.Revenue;
+}
+```
+
+A stream:
+
+```csharp
+// v6
+await foreach (Sale s in CsvParallel.ParseAsync(stream, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+{
+    Total += s.Revenue;
+}
+
+// v7
+using CsvReader csv = Excel.FromCsv(stream, leaveOpen: true, dialect);
+await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
+{
+    Total += s.Revenue;
+}
+```
+
+The other five methods port the same way: open a workbook, pass `csv.FirstSheet` (or any sheet) in place of the path, bytes or stream, and drop `Reader` from the options. XLSX and XLSB need no other change:
+
+```csharp
+using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+await foreach (Sale s in SheetParallel.ParseAsync(workbook.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
+{
+    Total += s.Revenue;
+}
+```
+
+## Behavior changes
+
+- The caller owns the workbook and keeps it open until the task completes or the enumeration ends. v6 opened and closed its own source.
+- The CSV dialect is given when the workbook is opened (`CsvReaderOptions`), not in the parallel options.
+- A CSV in a `MemoryStream` is no longer partitioned: the stream overload of `Excel.FromCsv` reads it sequentially. Pass the bytes as `ReadOnlyMemory<byte>` to keep partitioning.
+- `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from `ExcelParserConfig.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`; the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+- XLSX and XLSB sheets are now read on several threads when `DegreeOfParallelism` allows it. XLS, a table view (`ExcelTable.AsSheet()`), a sheet under 256 KB uncompressed and a CSV that cannot be partitioned still read sequentially with the same results.
+- `PrefetchDecompression` does not apply to a parallel XLSX or XLSB read; the pipeline already overlaps inflate and parse.
+
+## Native bindings
+
+The C ABI is unchanged: no signature moved, and `XL_ABI_VERSION` stays 6. Behavior changed. `degree_of_parallelism` of `0` on `xl_parse_typed` and the Arrow exports now parallelises XLSX and XLSB as well as CSV, using every processor. Pass `1` for the old sequential behavior. The Rust, Python and C++ bindings take the same value (`degree_of_parallelism`, `parallelism`) and need no code change; a `parallelism=0` call on an XLSX or XLSB sheet is now faster, and holds every partition's columns until they merge, so its peak memory is higher.
+
+`xl_csv_aggregate` keeps its signature. Inside, it opens a `CsvReader` with the dialect from the native struct and calls `SheetParallel`.
diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index fec416d3..c53c3d54 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -76,7 +76,7 @@ await using (var sheet = workbook.AddSheet("Changes"))
 Notes:
 
 - `[ExcelSerializable]` requires the model — and every type it's nested inside, if any — to be `partial`; the generator emits into an additional part of the same declaration. A compile error (`EXR001`/`EXR002`) names exactly what to fix.
-- Supported property types match `ExcelParser.FromAttributes<T>`'s: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, `enum`s, and `Nullable<T>` of each — plus `ReadOnlySpan<byte>`, which binds zero-copy through `ExcelCellReaders.Utf8`. The model may be a `ref struct`: mark it `ref partial struct` and the generator emits `IExcelRowMap<T>` on it like any other shape, so `ExcelParser.Generated<T>` and `ExcelParser.Build<T>` read it AOT-clean, as do the map-driven `CsvParallel.ForEachAsync`/`CsvParallel.AggregateAsync` overloads.
+- Supported property types match `ExcelParser.FromAttributes<T>`'s: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, `enum`s, and `Nullable<T>` of each — plus `ReadOnlySpan<byte>`, which binds zero-copy through `ExcelCellReaders.Utf8`. The model may be a `ref struct`: mark it `ref partial struct` and the generator emits `IExcelRowMap<T>` on it like any other shape, so `ExcelParser.Generated<T>` and `ExcelParser.Build<T>` read it AOT-clean, as do the map-driven `SheetParallel.ForEachAsync`/`SheetParallel.AggregateAsync` overloads.
 - The generator requires a build via `dotnet build`/the .NET SDK. Visual Studio's or `MSBuild.exe`'s .NET Framework host can't load it, so a project built only through those tools won't see generated code — build via the SDK, or fall back to `ExcelParser.FromAttributes<T>`/`ExcelRecordLayout.FromAttributes<T>` for that build path.
 - `ExcelParser.Generated<T>` builds one map per model and reuses it for every reader, including CSV — unlike `ExcelParser.FromAttributes<T>`, which swaps in a text-based date reader specifically for CSV. A `[ExcelSerializable]` model reads `DateTime`/`DateOnly`/`TimeOnly` via `ExcelCellReaders.DateTimeAuto`/`DateOnlyAuto`/`TimeOnlyAuto`: an Excel serial number first, falling back to date/time text when the cell isn't numeric — so a CSV column round-trips through the library's own writer either way. The one edge case this can't distinguish: a CSV cell that's only digits (e.g. an Excel serial number typed as plain text) is always read as a serial number, never as date text.
 - The attribute-based reflection path keeps working unchanged; `[ExcelSerializable]` is an additive, opt-in alternative for the same model shape, not a replacement.
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index eec0e114..53ae2455 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -28,23 +28,34 @@ foreach (var row in workbook.FirstSheet)
 
 An opened workbook (`XlsxWorkbook`, `XlsbWorkbook`, `XlsWorkbook`, `CsvReader`) hands out its sheets: `FirstSheet` is the first one, `Sheets[i]` any of them. A sheet holds no resources of its own; iterating it starts a new, independent read. Dispose the workbook, not the sheets.
 
-### Parallel CSV parsing (opt-in)
+### Parallel reading (opt-in)
+
+`SheetParallel` reads one sheet on several threads. It takes any sheet, so it works the same on XLSX, XLSB and CSV:
 
 ```csharp
-await foreach (var row in CsvParallel.ParseAsync("big.csv", ExcelParser.FromAttributes<SalesRow>(), new CsvParallelOptions { DegreeOfParallelism = 8 }))
+using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
+await foreach (var row in SheetParallel.ParseAsync(workbook.FirstSheet, ExcelParser.FromAttributes<SalesRow>(), new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += row.Revenue;
 }
 ```
 
-Rows arrive in file order, identical to the sequential parser. Parsing and type conversion run across
-threads; whatever your loop body does per row does not — if that dominates, raising the degree will
-not help. Sources that cannot be partitioned (non-seekable streams, non-UTF-8 encodings, small files)
-fall back to sequential parsing with the same results.
+You own the workbook: keep it open until the task completes or the enumeration ends. For CSV, give the dialect when you open it (`Excel.FromCsvFile(path, dialect)`), not in the options. `DegreeOfParallelism` of `0` (the default) uses every processor; `1` reads sequentially.
+
+There are three families, each over a sheet:
+
+| Family | Result | Order |
+|---|---|---|
+| `ParseAsync<T>` | an `IAsyncEnumerable<T>` | the sheet's own order, identical to `parser.Parse(sheet)` |
+| `ForEachAsync` | calls your callback on the worker threads | none |
+| `AggregateAsync` | folds one accumulator per partition into a result | the same result as a single-threaded run |
 
-For a fold or a per-row side effect, `CsvParallel.ForEachAsync` accepts a `ref struct` row type, so text
-columns stay as `ReadOnlySpan<byte>` and the per-row model allocation disappears entirely — a class
-model still costs one instance per row:
+Parsing and type conversion run across threads; whatever your loop body does per row does not, so if that dominates, raising the degree will not help.
+
+Both of the next two examples read a `ref struct` model, so text columns stay as `ReadOnlySpan<byte>` and the per-row model allocation disappears; a class model still costs one instance per row.
+
+A fold over an XLSX sheet, with one accumulator per partition merged in sheet order:
 
 ```csharp
 public ref struct SaleRow
@@ -53,32 +64,66 @@ public ref struct SaleRow
     [ExcelColumn("Units")]  public int Units { get; set; }
 }
 
+public sealed class UnitTotal : IRowAccumulator<UnitTotal, SaleRow>
+{
+    public long Units;
+
+    public void Add(SaleRow model) => Units += model.Units;
+
+    public void Merge(UnitTotal following) => Units += following.Units;
+}
+
+using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
+UnitTotal total = await SheetParallel.AggregateAsync<UnitTotal, SaleRow>(
+    workbook.FirstSheet,
+    ExcelParser.FromAttributes<SaleRow>(),
+    new SheetParallelOptions { HeaderRow = 1 });
+```
+
+The same call takes a `RowAggregation<TState>` when you would rather pass delegates than write a type, and an `IRowRecord<TRecord>` type in place of the parser.
+
+A per-row callback:
+
+```csharp
+using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
 long total = 0;
-await CsvParallel.ForEachAsync(
-    "big.csv",
+await SheetParallel.ForEachAsync(
+    workbook.FirstSheet,
     ExcelParser.FromAttributes<SaleRow>(),
     row => Interlocked.Add(ref total, row.Units),
-    new CsvParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 });
+    new SheetParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 });
 ```
 
-Unlike `CsvParallel.ParseAsync`, the callback runs on the worker threads, so records arrive in no
-particular order and the callback must be safe to call from several threads at once. Spans are valid
-only for the duration of the call.
-
-Delivery is at least once, not exactly once: the callback may be invoked more than once for the same
-record. A partition whose start offset was guessed wrongly is read again from the confirmed offset, and
-the discarded pass may already have delivered a whole partition's worth of records — 1 MiB to 64 MiB of them, not just a few near the seam.
-On a source with quoted fields those records may also be misparsed, carrying values that appear nowhere
-in the file, and an exception the callback threw during a discarded pass is discarded with it. A start
-is only guessed wrongly inside a quoted field, so a source in which the quote character never appears
-delivers every record exactly once; for that guarantee on any source, use `CsvParallel.AggregateAsync`,
-where the discarded partition's accumulator is thrown away, and apply side effects once it returns.
-A callback that writes to a database or sends messages must be idempotent and must also tolerate
-records that do not exist — deduplicating on a key does not filter those out.
-
-See the [parallel CSV benchmarks](../performance/benchmarks.md#parallel-csv) for what this buys. Those figures are
-`CsvParallel.AggregateAsync`'s, measured over the same projection path this shares: at dop 16 it is
-~2.8x faster than the typed path while allocating ~410x less, with zero garbage collections.
+Unlike `ParseAsync`, the callback runs on the worker threads, so records arrive in no particular order and the callback must be safe to call from several threads at once. Spans are valid only for the duration of the call.
+
+`HeaderRow` follows the same rule as before: `ParseAsync` takes the header from the parser's `ExcelParserConfig.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`, while the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+
+#### When it reads sequentially
+
+These cases read on one thread with the same results and no error:
+
+- `DegreeOfParallelism` of 1.
+- A sheet under 256 KB uncompressed.
+- XLS.
+- A table view (`ExcelTable.AsSheet()`).
+- A CSV that cannot be partitioned: a non-seekable stream or a non-UTF-8 encoding. A CSV over a `MemoryStream` is one of them; pass the bytes as `ReadOnlyMemory<byte>` to partition it.
+
+`PrefetchDecompression` does not apply on this path: XLSX and XLSB go through a pipeline that already overlaps inflate and parse.
+
+#### Delivery guarantees
+
+- **`ParseAsync` and `AggregateAsync`** are exact on every format. `ParseAsync` yields the same items in the same order as the sequential parse; `AggregateAsync` equals its own single-threaded run.
+- **XLSB** delivers every row exactly once, in `ForEachAsync` too.
+- **XLSX** delivers exactly once for a well-formed sheet. The pipeline cuts the inflated sheet at what looks like a row start; on a sheet where those bytes sit inside cell content (a CDATA run, a comment) or the file is truncated, a worker detects it, and the read recovers by reading the rest sequentially. `ParseAsync` and `AggregateAsync` stay exact. In `ForEachAsync`, workers may already have called the callback for chunks that are then dropped, so on such a sheet rows can be delivered twice, or be rows the sequential reader would not produce.
+- **CSV** is at least once in `ForEachAsync`, unchanged from v6: the callback may be invoked more than once for the same record. A partition whose start offset was guessed wrongly is read again from the confirmed offset, and the discarded pass may already have delivered a whole partition's worth of records, 1 MiB to 64 MiB of them, not just a few near the seam. On a source with quoted fields those records may also be misparsed, carrying values that appear nowhere in the file, and an exception the callback threw during a discarded pass is discarded with it. A start is only guessed wrongly inside a quoted field, so a source in which the quote character never appears delivers every record exactly once. For that guarantee on any source, use `AggregateAsync`, where the discarded partition's accumulator is thrown away, and apply side effects once it returns.
+
+A callback that writes to a database or sends messages must be idempotent on CSV, and on XLSX if the sheet may be malformed, and must also tolerate records that do not exist: deduplicating on a key does not filter those out.
+
+`ExcelParseException.Row` on `ParseAsync` counts the rows emitted so far. On `ForEachAsync` and `AggregateAsync` it is the exact row when the read is sequential and `0` when it was partitioned.
+
+See the [parallel sheet benchmarks](../performance/benchmarks.md#parallel-sheet-reading) and the [parallel CSV benchmarks](../performance/benchmarks.md#parallel-csv) for what this buys. On a real-data XLSX the sheet stage drops from 29 ms (prefetched, sequential) to about 18 ms, and on XLSB from 16 ms to about 13 ms; the floor is inflate, which runs on one thread. CSV has no such floor: its `AggregateAsync` at dop 16 is ~2.8x faster than the typed path while allocating ~410x less, with zero garbage collections.
 
 Properties need setters. A get-only property is skipped during binding and silently receives nothing.
 
@@ -216,7 +261,7 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
 
 ## Reading sheets in parallel
 
-Each sheet of a workbook can be read on its own thread:
+This is one thread per sheet. To read a single sheet on several threads, see [Parallel reading](#parallel-reading-opt-in). Each sheet of a workbook can be read on its own thread:
 
 ```csharp
 using XlsxWorkbook workbook = Excel.FromXlsxFile(path);
diff --git a/docs/performance/reader-performance.md b/docs/performance/reader-performance.md
index 02b94976..46031f41 100644
--- a/docs/performance/reader-performance.md
+++ b/docs/performance/reader-performance.md
@@ -488,9 +488,12 @@ starts. Typed models, allocating, own interleave:
 | dop 6 | 5.068 ms (2.80x) |
 | dop 12 | 4.107 ms (3.46x) |
 
-This is the one place in the library where parallelism converts, and it converts because CSV has no
-inflate floor. It is only available on the typed path: `Row` and `Cell` are `ref struct`s and cannot
-cross a thread boundary, so raw row enumeration hits the same wall as XLSX.
+This was the one place in the library where parallelism converted, and it converted because CSV has no
+inflate floor. Since v7 `SheetParallel` also reads XLSX and XLSB on several threads (see "Parallel intra-sheet
+parsing" below), with a smaller gain because inflate is still sequential. Parallel reading is only available on
+the typed path: `Row` and `Cell` are `ref struct`s and cannot cross a thread boundary, so raw row enumeration
+hits the same wall. `CsvParallel` is named `SheetParallel` in v7; the entries in this file keep the names they
+were measured under.
 
 ## Approaches measured and rejected
 
@@ -524,6 +527,37 @@ because inflate is then all that is left.
 It would also only ever serve the typed-parsing layer: `Row`/`Cell` are `ref struct` and cannot cross
 a thread boundary.
 
+**Update 2026-10-10: built.** `InflateStream` moved the inflate floor, so the prefetched XLSX read became
+parse-bound and the reasoning above no longer holds. A spike (Ryzen 7 5700X, real-data 65K corpus, min of 30
+interleaved rounds, sheet stage only, outputs identical to sequential) measured:
+
+| | XLSX (6.7 → 34.4 MB) | XLSB (3.7 → 15.9 MB) |
+|---|---|---|
+| read today, no prefetch / prefetch | 44.6 / 29.2 ms | 26.5 / 15.8 ms |
+| inflate only, whole buffer | 14.9 ms | 9.5 ms |
+| parse only, dop 1 / 2 / 4 / 8 | 29.0 / 14.8 / 7.8 / 4.2 ms | 15.4 / 7.8 / 4.0 / 2.3 ms |
+| A: 1 inflate thread + N parse workers (N ≥ 2) | 16.0 ms (1.8x) | 12.5 ms (1.25x) |
+| B oracle: parallel inflate + parse, 8 threads | 7.7 ms | 3.6 ms |
+
+A is what shipped: `SheetParallel` over XLSX and XLSB, one producer that inflates and cuts row-aligned chunks,
+`dop - 1` parse workers, an ordered merge (see ARCHITECTURE.md). The spike's consumer was light and its buffers
+were pre-touched, so those numbers are the shape of the gain, not a promise. Measured on the built pipeline
+(JIT harness, same corpus and method, light consumer, 256 KB chunks):
+
+| | XLSX | XLSB |
+|---|---|---|
+| prefetched sequential read | 28.35 ms | 15.65 ms |
+| pipeline, dop 3 to 16 | 17.6 ms (1.61x) | 13.3 ms (1.18x) |
+| typed `ParseAsync`, sequential / dop 4 | 55.4 / 18.9 ms | 37.6 / 14.4 ms |
+| `xl_parse_typed` over the published NativeAOT DLL, dop 1 / dop 0 | 54.1 / 20.3 ms (2.6x) | 28.1 / 15.2 ms (1.8x) |
+
+It saturates at dop 3, one producer plus two workers: dop 2 is a plain overlap of inflate and parse and gains
+nothing. The chunk size defaults to 256 KB, down from 1 MB: it removes ~0.5 ms of serial tail, and 4 MB adds
+~3.7 ms. XLSB stops at ~13 ms against a 9.6 ms inflate floor because the producer walks every BIFF12 record
+(~2.2 ms) and `InflateStream.Read` adds a copy (~0.7 ms). Only parallel inflate moves that. The
+BenchmarkDotNet tables for this are in `benchmarks.md`; they were taken on a loaded machine and are pending an
+idle rerun.
+
 ### Faster inflate — measured separately, no gain
 
 libdeflate was measured against `System.IO.Compression` on this workload before this investigation:
@@ -1115,6 +1149,13 @@ used to yield a silent prefix of its rows. `InflateStream` throws `InvalidDataEx
 
 ## Known open items
 
+- **Parallel inflate is the open lead (spec B, not built).** It replaces the pipeline's producer only; the
+  queue, workers and merge stay. The oracle ceilings at 8 threads, parallel inflate plus parse, are 7.7 ms for
+  XLSX and 3.6 ms for XLSB, against 17.6 and 13.3 ms for the shipped pipeline. A deflate block finder costs
+  0.4–1 ms per split point, with no false positives in 14 hits. The marker finding: XLSX back-references stop
+  depending on the unknown window after about 1 MB, but XLSB ones never do, so about 65–70% of XLSB bytes need
+  a second resolution pass. The cost of the 16-bit marker decode loop is unmeasured, and it decides whether
+  XLSB gains much.
 - `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The Tier1
   disassembly shows no spills and 88% of the time in `FastLoop` itself (see "The decode loop's Tier1
   disassembly"); the remainder is JIT codegen. A `uint bitsleft` is worth ~1.5% if anyone wants it.
diff --git a/python/README.md b/python/README.md
index d04edc65..bde9d4d3 100644
--- a/python/README.md
+++ b/python/README.md
@@ -177,11 +177,11 @@ once, typed or Arrow (see [Arrow](#arrow) below), and none disturbs another.
 Being a generator, `iter_parse_typed()` opens nothing until the first iteration, so a bad
 `batch_size` is only raised there, not at the call.
 
-#### Reading a large CSV on several threads
+#### Reading a large sheet on several threads
 
 `parse_typed()`, `to_arrow()`, `to_record_batch()` and `to_polars()` take `parallelism`: `1` (the
-default) reads on one thread, `0` uses every core, `n` up to n threads. Only CSV is split. Any other
-format, or a CSV under 256 KiB, is read on one thread with the same result. The table is identical
+default) reads on one thread, `0` uses every core, `n` up to n threads. XLSX, XLSB and CSV are split. XLS, or a
+sheet under 256 KiB, is read on one thread with the same result. The table is identical
 either way. Every partition's columns are held until they are merged, so the peak memory is higher
 than a sequential read of the same file. `to_polars()` with `parallelism` other than 1 parses the whole
 file instead of streaming it in batches.
@@ -193,6 +193,11 @@ file instead of streaming it in batches.
 | `65K_Records_Data.csv` (8 MB, 65,535 rows) | 21.4 ms | 5.8 ms | 3.7x |
 | the same rows ×20 (160 MB, 1.3M rows) | 425.9 ms | 117.5 ms | 3.6x |
 
+The same call on the real-data workbooks (XLSX 6.7 MB compressed, XLSB 3.7 MB; measured with the
+published NativeAOT library): XLSX 54.1 ms at
+`parallelism=1` against 20.3 ms at `0` (2.6x), XLSB 28.1 ms against 15.2 ms (1.8x). Inflate runs on
+one thread, so these formats stop scaling at about three threads.
+
 Peak working set on the 160 MB file, above the interpreter's own, went from 470 MiB to 503 MiB (both
 include the file's bytes and the handle's copy of them).
 
@@ -553,8 +558,8 @@ CSV, from `65K_Records_Data.csv` (8.2 MB), same 14 typed columns:
 
 polars' CSV reader is ahead (multithreaded, and it infers types from the text without our schema
 step); ExcelReader is ~10x faster than pandas on either engine. These include opening the file, so
-they are above the in-memory `xl_parse_typed` figures in [Reading a large CSV on several
-threads](#reading-a-large-csv-on-several-threads).
+they are above the in-memory `xl_parse_typed` figures in [Reading a large sheet on several
+threads](#reading-a-large-sheet-on-several-threads).
 
 ### Writing
 
diff --git a/rust/excelreader/README.md b/rust/excelreader/README.md
index 61c5412a..ea970955 100644
--- a/rust/excelreader/README.md
+++ b/rust/excelreader/README.md
@@ -71,7 +71,7 @@ for column in workbook.sheet(1)?.infer_schema(1, 100)? {
 `infer_schema_parse_text(header_row, sample_size)` also types text cells (every CSV field, or
 numbers stored as text): integers, decimals, `true`/`false` and ISO dates. `parse_sheet_parallel`
 and `arrow::parse_arrow_parallel` take a `degree_of_parallelism` (`0` = every processor, `1` =
-sequential); only CSV is split, and the result equals `parse_sheet`'s.
+sequential); XLSX, XLSB and CSV are split, and the result equals `parse_sheet`'s.
 
 A workbook hands out sheets. A `Sheet` is the workbook and an index: it holds no native
 resource, it is `Copy`, and every read on it opens its own cursor.
@@ -369,6 +369,9 @@ in this crate: a .NET thread resumes at address 0 after a signal the runtime sen
 process with no message. It happens with any `degree_of_parallelism` above 1, and the same runtime
 built into a plain C host does not show it, so a Rust host appears to make it far more likely.
 
+`parse_sheet_parallel` and `arrow::parse_arrow_parallel` now fan out on XLSX and XLSB too; this has not been tested
+on macOS, so treat them the same way.
+
 Until it is fixed upstream, pass `degree_of_parallelism: 1` on macOS for a sequential run, or keep
 sources under the 256 KB partitioning floor, where the library never fans out. Linux and Windows are
 unaffected. The crate's own partitioned aggregation tests are `#[ignore]`d on macOS for this reason.
diff --git a/src/ExcelReader.Native/README.md b/src/ExcelReader.Native/README.md
index 546e1b6f..dd0154f1 100644
--- a/src/ExcelReader.Native/README.md
+++ b/src/ExcelReader.Native/README.md
@@ -37,7 +37,7 @@ trace (needs `dotnet-trace` and `dotnet-pgo`):
 
 The XLSB methods are excluded on purpose: with their profile the XLSB parse got 3% slower, and
 without it 1.12x faster. Re-measured with the regenerated profile: including them makes XLSB typed
-parsing ~16% slower. Measure every format before and after replacing the profile. Some formats
+parsing ~22% slower. Measure every format before and after replacing the profile. Some formats
 may get worse, not only better.
 
 ## Layout

From 0ffacdef2d96b4dbf936ecd55ee557a1419a2648 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 00:49:08 -0300
Subject: [PATCH 080/115] fix: surface a source stream's own cancellation from
 the sheet pipeline

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../ParallelCsv/ParallelCsvEnumerable.cs      |  5 --
 .../Parser/ParallelCsv/ParallelCsvFactory.cs  |  2 +-
 .../SheetPipeline/SheetPipelineRunner.cs      |  3 +-
 .../ParallelCsv/ParallelCsvEnumerableTests.cs |  2 +-
 .../Parser/SheetPipeline/XlsxPipelineTests.cs | 68 +++++++++++++++++++
 5 files changed, 72 insertions(+), 8 deletions(-)

diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
index edb39806..82f862d2 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
@@ -3,7 +3,6 @@
 using ExcelReader.Core.Parser.Internal;
 using ExcelReader.Core.Reader.Csv;
 using ExcelReader.Core.Reader.Internal;
-using Microsoft.Win32.SafeHandles;
 
 namespace ExcelReader.Core.Parser.ParallelCsv
 {
@@ -18,7 +17,6 @@ internal sealed class ParallelCsvEnumerable<T> : IAsyncEnumerable<T>
         private readonly ExcelParserConfig _config;
         private readonly int _dop;
 
-        private readonly SafeFileHandle? _ownedHandle;
         private readonly ReaderLifetime? _lease;
         private readonly object? _owner;
 
@@ -31,7 +29,6 @@ internal ParallelCsvEnumerable(
             CsvReaderOptions readerOptions,
             ExcelParserConfig config,
             int degreeOfParallelism,
-            SafeFileHandle? ownedHandle,
             ReaderLifetime? lease = null,
             object? owner = null)
         {
@@ -43,7 +40,6 @@ internal ParallelCsvEnumerable(
             _readerOptions = readerOptions;
             _config = config;
             _dop = degreeOfParallelism;
-            _ownedHandle = ownedHandle;
             _lease = lease;
             _owner = owner;
         }
@@ -97,7 +93,6 @@ public async IAsyncEnumerator<T> GetAsyncEnumerator(CancellationToken cancellati
             {
                 await cts.CancelAsync().ConfigureAwait(false);
                 await allWorkers.ConfigureAwait(ConfigureAwaitOptions.SuppressThrowing);
-                _ownedHandle?.Dispose();
                 _lease?.Release();
             }
         }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
index 34babc94..9a34134c 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
@@ -71,7 +71,7 @@ private static IAsyncEnumerable<T> Build<T>(
                 return Sequential(source.OpenReader(options), parser, ct);
             }
 
-            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, null, lease, owner);
+            return new ParallelCsvEnumerable<T>(source, plan, dataStart, map, info, options, config, dop, lease, owner);
         }
 
         private static CsvEnumerable<T> Sequential<T>(
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
index 88413e03..a2262549 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetPipelineRunner.cs
@@ -131,7 +131,7 @@ await ChunkProducer.RunAsync(
                     },
                     ct).ConfigureAwait(false);
             }
-            catch (OperationCanceledException)
+            catch (OperationCanceledException) when (ct.IsCancellationRequested)
             {
             }
             catch (Exception ex)
@@ -158,6 +158,7 @@ private static async Task WorkAsync<TState>(
                 catch (Exception ex)
                 {
                     item.Done.TrySetException(ex);
+                    _ = item.Done.Task.Exception;
                     throw;
                 }
                 finally
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
index cc18ecb0..0d99f848 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
@@ -39,7 +39,7 @@ private static ParallelCsvEnumerable<TRow> Build<TRow>(byte[] csv, int dop, int
             CsvChunkPlan plan = CsvChunkPlan.Create(dataStart, csv.Length - dataStart, dop, chunkSizeOverride);
             return new ParallelCsvEnumerable<TRow>(
                 source, plan, dataStart, map, TypeMapper<TRow>.GetCsvInfo(),
-                CsvReaderOptions.Default, config, dop, null);
+                CsvReaderOptions.Default, config, dop);
         }
 
         private static async Task AssertSameFailureAsSequentialAsync<TRow>(byte[] csv, ExcelParserConfig config)
diff --git a/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs
index 45e949b6..f58ccccd 100644
--- a/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs
+++ b/tests/ExcelReader.Tests/Parser/SheetPipeline/XlsxPipelineTests.cs
@@ -82,6 +82,74 @@ public async Task MatchesSequential(int dop, int chunkBytes)
             Assert.Equal(Sequential(workbook, 3), await PipelineAsync(workbook, 3, dop, chunkBytes));
         }
 
+        [Fact]
+        public async Task SourceStreamCancellationIsNotSwallowed()
+        {
+            using var ms = WorkbookBuilder.Build(Rows(20000));
+            using var stream = new CancelAfterArmedStream(ms);
+            using XlsxWorkbook workbook = Excel.FromXlsx(stream);
+            SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
+            stream.Arm(100 * 1024);
+
+            await Assert.ThrowsAnyAsync<OperationCanceledException>(() =>
+                SheetPipelineRunner.AggregateAsync(source, Collecting, null, 0, 2, 64, CancellationToken.None));
+        }
+
+        private sealed class CancelAfterArmedStream(Stream inner) : Stream
+        {
+            private long _remaining = long.MaxValue;
+
+            public void Arm(long budget) => _remaining = budget;
+
+            public override bool CanRead => inner.CanRead;
+            public override bool CanSeek => inner.CanSeek;
+            public override bool CanWrite => false;
+            public override long Length => inner.Length;
+            public override long Position
+            {
+                get => inner.Position;
+                set => inner.Position = value;
+            }
+
+            public override void Flush()
+            {
+            }
+
+            public override int Read(byte[] buffer, int offset, int count)
+            {
+                int n = inner.Read(buffer, offset, count);
+                Spend(n);
+                return n;
+            }
+
+            public override int Read(Span<byte> buffer)
+            {
+                int n = inner.Read(buffer);
+                Spend(n);
+                return n;
+            }
+
+            public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
+            {
+                int n = await inner.ReadAsync(buffer, cancellationToken).ConfigureAwait(false);
+                Spend(n);
+                return n;
+            }
+
+            public override long Seek(long offset, SeekOrigin origin) => inner.Seek(offset, origin);
+            public override void SetLength(long value) => throw new NotSupportedException();
+            public override void Write(byte[] buffer, int offset, int count) => throw new NotSupportedException();
+
+            private void Spend(int n)
+            {
+                _remaining -= n;
+                if (_remaining < 0)
+                {
+                    throw new OperationCanceledException("source timeout");
+                }
+            }
+        }
+
         [Theory]
         [InlineData("")]
         [InlineData("<row r=\"1\"><c r=\"A1\"><v>1</v></c></row>")]

From 876d9ac88818639d0bc1f13b8f5ee2e000787aa5 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 00:50:41 -0300
Subject: [PATCH 081/115] docs: correct the CSV fallback rule and sample
 variables

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 ARCHITECTURE.md                              |  4 ++--
 docs/guide/migrating-to-v7.md                | 12 ++++++------
 docs/guide/reading.md                        |  4 ++--
 docs/performance/reader-performance.md       |  7 +++----
 python/README.md                             |  4 ++--
 src/ExcelReader.Core/Reader/SheetParallel.cs |  4 ++--
 6 files changed, 17 insertions(+), 18 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 67d45d6e..84bc9600 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -59,8 +59,8 @@ opt-in, takes any `IExcelSheet`, validates its arguments and dispatches on the s
 | anything else, and every fallback case | one sequential runner over `IExcelRowEnumerator` |
 
 The fallback cases give the same results with no error: a degree of parallelism of 1, a sheet under 256 KB
-uncompressed, XLS, a table view (`ExcelTable.AsSheet`), and a CSV that cannot be partitioned (a non-seekable
-stream or a non-UTF-8 encoding). The caller owns the workbook; the engine holds a `ReaderLifetime` lease
+uncompressed, XLS, a table view (`ExcelTable.AsSheet`), and a CSV that cannot be partitioned (a stream that is not a file
+or a non-UTF-8 encoding). The caller owns the workbook; the engine holds a `ReaderLifetime` lease
 until the task completes or the enumeration ends.
 
 The CSV engine is not folded into a shared partition abstraction. It is tuned, and its model, a static
diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 1bd4f4bd..ca2660f7 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -26,13 +26,13 @@ A CSV file:
 
 ```csharp
 // v6
-await foreach (Sale s in CsvParallel.ParseAsync(path, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+await foreach (Sale s in CsvParallel.ParseAsync(path, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = options }))
 {
     Total += s.Revenue;
 }
 
 // v7
-using CsvReader csv = Excel.FromCsvFile(path, dialect);
+using CsvReader csv = Excel.FromCsvFile(path, options);
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
@@ -43,13 +43,13 @@ CSV bytes in memory:
 
 ```csharp
 // v6
-await foreach (Sale s in CsvParallel.ParseAsync(data, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+await foreach (Sale s in CsvParallel.ParseAsync(data, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = options }))
 {
     Total += s.Revenue;
 }
 
 // v7
-using CsvReader csv = Excel.FromCsv(data, dialect);
+using CsvReader csv = Excel.FromCsv(data, options);
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
@@ -60,13 +60,13 @@ A stream:
 
 ```csharp
 // v6
-await foreach (Sale s in CsvParallel.ParseAsync(stream, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = dialect }))
+await foreach (Sale s in CsvParallel.ParseAsync(stream, parser, new CsvParallelOptions { DegreeOfParallelism = 8, Reader = options }))
 {
     Total += s.Revenue;
 }
 
 // v7
-using CsvReader csv = Excel.FromCsv(stream, leaveOpen: true, dialect);
+using CsvReader csv = Excel.FromCsv(stream, leaveOpen: true, options);
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index 53ae2455..2454130d 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -41,7 +41,7 @@ await foreach (var row in SheetParallel.ParseAsync(workbook.FirstSheet, ExcelPar
 }
 ```
 
-You own the workbook: keep it open until the task completes or the enumeration ends. For CSV, give the dialect when you open it (`Excel.FromCsvFile(path, dialect)`), not in the options. `DegreeOfParallelism` of `0` (the default) uses every processor; `1` reads sequentially.
+You own the workbook: keep it open until the task completes or the enumeration ends. For CSV, give the dialect when you open it (`Excel.FromCsvFile(path, options)`), not in the options. `DegreeOfParallelism` of `0` (the default) uses every processor; `1` reads sequentially.
 
 There are three families, each over a sheet:
 
@@ -108,7 +108,7 @@ These cases read on one thread with the same results and no error:
 - A sheet under 256 KB uncompressed.
 - XLS.
 - A table view (`ExcelTable.AsSheet()`).
-- A CSV that cannot be partitioned: a non-seekable stream or a non-UTF-8 encoding. A CSV over a `MemoryStream` is one of them; pass the bytes as `ReadOnlyMemory<byte>` to partition it.
+- A CSV that cannot be partitioned: a stream that is not a file, or a non-UTF-8 encoding. Only in-memory data (`ReadOnlyMemory<byte>`, `byte[]`) and a `FileStream`-backed source partition; a CSV over a `MemoryStream` does not, so pass its bytes as `ReadOnlyMemory<byte>`.
 
 `PrefetchDecompression` does not apply on this path: XLSX and XLSB go through a pipeline that already overlaps inflate and parse.
 
diff --git a/docs/performance/reader-performance.md b/docs/performance/reader-performance.md
index 46031f41..6a77667c 100644
--- a/docs/performance/reader-performance.md
+++ b/docs/performance/reader-performance.md
@@ -549,9 +549,9 @@ were pre-touched, so those numbers are the shape of the gain, not a promise. Mea
 | prefetched sequential read | 28.35 ms | 15.65 ms |
 | pipeline, dop 3 to 16 | 17.6 ms (1.61x) | 13.3 ms (1.18x) |
 | typed `ParseAsync`, sequential / dop 4 | 55.4 / 18.9 ms | 37.6 / 14.4 ms |
-| `xl_parse_typed` over the published NativeAOT DLL, dop 1 / dop 0 | 54.1 / 20.3 ms (2.6x) | 28.1 / 15.2 ms (1.8x) |
+| `xl_parse_typed` over the published NativeAOT DLL, dop 1 / dop 0 | 54.1 / 20.3 ms (2.6x) | 28.2 / 15.2 ms (1.85x) |
 
-It saturates at dop 3, one producer plus two workers: dop 2 is a plain overlap of inflate and parse and gains
+Under the JIT the sheet stage stops scaling at dop 3, one producer plus two workers: dop 2 is a plain overlap of inflate and parse and gains
 nothing. The chunk size defaults to 256 KB, down from 1 MB: it removes ~0.5 ms of serial tail, and 4 MB adds
 ~3.7 ms. XLSB stops at ~13 ms against a 9.6 ms inflate floor because the producer walks every BIFF12 record
 (~2.2 ms) and `InflateStream.Read` adds a copy (~0.7 ms). Only parallel inflate moves that. The
@@ -1153,8 +1153,7 @@ used to yield a silent prefix of its rows. `InflateStream` throws `InvalidDataEx
   queue, workers and merge stay. The oracle ceilings at 8 threads, parallel inflate plus parse, are 7.7 ms for
   XLSX and 3.6 ms for XLSB, against 17.6 and 13.3 ms for the shipped pipeline. A deflate block finder costs
   0.4–1 ms per split point, with no false positives in 14 hits. The marker finding: XLSX back-references stop
-  depending on the unknown window after about 1 MB, but XLSB ones never do, so about 65–70% of XLSB bytes need
-  a second resolution pass. The cost of the 16-bit marker decode loop is unmeasured, and it decides whether
+  depending on the unknown window after about 1 MB, but XLSB ones never do, so about 65–70% of XLSB output bytes depend on the unknown window. The cost of the 16-bit marker decode loop is unmeasured, and it decides whether
   XLSB gains much.
 - `InflateStream` reaches about three quarters of libdeflate's inflate speed on XLSX. The Tier1
   disassembly shows no spills and 88% of the time in `FastLoop` itself (see "The decode loop's Tier1
diff --git a/python/README.md b/python/README.md
index bde9d4d3..16bf8f9f 100644
--- a/python/README.md
+++ b/python/README.md
@@ -195,8 +195,8 @@ file instead of streaming it in batches.
 
 The same call on the real-data workbooks (XLSX 6.7 MB compressed, XLSB 3.7 MB; measured with the
 published NativeAOT library): XLSX 54.1 ms at
-`parallelism=1` against 20.3 ms at `0` (2.6x), XLSB 28.1 ms against 15.2 ms (1.8x). Inflate runs on
-one thread, so these formats stop scaling at about three threads.
+`parallelism=1` against 20.3 ms at `0` (2.6x), XLSB 28.2 ms against 15.2 ms (1.85x). Inflate runs on
+one thread, so under the JIT the sheet stage stops scaling at about three threads.
 
 Peak working set on the 160 MB file, above the interpreter's own, went from 470 MiB to 503 MiB (both
 include the file's bytes and the handle's copy of them).
diff --git a/src/ExcelReader.Core/Reader/SheetParallel.cs b/src/ExcelReader.Core/Reader/SheetParallel.cs
index 5d643ef8..8406aa60 100644
--- a/src/ExcelReader.Core/Reader/SheetParallel.cs
+++ b/src/ExcelReader.Core/Reader/SheetParallel.cs
@@ -19,8 +19,8 @@ namespace ExcelReader.Core.Reader
     /// <para>
     /// A read falls back to one sequential pass, with the same results and no error, when
     /// <see cref="SheetParallelOptions.DegreeOfParallelism"/> is 1, the sheet is too small to partition
-    /// usefully, the sheet is an XLS sheet or a table view, or a CSV cannot be partitioned (a non-seekable
-    /// stream or a non-UTF-8 encoding).
+    /// usefully, the sheet is an XLS sheet or a table view, or a CSV cannot be partitioned (a stream that is not a file
+    /// or a non-UTF-8 encoding).
     /// </para>
     /// <para>
     /// Delivery guarantees. The general contract is the weaker CSV one: <c>ForEachAsync</c> is at-least-once,

From e56971d8128f7d62380c6007c77910fe352e08ff Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:06:10 -0300
Subject: [PATCH 082/115] fix(reader): decode OOXML _xHHHH_ escapes in XLSX
 text

Excel writes characters XML cannot hold, such as CR, as _xHHHH_ (UTF-16 code
unit HHHH), and a literal "_x0041_" as "_x005F_x0041_". The library's own
writer emits the same escapes, but the reader returned them as literal text,
so a round trip through the library corrupted strings. Shared strings, inline
strings, formula string results and table column names now decode them,
including surrogate pairs; a lone surrogate or a malformed escape stays
literal.

HexVal also accepted bytes below '0' and '@'..'`' as hex digits because an
int <= uint comparison widens to long; it now rejects them.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Xlsx/XlsxTables.cs                 |   2 +-
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |   6 +-
 .../Reader/Xlsx/XlsxWorkbook.Loading.cs       |   2 +-
 src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs   | Bin 11871 -> 14872 bytes
 .../Reader/Xlsx/XStringEscapeTests.cs         | 123 ++++++++++++++++++
 5 files changed, 128 insertions(+), 5 deletions(-)
 create mode 100644 tests/ExcelReader.Tests/Reader/Xlsx/XStringEscapeTests.cs

diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
index 2899e7b6..0e906ad5 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxTables.cs
@@ -44,7 +44,7 @@ private static string[] ColumnNames(ReadOnlySpan<byte> xml, ReadOnlySpan<byte> p
             List<string> names = [];
             foreach (ReadOnlySpan<byte> column in new TagSpanEnumerable(xml, XlsxXml.Token("<"u8, prefix, "tableColumn"u8)))
             {
-                names.Add(XlsxXml.DecodeToString(XlsxXml.Attr(column, " name="u8)));
+                names.Add(XlsxXml.DecodeXStringToString(XlsxXml.Attr(column, " name="u8)));
             }
             return [.. names];
         }
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 1f7c928d..12741b73 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -516,7 +516,7 @@ private int TryEmitPlainInline(byte[] buf, int len, int p, int col, int style)
                     return -1;
                 }
                 int lt = textStart + rel;
-                if (!buf.AsSpan(lt, Math.Min(13, len - lt)).StartsWith("</t></is></c>"u8))
+                if (!buf.AsSpan(lt, Math.Min(13, len - lt)).StartsWith("</t></is></c>"u8) || buf.AsSpan(textStart, rel).IndexOf("_x"u8) >= 0)
                 {
                     return -1;
                 }
@@ -878,7 +878,7 @@ private void EmitScalarValue(Kind kind, ReadOnlySpan<byte> v, int col, int style
 
             private void EmitScalarValueFast(Kind kind, ReadOnlySpan<byte> v, int valueStart, int col, int style)
             {
-                if (kind == Kind.IsoDate || (kind == Kind.Formula && v.IndexOf((byte)'&') >= 0))
+                if (kind == Kind.IsoDate || (kind == Kind.Formula && (v.IndexOf((byte)'&') >= 0 || v.IndexOf("_x"u8) >= 0)))
                 {
                     EmitScalarValue(kind, v, col, style);
                     return;
@@ -964,7 +964,7 @@ private void AppendDecoded(ReadOnlySpan<byte> src)
                     return;
                 }
                 Span<byte> dst = _acc.ReserveValueSpan(src.Length);
-                _acc.Advance(XlsxXml.Decode(src, dst));
+                _acc.Advance(XlsxXml.UnescapeXString(dst[..XlsxXml.Decode(src, dst)]));
             }
 
             private void AppendRaw(ReadOnlySpan<byte> src)
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
index 80df6e9f..4e06ef2c 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
@@ -278,7 +278,7 @@ private int TryAppendPlainShared(BufferedStreamCursor io, SharedStringTokens tok
             }
             EnsureSharedFlat(flat + rel, flat);
             text[..rel].CopyTo(_sharedFlat.AsSpan(flat));
-            flat += rel;
+            flat += XlsxXml.UnescapeXString(_sharedFlat.AsSpan(flat, rel));
             return io.Pos + 7 + rel + 9;
         }
 
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs
index 8cc6c831a52440b848723176371330db5c649f03..783da178639a4fb111ae3e0dec011c5c4a114dc0 100644
GIT binary patch
delta 1871
zcmaJ?&rcgy5Uwp8+9C>}wgatA#suTt+AMY<CW`G=Q4>T|Do`*Ll4Dtm{cNwaee3SN
zjg1s3>VH7>F1_@BNX4B~&s8ryxA`-A>&)8)>?G8eWp`%2`R1D+{QdkF@%ke1YGVTq
z>#bu?xEAk$U?TzEfZ4VOCLGmw)=On*I~@i-w*;6Tv_`x5Yk_9+4!YQuV6JJyN^4Xs
zZk1Xq<fC5h?_7S;jgKMxVYX*J_rT#nDs$I%nb|pouFF^loGu)Hw+D<1OIXaSfao)D
zd@=9^SRQcpg1KNjyoV3bHxUHw7Duxo2g&r^BhI|GIbg?!svPZbVDjq8sbF8Jbn;+1
zRib=QQ}4!8-eIHtu7-qH{0DmFiYL*vx}cG>+>7RCNEl;}@t)|*pKhh+xPYOHwIh=9
z`Ej}SZQJ3V{{xm$gU5_S3u!!2oHT-Hkh5Vl3o3s@L8w<O5(^1H1>^GP_^0xp<*Au#
z%$hWp;&Oj6nNmP1G@oyVr6^#0m2YNOWp6$|ugc8Vuz3L~Y0e~LDo9q+X?d1eSfhNL
z8Xl-|$?Yvwh)R!KU7w?;3aCO6z78Y|G=X&`13XmrNgYW`CEuZKwV9H%Kw!G@jWal{
zJAp6(wcqBG`XzI8c^62z0oH|9dGJwkiulOZQj(OB2Z<T^I-Zx$wHdj0dueu}0rJmC
zT;7d*m>Zjl4)cV?O<_5_K!Y~XgM;P8$WS)#EUwciWa{qeGwfc7d4&6*d5-V4SrFOo
zo37dtX)a{sAUYi>;-q94em0(ZyH>A%=)11dGX>LVnRHlNgBvj$+gD?ufNf`}0_X+d
z_MG808rmplnY6*#QB4}so&|{txG_WBc*1EU>&}trKG4SMR-=Y=qopn48xIm(qZ8M$
zk}|Q><_(E%&Y@T2?PNT%E%yrvY|Px96UVXNQ~YI%W~mj|f?^|Hsryrd+y}YIp`g|T
zZ3x#Bs;~_&UqbM)QEWn{1{xg!J=e;OSxV!U(YU2NZfWIoJPWcOy%+16w#R7ww{RU^
zn6^*rU!3IAbzIPBT`aVHS;0pY%J|6V<v|oaCriib;VrGfE*pJs+9CUfB_GYlY3F0g
zel^qBnlSO3*|pDtoLZ3l3n-O!$OnKj6H719k;ZCCI$ilF;irV_Gt@qN{zqbSI`#II
zq+w9I*)R+lNvDX&`9}I|I_4u?U0$pnEokab93;HF)f(LQ6|mgQZpn+pygbW3mdnZM
zd%@kSJK_EH+;#y*!T*+rpybnu2l~%Whl?bC&2Cfd%Kyev1r(Z)z3h_QS)D_O!Y2h#
zgA``K^S*TcS9T>*(84cxq~2F7);VnIc&vtcQ%BuWGMW2*>*kmfzuRT5@yMggp%n`l
O7euSz^M7;QTmJ!TFk8U@

delta 80
zcmV-W0I&a;bl+UCz7>-oFc7oKA2SD&87CZ*k`xlNNhgp8liw~>lQ}O`lesV%le!-e
mlQ1w1lkPAdlWHg#votXx0ReZDfHL9&cPW#BG99zBGiC<5<s8ib

diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/XStringEscapeTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/XStringEscapeTests.cs
new file mode 100644
index 00000000..0d56ae59
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/XStringEscapeTests.cs
@@ -0,0 +1,123 @@
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+using ExcelReader.Core.Writer.Xlsx;
+using ExcelReader.Tests.Writer.Tables;
+
+namespace ExcelReader.Tests.Reader.Xlsx
+{
+    public class XStringEscapeTests
+    {
+        public static TheoryData<string> RoundTripText()
+        {
+            return new()
+            {
+                "a\rb",
+                "line1\r\nline2",
+                "a\u0001b _x0041_",
+                "_x000D_",
+                "x_y_z",
+                "trailing_",
+                "_x0041",
+                "\u001F\u0000",
+            };
+        }
+
+        private static List<string> ReadFirstColumn(Stream workbook)
+        {
+            using XlsxWorkbook reader = Excel.FromXlsx(workbook);
+            var values = new List<string>();
+            foreach (Row row in reader.FirstSheet)
+            {
+                values.Add(row[0].GetString());
+            }
+            return values;
+        }
+
+        [Theory]
+        [MemberData(nameof(RoundTripText))]
+        public async Task TextWrittenByTheLibraryReadsBackUnchanged(string text)
+        {
+            foreach (bool shared in new[] { false, true })
+            {
+                var ms = new MemoryStream();
+                await using (XlsxWorkbookWriter wb = XlsxWorkbookWriter.Create(ms, leaveOpen: true, new XlsxWriterOptions { UseSharedStrings = shared }))
+                {
+                    XlsxSheetWriter sheet = wb.AddSheet("S1");
+                    await using (XlsxRowWriter row = await sheet.StartRowAsync(TestContext.Current.CancellationToken))
+                    {
+                        row.Write(text);
+                    }
+                    await sheet.EndAsync(TestContext.Current.CancellationToken);
+                    await wb.EndAsync(TestContext.Current.CancellationToken);
+                }
+                ms.Position = 0;
+
+                Assert.Equal([text], ReadFirstColumn(ms));
+            }
+        }
+
+        public static TheoryData<string, string> ExcelEscapes()
+        {
+            return new()
+            {
+                { "a_x000D_b", "a\rb" },
+                { "a_x000d_b", "a\rb" },
+                { "_x000D__x000A_", "\r\n" },
+                { "_x005F_x0041_", "_x0041_" },
+                { "_x0041_", "A" },
+                { "_xD83D__xDE00_", "\U0001F600" },
+                { "_xD800_", "_xD800_" },
+                { "_xDE00_x", "_xDE00_x" },
+                { "_X000D_", "_X000D_" },
+                { "_x00D_", "_x00D_" },
+                { "_x000G_", "_x000G_" },
+            { "_x00!0_", "_x00!0_" },
+            { "_x00@0_", "_x00@0_" },
+                { "a_x000D", "a_x000D" },
+                { "&amp;_x0026_", "&&" },
+            };
+        }
+
+        [Theory]
+        [MemberData(nameof(ExcelEscapes))]
+        public void EscapesInSharedInlineAndFormulaTextAreDecoded(string xml, string expected)
+        {
+            string rows =
+                $"""<row r="1"><c r="A1" t="s"><v>0</v></c><c r="B1" t="inlineStr"><is><t>{xml}</t></is></c><c r="C1" t="str"><f>A1</f><v>{xml}</v></c><c r="D1" t="s"><v>1</v></c></row>""";
+            string sharedStrings = $"""<si><t>{xml}</t></si><si><r><t>[</t></r><r><t>{xml}</t></r><r><t>]</t></r></si>""";
+            using MemoryStream ms = WorkbookBuilder.Build(rows, sharedStrings);
+            using XlsxWorkbook reader = Excel.FromXlsx(ms);
+
+            using XlsxWorkbook.Enumerator e = reader.FirstSheet.GetEnumerator();
+            Assert.True(e.MoveNext());
+            Row row = e.Current;
+            Assert.Equal(expected, row[0].GetString());
+            Assert.Equal(expected, row[1].GetString());
+            Assert.Equal(expected, row[2].GetString());
+            Assert.Equal("[" + expected + "]", row[3].GetString());
+        }
+
+        [Fact]
+        public void APrefixedSheetDecodesEscapesInInlineText()
+        {
+            using MemoryStream ms = WorkbookBuilder.BuildPrefixed(
+                "x", """<x:row r="1"><x:c r="A1" t="inlineStr"><x:is><x:t>a_x000D_b</x:t></x:is></x:c></x:row>""");
+
+            Assert.Equal(["a\rb"], ReadFirstColumn(ms));
+        }
+
+        [Fact]
+        public void ATableColumnNameWrittenByTheLibraryReadsBackUnchanged()
+        {
+            ITableBook book = TableBooks.Create("xlsx");
+            book.AddSheet("S");
+            book.BeginTable("Codes", ["Code_x0041_", "Line_x000D_"]);
+            book.Row("a", "b");
+            byte[] package = book.Finish();
+
+            using XlsxWorkbook reader = Excel.FromXlsx(package);
+            Assert.True(reader.TryGetTable("Codes", out ExcelTable? table));
+            Assert.Equal(["Code_x0041_", "Line_x000D_"], table.ColumnNames);
+        }
+    }
+}

From 60686eb02928dc679af4ec8913c27b1df2dcfcbd Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:06:10 -0300
Subject: [PATCH 083/115] fix(reader): reject a streamed ZIP entry that ends
 short of its declared size

Sheets are read through a stream that never compared the bytes it produced
with the entry's declared uncompressed size; only whole-part reads did. A
damaged deflate stream that decoded as an early final block therefore ended a
sheet silently, mid-way (one test workbook stopped at 298 of 30,000 rows,
sequential and parallel alike). The entry stream now throws
InvalidDataException when it reaches its end short of the declared size, or
produces more than it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../Reader/Internal/WorkbookLookups.cs        |  4 +-
 .../Reader/Zip/LimitedReadStream.cs           | 32 ++++++++----
 .../Reader/ReaderLimitTests.cs                |  3 +-
 .../Reader/Xlsx/CorruptSheetEntryTests.cs     | 46 +++++++++++++++++
 .../Reader/Zip/ZipIndexTests.cs               | 50 +++++++++++++++++++
 5 files changed, 121 insertions(+), 14 deletions(-)
 create mode 100644 tests/ExcelReader.Tests/Reader/Xlsx/CorruptSheetEntryTests.cs

diff --git a/src/ExcelReader.Core/Reader/Internal/WorkbookLookups.cs b/src/ExcelReader.Core/Reader/Internal/WorkbookLookups.cs
index 186910ae..8d13eb95 100644
--- a/src/ExcelReader.Core/Reader/Internal/WorkbookLookups.cs
+++ b/src/ExcelReader.Core/Reader/Internal/WorkbookLookups.cs
@@ -85,9 +85,9 @@ internal static LimitedReadStream Wrap(
         {
             if (!options.PrefetchDecompression || uncompressedSize < PrefetchMinUncompressedSize)
             {
-                return new LimitedReadStream(opened, counter, entryLimitName, entryLimit);
+                return new LimitedReadStream(opened, uncompressedSize, counter, entryLimitName, entryLimit);
             }
-            return new LimitedReadStream(new PrefetchStream(opened), counter, entryLimitName, entryLimit);
+            return new LimitedReadStream(new PrefetchStream(opened), uncompressedSize, counter, entryLimitName, entryLimit);
         }
 
         internal static int InitialBufferCapacity(long entryLength)
diff --git a/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs b/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
index 185a25ba..a1863f9a 100644
--- a/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
+++ b/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
@@ -33,14 +33,20 @@ internal sealed class LimitedReadStream : Stream
         private readonly Stream _inner;
         private readonly DecompressedByteCounter? _totalCounter;
         private readonly DecompressedByteCounter? _entryCounter;
+        private readonly long _declaredLength;
+        private long _produced;
 
+        // declaredLength is the entry's size from the central directory. Neither raw deflate nor a stored
+        // entry can tell a cut-short stream from a complete one, so the length is the only end-of-data check.
         internal LimitedReadStream(
             Stream inner,
+            long declaredLength,
             DecompressedByteCounter? totalCounter,
             string entryLimitName = "",
             long entryLimit = 0)
         {
             _inner = inner;
+            _declaredLength = declaredLength;
             _totalCounter = totalCounter;
             _entryCounter = entryLimit > 0 ? new DecompressedByteCounter(entryLimit, entryLimitName) : null;
         }
@@ -63,23 +69,17 @@ public override void Flush()
 
         public override int Read(byte[] buffer, int offset, int count)
         {
-            int read = _inner.Read(buffer, offset, count);
-            Count(read);
-            return read;
+            return Count(_inner.Read(buffer, offset, count), count);
         }
 
         public override int Read(Span<byte> buffer)
         {
-            int read = _inner.Read(buffer);
-            Count(read);
-            return read;
+            return Count(_inner.Read(buffer), buffer.Length);
         }
 
         public override async ValueTask<int> ReadAsync(Memory<byte> buffer, CancellationToken cancellationToken = default)
         {
-            int read = await _inner.ReadAsync(buffer, cancellationToken).ConfigureAwait(false);
-            Count(read);
-            return read;
+            return Count(await _inner.ReadAsync(buffer, cancellationToken).ConfigureAwait(false), buffer.Length);
         }
 
         public override Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
@@ -117,14 +117,24 @@ public override async ValueTask DisposeAsync()
             await base.DisposeAsync().ConfigureAwait(false);
         }
 
-        private void Count(int read)
+        private int Count(int read, int requested)
         {
             if (read <= 0)
             {
-                return;
+                if (requested > 0 && _produced != _declaredLength)
+                {
+                    throw new InvalidDataException("The ZIP entry produced less data than its declared uncompressed size.");
+                }
+                return read;
+            }
+            _produced += read;
+            if (_produced > _declaredLength)
+            {
+                throw new InvalidDataException("The ZIP entry produced more data than its declared uncompressed size.");
             }
             _totalCounter?.Add(read);
             _entryCounter?.Add(read);
+            return read;
         }
     }
 }
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index 0153e247..4469dbaa 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -395,7 +395,7 @@ public void ZeroTotalDecompressedLimitRestoresUnlimitedTotalRead()
         public async Task LimitedReadStreamCoversUnsupportedOperationsAndByteArrayAsyncRead()
         {
             await using MemoryStream inner = new([1, 2, 3, 4, 5]);
-            await using LimitedReadStream limited = new(inner, new DecompressedByteCounter(limit: 10));
+            await using LimitedReadStream limited = new(inner, declaredLength: 5, new DecompressedByteCounter(limit: 10));
 
             Assert.True(limited.CanRead);
             Assert.False(limited.CanSeek);
@@ -421,6 +421,7 @@ public void LimitedReadStreamCountsSpanReadsAndEntryLimit()
             using MemoryStream inner = new([1, 2, 3, 4]);
             using LimitedReadStream limited = new(
                 inner,
+                declaredLength: 4,
                 totalCounter: null,
                 entryLimitName: nameof(ExcelReaderOptions.MaxCellBytes),
                 entryLimit: 2);
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/CorruptSheetEntryTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/CorruptSheetEntryTests.cs
new file mode 100644
index 00000000..89f8c156
--- /dev/null
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/CorruptSheetEntryTests.cs
@@ -0,0 +1,46 @@
+using System.Globalization;
+using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Xlsx;
+
+namespace ExcelReader.Tests.Reader.Xlsx
+{
+    public class CorruptSheetEntryTests
+    {
+        private static async Task<byte[]> BuildAsync(int rows)
+        {
+            object?[][] data = new object?[rows + 1][];
+            data[0] = ["Name", "Qty", "Day"];
+            for (int i = 0; i < rows; i++)
+            {
+                data[i + 1] = [string.Create(CultureInfo.InvariantCulture, $"item{i:D6}"), i, new DateTime(2024, 1, 1).AddDays(i % 400)];
+            }
+            using MemoryStream ms = await TypedWorkbook.BuildAsync(data);
+            return ms.ToArray();
+        }
+
+        private static int CountRows(XlsxWorkbook workbook)
+        {
+            int count = 0;
+            foreach (Row _ in workbook.FirstSheet)
+            {
+                count++;
+            }
+            return count;
+        }
+
+        // Damage at +4096 decodes as a stream that ends early: before the fix every reader stopped at 298 rows without an error.
+        [Theory]
+        [InlineData(4096, false)]
+        [InlineData(4096, true)]
+        [InlineData(300_000, false)]
+        public async Task ADamagedSheetEntryThrowsInsteadOfEndingEarly(int offset, bool prefetch)
+        {
+            byte[] bytes = await BuildAsync(30_000);
+            int entry = bytes.AsSpan().IndexOf("xl/worksheets/sheet1.xml"u8);
+            Array.Fill(bytes, (byte)0xFF, entry + offset, 512);
+            using XlsxWorkbook workbook = Excel.FromXlsx(bytes, new ExcelReaderOptions { PrefetchDecompression = prefetch });
+
+            Assert.Throws<InvalidDataException>(() => CountRows(workbook));
+        }
+    }
+}
diff --git a/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs b/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
index 995258a2..4328dfc1 100644
--- a/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Zip/ZipIndexTests.cs
@@ -881,6 +881,56 @@ public void DeflatedEntryCutShortIsRejectedWhenStreamedInsteadOfEndingEarly()
             Assert.Throws<InvalidDataException>(() => stream.CopyTo(Stream.Null));
         }
 
+        [Theory]
+        [InlineData(1)]
+        [InlineData(-1)]
+        public void StreamedEntryWhoseLengthDiffersFromItsDeclaredSizeIsRejected(int declaredDelta)
+        {
+            byte[] payload = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Repeat("<row><c><v>12345</v></c></row>", 4000)));
+            byte[] zipBytes = BuildZipWithOneEntry("data.xml", payload, CompressionLevel.Optimal);
+            PatchCentralDirectoryUInt32(zipBytes, "data.xml", fieldOffset: 24, (uint)(payload.Length + declaredDelta));
+
+            using ZipIndex index = ZipIndex.Create(zipBytes, ExcelReaderOptions.Default);
+            Assert.True(index.TryGetEntry("data.xml"u8, out ZipEntryRef entry));
+            using LimitedReadStream stream = index.OpenEntryStream(entry, new DecompressedByteCounter(0), ExcelReaderOptions.Default);
+
+            InvalidDataException ex = Assert.Throws<InvalidDataException>(() => stream.CopyTo(Stream.Null));
+            Assert.Contains(declaredDelta > 0 ? "less data" : "more data", ex.Message, StringComparison.Ordinal);
+        }
+
+        [Theory]
+        [InlineData(1)]
+        [InlineData(-1)]
+        public async Task StreamedEntryWhoseLengthDiffersFromItsDeclaredSizeIsRejectedAsync(int declaredDelta)
+        {
+            byte[] payload = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Repeat("<row><c><v>12345</v></c></row>", 4000)));
+            byte[] zipBytes = BuildZipWithOneEntry("data.xml", payload, CompressionLevel.Optimal);
+            PatchCentralDirectoryUInt32(zipBytes, "data.xml", fieldOffset: 24, (uint)(payload.Length + declaredDelta));
+            CancellationToken ct = TestContext.Current.CancellationToken;
+
+            using ZipIndex index = ZipIndex.Create(zipBytes, ExcelReaderOptions.Default);
+            Assert.True(index.TryGetEntry("data.xml"u8, out ZipEntryRef entry));
+            await using LimitedReadStream stream = await index.OpenEntryStreamAsync(entry, new DecompressedByteCounter(0), ExcelReaderOptions.Default, ct);
+
+            await Assert.ThrowsAsync<InvalidDataException>(() => stream.CopyToAsync(Stream.Null, ct));
+        }
+
+        [Fact]
+        public void StreamedEntryOfExactlyItsDeclaredSizeReadsToTheEnd()
+        {
+            byte[] payload = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Repeat("<row><c><v>12345</v></c></row>", 4000)));
+            byte[] zipBytes = BuildZipWithOneEntry("data.xml", payload, CompressionLevel.Optimal);
+
+            using ZipIndex index = ZipIndex.Create(zipBytes, ExcelReaderOptions.Default);
+            Assert.True(index.TryGetEntry("data.xml"u8, out ZipEntryRef entry));
+            using LimitedReadStream stream = index.OpenEntryStream(entry, new DecompressedByteCounter(0), ExcelReaderOptions.Default);
+            using var copy = new MemoryStream();
+            stream.CopyTo(copy);
+
+            Assert.Equal(payload, copy.ToArray());
+            Assert.Equal(0, stream.Read(new byte[16]));
+        }
+
         private static byte[] BuildZipWithCutDeflatedEntry(string entryName)
         {
             byte[] payload = Encoding.UTF8.GetBytes(string.Concat(Enumerable.Repeat("<row><c><v>12345</v></c></row>", 4000)));

From 11eb8c828b6349133b0e7c81701e90aa2a5486bf Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:16:58 -0300
Subject: [PATCH 084/115] refactor!: rename ExcelParserConfig to
 ExcelParserOptions

Every other settings type is named *Options; the parser factories' parameter is now `options`.
---
 .../Parser/{ExcelParserConfig.cs => ExcelParserOptions.cs}        | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename src/ExcelReader.Core/Parser/{ExcelParserConfig.cs => ExcelParserOptions.cs} (100%)

diff --git a/src/ExcelReader.Core/Parser/ExcelParserConfig.cs b/src/ExcelReader.Core/Parser/ExcelParserOptions.cs
similarity index 100%
rename from src/ExcelReader.Core/Parser/ExcelParserConfig.cs
rename to src/ExcelReader.Core/Parser/ExcelParserOptions.cs

From 0ece1fe5dc1b0031e9e5fff4e6580cd799790bbb Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:23:32 -0300
Subject: [PATCH 085/115] refactor!: hand converters an ExcelRowContext instead
 of loose date-system and culture arguments

IExcelCellConverter<T>.TryConvert, ExcelCellReader<T>, ExcelRowParser<T> and the
ExcelCellReaders methods now take `in ExcelRowContext`, so a new conversion setting is a
new property rather than a signature change for every converter. ExcelRowContext gains
init accessors so converters can be unit-tested.
---
 docs/guide/migrating-to-v7.md                 |  2 +-
 docs/guide/parsing.md                         | 10 +--
 docs/guide/reading.md                         |  2 +-
 src/ExcelReader.Arrow/ColumnAppender.cs       |  8 +--
 src/ExcelReader.Core/Parser/CsvEnumerable.cs  | 14 ++---
 .../Parser/ExcelCellReaders.cs                | 32 +++++-----
 .../Parser/ExcelEnumerable.cs                 |  6 +-
 .../Parser/ExcelMapDelegates.cs               | 10 ++-
 .../Parser/ExcelParseException.cs             |  4 +-
 src/ExcelReader.Core/Parser/ExcelParser.cs    | 48 +++++++-------
 .../Parser/ExcelParserOptions.cs              |  2 +-
 .../Parser/ExcelRequiredAttribute.cs          |  2 +-
 .../Parser/ExcelRowContext.cs                 | 28 +++++----
 .../Parser/ExcelRowMapBuilder.cs              | 16 ++---
 .../Parser/IExcelCellConverter.cs             |  5 +-
 .../Parser/Internal/ColumnParserFactory.cs    | 62 +++++++++----------
 .../Parser/Internal/Delegates.cs              |  3 +-
 .../Parser/Internal/RowProjector.cs           |  8 +--
 .../Parser/Internal/SparseRowProjection.cs    |  5 +-
 .../Parser/ParallelCsv/CsvChunkWorker.cs      |  4 +-
 .../Parser/ParallelCsv/CsvHeaderBinder.cs     |  2 +-
 .../Parser/ParallelCsv/MappedProjection.cs    | 16 ++---
 .../ParallelCsv/ParallelCsvEnumerable.cs      |  4 +-
 .../Parser/ParallelCsv/ParallelCsvFactory.cs  |  2 +-
 .../SheetPipeline/SheetRowProjection.cs       |  6 +-
 .../PublicAPI/PublicAPI.Shipped.txt           | 48 +++++++-------
 .../Reader/ExcelDataReader.cs                 |  4 +-
 .../Reader/Schema/SchemaInference.cs          |  4 +-
 src/ExcelReader.Core/Reader/SheetParallel.cs  | 12 ++--
 .../Writer/Internal/RecordColumns.cs          |  2 +-
 .../ExcelRowMapGenerator.cs                   |  8 +--
 src/ExcelReader.Native/Typed/TypedApi.cs      | 18 +++---
 .../Generator/GeneratorTests.cs               | 10 +--
 .../Parser/ConverterTests.cs                  | 16 ++---
 .../Parser/CsvParserTests.cs                  | 14 ++---
 .../Parser/ExcelCellReadersUtf8Tests.cs       |  2 +-
 .../Parser/ExcelParserTests.cs                | 12 ++--
 .../Parser/ExcelRowMapBuilderTests.cs         |  2 +-
 .../Parser/GeneratedMapParityTests.cs         |  2 +-
 .../Parser/HeaderCollisionTests.cs            | 10 +--
 .../ParallelCsv/AggregateCsvModelTests.cs     | 10 +--
 .../Parser/ParallelCsv/CsvChunkWorkerTests.cs |  8 +--
 .../ParallelCsv/CsvHeaderBinderTests.cs       |  6 +-
 .../ParallelCsv/ParallelCsvEnumerableTests.cs | 12 ++--
 .../ParallelCsv/ParseCsvParallelTests.cs      |  2 +-
 .../Parser/ParserFeatureTests.cs              |  4 +-
 .../Parser/RefStructModelTests.cs             |  4 +-
 .../ExcelReader.Tests/Parser/RequiredTests.cs |  2 +-
 .../Parser/SheetParallelXlsxTests.cs          |  4 +-
 .../Parser/UnifiedParserTests.cs              |  6 +-
 .../Reader/Xls/XlsWorkbookTests.cs            |  2 +-
 .../Writer/WorkbookWriterTests.cs             |  6 +-
 52 files changed, 264 insertions(+), 267 deletions(-)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index ca2660f7..32716cfe 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -88,7 +88,7 @@ await foreach (Sale s in SheetParallel.ParseAsync(workbook.FirstSheet, parser, n
 - The caller owns the workbook and keeps it open until the task completes or the enumeration ends. v6 opened and closed its own source.
 - The CSV dialect is given when the workbook is opened (`CsvReaderOptions`), not in the parallel options.
 - A CSV in a `MemoryStream` is no longer partitioned: the stream overload of `Excel.FromCsv` reads it sequentially. Pass the bytes as `ReadOnlyMemory<byte>` to keep partitioning.
-- `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from `ExcelParserConfig.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`; the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+- `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from `ExcelParserOptions.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`; the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
 - XLSX and XLSB sheets are now read on several threads when `DegreeOfParallelism` allows it. XLS, a table view (`ExcelTable.AsSheet()`), a sheet under 256 KB uncompressed and a CSV that cannot be partitioned still read sequentially with the same results.
 - `PrefetchDecompression` does not apply to a parallel XLSX or XLSB read; the pipeline already overlaps inflate and parse.
 
diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index c53c3d54..9c43a860 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -133,13 +133,13 @@ The match is by header name, not by property identity: configuring a *different*
 
 ## Parser configuration
 
-Pass an `ExcelParserConfig` to control header handling and culture:
+Pass an `ExcelParserOptions` to control header handling and culture:
 
 ```csharp
 using System.Globalization;
 using ExcelReader.Core.Parser;
 
-var config = new ExcelParserConfig
+var options = new ExcelParserOptions
 {
     HeaderRow = 1,                                   // 1-based row holding the headers
     ColumnNameComparer = StringComparer.OrdinalIgnoreCase,
@@ -147,7 +147,7 @@ var config = new ExcelParserConfig
     Culture = CultureInfo.GetCultureInfo("pt-BR"),   // parse "1.234,56" as 1234.56m
 };
 
-var parser = ExcelParser.FromAttributes<ChangeRow>(config);
+var parser = ExcelParser.FromAttributes<ChangeRow>(options);
 ```
 
 `Culture` applies when parsing text-backed numeric/`Guid` cells (XLSX inline and shared strings); binary numeric cells (XLS/XLSB) carry a raw value and ignore it. `HeaderNormalization` flags (`Trim`, `CollapseSpaces`, `RemoveDiacritics`) are applied to both the sheet headers and the property names before matching.
@@ -182,7 +182,7 @@ using ExcelReader.Core.Reader;
 
 public sealed class BrlMoneyConverter : IExcelCellConverter<decimal>
 {
-    public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out decimal value)
+    public bool TryConvert(in Cell cell, in ExcelRowContext context, out decimal value)
     {
         string text = cell.GetString().Replace("R$", "", StringComparison.Ordinal).Trim();
         return decimal.TryParse(text, NumberStyles.Currency, CultureInfo.GetCultureInfo("pt-BR"), out value);
@@ -196,7 +196,7 @@ public sealed class Invoice
 }
 ```
 
-Return `false` to signal a parse failure (the property keeps its default). Empty cells are skipped before the converter runs.
+Return `false` to signal a parse failure (the property keeps its default). Empty cells are skipped before the converter runs. `context` carries the workbook's date system (`IsDate1904`) and the parser culture (`FormatProvider`); to unit-test a converter, pass `new ExcelRowContext { IsDate1904 = false, FormatProvider = CultureInfo.InvariantCulture }`.
 
 ## Parse into a ref struct (zero-copy)
 
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index 2454130d..ba6e00b0 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -98,7 +98,7 @@ await SheetParallel.ForEachAsync(
 
 Unlike `ParseAsync`, the callback runs on the worker threads, so records arrive in no particular order and the callback must be safe to call from several threads at once. Spans are valid only for the duration of the call.
 
-`HeaderRow` follows the same rule as before: `ParseAsync` takes the header from the parser's `ExcelParserConfig.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`, while the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+`HeaderRow` follows the same rule as before: `ParseAsync` takes the header from the parser's `ExcelParserOptions.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`, while the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
 
 #### When it reads sequentially
 
diff --git a/src/ExcelReader.Arrow/ColumnAppender.cs b/src/ExcelReader.Arrow/ColumnAppender.cs
index 4ab6ae78..7b5e9376 100644
--- a/src/ExcelReader.Arrow/ColumnAppender.cs
+++ b/src/ExcelReader.Arrow/ColumnAppender.cs
@@ -175,7 +175,7 @@ internal override Field Field
 
             internal override void Append(in Cell cell, bool isDate1904)
             {
-                if (ExcelCellReaders.Bool(in cell, isDate1904, CultureInfo.InvariantCulture, out bool value))
+                if (ExcelCellReaders.Bool(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out bool value))
                 {
                     _builder.Append(value);
                 }
@@ -210,7 +210,7 @@ internal override Field Field
 
             internal override void Append(in Cell cell, bool isDate1904)
             {
-                if (ExcelCellReaders.DateOnlyAuto(in cell, isDate1904, CultureInfo.InvariantCulture, out DateOnly value))
+                if (ExcelCellReaders.DateOnlyAuto(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out DateOnly value))
                 {
                     _builder.Append(value);
                 }
@@ -247,7 +247,7 @@ internal override Field Field
 
             internal override void Append(in Cell cell, bool isDate1904)
             {
-                if (ExcelCellReaders.TimeOnlyAuto(in cell, isDate1904, CultureInfo.InvariantCulture, out TimeOnly value))
+                if (ExcelCellReaders.TimeOnlyAuto(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out TimeOnly value))
                 {
                     _builder.Append(value.ToTimeSpan().Ticks / 10);
                 }
@@ -284,7 +284,7 @@ internal override Field Field
 
             internal override void Append(in Cell cell, bool isDate1904)
             {
-                if (ExcelCellReaders.DateTimeAuto(in cell, isDate1904, CultureInfo.InvariantCulture, out DateTime value))
+                if (ExcelCellReaders.DateTimeAuto(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out DateTime value))
                 {
                     DateTime normalized = value.Kind == DateTimeKind.Unspecified
                         ? value
diff --git a/src/ExcelReader.Core/Parser/CsvEnumerable.cs b/src/ExcelReader.Core/Parser/CsvEnumerable.cs
index d935aad4..bb4d5902 100644
--- a/src/ExcelReader.Core/Parser/CsvEnumerable.cs
+++ b/src/ExcelReader.Core/Parser/CsvEnumerable.cs
@@ -22,12 +22,12 @@ public sealed class CsvEnumerable<T> : IEnumerable<T>, IAsyncEnumerable<T>
         where T : allows ref struct
     {
         private readonly CsvSheet _sheet;
-        private readonly ExcelParserConfig _config;
+        private readonly ExcelParserOptions _config;
         private readonly CancellationToken _ct;
         private readonly TypeMapInfo<T> _info;
         private readonly CsvReader? _ownedReader;
 
-        internal CsvEnumerable(CsvSheet sheet, ExcelParserConfig config, TypeMapInfo<T> info, CsvReader? ownedReader, CancellationToken ct)
+        internal CsvEnumerable(CsvSheet sheet, ExcelParserOptions config, TypeMapInfo<T> info, CsvReader? ownedReader, CancellationToken ct)
         {
             _sheet = sheet;
             _config = config;
@@ -36,7 +36,7 @@ internal CsvEnumerable(CsvSheet sheet, ExcelParserConfig config, TypeMapInfo<T>
             _ownedReader = ownedReader;
         }
 
-        internal CsvEnumerable(CsvSheet sheet, ExcelParserConfig config, TypeMapInfo<T> explicitInfo)
+        internal CsvEnumerable(CsvSheet sheet, ExcelParserOptions config, TypeMapInfo<T> explicitInfo)
         {
             _sheet = sheet;
             _config = config;
@@ -178,7 +178,7 @@ internal struct CsvRowProjector<T>
         private readonly StringComparer _comparer;
         private readonly HeaderNormalization _normalization;
         private readonly int _headerRow;
-        private readonly IFormatProvider _provider;
+        private readonly ExcelRowContext _context;
         private readonly bool _throwOnParseFailure;
         private ColumnParser<T>[]? _fieldParsers;
         private string?[] _fieldNames;
@@ -192,7 +192,7 @@ internal CsvRowProjector(TypeMapInfo<T> typeInfo, StringComparer comparer, Heade
             _comparer = comparer;
             _normalization = normalization;
             _headerRow = headerRow;
-            _provider = provider;
+            _context = new ExcelRowContext { FormatProvider = provider };
             _throwOnParseFailure = throwOnParseFailure;
             _fieldNames = [];
             _fieldRequired = [];
@@ -205,7 +205,7 @@ internal CsvRowProjector(TypeMapInfo<T> typeInfo, CsvBoundColumnMap<T> map, IFor
             _comparer = StringComparer.Ordinal;
             _normalization = HeaderNormalization.None;
             _headerRow = -1;
-            _provider = provider;
+            _context = new ExcelRowContext { FormatProvider = provider };
             _throwOnParseFailure = throwOnParseFailure;
             _fieldParsers = map.FieldParsers;
             _fieldNames = map.FieldNames;
@@ -362,7 +362,7 @@ private readonly void ParseCurrentRow(CsvReader.Enumerator rows, ref T model)
                     continue;
                 }
                 Cell cell = rows.FieldAt(i);
-                if (cell.Type == CellType.Empty || parser(ref model, in cell, false, _provider))
+                if (cell.Type == CellType.Empty || parser(ref model, in cell, in _context))
                 {
                     continue;
                 }
diff --git a/src/ExcelReader.Core/Parser/ExcelCellReaders.cs b/src/ExcelReader.Core/Parser/ExcelCellReaders.cs
index 4978046b..b186ce01 100644
--- a/src/ExcelReader.Core/Parser/ExcelCellReaders.cs
+++ b/src/ExcelReader.Core/Parser/ExcelCellReaders.cs
@@ -56,28 +56,28 @@ public static class ExcelCellReaders
         public static readonly ExcelCellReader<TimeOnly> TimeOnlyAuto = ReadTimeOnlyAuto;
 
 
-        private static bool ReadString(in Cell cell, bool isDate1904, IFormatProvider provider, out string value)
+        private static bool ReadString(in Cell cell, in ExcelRowContext context, out string value)
         {
             value = cell.GetString();
             return true;
         }
 
-        private static bool ReadDateTimeAuto(in Cell cell, bool isDate1904, IFormatProvider provider, out DateTime value)
+        private static bool ReadDateTimeAuto(in Cell cell, in ExcelRowContext context, out DateTime value)
         {
-            return ColumnParserFactory.ReadDateTime(in cell, isDate1904, provider, out value)
-                || ColumnParserFactory.ReadTextDateTime(in cell, isDate1904, provider, out value);
+            return ColumnParserFactory.ReadDateTime(in cell, in context, out value)
+                || ColumnParserFactory.ReadTextDateTime(in cell, in context, out value);
         }
 
-        private static bool ReadDateOnlyAuto(in Cell cell, bool isDate1904, IFormatProvider provider, out DateOnly value)
+        private static bool ReadDateOnlyAuto(in Cell cell, in ExcelRowContext context, out DateOnly value)
         {
-            return ColumnParserFactory.ReadDateOnly(in cell, isDate1904, provider, out value)
-                || ColumnParserFactory.ReadTextDateOnly(in cell, isDate1904, provider, out value);
+            return ColumnParserFactory.ReadDateOnly(in cell, in context, out value)
+                || ColumnParserFactory.ReadTextDateOnly(in cell, in context, out value);
         }
 
-        private static bool ReadTimeOnlyAuto(in Cell cell, bool isDate1904, IFormatProvider provider, out TimeOnly value)
+        private static bool ReadTimeOnlyAuto(in Cell cell, in ExcelRowContext context, out TimeOnly value)
         {
-            return ColumnParserFactory.ReadTimeOnly(in cell, isDate1904, provider, out value)
-                || ColumnParserFactory.ReadTextTimeOnly(in cell, isDate1904, provider, out value);
+            return ColumnParserFactory.ReadTimeOnly(in cell, in context, out value)
+                || ColumnParserFactory.ReadTextTimeOnly(in cell, in context, out value);
         }
 
         /// <summary>
@@ -86,10 +86,10 @@ private static bool ReadTimeOnlyAuto(in Cell cell, bool isDate1904, IFormatProvi
         /// <see cref="Guid"/>.
         /// </summary>
         /// <typeparam name="TValue">The value type to parse.</typeparam>
-        public static bool Parsable<TValue>(in Cell cell, bool isDate1904, IFormatProvider provider, [MaybeNullWhen(false)] out TValue value)
+        public static bool Parsable<TValue>(in Cell cell, in ExcelRowContext context, [MaybeNullWhen(false)] out TValue value)
             where TValue : IUtf8SpanParsable<TValue>
         {
-            return cell.TryParse(provider, out value);
+            return cell.TryParse(context.FormatProvider, out value);
         }
 
         /// <summary>
@@ -97,14 +97,14 @@ public static bool Parsable<TValue>(in Cell cell, bool isDate1904, IFormatProvid
         /// for types such as <see cref="TimeSpan"/> and <see cref="DateTimeOffset"/> that have no UTF-8 parser.
         /// </summary>
         /// <typeparam name="TValue">The value type to parse.</typeparam>
-        public static bool SpanParsable<TValue>(in Cell cell, bool isDate1904, IFormatProvider provider, [MaybeNullWhen(false)] out TValue value)
+        public static bool SpanParsable<TValue>(in Cell cell, in ExcelRowContext context, [MaybeNullWhen(false)] out TValue value)
             where TValue : ISpanParsable<TValue>
         {
-            return ColumnParserFactory.TryParseSpanParsable(in cell, provider, out value);
+            return ColumnParserFactory.TryParseSpanParsable(in cell, context.FormatProvider, out value);
         }
 
         /// <summary>Reads a cell's raw UTF-8 bytes without allocating. The span aliases the reader's buffer and is valid only until the reader advances.</summary>
-        public static bool Utf8(scoped in Cell cell, bool isDate1904, IFormatProvider provider, out ReadOnlySpan<byte> value)
+        public static bool Utf8(scoped in Cell cell, scoped in ExcelRowContext context, out ReadOnlySpan<byte> value)
         {
             value = cell.Value;
             return true;
@@ -112,7 +112,7 @@ public static bool Utf8(scoped in Cell cell, bool isDate1904, IFormatProvider pr
 
         /// <summary>Reads a cell as an enum, by its declared value name (case-insensitive) or its underlying numeric value.</summary>
         /// <typeparam name="TEnum">The enum type to parse.</typeparam>
-        public static bool Enum<TEnum>(in Cell cell, bool isDate1904, IFormatProvider provider, out TEnum value)
+        public static bool Enum<TEnum>(in Cell cell, in ExcelRowContext context, out TEnum value)
             where TEnum : struct, Enum
         {
             return ColumnParserFactory.TryParseEnum(in cell, out value);
diff --git a/src/ExcelReader.Core/Parser/ExcelEnumerable.cs b/src/ExcelReader.Core/Parser/ExcelEnumerable.cs
index 540fa59c..6937b258 100644
--- a/src/ExcelReader.Core/Parser/ExcelEnumerable.cs
+++ b/src/ExcelReader.Core/Parser/ExcelEnumerable.cs
@@ -12,7 +12,7 @@ namespace ExcelReader.Core.Parser
     public sealed class ExcelEnumerable<T> : ExcelEnumerable<T, XlsxSheet, XlsxWorkbook.Enumerator>
         where T : allows ref struct
     {
-        internal ExcelEnumerable(XlsxSheet sheet, ExcelParserConfig config, TypeMapInfo<T> explicitInfo)
+        internal ExcelEnumerable(XlsxSheet sheet, ExcelParserOptions config, TypeMapInfo<T> explicitInfo)
             : base(sheet, config, explicitInfo)
         {
         }
@@ -31,10 +31,10 @@ public class ExcelEnumerable<T, TSheet, TEnumerator> : IEnumerable<T>, IAsyncEnu
         where TEnumerator : class, IExcelRowEnumerator
     {
         private readonly TSheet _sheet;
-        private readonly ExcelParserConfig _config;
+        private readonly ExcelParserOptions _config;
         private readonly TypeMapInfo<T> _info;
 
-        internal ExcelEnumerable(TSheet sheet, ExcelParserConfig config, TypeMapInfo<T> explicitInfo)
+        internal ExcelEnumerable(TSheet sheet, ExcelParserOptions config, TypeMapInfo<T> explicitInfo)
         {
             _sheet = sheet;
             _config = config;
diff --git a/src/ExcelReader.Core/Parser/ExcelMapDelegates.cs b/src/ExcelReader.Core/Parser/ExcelMapDelegates.cs
index 73bf5769..ffde3277 100644
--- a/src/ExcelReader.Core/Parser/ExcelMapDelegates.cs
+++ b/src/ExcelReader.Core/Parser/ExcelMapDelegates.cs
@@ -11,11 +11,10 @@ namespace ExcelReader.Core.Parser
     /// </summary>
     /// <typeparam name="TValue">The value type the cell is read into.</typeparam>
     /// <param name="cell">The cell to read; callers only invoke this for a non-empty cell.</param>
-    /// <param name="isDate1904">True when the source workbook uses the 1904 date system.</param>
-    /// <param name="provider">The format provider configured for parsing.</param>
+    /// <param name="context">The date system and format provider to convert with.</param>
     /// <param name="value">The read value, when this method returns true.</param>
     /// <returns><see langword="true"/> if the cell was read successfully.</returns>
-    public delegate bool ExcelCellReader<TValue>(in Cell cell, bool isDate1904, IFormatProvider provider, out TValue value);
+    public delegate bool ExcelCellReader<TValue>(in Cell cell, in ExcelRowContext context, out TValue value);
 
     /// <summary>
     /// Assigns <paramref name="value"/> to a property of <paramref name="model"/>. The source generator
@@ -41,9 +40,8 @@ public delegate void ExcelPropertySetter<TModel, in TValue>(ref TModel model, TV
     /// <typeparam name="TModel">The row model type being read into.</typeparam>
     /// <param name="model">The model instance to mutate.</param>
     /// <param name="cell">The cell to read; callers only invoke this for a non-empty cell.</param>
-    /// <param name="isDate1904">True when the source workbook uses the 1904 date system.</param>
-    /// <param name="provider">The format provider configured for parsing.</param>
+    /// <param name="context">The date system and format provider to convert with.</param>
     /// <returns><see langword="true"/> if the cell was read and assigned successfully.</returns>
-    public delegate bool ExcelRowParser<TModel>(ref TModel model, in Cell cell, bool isDate1904, IFormatProvider provider)
+    public delegate bool ExcelRowParser<TModel>(ref TModel model, in Cell cell, in ExcelRowContext context)
         where TModel : allows ref struct;
 }
diff --git a/src/ExcelReader.Core/Parser/ExcelParseException.cs b/src/ExcelReader.Core/Parser/ExcelParseException.cs
index 413d7074..921a1347 100644
--- a/src/ExcelReader.Core/Parser/ExcelParseException.cs
+++ b/src/ExcelReader.Core/Parser/ExcelParseException.cs
@@ -6,11 +6,11 @@ namespace ExcelReader.Core.Parser
     /// <summary>
     /// Thrown when a bound column's cell is non-empty but fails to parse into the target property type
     /// and the parser is configured to throw on parse failures (rather than silently keep the property
-    /// at its default). See <see cref="ExcelParserConfig.ThrowOnParseFailure"/>.
+    /// at its default). See <see cref="ExcelParserOptions.ThrowOnParseFailure"/>.
     /// </summary>
     /// <remarks>
     /// A parse failure on an <c>[ExcelRequired]</c> column always surfaces as a missing-required-value
-    /// error instead, regardless of <see cref="ExcelParserConfig.ThrowOnParseFailure"/>, since the column
+    /// error instead, regardless of <see cref="ExcelParserOptions.ThrowOnParseFailure"/>, since the column
     /// has no usable value either way.
     /// </remarks>
     public sealed class ExcelParseException : Exception
diff --git a/src/ExcelReader.Core/Parser/ExcelParser.cs b/src/ExcelReader.Core/Parser/ExcelParser.cs
index 8bf07360..2e9029ee 100644
--- a/src/ExcelReader.Core/Parser/ExcelParser.cs
+++ b/src/ExcelReader.Core/Parser/ExcelParser.cs
@@ -24,18 +24,18 @@ namespace ExcelReader.Core.Parser
     public sealed class ExcelParser<T>
         where T : allows ref struct
     {
-        private readonly ExcelParserConfig _config;
+        private readonly ExcelParserOptions _config;
         private readonly Func<TypeMapInfo<T>> _info;
         private readonly Func<TypeMapInfo<T>> _csvInfo;
 
-        internal ExcelParser(ExcelParserConfig config, Func<TypeMapInfo<T>> info, Func<TypeMapInfo<T>> csvInfo)
+        internal ExcelParser(ExcelParserOptions config, Func<TypeMapInfo<T>> info, Func<TypeMapInfo<T>> csvInfo)
         {
             _config = config;
             _info = info;
             _csvInfo = csvInfo;
         }
 
-        internal ExcelParserConfig Config => _config;
+        internal ExcelParserOptions Config => _config;
 
         internal TypeMapInfo<T> CsvInfo => _csvInfo();
 
@@ -104,15 +104,15 @@ public static class ExcelParser
         /// a separate map with text-based date parsing.
         /// </remarks>
         /// <typeparam name="T">The model type.</typeparam>
-        /// <param name="config">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserConfig"/>.</param>
+        /// <param name="options">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserOptions"/>.</param>
         /// <returns>The parser.</returns>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="config"/> has <see cref="ExcelParserConfig.HeaderRow"/> less than 1.</exception>
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="options"/> has <see cref="ExcelParserOptions.HeaderRow"/> less than 1.</exception>
         [RequiresUnreferencedCode("Typed parsing reflects over T's public properties, which trimming may remove.")]
         [RequiresDynamicCode("Typed parsing binds property setters at runtime (MethodInfo.CreateDelegate / MakeGenericMethod).")]
-        public static ExcelParser<T> FromAttributes<T>(ExcelParserConfig? config = null)
+        public static ExcelParser<T> FromAttributes<T>(ExcelParserOptions? options = null)
             where T : allows ref struct
         {
-            return new ExcelParser<T>(ValidateConfig(config), TypeMapper<T>.GetInfo, TypeMapper<T>.GetCsvInfo);
+            return new ExcelParser<T>(ValidateOptions(options), TypeMapper<T>.GetInfo, TypeMapper<T>.GetCsvInfo);
         }
 
         /// <summary>Creates a parser from the map the <c>[ExcelSerializable]</c> source generator emitted for <typeparamref name="T"/>. Trimming and AOT safe.</summary>
@@ -122,13 +122,13 @@ public static ExcelParser<T> FromAttributes<T>(ExcelParserConfig? config = null)
         /// <c>*Auto</c> readers in <see cref="ExcelCellReaders"/> — serial number first, text as a fallback.
         /// </remarks>
         /// <typeparam name="T">The model type; must implement <see cref="IExcelRowMap{T}"/>.</typeparam>
-        /// <param name="config">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserConfig"/>.</param>
+        /// <param name="options">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserOptions"/>.</param>
         /// <returns>The parser.</returns>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="config"/> has <see cref="ExcelParserConfig.HeaderRow"/> less than 1.</exception>
-        public static ExcelParser<T> Generated<T>(ExcelParserConfig? config = null)
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="options"/> has <see cref="ExcelParserOptions.HeaderRow"/> less than 1.</exception>
+        public static ExcelParser<T> Generated<T>(ExcelParserOptions? options = null)
             where T : IExcelRowMap<T>, allows ref struct
         {
-            ExcelParserConfig effective = ValidateConfig(config);
+            ExcelParserOptions effective = ValidateOptions(options);
             var builder = new ExcelRowMapBuilder<T>();
             T.ConfigureExcelRowMap(builder);
             return Fixed(effective, builder.Build());
@@ -142,15 +142,15 @@ public static ExcelParser<T> Generated<T>(ExcelParserConfig? config = null)
         /// </remarks>
         /// <typeparam name="T">The model type.</typeparam>
         /// <param name="configure">Configures the row map by calling <see cref="ExcelRowMapBuilder{T}.Property{TValue}"/> and its siblings.</param>
-        /// <param name="config">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserConfig"/>.</param>
+        /// <param name="options">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserOptions"/>.</param>
         /// <returns>The parser.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="configure"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="config"/> has <see cref="ExcelParserConfig.HeaderRow"/> less than 1.</exception>
-        public static ExcelParser<T> Build<T>(Action<ExcelRowMapBuilder<T>> configure, ExcelParserConfig? config = null)
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="options"/> has <see cref="ExcelParserOptions.HeaderRow"/> less than 1.</exception>
+        public static ExcelParser<T> Build<T>(Action<ExcelRowMapBuilder<T>> configure, ExcelParserOptions? options = null)
             where T : allows ref struct
         {
             ArgumentNullException.ThrowIfNull(configure);
-            ExcelParserConfig effective = ValidateConfig(config);
+            ExcelParserOptions effective = ValidateOptions(options);
             var builder = new ExcelRowMapBuilder<T>();
             configure(builder);
             return Fixed(effective, builder.Build());
@@ -171,18 +171,18 @@ public static ExcelParser<T> Build<T>(Action<ExcelRowMapBuilder<T>> configure, E
         /// </remarks>
         /// <typeparam name="T">The model type.</typeparam>
         /// <param name="configure">Configures the properties that should override their attribute-driven binding.</param>
-        /// <param name="config">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserConfig"/>.</param>
+        /// <param name="options">Header matching, culture and parse-failure options. Defaults to a new <see cref="ExcelParserOptions"/>.</param>
         /// <returns>The parser.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="configure"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="config"/> has <see cref="ExcelParserConfig.HeaderRow"/> less than 1.</exception>
+        /// <exception cref="ArgumentOutOfRangeException"><paramref name="options"/> has <see cref="ExcelParserOptions.HeaderRow"/> less than 1.</exception>
         /// <exception cref="InvalidOperationException"><paramref name="configure"/> calls <see cref="ExcelRowMapBuilder{T}.PropertyAt{TValue}"/>: an index-based map has no header row to match attribute-driven properties against.</exception>
         [RequiresUnreferencedCode("BuildWithAttributeFallback reflects over T's public properties for the attribute-driven fallback, which trimming may remove.")]
         [RequiresDynamicCode("BuildWithAttributeFallback binds attribute-driven property setters at runtime (MethodInfo.CreateDelegate / MakeGenericMethod).")]
-        public static ExcelParser<T> BuildWithAttributeFallback<T>(Action<ExcelRowMapBuilder<T>> configure, ExcelParserConfig? config = null)
+        public static ExcelParser<T> BuildWithAttributeFallback<T>(Action<ExcelRowMapBuilder<T>> configure, ExcelParserOptions? options = null)
             where T : allows ref struct
         {
             ArgumentNullException.ThrowIfNull(configure);
-            ExcelParserConfig effective = ValidateConfig(config);
+            ExcelParserOptions effective = ValidateOptions(options);
             var builder = new ExcelRowMapBuilder<T>();
             configure(builder);
             TypeMapInfo<T> fluent = builder.Build(requireFactory: false);
@@ -191,19 +191,19 @@ public static ExcelParser<T> BuildWithAttributeFallback<T>(Action<ExcelRowMapBui
             return Fixed(effective, merged);
         }
 
-        private static ExcelParser<T> Fixed<T>(ExcelParserConfig config, TypeMapInfo<T> info)
+        private static ExcelParser<T> Fixed<T>(ExcelParserOptions config, TypeMapInfo<T> info)
             where T : allows ref struct
         {
             return new ExcelParser<T>(config, () => info, () => info);
         }
 
-        private static ExcelParserConfig ValidateConfig(ExcelParserConfig? config)
+        private static ExcelParserOptions ValidateOptions(ExcelParserOptions? options)
         {
-            if (config is not null && config.HeaderRow < 1)
+            if (options is not null && options.HeaderRow < 1)
             {
-                throw new ArgumentOutOfRangeException(nameof(config), config.HeaderRow, "HeaderRow must be at least 1.");
+                throw new ArgumentOutOfRangeException(nameof(options), options.HeaderRow, "HeaderRow must be at least 1.");
             }
-            return config ?? new ExcelParserConfig();
+            return options ?? new ExcelParserOptions();
         }
     }
 }
diff --git a/src/ExcelReader.Core/Parser/ExcelParserOptions.cs b/src/ExcelReader.Core/Parser/ExcelParserOptions.cs
index 26b575b0..6b96934e 100644
--- a/src/ExcelReader.Core/Parser/ExcelParserOptions.cs
+++ b/src/ExcelReader.Core/Parser/ExcelParserOptions.cs
@@ -6,7 +6,7 @@ namespace ExcelReader.Core.Parser
     /// Options controlling how <see cref="ExcelParser{T}"/> locates the header row, matches header
     /// text to bound properties, and handles cells that fail to parse.
     /// </summary>
-    public sealed class ExcelParserConfig
+    public sealed class ExcelParserOptions
     {
         /// <summary>Gets the 1-based row number that contains column headers. Defaults to <c>1</c>.</summary>
         public int HeaderRow { get; init; } = 1;
diff --git a/src/ExcelReader.Core/Parser/ExcelRequiredAttribute.cs b/src/ExcelReader.Core/Parser/ExcelRequiredAttribute.cs
index d5607bd6..e9fbe37c 100644
--- a/src/ExcelReader.Core/Parser/ExcelRequiredAttribute.cs
+++ b/src/ExcelReader.Core/Parser/ExcelRequiredAttribute.cs
@@ -5,7 +5,7 @@ namespace ExcelReader.Core.Parser
     /// is read if no matching name is found. By default every data row's cell must also be non-empty
     /// (and must parse successfully — a non-empty but unparsable cell fails the same way as a blank one),
     /// throwing on the first row that fails either check. Set <see cref="AllowEmpty"/> to true to require
-    /// only the column's presence. Contrast with <see cref="ExcelParserConfig.ThrowOnParseFailure"/>,
+    /// only the column's presence. Contrast with <see cref="ExcelParserOptions.ThrowOnParseFailure"/>,
     /// which governs parse-failure behavior only for non-required columns.
     /// </summary>
     [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
diff --git a/src/ExcelReader.Core/Parser/ExcelRowContext.cs b/src/ExcelReader.Core/Parser/ExcelRowContext.cs
index 524cb955..592db68a 100644
--- a/src/ExcelReader.Core/Parser/ExcelRowContext.cs
+++ b/src/ExcelReader.Core/Parser/ExcelRowContext.cs
@@ -1,27 +1,29 @@
+using System.Globalization;
+
 namespace ExcelReader.Core.Parser
 {
     /// <summary>
-    /// Immutable per-enumeration context handed to every generated <c>IExcelRowModel&lt;TSelf&gt;.FromRow</c>
-    /// call, carrying settings a row model needs to convert its own cells.
+    /// Settings a cell reader, converter or row parser needs to convert a cell, handed to every
+    /// <see cref="ExcelCellReader{TValue}"/>, <see cref="ExcelRowParser{TModel}"/> and
+    /// <see cref="IExcelCellConverter{T}.TryConvert"/> call.
     /// </summary>
     /// <remarks>
-    /// A normal <see langword="readonly"/> struct (not a ref struct), so it can be passed <c>in</c>
-    /// freely, unlike <c>Row</c> itself. Declared as a record struct purely for its
-    /// compiler-synthesized equality members (satisfying CA1815 without hand-written boilerplate; no
-    /// code in this library actually compares two contexts), and kept non-positional (no primary
-    /// constructor) so construction stays internal-only.
+    /// Passed by <see langword="in"/> reference. New settings arrive as new properties, so a converter
+    /// written against this type keeps compiling. Construct one with an object initializer to unit-test a
+    /// converter; <see langword="default"/> means the 1900 date system and the invariant culture.
     /// </remarks>
     public readonly record struct ExcelRowContext
     {
+        private readonly IFormatProvider? _formatProvider;
+
         /// <summary>True when the source workbook uses the 1904 date system.</summary>
-        public bool IsDate1904 { get; }
-        /// <summary>The format provider to use when parsing cell values.</summary>
-        public IFormatProvider FormatProvider { get; }
+        public bool IsDate1904 { get; init; }
 
-        internal ExcelRowContext(bool isDate1904, IFormatProvider formatProvider)
+        /// <summary>The format provider to use when parsing cell text. Defaults to <see cref="CultureInfo.InvariantCulture"/>.</summary>
+        public IFormatProvider FormatProvider
         {
-            IsDate1904 = isDate1904;
-            FormatProvider = formatProvider;
+            get => _formatProvider ?? CultureInfo.InvariantCulture;
+            init => _formatProvider = value;
         }
     }
 }
diff --git a/src/ExcelReader.Core/Parser/ExcelRowMapBuilder.cs b/src/ExcelReader.Core/Parser/ExcelRowMapBuilder.cs
index 97c35e5a..7a31abc4 100644
--- a/src/ExcelReader.Core/Parser/ExcelRowMapBuilder.cs
+++ b/src/ExcelReader.Core/Parser/ExcelRowMapBuilder.cs
@@ -37,9 +37,9 @@ public ExcelRowMapBuilder<T> Property<TValue>(
             ArgumentNullException.ThrowIfNull(names);
             ArgumentNullException.ThrowIfNull(read);
             ArgumentNullException.ThrowIfNull(set);
-            bool parser(ref T model, in Cell cell, bool isDate1904, IFormatProvider provider)
+            bool parser(ref T model, in Cell cell, in ExcelRowContext context)
             {
-                if (!read(in cell, isDate1904, provider, out TValue value))
+                if (!read(in cell, in context, out TValue value))
                 {
                     return false;
                 }
@@ -77,9 +77,9 @@ public ExcelRowMapBuilder<T> PropertyNullable<TValue>(
             ArgumentNullException.ThrowIfNull(names);
             ArgumentNullException.ThrowIfNull(read);
             ArgumentNullException.ThrowIfNull(set);
-            bool parser(ref T model, in Cell cell, bool isDate1904, IFormatProvider provider)
+            bool parser(ref T model, in Cell cell, in ExcelRowContext context)
             {
-                if (!read(in cell, isDate1904, provider, out TValue value))
+                if (!read(in cell, in context, out TValue value))
                 {
                     return false;
                 }
@@ -138,9 +138,9 @@ public ExcelRowMapBuilder<T> Converted<TValue>(
             ArgumentNullException.ThrowIfNull(names);
             ArgumentNullException.ThrowIfNull(converter);
             ArgumentNullException.ThrowIfNull(set);
-            bool parser(ref T model, in Cell cell, bool isDate1904, IFormatProvider provider)
+            bool parser(ref T model, in Cell cell, in ExcelRowContext context)
             {
-                if (!converter.TryConvert(in cell, isDate1904, provider, out TValue value))
+                if (!converter.TryConvert(in cell, in context, out TValue value))
                 {
                     return false;
                 }
@@ -176,9 +176,9 @@ public ExcelRowMapBuilder<T> PropertyAt<TValue>(
             ArgumentOutOfRangeException.ThrowIfNegative(columnIndex);
             ArgumentNullException.ThrowIfNull(read);
             ArgumentNullException.ThrowIfNull(set);
-            bool parser(ref T model, in Cell cell, bool isDate1904, IFormatProvider provider)
+            bool parser(ref T model, in Cell cell, in ExcelRowContext context)
             {
-                if (!read(in cell, isDate1904, provider, out TValue value))
+                if (!read(in cell, in context, out TValue value))
                 {
                     return false;
                 }
diff --git a/src/ExcelReader.Core/Parser/IExcelCellConverter.cs b/src/ExcelReader.Core/Parser/IExcelCellConverter.cs
index 25787ae1..0986a054 100644
--- a/src/ExcelReader.Core/Parser/IExcelCellConverter.cs
+++ b/src/ExcelReader.Core/Parser/IExcelCellConverter.cs
@@ -21,9 +21,8 @@ public interface IExcelCellConverter<T>
         /// signal a parse failure, which leaves the target property at its default.
         /// </summary>
         /// <param name="cell">The non-empty cell to convert.</param>
-        /// <param name="isDate1904">True when the source workbook uses the 1904 date system.</param>
-        /// <param name="provider">The format provider configured for parsing.</param>
+        /// <param name="context">The date system and format provider to convert with.</param>
         /// <param name="value">The converted value, when this method returns true.</param>
-        bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out T value);
+        bool TryConvert(in Cell cell, in ExcelRowContext context, out T value);
     }
 }
diff --git a/src/ExcelReader.Core/Parser/Internal/ColumnParserFactory.cs b/src/ExcelReader.Core/Parser/Internal/ColumnParserFactory.cs
index d08c0ec1..0af63c74 100644
--- a/src/ExcelReader.Core/Parser/Internal/ColumnParserFactory.cs
+++ b/src/ExcelReader.Core/Parser/Internal/ColumnParserFactory.cs
@@ -188,7 +188,7 @@ private static ColumnParser<T> BuildStringParser<T>(PropertyInfo prop)
             where T : allows ref struct
         {
             RefAction<T, string> setter = CompileSetter<T, string>(prop);
-            return (ref model, in cell, _, _) =>
+            return (ref model, in cell, in _) =>
             {
                 setter(ref model, cell.GetString());
                 return true;
@@ -199,22 +199,22 @@ private static ColumnParser<T> BuildSpanParser<T>(PropertyInfo prop)
             where T : allows ref struct
         {
             RefAction<T, ReadOnlySpan<byte>> setter = CompileRefStructSetter<T, ReadOnlySpan<byte>>(prop);
-            return (ref model, in cell, _, _) =>
+            return (ref model, in cell, in _) =>
             {
                 setter(ref model, cell.Value);
                 return true;
             };
         }
 
-        private delegate bool CellReader<V>(in Cell cell, bool isDate1904, IFormatProvider provider, out V value);
+        private delegate bool CellReader<V>(in Cell cell, in ExcelRowContext context, out V value);
 
         private static ColumnParser<T> BuildValue<T, V>(PropertyInfo prop, CellReader<V> read)
             where T : allows ref struct
         {
             RefAction<T, V> setter = CompileSetter<T, V>(prop);
-            return (ref model, in cell, isDate1904, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!read(in cell, isDate1904, provider, out V value))
+                if (!read(in cell, in context, out V value))
                 {
                     return false;
                 }
@@ -228,9 +228,9 @@ private static ColumnParser<T> BuildNullableValue<T, V>(PropertyInfo prop, CellR
             where T : allows ref struct
         {
             RefAction<T, V?> setter = CompileSetter<T, V?>(prop);
-            return (ref model, in cell, isDate1904, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!read(in cell, isDate1904, provider, out V value))
+                if (!read(in cell, in context, out V value))
                 {
                     return false;
                 }
@@ -240,19 +240,19 @@ private static ColumnParser<T> BuildNullableValue<T, V>(PropertyInfo prop, CellR
         }
 
 #pragma warning disable S1172 
-        internal static bool ReadBool(in Cell cell, bool isDate1904, IFormatProvider provider, out bool value)
+        internal static bool ReadBool(in Cell cell, in ExcelRowContext context, out bool value)
         {
             return TryParseBool(in cell, out value);
         }
 
-        internal static bool ReadDateTime(in Cell cell, bool isDate1904, IFormatProvider _, out DateTime value)
+        internal static bool ReadDateTime(in Cell cell, in ExcelRowContext context, out DateTime value)
         {
-            return cell.TryGetDateTime(isDate1904, out value);
+            return cell.TryGetDateTime(context.IsDate1904, out value);
         }
 
-        internal static bool ReadDateOnly(in Cell cell, bool isDate1904, IFormatProvider _, out DateOnly value)
+        internal static bool ReadDateOnly(in Cell cell, in ExcelRowContext context, out DateOnly value)
         {
-            if (!cell.TryGetDateTime(isDate1904, out DateTime dt))
+            if (!cell.TryGetDateTime(context.IsDate1904, out DateTime dt))
             {
                 value = default;
                 return false;
@@ -261,7 +261,7 @@ internal static bool ReadDateOnly(in Cell cell, bool isDate1904, IFormatProvider
             return true;
         }
 
-        internal static bool ReadTimeOnly(in Cell cell, bool isDate1904, IFormatProvider provider, out TimeOnly value)
+        internal static bool ReadTimeOnly(in Cell cell, in ExcelRowContext context, out TimeOnly value)
         {
             if (!cell.TryGetDouble(out double serial) || !double.IsFinite(serial))
             {
@@ -272,19 +272,19 @@ internal static bool ReadTimeOnly(in Cell cell, bool isDate1904, IFormatProvider
             return true;
         }
 
-        internal static bool ReadTextDateTime(in Cell cell, bool _, IFormatProvider provider, out DateTime value)
+        internal static bool ReadTextDateTime(in Cell cell, in ExcelRowContext context, out DateTime value)
         {
-            return TryParseDateTimeText(in cell, provider, out value);
+            return TryParseDateTimeText(in cell, context.FormatProvider, out value);
         }
 
-        internal static bool ReadTextDateOnly(in Cell cell, bool _, IFormatProvider provider, out DateOnly value)
+        internal static bool ReadTextDateOnly(in Cell cell, in ExcelRowContext context, out DateOnly value)
         {
-            return TryParseDateOnlyText(in cell, provider, out value);
+            return TryParseDateOnlyText(in cell, context.FormatProvider, out value);
         }
 
-        internal static bool ReadTextTimeOnly(in Cell cell, bool _, IFormatProvider provider, out TimeOnly value)
+        internal static bool ReadTextTimeOnly(in Cell cell, in ExcelRowContext context, out TimeOnly value)
         {
-            return TryParseTimeOnlyText(in cell, provider, out value);
+            return TryParseTimeOnlyText(in cell, context.FormatProvider, out value);
         }
 #pragma warning restore S1172
 
@@ -387,9 +387,9 @@ private static ColumnParser<T> BuildParsableCore<T, TProp>(PropertyInfo prop)
             where T : allows ref struct
         {
             RefAction<T, TProp> setter = CompileSetter<T, TProp>(prop);
-            return (ref model, in cell, _, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!cell.TryParse<TProp>(provider, out var value))
+                if (!cell.TryParse<TProp>(context.FormatProvider, out var value))
                 {
                     return false;
                 }
@@ -403,9 +403,9 @@ private static ColumnParser<T> BuildNullableParsableCore<T, TProp>(PropertyInfo
             where T : allows ref struct
         {
             RefAction<T, TProp?> setter = CompileSetter<T, TProp?>(prop);
-            return (ref model, in cell, _, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!cell.TryParse(provider, out TProp parsed))
+                if (!cell.TryParse(context.FormatProvider, out TProp parsed))
                 {
                     return false;
                 }
@@ -420,9 +420,9 @@ private static ColumnParser<T> BuildSpanParsableCore<T, TProp>(PropertyInfo prop
             where T : allows ref struct
         {
             RefAction<T, TProp> setter = CompileSetter<T, TProp>(prop);
-            return (ref model, in cell, _, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!TryParseSpanParsable<TProp>(in cell, provider, out var value))
+                if (!TryParseSpanParsable<TProp>(in cell, context.FormatProvider, out var value))
                 {
                     return false;
                 }
@@ -436,9 +436,9 @@ private static ColumnParser<T> BuildNullableSpanParsableCore<T, TProp>(PropertyI
             where T : allows ref struct
         {
             RefAction<T, TProp?> setter = CompileSetter<T, TProp?>(prop);
-            return (ref model, in cell, _, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!TryParseSpanParsable(in cell, provider, out TProp parsed))
+                if (!TryParseSpanParsable(in cell, context.FormatProvider, out TProp parsed))
                 {
                     return false;
                 }
@@ -512,7 +512,7 @@ private static ColumnParser<T> BuildEnumCore<T, TEnum>(PropertyInfo prop)
             where T : allows ref struct
         {
             RefAction<T, TEnum> setter = CompileSetter<T, TEnum>(prop);
-            return (ref model, in cell, _, _) =>
+            return (ref model, in cell, in _) =>
             {
                 if (!EnumCache<TEnum>.TryParse(in cell, out TEnum value))
                 {
@@ -528,7 +528,7 @@ private static ColumnParser<T> BuildNullableEnumCore<T, TEnum>(PropertyInfo prop
             where T : allows ref struct
         {
             RefAction<T, TEnum?> setter = CompileSetter<T, TEnum?>(prop);
-            return (ref model, in cell, _, _) =>
+            return (ref model, in cell, in _) =>
             {
                 if (!EnumCache<TEnum>.TryParse(in cell, out TEnum parsed))
                 {
@@ -545,9 +545,9 @@ private static ColumnParser<T> BuildConverterCore<T, TProp, TConv>(PropertyInfo
         {
             var typed = (TConv)converter;
             RefAction<T, TProp> setter = CompileSetter<T, TProp>(prop);
-            return (ref model, in cell, isDate1904, provider) =>
+            return (ref model, in cell, in context) =>
             {
-                if (!typed.TryConvert(in cell, isDate1904, provider, out TProp value))
+                if (!typed.TryConvert(in cell, in context, out TProp value))
                 {
                     return false;
                 }
diff --git a/src/ExcelReader.Core/Parser/Internal/Delegates.cs b/src/ExcelReader.Core/Parser/Internal/Delegates.cs
index 82c54573..1d6b2136 100644
--- a/src/ExcelReader.Core/Parser/Internal/Delegates.cs
+++ b/src/ExcelReader.Core/Parser/Internal/Delegates.cs
@@ -10,7 +10,6 @@ internal delegate void RefAction<TModel, in TProperty>(ref TModel model, TProper
     internal delegate bool ColumnParser<TModel>(
         ref TModel model,
         in Cell cell,
-        bool isDate1904,
-        IFormatProvider provider)
+        in ExcelRowContext context)
         where TModel : allows ref struct;
 }
diff --git a/src/ExcelReader.Core/Parser/Internal/RowProjector.cs b/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
index fc2a7380..19ab1294 100644
--- a/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
+++ b/src/ExcelReader.Core/Parser/Internal/RowProjector.cs
@@ -11,8 +11,7 @@ internal struct RowProjector<T>
         private readonly StringComparer _comparer;
         private readonly HeaderNormalization _normalization;
         private readonly int _headerRow;
-        private readonly bool _isDate1904;
-        private readonly IFormatProvider _provider;
+        private readonly ExcelRowContext _context;
         private readonly bool _throwOnParseFailure;
         private ColumnBinding<T>[]? _bindings;
         private bool[] _seen;
@@ -25,8 +24,7 @@ internal RowProjector(TypeMapInfo<T> typeInfo, StringComparer comparer, HeaderNo
             _comparer = comparer;
             _normalization = normalization;
             _headerRow = headerRow;
-            _isDate1904 = isDate1904;
-            _provider = provider;
+            _context = new ExcelRowContext { IsDate1904 = isDate1904, FormatProvider = provider };
             _throwOnParseFailure = throwOnParseFailure;
             _seen = [];
         }
@@ -84,7 +82,7 @@ private void BuildIndexColumnMap()
         private readonly void ParseCurrentRow(in Row row, ref T model)
         {
             bool track = _requireValueCount > 0;
-            SparseRowProjection.ParseRow(in row, _bindings!, _seen, track, _isDate1904, _provider, _throwOnParseFailure, _rowNumber, ref model);
+            SparseRowProjection.ParseRow(in row, _bindings!, _seen, track, in _context, _throwOnParseFailure, _rowNumber, ref model);
         }
     }
 }
diff --git a/src/ExcelReader.Core/Parser/Internal/SparseRowProjection.cs b/src/ExcelReader.Core/Parser/Internal/SparseRowProjection.cs
index 6dae79fa..71be8232 100644
--- a/src/ExcelReader.Core/Parser/Internal/SparseRowProjection.cs
+++ b/src/ExcelReader.Core/Parser/Internal/SparseRowProjection.cs
@@ -73,8 +73,7 @@ internal static void ParseRow<TModel>(
             ColumnBinding<TModel>[] bindings,
             scoped Span<bool> seen,
             bool track,
-            bool isDate1904,
-            IFormatProvider provider,
+            in ExcelRowContext context,
             bool throwOnParseFailure,
             int rowNumber,
             ref TModel model)
@@ -107,7 +106,7 @@ internal static void ParseRow<TModel>(
                     bindingIndex++;
                     continue;
                 }
-                if (binding.Parser(ref model, in cell, isDate1904, provider))
+                if (binding.Parser(ref model, in cell, in context))
                 {
                     if (track && binding.RequireValue)
                     {
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs b/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
index 36ad5263..df4614f8 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
@@ -112,7 +112,7 @@ internal static ValueTask<CsvChunkResult<T>> ParseAsync<T>(
             CsvBoundColumnMap<T> map,
             TypeMapInfo<T> info,
             CsvReaderOptions readerOptions,
-            ExcelParserConfig config,
+            ExcelParserOptions config,
             List<T> models,
             CancellationToken ct)
         {
@@ -134,7 +134,7 @@ private static async ValueTask<CsvChunkResult<T>> ParseFromAsync<T>(
             CsvBoundColumnMap<T> map,
             TypeMapInfo<T> info,
             CsvReaderOptions options,
-            ExcelParserConfig config,
+            ExcelParserOptions config,
             CancellationToken ct)
         {
             var projector = new CsvRowProjector<T>(info, map, config.Culture, config.ThrowOnParseFailure);
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvHeaderBinder.cs b/src/ExcelReader.Core/Parser/ParallelCsv/CsvHeaderBinder.cs
index faf29623..b9287001 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvHeaderBinder.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/CsvHeaderBinder.cs
@@ -7,7 +7,7 @@ internal static class CsvHeaderBinder
     {
         internal static CsvBoundColumnMap<T> Bind<T>(
             CsvReader reader,
-            ExcelParserConfig config,
+            ExcelParserOptions config,
             TypeMapInfo<T> info,
             out long firstDataRecordOffset)
         {
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
index 93b5022f..f40dc39c 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/MappedProjection.cs
@@ -12,7 +12,7 @@ internal static class MappedProjection<TState, TModel>
         internal static RowAction<TState> Bind(
             ExcelParser<TModel> parser, TypeMapInfo<TModel> info, bool isDate1904, Row header, int headerRow, bool sequential, ModelSink<TState, TModel> sink)
         {
-            ExcelParserConfig config = parser.Config;
+            ExcelParserOptions config = parser.Config;
             ColumnBinding<TModel>[] bindings;
             int requireValueCount;
             if (info.IsIndexBased)
@@ -25,7 +25,7 @@ internal static RowAction<TState> Bind(
                 bindings = SparseRowProjection.BuildColumnMap(in header, info, config.ColumnNameComparer, config.HeaderNormalization, out requireValueCount);
             }
             bool track = requireValueCount > 0;
-            IFormatProvider provider = config.Culture;
+            ExcelRowContext context = new() { IsDate1904 = isDate1904, FormatProvider = config.Culture };
             bool throwOnParseFailure = config.ThrowOnParseFailure;
             int rowNumber = headerRow;
 
@@ -36,7 +36,7 @@ void Plain(ref TState state, Row row)
                     return;
                 }
                 TModel model = info.CreateInstance();
-                SparseRowProjection.ParseRow(in row, bindings, default, false, isDate1904, provider, throwOnParseFailure, 0, ref model);
+                SparseRowProjection.ParseRow(in row, bindings, default, false, in context, throwOnParseFailure, 0, ref model);
                 sink(ref state, model);
             }
 
@@ -48,7 +48,7 @@ void PlainNumbered(ref TState state, Row row)
                     return;
                 }
                 TModel model = info.CreateInstance();
-                SparseRowProjection.ParseRow(in row, bindings, default, false, isDate1904, provider, throwOnParseFailure, current, ref model);
+                SparseRowProjection.ParseRow(in row, bindings, default, false, in context, throwOnParseFailure, current, ref model);
                 sink(ref state, model);
             }
 
@@ -62,11 +62,11 @@ void Tracked(ref TState state, Row row)
                 if (bindings.Length <= StackallocLimit)
                 {
                     Span<bool> seen = stackalloc bool[bindings.Length];
-                    SparseRowProjection.ParseRow(in row, bindings, seen, true, isDate1904, provider, throwOnParseFailure, 0, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, seen, true, in context, throwOnParseFailure, 0, ref model);
                 }
                 else
                 {
-                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, isDate1904, provider, throwOnParseFailure, 0, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, in context, throwOnParseFailure, 0, ref model);
                 }
                 sink(ref state, model);
             }
@@ -82,11 +82,11 @@ void TrackedNumbered(ref TState state, Row row)
                 if (bindings.Length <= StackallocLimit)
                 {
                     Span<bool> seen = stackalloc bool[bindings.Length];
-                    SparseRowProjection.ParseRow(in row, bindings, seen, true, isDate1904, provider, throwOnParseFailure, current, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, seen, true, in context, throwOnParseFailure, current, ref model);
                 }
                 else
                 {
-                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, isDate1904, provider, throwOnParseFailure, current, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, new bool[bindings.Length], true, in context, throwOnParseFailure, current, ref model);
                 }
                 sink(ref state, model);
             }
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
index 82f862d2..964692ab 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvEnumerable.cs
@@ -14,7 +14,7 @@ internal sealed class ParallelCsvEnumerable<T> : IAsyncEnumerable<T>
         private readonly CsvBoundColumnMap<T> _map;
         private readonly TypeMapInfo<T> _info;
         private readonly CsvReaderOptions _readerOptions;
-        private readonly ExcelParserConfig _config;
+        private readonly ExcelParserOptions _config;
         private readonly int _dop;
 
         private readonly ReaderLifetime? _lease;
@@ -27,7 +27,7 @@ internal ParallelCsvEnumerable(
             CsvBoundColumnMap<T> map,
             TypeMapInfo<T> info,
             CsvReaderOptions readerOptions,
-            ExcelParserConfig config,
+            ExcelParserOptions config,
             int degreeOfParallelism,
             ReaderLifetime? lease = null,
             object? owner = null)
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
index 9a34134c..80b1e0cb 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/ParallelCsvFactory.cs
@@ -51,7 +51,7 @@ private static IAsyncEnumerable<T> Build<T>(
             ReaderLifetime? lease = null,
             object? owner = null)
         {
-            ExcelParserConfig config = parser.Config;
+            ExcelParserOptions config = parser.Config;
             TypeMapInfo<T> info = parser.CsvInfo;
             CsvBoundColumnMap<T> map;
             long dataStart;
diff --git a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
index 0bab5264..4c08148e 100644
--- a/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
+++ b/src/ExcelReader.Core/Parser/SheetPipeline/SheetRowProjection.cs
@@ -39,19 +39,19 @@ private static RowActionFactory<Chunk> Binder(ExcelParser<T> parser, TypeMapInfo
         {
             return (Row header, bool _) =>
             {
-                ExcelParserConfig config = parser.Config;
+                ExcelParserOptions config = parser.Config;
                 ColumnBinding<T>[] bindings = info.IsIndexBased
                     ? info.IndexBindings
                     : SparseRowProjection.BuildColumnMap(in header, info, config.ColumnNameComparer, config.HeaderNormalization, out int _);
                 bool track = bindings.Any(static binding => binding.RequireValue);
-                IFormatProvider provider = config.Culture;
+                ExcelRowContext context = new() { IsDate1904 = isDate1904, FormatProvider = config.Culture };
                 bool throwOnParseFailure = config.ThrowOnParseFailure;
                 return (ref Chunk chunk, Row row) =>
                 {
                     int rowInChunk = ++chunk.Rows;
                     T model = info.CreateInstance();
                     Span<bool> seen = track ? (chunk.Seen ??= new bool[bindings.Length]) : default;
-                    SparseRowProjection.ParseRow(in row, bindings, seen, track, isDate1904, provider, throwOnParseFailure, rowInChunk, ref model);
+                    SparseRowProjection.ParseRow(in row, bindings, seen, track, in context, throwOnParseFailure, rowInChunk, ref model);
                     chunk.Items.Add(model);
                 };
             };
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index a175e6ab..5240f03a 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -42,18 +42,18 @@ ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.IExcelSheet
 ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xls.XlsSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xls.XlsSheet, ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator!>!
 ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsb.XlsbSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T, ExcelReader.Core.Reader.Xlsb.XlsbSheet, ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator!>!
 ExcelReader.Core.Parser.ExcelParser<T>.Parse(ExcelReader.Core.Reader.Xlsx.XlsxSheet sheet) -> ExcelReader.Core.Parser.ExcelEnumerable<T>!
-ExcelReader.Core.Parser.ExcelParserConfig
-ExcelReader.Core.Parser.ExcelParserConfig.ColumnNameComparer.get -> System.StringComparer!
-ExcelReader.Core.Parser.ExcelParserConfig.ColumnNameComparer.init -> void
-ExcelReader.Core.Parser.ExcelParserConfig.Culture.get -> System.Globalization.CultureInfo!
-ExcelReader.Core.Parser.ExcelParserConfig.Culture.init -> void
-ExcelReader.Core.Parser.ExcelParserConfig.ExcelParserConfig() -> void
-ExcelReader.Core.Parser.ExcelParserConfig.HeaderNormalization.get -> ExcelReader.Core.Parser.HeaderNormalization
-ExcelReader.Core.Parser.ExcelParserConfig.HeaderNormalization.init -> void
-ExcelReader.Core.Parser.ExcelParserConfig.HeaderRow.get -> int
-ExcelReader.Core.Parser.ExcelParserConfig.HeaderRow.init -> void
-ExcelReader.Core.Parser.ExcelParserConfig.ThrowOnParseFailure.get -> bool
-ExcelReader.Core.Parser.ExcelParserConfig.ThrowOnParseFailure.init -> void
+ExcelReader.Core.Parser.ExcelParserOptions
+ExcelReader.Core.Parser.ExcelParserOptions.ColumnNameComparer.get -> System.StringComparer!
+ExcelReader.Core.Parser.ExcelParserOptions.ColumnNameComparer.init -> void
+ExcelReader.Core.Parser.ExcelParserOptions.Culture.get -> System.Globalization.CultureInfo!
+ExcelReader.Core.Parser.ExcelParserOptions.Culture.init -> void
+ExcelReader.Core.Parser.ExcelParserOptions.ExcelParserOptions() -> void
+ExcelReader.Core.Parser.ExcelParserOptions.HeaderNormalization.get -> ExcelReader.Core.Parser.HeaderNormalization
+ExcelReader.Core.Parser.ExcelParserOptions.HeaderNormalization.init -> void
+ExcelReader.Core.Parser.ExcelParserOptions.HeaderRow.get -> int
+ExcelReader.Core.Parser.ExcelParserOptions.HeaderRow.init -> void
+ExcelReader.Core.Parser.ExcelParserOptions.ThrowOnParseFailure.get -> bool
+ExcelReader.Core.Parser.ExcelParserOptions.ThrowOnParseFailure.init -> void
 ExcelReader.Core.Parser.ExcelPropertySetter<TModel, TValue>
 ExcelReader.Core.Parser.ExcelRequiredAttribute
 ExcelReader.Core.Parser.ExcelRequiredAttribute.AllowEmpty.get -> bool
@@ -63,7 +63,9 @@ ExcelReader.Core.Parser.ExcelRowContext
 ExcelReader.Core.Parser.ExcelRowContext.Equals(ExcelReader.Core.Parser.ExcelRowContext other) -> bool
 ExcelReader.Core.Parser.ExcelRowContext.ExcelRowContext() -> void
 ExcelReader.Core.Parser.ExcelRowContext.FormatProvider.get -> System.IFormatProvider!
+ExcelReader.Core.Parser.ExcelRowContext.FormatProvider.init -> void
 ExcelReader.Core.Parser.ExcelRowContext.IsDate1904.get -> bool
+ExcelReader.Core.Parser.ExcelRowContext.IsDate1904.init -> void
 ExcelReader.Core.Parser.ExcelRowMapBuilder<T>
 ExcelReader.Core.Parser.ExcelRowMapBuilder<T>.Converted<TValue>(string![]! names, ExcelReader.Core.Parser.IExcelCellConverter<TValue>! converter, ExcelReader.Core.Parser.ExcelPropertySetter<T, TValue>! set, bool isRequired = false, bool requireValue = false) -> ExcelReader.Core.Parser.ExcelRowMapBuilder<T>!
 ExcelReader.Core.Parser.ExcelRowMapBuilder<T>.ExcelRowMapBuilder() -> void
@@ -81,7 +83,7 @@ ExcelReader.Core.Parser.HeaderNormalization.None = 0 -> ExcelReader.Core.Parser.
 ExcelReader.Core.Parser.HeaderNormalization.RemoveDiacritics = 4 -> ExcelReader.Core.Parser.HeaderNormalization
 ExcelReader.Core.Parser.HeaderNormalization.Trim = 1 -> ExcelReader.Core.Parser.HeaderNormalization
 ExcelReader.Core.Parser.IExcelCellConverter<T>
-ExcelReader.Core.Parser.IExcelCellConverter<T>.TryConvert(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out T value) -> bool
+ExcelReader.Core.Parser.IExcelCellConverter<T>.TryConvert(in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context, out T value) -> bool
 ExcelReader.Core.Parser.IExcelRowMap<T>
 ExcelReader.Core.Parser.IExcelRowMap<T>.ConfigureExcelRowMap(ExcelReader.Core.Parser.ExcelRowMapBuilder<T>! builder) -> void
 ExcelReader.Core.Parser.SyncRowEnumerator<T, TRows>
@@ -671,14 +673,14 @@ override ExcelReader.Core.Writer.Xlsb.XlsbWriterOptions.ToString() -> string!
 override ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions.Equals(object? obj) -> bool
 override ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions.GetHashCode() -> int
 override ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions.ToString() -> string!
-static ExcelReader.Core.Parser.ExcelCellReaders.Enum<TEnum>(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TEnum value) -> bool
-static ExcelReader.Core.Parser.ExcelCellReaders.Parsable<TValue>(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TValue value) -> bool
-static ExcelReader.Core.Parser.ExcelCellReaders.SpanParsable<TValue>(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TValue value) -> bool
-static ExcelReader.Core.Parser.ExcelCellReaders.Utf8(scoped in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out System.ReadOnlySpan<byte> value) -> bool
-static ExcelReader.Core.Parser.ExcelParser.Build<T>(System.Action<ExcelReader.Core.Parser.ExcelRowMapBuilder<T>!>! configure, ExcelReader.Core.Parser.ExcelParserConfig? config = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
-static ExcelReader.Core.Parser.ExcelParser.BuildWithAttributeFallback<T>(System.Action<ExcelReader.Core.Parser.ExcelRowMapBuilder<T>!>! configure, ExcelReader.Core.Parser.ExcelParserConfig? config = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
-static ExcelReader.Core.Parser.ExcelParser.FromAttributes<T>(ExcelReader.Core.Parser.ExcelParserConfig? config = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
-static ExcelReader.Core.Parser.ExcelParser.Generated<T>(ExcelReader.Core.Parser.ExcelParserConfig? config = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
+static ExcelReader.Core.Parser.ExcelCellReaders.Enum<TEnum>(in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context, out TEnum value) -> bool
+static ExcelReader.Core.Parser.ExcelCellReaders.Parsable<TValue>(in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context, out TValue value) -> bool
+static ExcelReader.Core.Parser.ExcelCellReaders.SpanParsable<TValue>(in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context, out TValue value) -> bool
+static ExcelReader.Core.Parser.ExcelCellReaders.Utf8(scoped in ExcelReader.Core.Reader.Cell cell, scoped in ExcelReader.Core.Parser.ExcelRowContext context, out System.ReadOnlySpan<byte> value) -> bool
+static ExcelReader.Core.Parser.ExcelParser.Build<T>(System.Action<ExcelReader.Core.Parser.ExcelRowMapBuilder<T>!>! configure, ExcelReader.Core.Parser.ExcelParserOptions? options = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
+static ExcelReader.Core.Parser.ExcelParser.BuildWithAttributeFallback<T>(System.Action<ExcelReader.Core.Parser.ExcelRowMapBuilder<T>!>! configure, ExcelReader.Core.Parser.ExcelParserOptions? options = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
+static ExcelReader.Core.Parser.ExcelParser.FromAttributes<T>(ExcelReader.Core.Parser.ExcelParserOptions? options = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
+static ExcelReader.Core.Parser.ExcelParser.Generated<T>(ExcelReader.Core.Parser.ExcelParserOptions? options = null) -> ExcelReader.Core.Parser.ExcelParser<T>!
 static ExcelReader.Core.Parser.ExcelRowContext.operator !=(ExcelReader.Core.Parser.ExcelRowContext left, ExcelReader.Core.Parser.ExcelRowContext right) -> bool
 static ExcelReader.Core.Parser.ExcelRowContext.operator ==(ExcelReader.Core.Parser.ExcelRowContext left, ExcelReader.Core.Parser.ExcelRowContext right) -> bool
 static ExcelReader.Core.Reader.Csv.CsvDialect.Default.get -> ExcelReader.Core.Reader.Csv.CsvDialect
@@ -803,9 +805,9 @@ static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlyAuto -> ExcelRe
 static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlySerial -> ExcelReader.Core.Parser.ExcelCellReader<System.TimeOnly>!
 static readonly ExcelReader.Core.Parser.ExcelCellReaders.TimeOnlyText -> ExcelReader.Core.Parser.ExcelCellReader<System.TimeOnly>!
 virtual ExcelReader.Core.Parser.AsyncRowEnumerator<T, TSheet, TRows>.DisposeAsync() -> System.Threading.Tasks.ValueTask
-virtual ExcelReader.Core.Parser.ExcelCellReader<TValue>.Invoke(in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider, out TValue value) -> bool
+virtual ExcelReader.Core.Parser.ExcelCellReader<TValue>.Invoke(in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context, out TValue value) -> bool
 virtual ExcelReader.Core.Parser.ExcelPropertySetter<TModel, TValue>.Invoke(ref TModel model, TValue value) -> void
-virtual ExcelReader.Core.Parser.ExcelRowParser<TModel>.Invoke(ref TModel model, in ExcelReader.Core.Reader.Cell cell, bool isDate1904, System.IFormatProvider! provider) -> bool
+virtual ExcelReader.Core.Parser.ExcelRowParser<TModel>.Invoke(ref TModel model, in ExcelReader.Core.Reader.Cell cell, in ExcelReader.Core.Parser.ExcelRowContext context) -> bool
 virtual ExcelReader.Core.Reader.RowAction<TState>.Invoke(ref TState state, ExcelReader.Core.Reader.Row row) -> void
 ~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetAsyncEnumerator(System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken)) -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.AsyncEnumerator!
 ~ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.GetEnumerator() -> ExcelReader.Core.Parser.ExcelEnumerable<T, TSheet, TEnumerator>.Enumerator!
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReader.cs b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
index ca877c92..b83d21b4 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReader.cs
+++ b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
@@ -208,7 +208,7 @@ public object GetValue(int i)
                 CellType.Empty => DBNull.Value,
                 CellType.Number => cell.TryGetDouble(out double d) ? d : cell.GetString(),
                 CellType.Date => cell.TryGetDateTime(_isDate1904, out DateTime dt) ? dt : cell.GetString(),
-                CellType.Boolean => ExcelCellReaders.Bool(in cell, _isDate1904, CultureInfo.InvariantCulture, out bool b) ? b : cell.GetString(),
+                CellType.Boolean => ExcelCellReaders.Bool(in cell, default, out bool b) ? b : cell.GetString(),
                 _ => cell.GetString(),
             };
         }
@@ -241,7 +241,7 @@ public string GetString(int i)
         public bool GetBoolean(int i)
         {
             Cell cell = CurrentCell(i);
-            return ExcelCellReaders.Bool(in cell, _isDate1904, CultureInfo.InvariantCulture, out bool value)
+            return ExcelCellReaders.Bool(in cell, default, out bool value)
                 ? value
                 : throw new FormatException($"Column {i} is not a valid boolean.");
         }
diff --git a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
index 1d31b075..ce927267 100644
--- a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
+++ b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
@@ -152,7 +152,7 @@ internal void Observe(in Cell cell, bool isDate1904, bool parseText)
                         break;
                     case CellType.Number:
                         SawNumber = true;
-                        if (!ExcelCellReaders.Parsable<long>(in cell, isDate1904, CultureInfo.InvariantCulture, out _))
+                        if (!cell.TryParse<long>(CultureInfo.InvariantCulture, out _))
                         {
                             SawNonIntegralNumber = true;
                         }
@@ -176,7 +176,7 @@ private bool ObserveText(in Cell cell, bool isDate1904)
                 bool canonical = HasCanonicalIntegerPart(text, out bool allDigits);
                 if (canonical && allDigits)
                 {
-                    if (!ExcelCellReaders.Parsable<long>(in cell, isDate1904, CultureInfo.InvariantCulture, out _))
+                    if (!cell.TryParse<long>(CultureInfo.InvariantCulture, out _))
                     {
                         return false;
                     }
diff --git a/src/ExcelReader.Core/Reader/SheetParallel.cs b/src/ExcelReader.Core/Reader/SheetParallel.cs
index 8406aa60..0dfd53b2 100644
--- a/src/ExcelReader.Core/Reader/SheetParallel.cs
+++ b/src/ExcelReader.Core/Reader/SheetParallel.cs
@@ -43,7 +43,7 @@ public static class SheetParallel
         /// </summary>
         /// <typeparam name="T">The row model type to bind each row to.</typeparam>
         /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the enumeration ends.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> locates the header.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="T"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserOptions.HeaderRow"/> locates the header.</param>
         /// <param name="options">Parallelism options. Defaults to <see cref="SheetParallelOptions.Default"/>. <see cref="SheetParallelOptions.HeaderRow"/> does not apply here and must be left at <c>0</c>.</param>
         /// <param name="ct">A token to cancel enumeration.</param>
         /// <returns>An enumerable that yields one <typeparamref name="T"/> per data row.</returns>
@@ -67,7 +67,7 @@ public static IAsyncEnumerable<T> ParseAsync<T>(
             if (validated.HeaderRow != 0)
             {
                 throw new ArgumentException(
-                    $"{nameof(SheetParallelOptions)}.{nameof(SheetParallelOptions.HeaderRow)} does not apply to typed parsing; set {nameof(ExcelParserConfig)}.{nameof(ExcelParserConfig.HeaderRow)} instead.",
+                    $"{nameof(SheetParallelOptions)}.{nameof(SheetParallelOptions.HeaderRow)} does not apply to typed parsing; set {nameof(ExcelParserOptions)}.{nameof(ExcelParserOptions.HeaderRow)} instead.",
                     nameof(options));
             }
             return SheetRunner.Parse(sheet, parser, validated.DegreeOfParallelism, ct);
@@ -127,7 +127,7 @@ public static Task ForEachAsync<TRecord>(
         /// </summary>
         /// <typeparam name="TModel">The model type. May be a <see langword="ref struct"/> with <see cref="ReadOnlySpan{T}"/> of <see cref="byte"/> properties.</typeparam>
         /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserOptions.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
         /// <param name="body">Receives each record. See the remarks for the contract it must honor.</param>
         /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
@@ -141,7 +141,7 @@ public static Task ForEachAsync<TRecord>(
         /// <see cref="IRowRecord{TSelf}"/> overload: <paramref name="body"/> runs concurrently, delivery is
         /// at least once in general (exactly once on XLSB, and on a well-formed XLSX sheet), and records arrive
         /// in no particular order. A property that fails to parse keeps its default unless
-        /// <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing <c>[ExcelRequired]</c> column or
+        /// <see cref="ExcelParserOptions.ThrowOnParseFailure"/> is set; a missing <c>[ExcelRequired]</c> column or
         /// value throws <see cref="ExcelParseException"/>; empty rows are skipped.
         /// </para>
         /// <para>
@@ -198,7 +198,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
         /// <typeparam name="TAccumulator">The accumulator type. See <see cref="IRowAccumulator{TSelf, TModel}"/> for the contract it must honor.</typeparam>
         /// <typeparam name="TModel">The model type.</typeparam>
         /// <param name="sheet">The sheet to read. The caller keeps ownership and keeps its workbook open until the task completes.</param>
-        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserConfig.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
+        /// <param name="parser">How columns bind to <typeparamref name="TModel"/>; created with <see cref="ExcelParser"/>. Its <see cref="ExcelParserOptions.HeaderRow"/> is ignored in favour of <see cref="SheetParallelOptions.HeaderRow"/>.</param>
         /// <param name="options">Parallelism and header options. Defaults to <see cref="SheetParallelOptions.Default"/>.</param>
         /// <param name="ct">A token to cancel processing.</param>
         /// <returns>The accumulator holding every record.</returns>
@@ -208,7 +208,7 @@ public static Task<TAccumulator> AggregateAsync<TAccumulator, TRecord>(
         /// <remarks>
         /// <para>
         /// The header is bound once, before any row is folded. A property that fails to parse keeps its
-        /// default unless <see cref="ExcelParserConfig.ThrowOnParseFailure"/> is set; a missing
+        /// default unless <see cref="ExcelParserOptions.ThrowOnParseFailure"/> is set; a missing
         /// <c>[ExcelRequired]</c> column or value throws <see cref="ExcelParseException"/>; empty rows are skipped.
         /// </para>
         /// <para>
diff --git a/src/ExcelReader.Core/Writer/Internal/RecordColumns.cs b/src/ExcelReader.Core/Writer/Internal/RecordColumns.cs
index 2bb7d8a4..330217eb 100644
--- a/src/ExcelReader.Core/Writer/Internal/RecordColumns.cs
+++ b/src/ExcelReader.Core/Writer/Internal/RecordColumns.cs
@@ -180,7 +180,7 @@ internal static MethodInfo Select(Type pt, out bool asString)
     }
 
     /// <summary>
-    /// Formats text-fallback columns with the invariant culture, which is what <see cref="ExcelParserConfig.Culture"/>
+    /// Formats text-fallback columns with the invariant culture, which is what <see cref="ExcelParserOptions.Culture"/>
     /// defaults to, so a column written on any machine parses back.
     /// </summary>
     internal static class InvariantText
diff --git a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
index f6ac8f16..6869f785 100644
--- a/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
+++ b/src/ExcelReader.Generator/ExcelRowMapGenerator.cs
@@ -650,16 +650,16 @@ private static void EmitReadFragment(StringBuilder sb, string qualifiedType, Pro
                 case ReadKind.Value:
                 case ReadKind.Nullable:
                     EmitPropertyRaw(sb, qualifiedType, namesLiteral, p.Assign, req,
-                        $"{p.Read.Reader}(in c, d, pr, out {p.Read.ValueType} v)");
+                        $"{p.Read.Reader}(in c, in x, out {p.Read.ValueType} v)");
                     return;
                 case ReadKind.Converted:
                     EmitPropertyRaw(sb, qualifiedType, namesLiteral, p.Assign, req,
-                        $"{p.Read.Reader}.TryConvert(in c, d, pr, out {p.Read.ValueType} v)");
+                        $"{p.Read.Reader}.TryConvert(in c, in x, out {p.Read.ValueType} v)");
                     return;
                 case ReadKind.GuidValue:
                 case ReadKind.GuidNullable:
                     EmitPropertyRaw(sb, qualifiedType, namesLiteral, p.Assign, req,
-                        "global::ExcelReader.Core.Parser.ExcelCellReaders.Parsable<global::System.Guid>(in c, d, pr, out global::System.Guid v)");
+                        "global::ExcelReader.Core.Parser.ExcelCellReaders.Parsable<global::System.Guid>(in c, in x, out global::System.Guid v)");
                     return;
                 default:
                     return;
@@ -668,7 +668,7 @@ private static void EmitReadFragment(StringBuilder sb, string qualifiedType, Pro
 
         private static void EmitPropertyRaw(StringBuilder sb, string qualifiedType, string namesLiteral, string assign, string req, string tryReadExpr)
         {
-            sb.AppendLine($"            .PropertyRaw([{namesLiteral}], static (ref {qualifiedType} m, in global::ExcelReader.Core.Reader.Cell c, bool d, global::System.IFormatProvider pr) =>");
+            sb.AppendLine($"            .PropertyRaw([{namesLiteral}], static (ref {qualifiedType} m, in global::ExcelReader.Core.Reader.Cell c, in global::ExcelReader.Core.Parser.ExcelRowContext x) =>");
             sb.AppendLine("            {");
             sb.AppendLine($"                if (!{tryReadExpr}) {{ return false; }}");
             sb.AppendLine($"                {assign};");
diff --git a/src/ExcelReader.Native/Typed/TypedApi.cs b/src/ExcelReader.Native/Typed/TypedApi.cs
index a5d4baaf..a7766d07 100644
--- a/src/ExcelReader.Native/Typed/TypedApi.cs
+++ b/src/ExcelReader.Native/Typed/TypedApi.cs
@@ -432,41 +432,41 @@ private bool AppendString(in Cell cell)
             [MethodImpl(MethodImplOptions.NoInlining)]
             private bool AppendInt64(in Cell cell, bool isDate1904)
             {
-                return Append(_longs, ExcelCellReaders.Parsable(in cell, isDate1904, CultureInfo.InvariantCulture, out long value), value);
+                return Append(_longs, ExcelCellReaders.Parsable(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out long value), value);
             }
 
             [MethodImpl(MethodImplOptions.NoInlining)]
             private bool AppendFloat64(in Cell cell, bool isDate1904)
             {
-                return Append(_doubles, ExcelCellReaders.Parsable(in cell, isDate1904, CultureInfo.InvariantCulture, out double value), value);
+                return Append(_doubles, ExcelCellReaders.Parsable(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out double value), value);
             }
 
             [MethodImpl(MethodImplOptions.NoInlining)]
             private bool AppendBool(in Cell cell, bool isDate1904)
             {
-                return Append(_bools, ColumnParserFactory.ReadBool(in cell, isDate1904, CultureInfo.InvariantCulture, out bool flag), (byte)(flag ? 1 : 0));
+                return Append(_bools, ColumnParserFactory.ReadBool(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out bool flag), (byte)(flag ? 1 : 0));
             }
 
             private static readonly int UnixEpochDayNumber = new DateOnly(1970, 1, 1).DayNumber;
 
             private bool AppendDate(in Cell cell, bool isDate1904)
             {
-                bool ok = ColumnParserFactory.ReadDateOnly(in cell, isDate1904, CultureInfo.InvariantCulture, out DateOnly value)
-                    || ColumnParserFactory.ReadTextDateOnly(in cell, isDate1904, CultureInfo.InvariantCulture, out value);
+                bool ok = ColumnParserFactory.ReadDateOnly(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out DateOnly value)
+                    || ColumnParserFactory.ReadTextDateOnly(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out value);
                 return Append(_ints, ok, value.DayNumber - UnixEpochDayNumber);
             }
 
             private bool AppendTime(in Cell cell, bool isDate1904)
             {
-                bool ok = ColumnParserFactory.ReadTimeOnly(in cell, isDate1904, CultureInfo.InvariantCulture, out TimeOnly value)
-                    || ColumnParserFactory.ReadTextTimeOnly(in cell, isDate1904, CultureInfo.InvariantCulture, out value);
+                bool ok = ColumnParserFactory.ReadTimeOnly(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out TimeOnly value)
+                    || ColumnParserFactory.ReadTextTimeOnly(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out value);
                 return Append(_longs, ok, value.ToTimeSpan().Ticks / 10);
             }
 
             private bool AppendTimestamp(in Cell cell, bool isDate1904)
             {
-                bool ok = ColumnParserFactory.ReadDateTime(in cell, isDate1904, CultureInfo.InvariantCulture, out DateTime value)
-                    || ColumnParserFactory.ReadTextDateTime(in cell, isDate1904, CultureInfo.InvariantCulture, out value);
+                bool ok = ColumnParserFactory.ReadDateTime(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out DateTime value)
+                    || ColumnParserFactory.ReadTextDateTime(in cell, new ExcelRowContext { IsDate1904 = isDate1904 }, out value);
                 return Append(_longs, ok, (value - DateTime.UnixEpoch).Ticks / 10);
             }
 
diff --git a/tests/ExcelReader.Tests/Generator/GeneratorTests.cs b/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
index 4285abbd..73a07cff 100644
--- a/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
+++ b/tests/ExcelReader.Tests/Generator/GeneratorTests.cs
@@ -224,7 +224,7 @@ namespace GeneratorTests.BadConverter
                 {
                     public sealed class WrongConverter : IExcelCellConverter<int>
                     {
-                        public bool TryConvert(in Cell cell, bool isDate1904, System.IFormatProvider provider, out int value)
+                        public bool TryConvert(in Cell cell, in ExcelRowContext context, out int value)
                         {
                             value = 0;
                             return true;
@@ -258,7 +258,7 @@ namespace GeneratorTests.GoodConverter
                 {
                     public sealed class UpperCaseConverter : IExcelCellConverter<string>, IExcelCellWriter<string>
                     {
-                        public bool TryConvert(in Cell cell, bool isDate1904, System.IFormatProvider provider, out string value)
+                        public bool TryConvert(in Cell cell, in ExcelRowContext context, out string value)
                         {
                             value = cell.GetString().ToUpperInvariant();
                             return true;
@@ -789,7 +789,7 @@ private static async Task<MemoryStream> BuildAsync(string[] header, string[] row
                         return ms;
                     }
 
-                    private static async Task<string> ParseAsync<T>(ExcelParserConfig? config, string[] header, string[] row, Func<T, string> describe)
+                    private static async Task<string> ParseAsync<T>(ExcelParserOptions? config, string[] header, string[] row, Func<T, string> describe)
                         where T : IExcelRowMap<T>
                     {
                         using MemoryStream ms = await BuildAsync(header, row);
@@ -811,7 +811,7 @@ private static async Task<string> ParseAsync<T>(ExcelParserConfig? config, strin
 
                     public static async Task<string[]> RunAsync()
                     {
-                        var ordinal = new ExcelParserConfig { ColumnNameComparer = StringComparer.Ordinal };
+                        var ordinal = new ExcelParserOptions { ColumnNameComparer = StringComparer.Ordinal };
                         return new[]
                         {
                             await ParseAsync<CaseModel>(null, new[] { "Name" }, new[] { "A" }, static m => m.Upper + "," + m.Lower),
@@ -940,7 +940,7 @@ public ref partial struct Reading
             Assert.True(emit.Success, string.Join(Environment.NewLine, emit.Diagnostics.Select(static d => d.ToString())));
             Assert.Contains("ref partial struct Reading : global::ExcelReader.Core.Parser.IExcelRowMap<", generated, StringComparison.Ordinal);
             Assert.Contains("global::ExcelReader.Core.Writer.IExcelRecordMap<", generated, StringComparison.Ordinal);
-            Assert.Contains("global::ExcelReader.Core.Parser.ExcelCellReaders.Utf8(in c, d, pr, out global::System.ReadOnlySpan<byte> v)", generated, StringComparison.Ordinal);
+            Assert.Contains("global::ExcelReader.Core.Parser.ExcelCellReaders.Utf8(in c, in x, out global::System.ReadOnlySpan<byte> v)", generated, StringComparison.Ordinal);
             Assert.Contains("row.Write(global::System.Text.Encoding.UTF8.GetString(m.Station))", generated, StringComparison.Ordinal);
         }
     }
diff --git a/tests/ExcelReader.Tests/Parser/ConverterTests.cs b/tests/ExcelReader.Tests/Parser/ConverterTests.cs
index efa44624..cf67d9f1 100644
--- a/tests/ExcelReader.Tests/Parser/ConverterTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ConverterTests.cs
@@ -10,7 +10,7 @@ public class ConverterTests
 
         private sealed class BrlMoneyConverter : IExcelCellConverter<decimal>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out decimal value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out decimal value)
             {
                 string text = cell.GetString().Replace("R$", string.Empty, StringComparison.Ordinal).Trim();
                 return decimal.TryParse(text, NumberStyles.Currency, CultureInfo.GetCultureInfo("pt-BR"), out value);
@@ -19,10 +19,10 @@ public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider,
 
         private sealed class PercentConverter : IExcelCellConverter<Percent>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out Percent value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out Percent value)
             {
                 string text = cell.GetString().TrimEnd('%');
-                if (double.TryParse(text, NumberStyles.Any, provider, out double pct))
+                if (double.TryParse(text, NumberStyles.Any, context.FormatProvider, out double pct))
                 {
                     value = new Percent(pct / 100.0);
                     return true;
@@ -34,10 +34,10 @@ public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider,
 
         private sealed class NullablePercentConverter : IExcelCellConverter<Percent?>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out Percent? value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out Percent? value)
             {
                 string text = cell.GetString().TrimEnd('%');
-                if (double.TryParse(text, NumberStyles.Any, provider, out double pct))
+                if (double.TryParse(text, NumberStyles.Any, context.FormatProvider, out double pct))
                 {
                     value = new Percent(pct / 100.0);
                     return true;
@@ -49,9 +49,9 @@ public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider,
 
         private sealed class YearConverter : IExcelCellConverter<int>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out int value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out int value)
             {
-                if (cell.TryGetDateTime(isDate1904, out DateTime dt))
+                if (cell.TryGetDateTime(context.IsDate1904, out DateTime dt))
                 {
                     value = dt.Year;
                     return true;
@@ -86,7 +86,7 @@ private sealed class DatedRow
 
         private sealed class MismatchedConverter : IExcelCellConverter<int>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out int value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out int value)
             {
                 value = 0;
                 return false;
diff --git a/tests/ExcelReader.Tests/Parser/CsvParserTests.cs b/tests/ExcelReader.Tests/Parser/CsvParserTests.cs
index 61f8a99b..d00f8c38 100644
--- a/tests/ExcelReader.Tests/Parser/CsvParserTests.cs
+++ b/tests/ExcelReader.Tests/Parser/CsvParserTests.cs
@@ -66,9 +66,9 @@ private sealed class DateRow
 
         private sealed class IsoDateConverter : IExcelCellConverter<DateTime>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out DateTime value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out DateTime value)
             {
-                return DateTime.TryParse(cell.GetString(), provider, DateTimeStyles.None, out value);
+                return DateTime.TryParse(cell.GetString(), context.FormatProvider, DateTimeStyles.None, out value);
             }
         }
 
@@ -125,7 +125,7 @@ public void PtBrCultureParsesCommaDecimal()
         {
             using var ms = Csv("Name,Amount\nConta,\"1.234,56\"\n");
             using var reader = Excel.FromCsv(ms);
-            var config = new ExcelParserConfig { Culture = CultureInfo.GetCultureInfo("pt-BR") };
+            var config = new ExcelParserOptions { Culture = CultureInfo.GetCultureInfo("pt-BR") };
 
             MoneyRow row = ExcelParser.FromAttributes<MoneyRow>(config).Parse(reader.FirstSheet).Single();
 
@@ -174,7 +174,7 @@ public void EmptyCellLeavesNullableColumnNull()
         public void HeaderRowGreaterThanOneSkipsPrecedingRows()
         {
             using var ms = Csv("ignore me\nName,Age,Score,Active,Balance\nAlice,42,95.5,true,12345.67\n");
-            var config = new ExcelParserConfig { HeaderRow = 2 };
+            var config = new ExcelParserOptions { HeaderRow = 2 };
 
             PersonRow row = ExcelParser.FromAttributes<PersonRow>(config).Parse(Excel.FromCsv(ms).FirstSheet).Single();
 
@@ -215,7 +215,7 @@ public void ThrowOnParseFailureThrowsExcelParseExceptionForUnparseableColumn()
         {
             using var ms = Csv("Name,Amount\nConta,not-a-number\n");
             using var reader = Excel.FromCsv(ms);
-            var config = new ExcelParserConfig { ThrowOnParseFailure = true };
+            var config = new ExcelParserOptions { ThrowOnParseFailure = true };
 
             ExcelParseException ex = Assert.Throws<ExcelParseException>(
                 () => ExcelParser.FromAttributes<MoneyRow>(config).Parse(reader.FirstSheet).ToList());
@@ -263,7 +263,7 @@ public void ANonFiniteTimeOnlyCellFailsToParseInsteadOfBecomingMidnight(string t
         {
             using var ms = Csv($"Start\n{text}\n");
             using var reader = Excel.FromCsv(ms);
-            var config = new ExcelParserConfig { ThrowOnParseFailure = true };
+            var config = new ExcelParserOptions { ThrowOnParseFailure = true };
 
             ExcelParseException ex = Assert.Throws<ExcelParseException>(
                 () => ExcelParser.FromAttributes<ShiftRow>(config).Parse(reader.FirstSheet).ToList());
@@ -311,7 +311,7 @@ public void DateColumnRespectsCulture()
         {
             using var ms = Csv("Created,Day\n02/07/2026,02/07/2026\n");
             using var reader = Excel.FromCsv(ms);
-            var config = new ExcelParserConfig { Culture = CultureInfo.GetCultureInfo("pt-BR") };
+            var config = new ExcelParserOptions { Culture = CultureInfo.GetCultureInfo("pt-BR") };
 
             DateRow row = ExcelParser.FromAttributes<DateRow>(config).Parse(reader.FirstSheet).Single();
 
diff --git a/tests/ExcelReader.Tests/Parser/ExcelCellReadersUtf8Tests.cs b/tests/ExcelReader.Tests/Parser/ExcelCellReadersUtf8Tests.cs
index 6680c1b7..2573924e 100644
--- a/tests/ExcelReader.Tests/Parser/ExcelCellReadersUtf8Tests.cs
+++ b/tests/ExcelReader.Tests/Parser/ExcelCellReadersUtf8Tests.cs
@@ -17,7 +17,7 @@ public void ReadsTheRawBytesOfEveryField()
             {
                 for (int i = 0; i < 3; i++)
                 {
-                    Assert.True(ExcelCellReaders.Utf8(row[i], false, System.Globalization.CultureInfo.InvariantCulture, out ReadOnlySpan<byte> value));
+                    Assert.True(ExcelCellReaders.Utf8(row[i], default, out ReadOnlySpan<byte> value));
                     seen.Add(Encoding.UTF8.GetString(value));
                 }
             }
diff --git a/tests/ExcelReader.Tests/Parser/ExcelParserTests.cs b/tests/ExcelReader.Tests/Parser/ExcelParserTests.cs
index 6ad2e6b5..afb3f5d4 100644
--- a/tests/ExcelReader.Tests/Parser/ExcelParserTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ExcelParserTests.cs
@@ -223,7 +223,7 @@ public async Task OrdinalComparerRejectsCaseMismatch()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["name"], ["Alice"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { ColumnNameComparer = StringComparer.Ordinal };
+            var config = new ExcelParserOptions { ColumnNameComparer = StringComparer.Ordinal };
             var result = ExcelParser.FromAttributes<PersonRow>(config).Parse(reader.FirstSheet).ToList();
             Assert.Single(result);
             Assert.Null(result[0].Name);
@@ -234,7 +234,7 @@ public async Task OrdinalComparerAcceptsExactCaseMatch()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Name"], ["Alice"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { ColumnNameComparer = StringComparer.Ordinal };
+            var config = new ExcelParserOptions { ColumnNameComparer = StringComparer.Ordinal };
             var result = ExcelParser.FromAttributes<PersonRow>(config).Parse(reader.FirstSheet).ToList();
             Assert.Single(result);
             Assert.Equal("Alice", result[0].Name);
@@ -249,7 +249,7 @@ public async Task HeaderRowTwoSkipsFirstRow()
                 ["Name"],
                 ["Alice"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { HeaderRow = 2 };
+            var config = new ExcelParserOptions { HeaderRow = 2 };
             var result = ExcelParser.FromAttributes<PersonRow>(config).Parse(reader.FirstSheet).ToList();
             Assert.Single(result);
             Assert.Equal("Alice", result[0].Name);
@@ -264,7 +264,7 @@ public async Task HeaderRowThreeSkipsTwoRows()
                 ["Name"],
                 ["Bob"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { HeaderRow = 3 };
+            var config = new ExcelParserOptions { HeaderRow = 3 };
             var result = ExcelParser.FromAttributes<PersonRow>(config).Parse(reader.FirstSheet).ToList();
             Assert.Single(result);
             Assert.Equal("Bob", result[0].Name);
@@ -275,14 +275,14 @@ public async Task HeaderRowThreeSkipsTwoRows()
         public void ZeroHeaderRowThrows()
         {
             Assert.Throws<ArgumentOutOfRangeException>(() =>
-                ExcelParser.FromAttributes<PersonRow>(new ExcelParserConfig { HeaderRow = 0 }));
+                ExcelParser.FromAttributes<PersonRow>(new ExcelParserOptions { HeaderRow = 0 }));
         }
 
         [Fact]
         public void NegativeHeaderRowThrows()
         {
             Assert.Throws<ArgumentOutOfRangeException>(() =>
-                ExcelParser.FromAttributes<PersonRow>(new ExcelParserConfig { HeaderRow = -1 }));
+                ExcelParser.FromAttributes<PersonRow>(new ExcelParserOptions { HeaderRow = -1 }));
         }
 
 
diff --git a/tests/ExcelReader.Tests/Parser/ExcelRowMapBuilderTests.cs b/tests/ExcelReader.Tests/Parser/ExcelRowMapBuilderTests.cs
index 80f4606f..a94fb2eb 100644
--- a/tests/ExcelReader.Tests/Parser/ExcelRowMapBuilderTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ExcelRowMapBuilderTests.cs
@@ -97,7 +97,7 @@ public async Task RequiredColumnMissingThrowsLikeReflection()
             TypeMapInfo<MapBuilderTestModel> info = builder.Build();
 
             await using XlsxWorkbook mappedReader = await Excel.FromXlsxAsync(mappedStream, ct: TestContext.Current.CancellationToken);
-            var mappedEnumerable = new ExcelEnumerable<MapBuilderTestModel, XlsxSheet, XlsxWorkbook.Enumerator>(mappedReader.FirstSheet, new ExcelParserConfig(), info);
+            var mappedEnumerable = new ExcelEnumerable<MapBuilderTestModel, XlsxSheet, XlsxWorkbook.Enumerator>(mappedReader.FirstSheet, new ExcelParserOptions(), info);
             ExcelParseException mappedEx = Assert.Throws<ExcelParseException>(() => mappedEnumerable.ToList());
 
             await using MemoryStream reflectedStream = await TypedWorkbook.BuildAsync(["Name"], ["Alice"]);
diff --git a/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs b/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
index 3e2a8975..7158a982 100644
--- a/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
+++ b/tests/ExcelReader.Tests/Parser/GeneratedMapParityTests.cs
@@ -47,7 +47,7 @@ public partial class EveryTypeModel
 
         public sealed class UpperCaseConverter : IExcelCellConverter<string>, IExcelCellWriter<string>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out string value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out string value)
             {
                 value = cell.GetString().ToUpperInvariant();
                 return true;
diff --git a/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs b/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
index 11ac642a..36e7624f 100644
--- a/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
+++ b/tests/ExcelReader.Tests/Parser/HeaderCollisionTests.cs
@@ -41,9 +41,9 @@ private sealed partial class SamePropertyAliasModel
             public string Name { get; set; } = "";
         }
 
-        private static readonly ExcelParserConfig Ordinal = new() { ColumnNameComparer = StringComparer.Ordinal };
+        private static readonly ExcelParserOptions Ordinal = new() { ColumnNameComparer = StringComparer.Ordinal };
 
-        private static ExcelParser<CaseModel>[] CaseParsers(ExcelParserConfig? config)
+        private static ExcelParser<CaseModel>[] CaseParsers(ExcelParserOptions? config)
         {
             return
             [
@@ -55,7 +55,7 @@ private static ExcelParser<CaseModel>[] CaseParsers(ExcelParserConfig? config)
             ];
         }
 
-        private static ExcelParser<AliasModel>[] AliasParsers(ExcelParserConfig? config)
+        private static ExcelParser<AliasModel>[] AliasParsers(ExcelParserOptions? config)
         {
             return
             [
@@ -67,7 +67,7 @@ private static ExcelParser<AliasModel>[] AliasParsers(ExcelParserConfig? config)
             ];
         }
 
-        private static ExcelParser<DiacriticModel>[] DiacriticParsers(ExcelParserConfig? config)
+        private static ExcelParser<DiacriticModel>[] DiacriticParsers(ExcelParserOptions? config)
         {
             return
             [
@@ -130,7 +130,7 @@ public async Task AliasCollidingWithAnotherPropertyThrows()
         [Fact]
         public async Task NormalizationEquivalentHeadersThrowOnlyWhenNormalizationMakesThemEqual()
         {
-            foreach (ExcelParser<DiacriticModel> parser in DiacriticParsers(new ExcelParserConfig { HeaderNormalization = HeaderNormalization.RemoveDiacritics }))
+            foreach (ExcelParser<DiacriticModel> parser in DiacriticParsers(new ExcelParserOptions { HeaderNormalization = HeaderNormalization.RemoveDiacritics }))
             {
                 await Assert.ThrowsAsync<InvalidOperationException>(() => ParseAsync(parser, ["Cafe"], ["x"]));
             }
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
index 65508c2a..4c108968 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/AggregateCsvModelTests.cs
@@ -76,7 +76,7 @@ private static List<string> Sequential(byte[] csv, int headerRow)
         {
             using CsvReader reader = Excel.FromCsv(csv);
             var rows = new List<string>();
-            foreach (Person person in ExcelParser.FromAttributes<Person>(new ExcelParserConfig { HeaderRow = headerRow }).Parse(reader.FirstSheet))
+            foreach (Person person in ExcelParser.FromAttributes<Person>(new ExcelParserOptions { HeaderRow = headerRow }).Parse(reader.FirstSheet))
             {
                 rows.Add(Render(person));
             }
@@ -92,7 +92,7 @@ private static ExcelParser<Person>[] EveryMap()
                 ExcelParser.Generated<Person>(),
                 ExcelParser.FromAttributes<Person>(),
                 ExcelParser.Build<Person>(static b => b
-                    .PropertyRaw(["Name"], static (ref Person m, in Cell c, bool d, IFormatProvider pr) =>
+                    .PropertyRaw(["Name"], static (ref Person m, in Cell c, in ExcelRowContext x) =>
                     {
                         m.Name = c.Value;
                         return true;
@@ -204,7 +204,7 @@ public async Task BindsReorderedAndAliasedColumns()
         {
             byte[] csv = "Note,Identifier,Name\nn1,1,ada\nn2,2,bob\n"u8.ToArray();
             ExcelParser<Person> map = ExcelParser.Build<Person>(static b => b
-                .PropertyRaw(["Name"], static (ref Person m, in Cell c, bool d, IFormatProvider pr) =>
+                .PropertyRaw(["Name"], static (ref Person m, in Cell c, in ExcelRowContext x) =>
                 {
                     m.Name = c.Value;
                     return true;
@@ -274,7 +274,7 @@ public async Task SkipsEmptyRecords()
         public async Task ReportsTheExactRowSequentiallyAndZeroWhenPartitioned()
         {
             byte[] csv = "Name,Id,Note\nada,1,n\nbob,2,n\ncid,oops,n\ndan,4,n\n"u8.ToArray();
-            ExcelParser<Person> map = ExcelParser.Generated<Person>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParser<Person> map = ExcelParser.Generated<Person>(new ExcelParserOptions { ThrowOnParseFailure = true });
 
             using CsvReader reader = Excel.FromCsv(csv);
             ExcelParseException sequential = await Assert.ThrowsAsync<ExcelParseException>(() => SheetParallel.AggregateAsync<PeopleLog, Person>(
@@ -289,7 +289,7 @@ public async Task ReportsTheExactRowSequentiallyAndZeroWhenPartitioned()
         public async Task DiscardsParseFailuresFromAMisguessedPartition()
         {
             byte[] csv = "Name,Id,Note\nok,1,\"one\nBOOM,notint,x\"\nok,2,two\nok,3,\"three\nBOOM,bad,y\"\nok,4,four\n"u8.ToArray();
-            ExcelParser<Person> map = ExcelParser.Generated<Person>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParser<Person> map = ExcelParser.Generated<Person>(new ExcelParserOptions { ThrowOnParseFailure = true });
             List<string> expected = Sequential(csv, headerRow: 1);
             for (int chunkSize = 1; chunkSize <= csv.Length; chunkSize++)
             {
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvChunkWorkerTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvChunkWorkerTests.cs
index 2be4f5fb..99c9bde8 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvChunkWorkerTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvChunkWorkerTests.cs
@@ -19,7 +19,7 @@ private static async Task<CsvChunkResult<Row>> ParseAsync(byte[] csv, long start
         {
             using var headerReader = Excel.FromCsv(csv);
             CsvBoundColumnMap<Row> map = CsvHeaderBinder.Bind(
-                headerReader, new ExcelParserConfig(), TypeMapper<Row>.GetCsvInfo(), out _);
+                headerReader, new ExcelParserOptions(), TypeMapper<Row>.GetCsvInfo(), out _);
 
             var source = new CsvChunkSource(csv.AsMemory());
             return await CsvChunkWorker.ParseAsync(
@@ -29,7 +29,7 @@ private static async Task<CsvChunkResult<Row>> ParseAsync(byte[] csv, long start
                 map,
                 TypeMapper<Row>.GetCsvInfo(),
                 CsvReaderOptions.Default,
-                new ExcelParserConfig(),
+                new ExcelParserOptions(),
                 [],
                 CancellationToken.None);
         }
@@ -120,7 +120,7 @@ public async Task ParsesTheSameRecordFromAFileBackedSourceAsFromMemory()
             {
                 using var headerReader = Excel.FromCsv(csv);
                 CsvBoundColumnMap<Row> map = CsvHeaderBinder.Bind(
-                    headerReader, new ExcelParserConfig(), TypeMapper<Row>.GetCsvInfo(), out _);
+                    headerReader, new ExcelParserOptions(), TypeMapper<Row>.GetCsvInfo(), out _);
 
                 using SafeFileHandle handle = File.OpenHandle(path, FileMode.Open, FileAccess.Read, FileShare.Read);
                 var source = new CsvChunkSource(handle, csv.Length);
@@ -132,7 +132,7 @@ public async Task ParsesTheSameRecordFromAFileBackedSourceAsFromMemory()
                     map,
                     TypeMapper<Row>.GetCsvInfo(),
                     CsvReaderOptions.Default,
-                    new ExcelParserConfig(),
+                    new ExcelParserOptions(),
                     [],
                     TestContext.Current.CancellationToken);
 
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvHeaderBinderTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvHeaderBinderTests.cs
index cd1495ff..20a43952 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvHeaderBinderTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/CsvHeaderBinderTests.cs
@@ -23,7 +23,7 @@ public void BindsTheHeaderAndReportsWhereDataStarts()
 
             CsvBoundColumnMap<Person> map = CsvHeaderBinder.Bind(
                 reader,
-                new ExcelParserConfig(),
+                new ExcelParserOptions(),
                 TypeMapper<Person>.GetCsvInfo(),
                 out long firstDataRecordOffset);
 
@@ -42,7 +42,7 @@ public void AProjectorBuiltFromABoundMapParsesTheVeryFirstRowAsData()
             using var headerReader = Excel.FromCsv(all);
             CsvBoundColumnMap<Person> map = CsvHeaderBinder.Bind(
                 headerReader,
-                new ExcelParserConfig(),
+                new ExcelParserOptions(),
                 TypeMapper<Person>.GetCsvInfo(),
                 out long dataStart);
 
@@ -77,7 +77,7 @@ public void TheSameBoundMapIsSafeToShareAcrossConcurrentProjectors()
             using var headerReader = Excel.FromCsv(all);
             CsvBoundColumnMap<Person> map = CsvHeaderBinder.Bind(
                 headerReader,
-                new ExcelParserConfig(),
+                new ExcelParserOptions(),
                 TypeMapper<Person>.GetCsvInfo(),
                 out long dataStart);
 
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
index 0d99f848..4050c2d6 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParallelCsvEnumerableTests.cs
@@ -26,10 +26,10 @@ private sealed class RequiredRow
 
         private static ParallelCsvEnumerable<Row> Build(byte[] csv, int dop, int chunkSizeOverride)
         {
-            return Build<Row>(csv, dop, chunkSizeOverride, new ExcelParserConfig());
+            return Build<Row>(csv, dop, chunkSizeOverride, new ExcelParserOptions());
         }
 
-        private static ParallelCsvEnumerable<TRow> Build<TRow>(byte[] csv, int dop, int chunkSizeOverride, ExcelParserConfig config)
+        private static ParallelCsvEnumerable<TRow> Build<TRow>(byte[] csv, int dop, int chunkSizeOverride, ExcelParserOptions config)
         {
             using var headerReader = Excel.FromCsv(csv);
             CsvBoundColumnMap<TRow> map = CsvHeaderBinder.Bind(
@@ -42,7 +42,7 @@ private static ParallelCsvEnumerable<TRow> Build<TRow>(byte[] csv, int dop, int
                 CsvReaderOptions.Default, config, dop);
         }
 
-        private static async Task AssertSameFailureAsSequentialAsync<TRow>(byte[] csv, ExcelParserConfig config)
+        private static async Task AssertSameFailureAsSequentialAsync<TRow>(byte[] csv, ExcelParserOptions config)
         {
             using CsvReader sequentialReader = Excel.FromCsv(csv);
             ExcelParseException expected = Assert.Throws<ExcelParseException>(
@@ -169,7 +169,7 @@ public Task ReportsAParseFailureAtTheRowTheSequentialPathWouldReport()
 
             return AssertSameFailureAsSequentialAsync<Row>(
                 Encoding.UTF8.GetBytes(sb.ToString()),
-                new ExcelParserConfig { ThrowOnParseFailure = true });
+                new ExcelParserOptions { ThrowOnParseFailure = true });
         }
 
         [Fact]
@@ -183,7 +183,7 @@ public Task ReportsABlankRequiredCellTheWayTheSequentialPathDoes()
             }
 
             return AssertSameFailureAsSequentialAsync<RequiredRow>(
-                Encoding.UTF8.GetBytes(sb.ToString()), new ExcelParserConfig());
+                Encoding.UTF8.GetBytes(sb.ToString()), new ExcelParserOptions());
         }
 
         [Fact]
@@ -198,7 +198,7 @@ public Task ReportsAParseFailureRowRelativeToANonDefaultHeaderRow()
 
             return AssertSameFailureAsSequentialAsync<Row>(
                 Encoding.UTF8.GetBytes(sb.ToString()),
-                new ExcelParserConfig { HeaderRow = 3, ThrowOnParseFailure = true });
+                new ExcelParserOptions { HeaderRow = 3, ThrowOnParseFailure = true });
         }
 
         [Fact]
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
index 8ebd9fdb..960740c3 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
@@ -138,7 +138,7 @@ public void AHeaderRowOnTheParallelOptionsThrowsBecauseTypedParsingReadsItFromTh
 
             ArgumentException exception = Assert.Throws<ArgumentException>(
                 () => SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { HeaderRow = 2 }, ct: TestContext.Current.CancellationToken));
-            Assert.Contains(nameof(ExcelParserConfig.HeaderRow), exception.Message, StringComparison.Ordinal);
+            Assert.Contains(nameof(ExcelParserOptions.HeaderRow), exception.Message, StringComparison.Ordinal);
         }
 
         [Fact]
diff --git a/tests/ExcelReader.Tests/Parser/ParserFeatureTests.cs b/tests/ExcelReader.Tests/Parser/ParserFeatureTests.cs
index a29a87dc..00d4e276 100644
--- a/tests/ExcelReader.Tests/Parser/ParserFeatureTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParserFeatureTests.cs
@@ -73,7 +73,7 @@ public async Task PtBrCultureParsesCommaDecimalAndThousandsSeparator()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Name", "Amount"], ["Conta", "1.234,56"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { Culture = CultureInfo.GetCultureInfo("pt-BR") };
+            var config = new ExcelParserOptions { Culture = CultureInfo.GetCultureInfo("pt-BR") };
 
             MoneyRow row = ExcelParser.FromAttributes<MoneyRow>(config).Parse(reader.FirstSheet).Single();
 
@@ -97,7 +97,7 @@ public async Task ThrowOnParseFailureThrowsForUnparseableNonRequiredColumn()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Name", "Amount"], ["Conta", "not-a-number"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { ThrowOnParseFailure = true };
+            var config = new ExcelParserOptions { ThrowOnParseFailure = true };
 
             ExcelParseException ex = Assert.Throws<ExcelParseException>(
                 () => ExcelParser.FromAttributes<MoneyRow>(config).Parse(reader.FirstSheet).ToList());
diff --git a/tests/ExcelReader.Tests/Parser/RefStructModelTests.cs b/tests/ExcelReader.Tests/Parser/RefStructModelTests.cs
index 120d4447..87e6e858 100644
--- a/tests/ExcelReader.Tests/Parser/RefStructModelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/RefStructModelTests.cs
@@ -32,7 +32,7 @@ private readonly ref struct SaleSpanRef
 
         private sealed class UpperCaseConverter : IExcelCellConverter<string>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out string value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out string value)
             {
                 value = cell.GetString().ToUpperInvariant();
                 return true;
@@ -179,7 +179,7 @@ public async Task ParseNamed_ThrowOnParseFailureThrowsExcelParseException()
             await using var ms = await TypedWorkbook.BuildAsync(
                 ["Name", "Id", "Value", "Date"],
                 ["Alice", "oops", 10.5, SampleDate]);
-            var config = new ExcelParserConfig { ThrowOnParseFailure = true };
+            var config = new ExcelParserOptions { ThrowOnParseFailure = true };
 
             using var reader = Excel.FromXlsx(ms, leaveOpen: true);
             var enumerator = ExcelParser.FromAttributes<SaleNamedRef>(config).Parse(reader.FirstSheet).GetEnumerator();
diff --git a/tests/ExcelReader.Tests/Parser/RequiredTests.cs b/tests/ExcelReader.Tests/Parser/RequiredTests.cs
index fa28db6b..0ddf20e2 100644
--- a/tests/ExcelReader.Tests/Parser/RequiredTests.cs
+++ b/tests/ExcelReader.Tests/Parser/RequiredTests.cs
@@ -133,7 +133,7 @@ public async Task ThrowOnParseFailureReportsColumnAndRawValueEvenForRequiredColu
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id", "FullName"], ["oops", "Alice"]);
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
-            var config = new ExcelParserConfig { ThrowOnParseFailure = true };
+            var config = new ExcelParserOptions { ThrowOnParseFailure = true };
 
             ExcelParseException ex = Assert.Throws<ExcelParseException>(
                 () => ExcelParser.FromAttributes<Row>(config).Parse(reader.FirstSheet).ToList());
diff --git a/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
index e3f8a859..b4696b3b 100644
--- a/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
+++ b/tests/ExcelReader.Tests/Parser/SheetParallelXlsxTests.cs
@@ -143,7 +143,7 @@ public async Task AParseFailureReportsTheSheetRow()
             }
             using MemoryStream ms = WorkbookBuilder.Build(sb.ToString());
             using XlsxWorkbook workbook = Excel.FromXlsx(ms);
-            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserOptions { ThrowOnParseFailure = true });
             ExcelParseException sequential = Assert.Throws<ExcelParseException>(() => parser.Parse(workbook.FirstSheet).ToList());
             SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
 
@@ -171,7 +171,7 @@ public async Task AParseFailureAfterPipelineRecoveryReportsTheSheetRow()
             }
             using MemoryStream ms = WorkbookBuilder.Build(sb.ToString());
             using XlsxWorkbook workbook = Excel.FromXlsx(ms);
-            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserConfig { ThrowOnParseFailure = true });
+            ExcelParser<Sale> parser = ExcelParser.FromAttributes<Sale>(new ExcelParserOptions { ThrowOnParseFailure = true });
             ExcelParseException sequential = Assert.Throws<ExcelParseException>(() => parser.Parse(workbook.FirstSheet).ToList());
             SheetPipelineSource source = SheetPipelineSource.Create(workbook.FirstSheet)!;
             Assert.Equal(211, sequential.Row);
diff --git a/tests/ExcelReader.Tests/Parser/UnifiedParserTests.cs b/tests/ExcelReader.Tests/Parser/UnifiedParserTests.cs
index 40265324..ba7f6f38 100644
--- a/tests/ExcelReader.Tests/Parser/UnifiedParserTests.cs
+++ b/tests/ExcelReader.Tests/Parser/UnifiedParserTests.cs
@@ -154,14 +154,14 @@ public void RefStructModelParsesThroughExcelFluentParser()
         {
             using CsvReader reader = Excel.FromCsv(Csv);
             var parser = ExcelParser.Build<FluentSale>(static builder => builder
-                .PropertyRaw(["Name"], static (ref FluentSale m, in Cell c, bool _, IFormatProvider _) =>
+                .PropertyRaw(["Name"], static (ref FluentSale m, in Cell c, in ExcelRowContext _) =>
                 {
                     m.Name = c.Value;
                     return true;
                 })
-                .PropertyRaw(["Id"], static (ref FluentSale m, in Cell c, bool _, IFormatProvider p) =>
+                .PropertyRaw(["Id"], static (ref FluentSale m, in Cell c, in ExcelRowContext x) =>
                 {
-                    bool ok = c.TryParse(p, out int id);
+                    bool ok = c.TryParse(x.FormatProvider, out int id);
                     m.Id = id;
                     return ok;
                 }));
diff --git a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
index aff305a6..5b5c4d54 100644
--- a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
@@ -305,7 +305,7 @@ public void XlsParserHeaderRowSkipsLeadingRows()
         {
             using var ms = XlsWorkbookBuilder.Build(sheets: [("S1", [["skip"], ["Name"], ["Sol"]])]);
             using var reader = Excel.FromXls(ms);
-            var parser = ExcelParser.FromAttributes<PersonRow>(new ExcelParserConfig { HeaderRow = 2 });
+            var parser = ExcelParser.FromAttributes<PersonRow>(new ExcelParserOptions { HeaderRow = 2 });
 
             var result = parser.Parse(reader.FirstSheet).ToList();
             Assert.Single(result);
diff --git a/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs b/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
index af1a9491..aed46749 100644
--- a/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
@@ -114,9 +114,9 @@ private sealed class IgnoreRow
 
         private sealed class MoneyConverter : IExcelCellConverter<Money>, IExcelCellWriter<Money>
         {
-            public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out Money value)
+            public bool TryConvert(in Cell cell, in ExcelRowContext context, out Money value)
             {
-                if (cell.TryParse(provider, out decimal amount))
+                if (cell.TryParse(context.FormatProvider, out decimal amount))
                 {
                     value = new Money(amount);
                     return true;
@@ -833,7 +833,7 @@ public async Task HeaderRowTwoConfig()
             }).ConfigureAwait(true);
 
             await using var reader = Excel.FromXlsx(ms);
-            var config = new ExcelParserConfig { HeaderRow = 2 };
+            var config = new ExcelParserOptions { HeaderRow = 2 };
             var rows = ExcelParser.FromAttributes<StringRow>(config).Parse(reader.FirstSheet).ToList();
             Assert.Single(rows);
             Assert.Equal("HeaderRow2", rows[0].Name);

From 042c8a38e0b39b7ca146da12195754344f05b7d3 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:30:12 -0300
Subject: [PATCH 086/115] refactor!: take options objects instead of positional
 optional parameters

Excel.InferSchema now takes SchemaInferenceOptions (replacing both overloads), the
ExcelDataReader constructor takes ExcelDataReaderOptions, ToArrowRecordBatch takes
ArrowReadOptions and WriteRecordBatch/WriteRecordBatchAsync take ArrowWriteOptions. A new
knob becomes a new init property instead of another overload.
---
 docs/guide/reading.md                         | 12 ++--
 .../ArrowConversionExtensions.cs              | 20 +++---
 src/ExcelReader.Arrow/ArrowReadOptions.cs     | 24 +++++++
 src/ExcelReader.Arrow/ArrowWriteExtensions.cs | 67 ++++++++++---------
 src/ExcelReader.Arrow/ArrowWriteOptions.cs    | 15 +++++
 .../PublicAPI/PublicAPI.Shipped.txt           |  9 ---
 .../PublicAPI/PublicAPI.Unshipped.txt         | 23 +++++++
 src/ExcelReader.Cli/CliCommands.cs            |  2 +-
 .../PublicAPI/PublicAPI.Shipped.txt           |  3 -
 .../PublicAPI/PublicAPI.Unshipped.txt         | 16 +++++
 src/ExcelReader.Core/Reader/Excel.cs          | 47 +++----------
 .../Reader/ExcelDataReader.cs                 | 16 ++---
 .../Reader/ExcelDataReaderOptions.cs          | 16 +++++
 .../Reader/Schema/ExcelColumnSchema.cs        |  2 +-
 .../Reader/Schema/ExcelColumnType.cs          |  2 +-
 .../Reader/Schema/SchemaInference.cs          |  2 +-
 .../Reader/Schema/SchemaInferenceOptions.cs   | 27 ++++++++
 .../Interop/ArrowConversionBenchmark.cs       |  6 +-
 .../Parse/ParseBenchmark.cs                   |  4 +-
 .../Read/ReadBenchmark.cs                     |  2 +-
 .../Read/StringHeavyReadBenchmark.cs          |  4 +-
 .../Read/XlsReadBenchmark.cs                  |  2 +-
 .../RealData/RealDataReadBenchmark.cs         |  8 +--
 .../Arrow/ArrowConversionTests.cs             | 26 +++----
 .../Arrow/ArrowWriteExtensionsTests.cs        | 10 +--
 .../Reader/Csv/CsvReplayTests.cs              |  2 +-
 .../Reader/ExcelDataReaderTests.cs            |  4 +-
 .../Reader/SchemaInferenceTests.cs            |  2 +-
 .../Reader/SheetConsumerTests.cs              |  2 +-
 .../Reader/Tables/TableBindingTests.cs        |  8 +--
 30 files changed, 231 insertions(+), 152 deletions(-)
 create mode 100644 src/ExcelReader.Arrow/ArrowReadOptions.cs
 create mode 100644 src/ExcelReader.Arrow/ArrowWriteOptions.cs
 create mode 100644 src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs
 create mode 100644 src/ExcelReader.Core/Reader/Schema/SchemaInferenceOptions.cs

diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index ba6e00b0..8852fb1a 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -141,7 +141,7 @@ using var workbook = Excel.FromXlsxFile("report.xlsx");
 Apache.Arrow.RecordBatch batch = workbook.FirstSheet.ToArrowRecordBatch();
 ```
 
-`schema` defaults to `Excel.InferSchema`'s guess; pass an explicit `ExcelColumnSchema[]` to skip inference. The whole sheet is materialized into one `RecordBatch` — there is no chunked/streaming variant yet. Inference costs about the same time and ~1.8x the allocation of an explicit schema on the same file. See [Arrow conversion](../performance/benchmarks.md#arrow-conversion) in the benchmarks.
+The schema defaults to `Excel.InferSchema`'s guess; pass one in `new ArrowReadOptions { Schema = ... }` to skip inference, and set `HeaderRow` there (default 1, 0 for none). The whole sheet is materialized into one `RecordBatch` — there is no chunked/streaming variant yet. Inference costs about the same time and ~1.8x the allocation of an explicit schema on the same file. See [Arrow conversion](../performance/benchmarks.md#arrow-conversion) in the benchmarks.
 
 `WriteRecordBatch`/`WriteRecordBatchAsync` are the write-side mirror — one call from a `RecordBatch` to a sheet, for XLSX, XLSB, XLS, and CSV:
 
@@ -154,7 +154,7 @@ using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("repor
 workbook.WriteRecordBatch(batch); // adds the sheet, writes the header + every row, ends the workbook
 ```
 
-Supports string, large string, string view, every integer width (signed and unsigned), half float, float, double, decimal128, decimal256, boolean, date32, date64, time32, time64, timestamp and null columns; any other type (binary, nested, dictionary) throws `NotSupportedException`. Pass `writeHeader: false` to skip the header row, or a `sheetName` (XLSX/XLSB/XLS only — CSV has no sheet name) to rename it from the `"Sheet1"` default.
+Supports string, large string, string view, every integer width (signed and unsigned), half float, float, double, decimal128, decimal256, boolean, date32, date64, time32, time64, timestamp and null columns; any other type (binary, nested, dictionary) throws `NotSupportedException`. Pass `new ArrowWriteOptions { WriteHeader = false }` to skip the header row, or set `SheetName` (XLSX/XLSB/XLS only — CSV has no sheet name) to rename it from the `"Sheet1"` default.
 
 ## Open by auto-detecting the format
 
@@ -255,8 +255,8 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
   its first column.
 - A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but `Parse` throws
   `InvalidOperationException` for every map, and `ExcelDataReader` and `InferSchema` throw it when
-  `headerRow` is greater than 0. Read it with `new ExcelDataReader(table.AsSheet(), headerRow: 0)`,
-  `Excel.InferSchema(table.AsSheet(), headerRow: 0)`, or by column index on the rows.
+  `HeaderRow` is greater than 0. Read it with `new ExcelDataReader(table.AsSheet(), new ExcelDataReaderOptions { HeaderRow = 0 })`,
+  `Excel.InferSchema(table.AsSheet(), new SchemaInferenceOptions { HeaderRow = 0 })`, or by column index on the rows.
 - `StyleName` is the table style's name, such as `TableStyleMedium2`, or `null` when the table has none.
 
 ## Reading sheets in parallel
@@ -366,13 +366,13 @@ using System.Data;
 using ExcelReader.Core.Reader;
 
 using IExcelWorkbook workbook = Excel.Open("report.xlsx");
-using IDataReader data = new ExcelDataReader(workbook.FirstSheet); // headerRow: 1 by default
+using IDataReader data = new ExcelDataReader(workbook.FirstSheet); // header on row 1 by default
 
 var table = new DataTable();
 table.Load(data);
 ```
 
-The header row (1-based, default 1) fixes the column shape; pass `headerRow: 0` for a header-less sheet, whose columns come back named `Column0`, `Column1`, ... sized from the first data row. There is no schema-inference pass — `GetFieldType`/`GetValue`/the typed getters read the *current* row's own cell type, so a consumer building its schema from the first row (like `DataTable.Load`) locks in that row's types for the whole load. `NextResult()` always returns `false`; build one `ExcelDataReader` per sheet instead of chaining result sets.
+The header row (1-based, default 1) fixes the column shape; pass `new ExcelDataReaderOptions { HeaderRow = 0 }` for a header-less sheet, whose columns come back named `Column0`, `Column1`, ... sized from the first data row. There is no schema-inference pass — `GetFieldType`/`GetValue`/the typed getters read the *current* row's own cell type, so a consumer building its schema from the first row (like `DataTable.Load`) locks in that row's types for the whole load. `NextResult()` always returns `false`; build one `ExcelDataReader` per sheet instead of chaining result sets.
 
 The bridge costs ~1.3–1.4x over iterating rows directly, and `GetBytes` stays within ~10% of the direct read. See [ADO.NET bridge](../performance/benchmarks.md#adonet-bridge-idatareader) in the benchmarks.
 
diff --git a/src/ExcelReader.Arrow/ArrowConversionExtensions.cs b/src/ExcelReader.Arrow/ArrowConversionExtensions.cs
index a06e89be..25f7cdd3 100644
--- a/src/ExcelReader.Arrow/ArrowConversionExtensions.cs
+++ b/src/ExcelReader.Arrow/ArrowConversionExtensions.cs
@@ -9,26 +9,24 @@ public static class ArrowConversionExtensions
     {
         /// <summary>Converts one sheet into an Arrow <see cref="RecordBatch"/>.</summary>
         /// <param name="sheet">The sheet to convert.</param>
-        /// <param name="schema">The column schema to use; inferred from the sheet with <see cref="Excel.InferSchema(IExcelSheet, int, int, bool)"/> when <see langword="null"/>.</param>
-        /// <param name="headerRow">
-        /// 1-based header row, reused both for schema inference (when <paramref name="schema"/> is
-        /// <see langword="null"/>) and to skip the header line during the data pass. 0 means no header row.
-        /// </param>
+        /// <param name="options">The schema and header row; <see cref="ArrowReadOptions.Default"/> when <see langword="null"/>.</param>
         /// <returns>A record batch with one column per schema entry and one row per data row.</returns>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is <see langword="null"/>.</exception>
         /// <exception cref="InvalidOperationException">
         /// A cell failed to convert to its column's declared type on a non-nullable column.
         /// </exception>
-        /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
-        /// <exception cref="NotSupportedException"><paramref name="schema"/> names an unrecognized <see cref="ExcelColumnType"/>.</exception>
-        public static RecordBatch ToArrowRecordBatch(this IExcelSheet sheet, ExcelColumnSchema[]? schema = null, int headerRow = 1)
+        /// <exception cref="ArgumentException">The sheet has fewer rows than <see cref="ArrowReadOptions.HeaderRow"/>.</exception>
+        /// <exception cref="NotSupportedException"><see cref="ArrowReadOptions.Schema"/> names an unrecognized <see cref="ExcelColumnType"/>.</exception>
+        public static RecordBatch ToArrowRecordBatch(this IExcelSheet sheet, ArrowReadOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(sheet);
-            schema ??= Excel.InferSchema(sheet, headerRow);
+            options ??= ArrowReadOptions.Default;
+            int headerRow = options.HeaderRow;
+            IReadOnlyList<ExcelColumnSchema> schema = options.Schema ?? Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = headerRow });
             bool isDate1904 = sheet.IsDate1904;
             using IExcelRowEnumerator rows = sheet.GetEnumerator();
-            ColumnAppender[] appenders = new ColumnAppender[schema.Length];
-            for (int i = 0; i < schema.Length; i++)
+            ColumnAppender[] appenders = new ColumnAppender[schema.Count];
+            for (int i = 0; i < schema.Count; i++)
             {
                 appenders[i] = ColumnAppender.Create(schema[i]);
             }
diff --git a/src/ExcelReader.Arrow/ArrowReadOptions.cs b/src/ExcelReader.Arrow/ArrowReadOptions.cs
new file mode 100644
index 00000000..60606bc4
--- /dev/null
+++ b/src/ExcelReader.Arrow/ArrowReadOptions.cs
@@ -0,0 +1,24 @@
+using ExcelReader.Core.Reader.Schema;
+
+namespace ExcelReader.Arrow
+{
+    /// <summary>Options for converting a sheet with <see cref="ArrowConversionExtensions.ToArrowRecordBatch"/>.</summary>
+    public sealed class ArrowReadOptions
+    {
+        /// <summary>Gets the default options: header on row 1, schema inferred from the sheet.</summary>
+        public static ArrowReadOptions Default { get; } = new();
+
+        /// <summary>
+        /// Gets the column schema to use. <see langword="null"/>, the default, infers it from the sheet with
+        /// <see cref="Core.Reader.Excel.InferSchema"/> using <see cref="HeaderRow"/>.
+        /// </summary>
+        public IReadOnlyList<ExcelColumnSchema>? Schema { get; init; }
+
+        /// <summary>
+        /// Gets the 1-based header row, used both for schema inference (when <see cref="Schema"/> is
+        /// <see langword="null"/>) and to skip the header line during the data pass. <c>0</c> means no header
+        /// row. Defaults to <c>1</c>.
+        /// </summary>
+        public int HeaderRow { get; init; } = 1;
+    }
+}
diff --git a/src/ExcelReader.Arrow/ArrowWriteExtensions.cs b/src/ExcelReader.Arrow/ArrowWriteExtensions.cs
index 0b74138b..06266f89 100644
--- a/src/ExcelReader.Arrow/ArrowWriteExtensions.cs
+++ b/src/ExcelReader.Arrow/ArrowWriteExtensions.cs
@@ -11,7 +11,7 @@ namespace ExcelReader.Arrow
 {
     /// <summary>
     /// Writes an Apache Arrow <see cref="RecordBatch"/> to a workbook as one sheet — the write-side
-    /// mirror of <see cref="ArrowConversionExtensions.ToArrowRecordBatch(Core.Reader.IExcelSheet, Core.Reader.Schema.ExcelColumnSchema[], int)"/>.
+    /// mirror of <see cref="ArrowConversionExtensions.ToArrowRecordBatch(Core.Reader.IExcelSheet, ArrowReadOptions)"/>.
     /// </summary>
     public static class ArrowWriteExtensions
     {
@@ -20,7 +20,7 @@ public static class ArrowWriteExtensions
 
         /// <summary>
         /// Writes <paramref name="batch"/> to <paramref name="workbook"/> as one XLSX sheet, in a single
-        /// call: adds the sheet, writes the header row (unless <paramref name="writeHeader"/> is false)
+        /// call: adds the sheet, writes the header row (unless <see cref="ArrowWriteOptions.WriteHeader"/> is false)
         /// and every data row, then ends the sheet and the workbook.
         /// </summary>
         /// <param name="workbook">A freshly created, not-yet-started workbook writer.</param>
@@ -29,78 +29,78 @@ public static class ArrowWriteExtensions
         /// width (signed and unsigned), half float, float, double, decimal128, decimal256, boolean,
         /// date32, date64, time32, time64, timestamp and null.
         /// </param>
-        /// <param name="sheetName">The sheet's name.</param>
-        /// <param name="writeHeader">Whether to write a header row of column names first.</param>
+        /// <param name="options">The sheet name and whether to write a header row; <see cref="ArrowWriteOptions.Default"/> when <see langword="null"/>.</param>
         /// <exception cref="ArgumentNullException"><paramref name="workbook"/> or <paramref name="batch"/> is <see langword="null"/>.</exception>
         /// <exception cref="NotSupportedException">A column's Arrow type is not one of the supported types.</exception>
-        public static void WriteRecordBatch(this XlsxWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true)
+        public static void WriteRecordBatch(this XlsxWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null)
         {
-            WriteRecordBatchCore<XlsxSheetWriter, XlsxRowWriter>(workbook, batch, sheetName, writeHeader);
+            WriteRecordBatchCore<XlsxSheetWriter, XlsxRowWriter>(workbook, batch, options);
         }
 
-        /// <summary>Same as <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, string, bool)"/>, for an XLSB workbook.</summary>
+        /// <summary>Same as <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>, for an XLSB workbook.</summary>
         /// <exception cref="ArgumentNullException"><paramref name="workbook"/> or <paramref name="batch"/> is <see langword="null"/>.</exception>
         /// <exception cref="NotSupportedException">A column's Arrow type is not one of the supported types.</exception>
-        public static void WriteRecordBatch(this XlsbWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true)
+        public static void WriteRecordBatch(this XlsbWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null)
         {
-            WriteRecordBatchCore<XlsbSheetWriter, XlsbRowWriter>(workbook, batch, sheetName, writeHeader);
+            WriteRecordBatchCore<XlsbSheetWriter, XlsbRowWriter>(workbook, batch, options);
         }
 
-        /// <summary>Same as <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, string, bool)"/>, for a legacy XLS workbook.</summary>
+        /// <summary>Same as <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>, for a legacy XLS workbook.</summary>
         /// <exception cref="ArgumentNullException"><paramref name="workbook"/> or <paramref name="batch"/> is <see langword="null"/>.</exception>
         /// <exception cref="NotSupportedException">A column's Arrow type is not one of the supported types.</exception>
-        public static void WriteRecordBatch(this XlsWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true)
+        public static void WriteRecordBatch(this XlsWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null)
         {
-            WriteRecordBatchCore<XlsSheetWriter, XlsRowWriter>(workbook, batch, sheetName, writeHeader);
+            WriteRecordBatchCore<XlsSheetWriter, XlsRowWriter>(workbook, batch, options);
         }
 
         /// <summary>
         /// Writes <paramref name="batch"/> to <paramref name="workbook"/> as CSV's single unnamed sheet,
-        /// in a single call.
+        /// in a single call. <see cref="ArrowWriteOptions.SheetName"/> is ignored.
         /// </summary>
         /// <exception cref="ArgumentNullException"><paramref name="workbook"/> or <paramref name="batch"/> is <see langword="null"/>.</exception>
         /// <exception cref="NotSupportedException">A column's Arrow type is not one of the supported types.</exception>
-        public static void WriteRecordBatch(this CsvWorkbookWriter workbook, RecordBatch batch, bool writeHeader = true)
+        public static void WriteRecordBatch(this CsvWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null)
         {
-            WriteRecordBatchCore<CsvSheetWriter, CsvRowWriter>(workbook, batch, sheetName: "Sheet1", writeHeader);
+            WriteRecordBatchCore<CsvSheetWriter, CsvRowWriter>(workbook, batch, options);
         }
 
-        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, string, bool)"/>.</summary>
-        public static ValueTask WriteRecordBatchAsync(this XlsxWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true, CancellationToken ct = default)
+        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsxWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>.</summary>
+        public static ValueTask WriteRecordBatchAsync(this XlsxWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null, CancellationToken ct = default)
         {
-            return WriteRecordBatchCoreAsync<XlsxSheetWriter, XlsxRowWriter>(workbook, batch, sheetName, writeHeader, ct);
+            return WriteRecordBatchCoreAsync<XlsxSheetWriter, XlsxRowWriter>(workbook, batch, options, ct);
         }
 
-        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsbWorkbookWriter, RecordBatch, string, bool)"/>.</summary>
-        public static ValueTask WriteRecordBatchAsync(this XlsbWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true, CancellationToken ct = default)
+        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsbWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>.</summary>
+        public static ValueTask WriteRecordBatchAsync(this XlsbWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null, CancellationToken ct = default)
         {
-            return WriteRecordBatchCoreAsync<XlsbSheetWriter, XlsbRowWriter>(workbook, batch, sheetName, writeHeader, ct);
+            return WriteRecordBatchCoreAsync<XlsbSheetWriter, XlsbRowWriter>(workbook, batch, options, ct);
         }
 
-        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsWorkbookWriter, RecordBatch, string, bool)"/>.</summary>
-        public static ValueTask WriteRecordBatchAsync(this XlsWorkbookWriter workbook, RecordBatch batch, string sheetName = "Sheet1", bool writeHeader = true, CancellationToken ct = default)
+        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(XlsWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>.</summary>
+        public static ValueTask WriteRecordBatchAsync(this XlsWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null, CancellationToken ct = default)
         {
-            return WriteRecordBatchCoreAsync<XlsSheetWriter, XlsRowWriter>(workbook, batch, sheetName, writeHeader, ct);
+            return WriteRecordBatchCoreAsync<XlsSheetWriter, XlsRowWriter>(workbook, batch, options, ct);
         }
 
-        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(CsvWorkbookWriter, RecordBatch, bool)"/>.</summary>
-        public static ValueTask WriteRecordBatchAsync(this CsvWorkbookWriter workbook, RecordBatch batch, bool writeHeader = true, CancellationToken ct = default)
+        /// <summary>Asynchronous counterpart to <see cref="WriteRecordBatch(CsvWorkbookWriter, RecordBatch, ArrowWriteOptions)"/>.</summary>
+        public static ValueTask WriteRecordBatchAsync(this CsvWorkbookWriter workbook, RecordBatch batch, ArrowWriteOptions? options = null, CancellationToken ct = default)
         {
-            return WriteRecordBatchCoreAsync<CsvSheetWriter, CsvRowWriter>(workbook, batch, sheetName: "Sheet1", writeHeader, ct);
+            return WriteRecordBatchCoreAsync<CsvSheetWriter, CsvRowWriter>(workbook, batch, options, ct);
         }
 
-        private static void WriteRecordBatchCore<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, RecordBatch batch, string sheetName, bool writeHeader)
+        private static void WriteRecordBatchCore<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, RecordBatch batch, ArrowWriteOptions? options)
             where TSheet : ISheetWriter<TRow>
             where TRow : IRowWriter
         {
             ArgumentNullException.ThrowIfNull(workbook);
             ArgumentNullException.ThrowIfNull(batch);
+            options ??= ArrowWriteOptions.Default;
             IReadOnlyList<Field> fields = batch.Schema.FieldsList;
 
-            TSheet sheet = workbook.AddSheet(sheetName);
+            TSheet sheet = workbook.AddSheet(options.SheetName);
             ApplyTemporalStyles<TSheet, TRow>(workbook, sheet, fields);
 
-            if (writeHeader)
+            if (options.WriteHeader)
             {
                 using TRow header = sheet.StartRow();
                 foreach (Field field in fields)
@@ -122,18 +122,19 @@ private static void WriteRecordBatchCore<TSheet, TRow>(IWorkbookWriter<TSheet> w
             workbook.End();
         }
 
-        private static async ValueTask WriteRecordBatchCoreAsync<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, RecordBatch batch, string sheetName, bool writeHeader, CancellationToken ct)
+        private static async ValueTask WriteRecordBatchCoreAsync<TSheet, TRow>(IWorkbookWriter<TSheet> workbook, RecordBatch batch, ArrowWriteOptions? options, CancellationToken ct)
             where TSheet : ISheetWriter<TRow>
             where TRow : IRowWriter
         {
             ArgumentNullException.ThrowIfNull(workbook);
             ArgumentNullException.ThrowIfNull(batch);
+            options ??= ArrowWriteOptions.Default;
             IReadOnlyList<Field> fields = batch.Schema.FieldsList;
 
-            TSheet sheet = workbook.AddSheet(sheetName);
+            TSheet sheet = workbook.AddSheet(options.SheetName);
             ApplyTemporalStyles<TSheet, TRow>(workbook, sheet, fields);
 
-            if (writeHeader)
+            if (options.WriteHeader)
             {
                 TRow header = await sheet.StartRowAsync(ct).ConfigureAwait(false);
                 foreach (Field field in fields)
diff --git a/src/ExcelReader.Arrow/ArrowWriteOptions.cs b/src/ExcelReader.Arrow/ArrowWriteOptions.cs
new file mode 100644
index 00000000..e0d97653
--- /dev/null
+++ b/src/ExcelReader.Arrow/ArrowWriteOptions.cs
@@ -0,0 +1,15 @@
+namespace ExcelReader.Arrow
+{
+    /// <summary>Options for writing a record batch with <see cref="ArrowWriteExtensions"/>.</summary>
+    public sealed class ArrowWriteOptions
+    {
+        /// <summary>Gets the default options: a sheet named <c>Sheet1</c> with a header row.</summary>
+        public static ArrowWriteOptions Default { get; } = new();
+
+        /// <summary>Gets the name of the sheet the batch is written to. Defaults to <c>Sheet1</c>.</summary>
+        public string SheetName { get; init; } = "Sheet1";
+
+        /// <summary>Gets whether the first row holds the batch's field names. Defaults to <see langword="true"/>.</summary>
+        public bool WriteHeader { get; init; } = true;
+    }
+}
diff --git a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
index 297b0d9a..a10d55c4 100644
--- a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Shipped.txt
@@ -1,12 +1,3 @@
 #nullable enable
 ExcelReader.Arrow.ArrowConversionExtensions
 ExcelReader.Arrow.ArrowWriteExtensions
-static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]? schema = null, int headerRow = 1) -> Apache.Arrow.RecordBatch!
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Csv.CsvWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, bool writeHeader = true) -> void
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xls.XlsWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true) -> void
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true) -> void
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xlsx.XlsxWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true) -> void
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Csv.CsvWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, bool writeHeader = true, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xls.XlsWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
-static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xlsx.XlsxWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, string! sheetName = "Sheet1", bool writeHeader = true, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
diff --git a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
index 7dc5c581..854fae10 100644
--- a/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Arrow/PublicAPI/PublicAPI.Unshipped.txt
@@ -1 +1,24 @@
 #nullable enable
+ExcelReader.Arrow.ArrowReadOptions
+ExcelReader.Arrow.ArrowReadOptions.ArrowReadOptions() -> void
+ExcelReader.Arrow.ArrowReadOptions.HeaderRow.get -> int
+ExcelReader.Arrow.ArrowReadOptions.HeaderRow.init -> void
+ExcelReader.Arrow.ArrowReadOptions.Schema.get -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.Schema.ExcelColumnSchema>?
+ExcelReader.Arrow.ArrowReadOptions.Schema.init -> void
+ExcelReader.Arrow.ArrowWriteOptions
+ExcelReader.Arrow.ArrowWriteOptions.ArrowWriteOptions() -> void
+ExcelReader.Arrow.ArrowWriteOptions.SheetName.get -> string!
+ExcelReader.Arrow.ArrowWriteOptions.SheetName.init -> void
+ExcelReader.Arrow.ArrowWriteOptions.WriteHeader.get -> bool
+ExcelReader.Arrow.ArrowWriteOptions.WriteHeader.init -> void
+static ExcelReader.Arrow.ArrowConversionExtensions.ToArrowRecordBatch(this ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Arrow.ArrowReadOptions? options = null) -> Apache.Arrow.RecordBatch!
+static ExcelReader.Arrow.ArrowReadOptions.Default.get -> ExcelReader.Arrow.ArrowReadOptions!
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Csv.CsvWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null) -> void
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xls.XlsWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null) -> void
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null) -> void
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatch(this ExcelReader.Core.Writer.Xlsx.XlsxWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null) -> void
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Csv.CsvWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xls.XlsWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+static ExcelReader.Arrow.ArrowWriteExtensions.WriteRecordBatchAsync(this ExcelReader.Core.Writer.Xlsx.XlsxWorkbookWriter! workbook, Apache.Arrow.RecordBatch! batch, ExcelReader.Arrow.ArrowWriteOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
+static ExcelReader.Arrow.ArrowWriteOptions.Default.get -> ExcelReader.Arrow.ArrowWriteOptions!
diff --git a/src/ExcelReader.Cli/CliCommands.cs b/src/ExcelReader.Cli/CliCommands.cs
index 0105637e..85c2c391 100644
--- a/src/ExcelReader.Cli/CliCommands.cs
+++ b/src/ExcelReader.Cli/CliCommands.cs
@@ -195,7 +195,7 @@ internal static int Schema(string path, string? sheet, int headerRow, int sample
             {
                 using IExcelWorkbook workbook = Open(path, sheet, out IExcelSheet selected, password, inputDelimiter);
 
-                foreach (ExcelColumnSchema column in Excel.InferSchema(selected, headerRow, sampleSize))
+                foreach (ExcelColumnSchema column in Excel.InferSchema(selected, new SchemaInferenceOptions { HeaderRow = headerRow, SampleSize = sampleSize }))
                 {
                     stdout.Write(column.Index.ToString(CultureInfo.InvariantCulture));
                     stdout.Write('\t');
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 5240f03a..649515e1 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -192,7 +192,6 @@ ExcelReader.Core.Reader.ExcelDataReader
 ExcelReader.Core.Reader.ExcelDataReader.Close() -> void
 ExcelReader.Core.Reader.ExcelDataReader.Depth.get -> int
 ExcelReader.Core.Reader.ExcelDataReader.Dispose() -> void
-ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1) -> void
 ExcelReader.Core.Reader.ExcelDataReader.FieldCount.get -> int
 ExcelReader.Core.Reader.ExcelDataReader.GetBoolean(int i) -> bool
 ExcelReader.Core.Reader.ExcelDataReader.GetByte(int i) -> byte
@@ -726,8 +725,6 @@ static ExcelReader.Core.Reader.Excel.FromXlsx(System.ReadOnlyMemory<byte> data,
 static ExcelReader.Core.Reader.Excel.FromXlsxAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
 static ExcelReader.Core.Reader.Excel.FromXlsxFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!
 static ExcelReader.Core.Reader.Excel.FromXlsxFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xlsx.XlsxWorkbook!>
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow = 1, int sampleSize = 100, bool parseText = false) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, int headerRow, int sampleSize) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
 static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, ExcelReader.Core.Reader.ExcelFileFormat format, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
 static ExcelReader.Core.Reader.Excel.Open(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
 static ExcelReader.Core.Reader.Excel.Open(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelFileFormat format, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.IExcelWorkbook!
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 6b7a4d18..f262ae01 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -70,3 +70,19 @@ static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TModel>(ExcelReader.Co
 static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TRecord>(ExcelReader.Core.Reader.IExcelSheet! sheet, System.Action<TRecord>! body, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
 static ExcelReader.Core.Reader.SheetParallel.ParseAsync<T>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
 static ExcelReader.Core.Reader.SheetParallelOptions.Default.get -> ExcelReader.Core.Reader.SheetParallelOptions!
+ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.ExcelDataReaderOptions? options = null) -> void
+ExcelReader.Core.Reader.ExcelDataReaderOptions
+ExcelReader.Core.Reader.ExcelDataReaderOptions.ExcelDataReaderOptions() -> void
+ExcelReader.Core.Reader.ExcelDataReaderOptions.HeaderRow.get -> int
+ExcelReader.Core.Reader.ExcelDataReaderOptions.HeaderRow.init -> void
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.HeaderRow.get -> int
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.HeaderRow.init -> void
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.ParseText.get -> bool
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.ParseText.init -> void
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.get -> int
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.init -> void
+ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SchemaInferenceOptions() -> void
+static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.SchemaInferenceOptions? options = null) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
+static ExcelReader.Core.Reader.ExcelDataReaderOptions.Default.get -> ExcelReader.Core.Reader.ExcelDataReaderOptions!
+static ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.Default.get -> ExcelReader.Core.Reader.Schema.SchemaInferenceOptions!
diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index a81620e1..64d843c8 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -267,58 +267,31 @@ public static async ValueTask<CsvReader> FromCsvAsync(Stream stream, bool leaveO
 
         /// <summary>Guesses a column schema for <paramref name="sheet"/> by sampling it from the first row.</summary>
         /// <param name="sheet">The sheet to sample. A new enumerator is opened and disposed; no other read of the sheet is disturbed.</param>
-        /// <param name="headerRow">1-based row number to take column names from; 0 means "no header",
-        /// so every returned schema is addressable only by <see cref="ExcelColumnSchema.Index"/>.</param>
-        /// <param name="sampleSize">How many rows after the header to inspect.</param>
+        /// <param name="options">Header row, sample size and text parsing; <see cref="SchemaInferenceOptions.Default"/> when <see langword="null"/>.</param>
         /// <returns>One <see cref="ExcelColumnSchema"/> per column, in column order.</returns>
         /// <remarks>
         /// This is a guess over a bounded sample, not a guarantee about the whole sheet — a column
-        /// whose first <paramref name="sampleSize"/> rows are all integers is reported as
+        /// whose first <see cref="SchemaInferenceOptions.SampleSize"/> rows are all integers is reported as
         /// <see cref="ExcelColumnType.Int64Column"/> even if row 10,000 holds text. Verify it fits
         /// before trusting it, and feed the result into <see cref="ExcelParser.Build{T}"/> to
         /// build a real map.
         /// </remarks>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative, or
-        /// <paramref name="sampleSize"/> is not positive.</exception>
-        /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
-        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
-        public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow, int sampleSize)
-        {
-            return InferSchema(sheet, headerRow, sampleSize, parseText: false);
-        }
-
-        /// <summary>
-        /// Guesses a column schema by sampling the sheet's rows, as
-        /// <see cref="InferSchema(IExcelSheet, int, int)"/> does, and can also type cells that hold text.
-        /// </summary>
-        /// <param name="sheet">The sheet to sample. A new enumerator is opened and disposed; no other read of the sheet is disturbed.</param>
-        /// <param name="headerRow">1-based row number to take column names from; 0 means "no header",
-        /// so every returned schema is addressable only by <see cref="ExcelColumnSchema.Index"/>.</param>
-        /// <param name="sampleSize">How many rows after the header to inspect.</param>
-        /// <param name="parseText">When <see langword="true"/>, a text cell (every CSV field, or a number
-        /// stored as text) counts as an integer, a decimal, <c>true</c>/<c>false</c>, or an ISO-8601 date or
-        /// date-time when its text has exactly that shape. Numbers with a leading zero (<c>00123</c>), scientific
-        /// notation (<c>12E4</c>), padded or culture-formatted numbers, and non-ISO dates stay text. A column only gets a non-text type when
-        /// every sampled value converts to it.</param>
-        /// <returns>One <see cref="ExcelColumnSchema"/> per column, in column order.</returns>
-        /// <remarks>Still a guess over a bounded sample: a value past the sample can still fail to convert.
-        /// See <see cref="InferSchema(IExcelSheet, int, int)"/>.</remarks>
-        /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is <see langword="null"/>.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative, or
-        /// <paramref name="sampleSize"/> is not positive.</exception>
-        /// <exception cref="ArgumentException">The sheet has fewer rows than <paramref name="headerRow"/>.</exception>
-        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
-        public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, int headerRow = 1, int sampleSize = 100, bool parseText = false)
+        /// <exception cref="ArgumentOutOfRangeException"><see cref="SchemaInferenceOptions.HeaderRow"/> is negative, or
+        /// <see cref="SchemaInferenceOptions.SampleSize"/> is not positive.</exception>
+        /// <exception cref="ArgumentException">The sheet has fewer rows than <see cref="SchemaInferenceOptions.HeaderRow"/>.</exception>
+        /// <exception cref="InvalidOperationException"><see cref="SchemaInferenceOptions.HeaderRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
+        public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, SchemaInferenceOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(sheet);
-            if (headerRow > 0)
+            options ??= SchemaInferenceOptions.Default;
+            if (options.HeaderRow > 0)
             {
                 ExcelTableSheet.ThrowIfHeaderless(sheet);
             }
 
             using IExcelRowEnumerator rows = sheet.GetEnumerator();
-            return SchemaInference.Infer(rows, sheet.IsDate1904, headerRow, sampleSize, parseText, ExcelTableSheet.FirstColumnOf(sheet));
+            return SchemaInference.Infer(rows, sheet.IsDate1904, options.HeaderRow, options.SampleSize, options.ParseText, ExcelTableSheet.FirstColumnOf(sheet));
         }
 
         private static ReadOnlySpan<byte> ZipSignature => [0x50, 0x4B, 0x03, 0x04];
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReader.cs b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
index b83d21b4..62b286f1 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReader.cs
+++ b/src/ExcelReader.Core/Reader/ExcelDataReader.cs
@@ -15,7 +15,7 @@ namespace ExcelReader.Core.Reader
     /// </summary>
     /// <remarks>
     /// The column shape is fixed once, at construction time, from the header row (or from the first data
-    /// row when <c>headerRow</c> is 0) — it never grows as later, wider rows come in. There is no schema
+    /// row when <see cref="ExcelDataReaderOptions.HeaderRow"/> is 0) — it never grows as later, wider rows come in. There is no schema
     /// pass, so <see cref="GetFieldType"/>, <see cref="GetValue"/>, and the typed getters all read the
     /// <em>current</em> row's own cell type; a consumer that builds a schema from the first
     /// <see cref="Read"/> (e.g. <c>DataTable.Load</c>) locks in that row's types for the whole load.
@@ -45,17 +45,15 @@ public sealed class ExcelDataReader : IDataReader
         /// Wraps <paramref name="sheet"/>.
         /// </summary>
         /// <param name="sheet">The sheet to read. Its workbook stays owned by the caller.</param>
-        /// <param name="headerRow">
-        /// The 1-based row holding column names. Pass 0 for a header-less sheet, whose columns come back
-        /// named <c>"Column0"</c>, <c>"Column1"</c>, ... and whose count is taken from the first data row.
-        /// </param>
+        /// <param name="options">The header row; <see cref="ExcelDataReaderOptions.Default"/> when <see langword="null"/>.</param>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is null.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><paramref name="headerRow"/> is negative.</exception>
-        /// <exception cref="InvalidOperationException"><paramref name="headerRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
-        public ExcelDataReader(IExcelSheet sheet, int headerRow = 1)
+        /// <exception cref="ArgumentOutOfRangeException"><see cref="ExcelDataReaderOptions.HeaderRow"/> is negative.</exception>
+        /// <exception cref="InvalidOperationException"><see cref="ExcelDataReaderOptions.HeaderRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
+        public ExcelDataReader(IExcelSheet sheet, ExcelDataReaderOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(sheet);
-            ArgumentOutOfRangeException.ThrowIfNegative(headerRow);
+            int headerRow = (options ?? ExcelDataReaderOptions.Default).HeaderRow;
+            ArgumentOutOfRangeException.ThrowIfNegative(headerRow, nameof(options));
             if (headerRow > 0)
             {
                 ExcelTableSheet.ThrowIfHeaderless(sheet);
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs b/src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs
new file mode 100644
index 00000000..95f87a1b
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs
@@ -0,0 +1,16 @@
+namespace ExcelReader.Core.Reader
+{
+    /// <summary>Options for adapting a sheet to <see cref="System.Data.IDataReader"/> with <see cref="ExcelDataReader"/>.</summary>
+    public sealed class ExcelDataReaderOptions
+    {
+        /// <summary>Gets the default options: column names on row 1.</summary>
+        public static ExcelDataReaderOptions Default { get; } = new();
+
+        /// <summary>
+        /// Gets the 1-based row holding column names. <c>0</c> means a header-less sheet, whose columns come
+        /// back named <c>"Column0"</c>, <c>"Column1"</c>, ... and whose count is taken from the first data row.
+        /// Defaults to <c>1</c>.
+        /// </summary>
+        public int HeaderRow { get; init; } = 1;
+    }
+}
diff --git a/src/ExcelReader.Core/Reader/Schema/ExcelColumnSchema.cs b/src/ExcelReader.Core/Reader/Schema/ExcelColumnSchema.cs
index 34694243..35e934cd 100644
--- a/src/ExcelReader.Core/Reader/Schema/ExcelColumnSchema.cs
+++ b/src/ExcelReader.Core/Reader/Schema/ExcelColumnSchema.cs
@@ -2,7 +2,7 @@ namespace ExcelReader.Core.Reader.Schema
 {
     /// <summary>
     /// One column's guessed shape, as returned by
-    /// <see cref="Excel.InferSchema(IExcelSheet, int, int)"/>.
+    /// <see cref="Excel.InferSchema(IExcelSheet, SchemaInferenceOptions)"/>.
     /// </summary>
     /// <remarks>
     /// This is a guess over a bounded sample, not a guarantee about the whole sheet — verify it fits
diff --git a/src/ExcelReader.Core/Reader/Schema/ExcelColumnType.cs b/src/ExcelReader.Core/Reader/Schema/ExcelColumnType.cs
index e1af2304..d22685a9 100644
--- a/src/ExcelReader.Core/Reader/Schema/ExcelColumnType.cs
+++ b/src/ExcelReader.Core/Reader/Schema/ExcelColumnType.cs
@@ -2,7 +2,7 @@ namespace ExcelReader.Core.Reader.Schema
 {
     /// <summary>
     /// A column's inferred or declared value type, as produced by
-    /// <see cref="Reader.Excel.InferSchema(Reader.IExcelSheet, int, int)"/>.
+    /// <see cref="Reader.Excel.InferSchema(Reader.IExcelSheet, SchemaInferenceOptions)"/>.
     /// </summary>
     /// <remarks>
     /// The underlying values are fixed: they are the XL_T_* constants of the native C ABI
diff --git a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
index ce927267..b5978362 100644
--- a/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
+++ b/src/ExcelReader.Core/Reader/Schema/SchemaInference.cs
@@ -9,7 +9,7 @@ namespace ExcelReader.Core.Reader.Schema
 {
     /// <summary>
     /// Guesses a column schema by sampling a sheet's rows. Backs
-    /// <see cref="Excel.InferSchema(IExcelSheet, int, int)"/> and the native <c>xl_infer_schema</c>
+    /// <see cref="Excel.InferSchema(IExcelSheet, SchemaInferenceOptions)"/> and the native <c>xl_infer_schema</c>
     /// export, so both answer identically by construction.
     /// </summary>
     internal static class SchemaInference
diff --git a/src/ExcelReader.Core/Reader/Schema/SchemaInferenceOptions.cs b/src/ExcelReader.Core/Reader/Schema/SchemaInferenceOptions.cs
new file mode 100644
index 00000000..4da1a698
--- /dev/null
+++ b/src/ExcelReader.Core/Reader/Schema/SchemaInferenceOptions.cs
@@ -0,0 +1,27 @@
+namespace ExcelReader.Core.Reader.Schema
+{
+    /// <summary>Options for guessing a column schema with <see cref="Excel.InferSchema"/>.</summary>
+    public sealed class SchemaInferenceOptions
+    {
+        /// <summary>Gets the default options: header on row 1, 100 sampled rows, text left as text.</summary>
+        public static SchemaInferenceOptions Default { get; } = new();
+
+        /// <summary>
+        /// Gets the 1-based row number to take column names from. <c>0</c> means "no header", so every
+        /// returned schema is addressable only by <see cref="ExcelColumnSchema.Index"/>. Defaults to <c>1</c>.
+        /// </summary>
+        public int HeaderRow { get; init; } = 1;
+
+        /// <summary>Gets how many rows after the header to inspect. Defaults to <c>100</c>.</summary>
+        public int SampleSize { get; init; } = 100;
+
+        /// <summary>
+        /// Gets whether a text cell (every CSV field, or a number stored as text) counts as an integer, a
+        /// decimal, <c>true</c>/<c>false</c>, or an ISO-8601 date or date-time when its text has exactly that
+        /// shape. Numbers with a leading zero (<c>00123</c>), scientific notation (<c>12E4</c>), padded or
+        /// culture-formatted numbers, and non-ISO dates stay text. A column only gets a non-text type when
+        /// every sampled value converts to it. Defaults to <see langword="false"/>.
+        /// </summary>
+        public bool ParseText { get; init; }
+    }
+}
diff --git a/tests/ExcelReader.Benchmarks/Interop/ArrowConversionBenchmark.cs b/tests/ExcelReader.Benchmarks/Interop/ArrowConversionBenchmark.cs
index 7edec50b..f1815589 100644
--- a/tests/ExcelReader.Benchmarks/Interop/ArrowConversionBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Interop/ArrowConversionBenchmark.cs
@@ -48,7 +48,7 @@ public async Task SetupAsync()
         public long CsvAllString()
         {
             using var reader = Excel.FromCsv(_csvAllString);
-            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(AllStringSchema, headerRow: 0);
+            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = AllStringSchema, HeaderRow = 0 });
             return batch.Length;
         }
 
@@ -56,7 +56,7 @@ public long CsvAllString()
         public long CsvTyped()
         {
             using var reader = Excel.FromCsv(_csvTyped);
-            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(TypedSchema);
+            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = TypedSchema });
             return batch.Length;
         }
 
@@ -65,7 +65,7 @@ public long XlsbTyped()
         {
             using var ms = new MemoryStream(_xlsbTyped, writable: false);
             using var reader = Excel.FromXlsb(ms);
-            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(TypedSchema);
+            using RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = TypedSchema });
             return batch.Length;
         }
 
diff --git a/tests/ExcelReader.Benchmarks/Parse/ParseBenchmark.cs b/tests/ExcelReader.Benchmarks/Parse/ParseBenchmark.cs
index c7d1b1c2..cac206ca 100644
--- a/tests/ExcelReader.Benchmarks/Parse/ParseBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Parse/ParseBenchmark.cs
@@ -155,7 +155,7 @@ public long OfficeIMO()
         public long Sylvan()
         {
             using var ms = new MemoryStream(_workbook, writable: false);
-            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions());
+            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             long acc = 0;
             foreach (Record rec in reader.GetRecords<Record>())
             {
@@ -168,7 +168,7 @@ public long Sylvan()
         public async Task<long> SylvanAsync()
         {
             await using var ms = new MemoryStream(_workbook, writable: false);
-            await using var reader = await global::Sylvan.Data.Excel.ExcelDataReader.CreateAsync(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions()).ConfigureAwait(false);
+            await using var reader = await global::Sylvan.Data.Excel.ExcelDataReader.CreateAsync(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions()).ConfigureAwait(false);
             long acc = 0;
             await foreach (Record rec in reader.GetRecordsAsync<Record>())
             {
diff --git a/tests/ExcelReader.Benchmarks/Read/ReadBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/ReadBenchmark.cs
index 82aff6fa..f17e01f1 100644
--- a/tests/ExcelReader.Benchmarks/Read/ReadBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Read/ReadBenchmark.cs
@@ -78,7 +78,7 @@ public long ExcelReaderMaterialized()
         public long Sylvan()
         {
             using var ms = new MemoryStream(_workbook, writable: false);
-            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions());
+            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
diff --git a/tests/ExcelReader.Benchmarks/Read/StringHeavyReadBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/StringHeavyReadBenchmark.cs
index 56a402ce..2cfb67e1 100644
--- a/tests/ExcelReader.Benchmarks/Read/StringHeavyReadBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Read/StringHeavyReadBenchmark.cs
@@ -66,7 +66,7 @@ public long Xlsx_ExcelReader_Prefetch()
         public long Xlsx_Sylvan()
         {
             using MemoryStream ms = Open(_xlsx, nameof(Xlsx_Sylvan));
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
@@ -115,7 +115,7 @@ public long Xlsb_ExcelReader_Prefetch()
         public long Xlsb_Sylvan()
         {
             using MemoryStream ms = Open(_xlsb, nameof(Xlsb_Sylvan));
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelBinary, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelBinary, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
diff --git a/tests/ExcelReader.Benchmarks/Read/XlsReadBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/XlsReadBenchmark.cs
index 0dd985a3..f45f7902 100644
--- a/tests/ExcelReader.Benchmarks/Read/XlsReadBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Read/XlsReadBenchmark.cs
@@ -47,7 +47,7 @@ public async Task<long> ExcelReaderAsync()
         public long Sylvan()
         {
             using var ms = new MemoryStream(_workbook, writable: false);
-            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.Excel, new ExcelDataReaderOptions());
+            using var reader = global::Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.Excel, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
diff --git a/tests/ExcelReader.Benchmarks/RealData/RealDataReadBenchmark.cs b/tests/ExcelReader.Benchmarks/RealData/RealDataReadBenchmark.cs
index d8a2e82d..2dfedb26 100644
--- a/tests/ExcelReader.Benchmarks/RealData/RealDataReadBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/RealData/RealDataReadBenchmark.cs
@@ -50,7 +50,7 @@ public long Xlsx_ExcelReader()
         public long Xlsx_Sylvan()
         {
             using MemoryStream ms = new(_xlsx, writable: false);
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
@@ -107,7 +107,7 @@ public long Xlsm_ExcelReader()
         public long Xlsm_Sylvan()
         {
             using MemoryStream ms = new(_xlsm, writable: false);
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelXml, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
@@ -164,7 +164,7 @@ public long Xlsb_ExcelReader()
         public long Xlsb_Sylvan()
         {
             using MemoryStream ms = new(_xlsb, writable: false);
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelBinary, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.ExcelBinary, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
@@ -221,7 +221,7 @@ public long Xls_ExcelReader()
         public long Xls_Sylvan()
         {
             using MemoryStream ms = new(_xls, writable: false);
-            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.Excel, new ExcelDataReaderOptions());
+            using Sylvan.Data.Excel.ExcelDataReader reader = Sylvan.Data.Excel.ExcelDataReader.Create(ms, ExcelWorkbookType.Excel, new global::Sylvan.Data.Excel.ExcelDataReaderOptions());
             return AccumulateSylvanExcel(reader);
         }
 
diff --git a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
index 73737873..07ef7aa8 100644
--- a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
+++ b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
@@ -39,7 +39,7 @@ public void ToArrowRecordBatch_Should_Convert_String_And_Int64_Columns()
                 new() { Index = 1, Name = "qty", Type = ExcelColumnType.Int64Column },
             ];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             Assert.Equal(2, batch.Length);
             Assert.Equal(2, batch.ColumnCount);
@@ -58,7 +58,7 @@ public void ToArrowRecordBatch_Should_Append_Null_For_Blank_Cells_On_Nullable_Co
             using CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes("qty\n5\n\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "qty", Type = ExcelColumnType.Int64Column, IsNullable = true }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var qty = Assert.IsType<Int64Array>(batch.Column(0));
             Assert.False(qty.IsNull(0));
@@ -76,7 +76,7 @@ public void ToArrowRecordBatch_Should_Append_Null_For_Blank_Cells_On_Nullable_St
                 new() { Index = 1, Name = "qty", Type = ExcelColumnType.Int64Column },
             ];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var name = Assert.IsType<StringArray>(batch.Column(0));
             Assert.Equal("widget", name.GetString(0));
@@ -94,7 +94,7 @@ public void ToArrowRecordBatch_Should_Keep_Blank_Cells_As_Empty_Strings_On_NonNu
                 new() { Index = 1, Name = "qty", Type = ExcelColumnType.Int64Column },
             ];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var name = Assert.IsType<StringArray>(batch.Column(0));
             Assert.False(name.IsNull(0));
@@ -107,7 +107,7 @@ public void ToArrowRecordBatch_Should_Throw_When_A_NonNullable_Value_Fails_To_Co
             using CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes("qty\nnotanumber\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "qty", Type = ExcelColumnType.Int64Column }];
 
-            InvalidOperationException exception = Assert.Throws<InvalidOperationException>(() => reader.FirstSheet.ToArrowRecordBatch(schema));
+            InvalidOperationException exception = Assert.Throws<InvalidOperationException>(() => reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema }));
             Assert.Contains("qty", exception.Message, StringComparison.Ordinal);
         }
 
@@ -117,7 +117,7 @@ public void ToArrowRecordBatch_Should_Convert_Float64_Column()
             using CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes("price\n1.5\n2.25\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "price", Type = ExcelColumnType.Float64Column }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var price = Assert.IsType<DoubleArray>(batch.Column(0));
             Assert.Equal(1.5, price.GetValue(0));
@@ -130,7 +130,7 @@ public void ToArrowRecordBatch_Should_Convert_Bool_Column()
             using CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes("flag\ntrue\nfalse\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "flag", Type = ExcelColumnType.BoolColumn }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var flag = Assert.IsType<BooleanArray>(batch.Column(0));
             Assert.True(flag.GetValue(0));
@@ -143,7 +143,7 @@ public void ToArrowRecordBatch_Should_Convert_Date_Column()
             using var reader = Excel.FromCsv(Encoding.UTF8.GetBytes("day\n2024-01-15\n2024-03-01\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "day", Type = ExcelColumnType.DateColumn }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var day = Assert.IsType<Date32Array>(batch.Column(0));
             int expectedFirst = (new DateTime(2024, 1, 15) - DateTime.UnixEpoch).Days;
@@ -158,7 +158,7 @@ public void ToArrowRecordBatch_Should_Convert_Time_Column()
             using var reader = Excel.FromCsv(Encoding.UTF8.GetBytes("clock\n13:30:00\n\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "clock", Type = ExcelColumnType.TimeColumn, IsNullable = true }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var clock = Assert.IsType<Time64Array>(batch.Column(0));
             Assert.Equal(new TimeSpan(13, 30, 0).Ticks / 10, clock.GetValue(0));
@@ -171,7 +171,7 @@ public void ToArrowRecordBatch_Should_Convert_Timestamp_Column()
             using var reader = Excel.FromCsv(Encoding.UTF8.GetBytes("stamp\n2024-01-15 13:30:00\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "stamp", Type = ExcelColumnType.TimestampColumn }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var stamp = Assert.IsType<TimestampArray>(batch.Column(0));
             long expected = (new DateTime(2024, 1, 15, 13, 30, 0) - DateTime.UnixEpoch).Ticks / 10;
@@ -184,7 +184,7 @@ public void ToArrowRecordBatch_Should_Convert_Timestamp_Column_With_Explicit_Utc
             using var reader = Excel.FromCsv(Encoding.UTF8.GetBytes("stamp\n2024-01-15T13:30:00Z\n"));
             ExcelColumnSchema[] schema = [new() { Index = 0, Name = "stamp", Type = ExcelColumnType.TimestampColumn }];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             var stamp = Assert.IsType<TimestampArray>(batch.Column(0));
             long expected = (new DateTime(2024, 1, 15, 13, 30, 0, DateTimeKind.Utc) - DateTime.UnixEpoch).Ticks / 10;
@@ -214,7 +214,7 @@ public void ToArrowRecordBatch_Should_Treat_HeaderRow_Zero_As_No_Header()
                 new() { Index = 1, Type = ExcelColumnType.Int64Column },
             ];
 
-            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(schema, headerRow: 0);
+            RecordBatch batch = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = 0 });
 
             Assert.Equal(2, batch.Length);
             var name = Assert.IsType<StringArray>(batch.Column(0));
@@ -228,7 +228,7 @@ public void ToArrowRecordBatch_Should_Match_The_Native_Arrow_Path_On_RealExcel()
 
             using IExcelWorkbook managedReader = Excel.Open(path);
             ExcelColumnSchema[] schema = Excel.InferSchema(managedReader.FirstSheet);
-            RecordBatch managedBatch = managedReader.FirstSheet.ToArrowRecordBatch(schema, headerRow: 1);
+            RecordBatch managedBatch = managedReader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = 1 });
 
             Assert.Equal(NativeStatus.Ok, NativeApiTests.OpenPath(path, NativeFormat.Xlsb, out NativeHandle? handle));
             try
diff --git a/tests/ExcelReader.Tests/Arrow/ArrowWriteExtensionsTests.cs b/tests/ExcelReader.Tests/Arrow/ArrowWriteExtensionsTests.cs
index db2fbae7..e9540354 100644
--- a/tests/ExcelReader.Tests/Arrow/ArrowWriteExtensionsTests.cs
+++ b/tests/ExcelReader.Tests/Arrow/ArrowWriteExtensionsTests.cs
@@ -117,7 +117,7 @@ public void WriteRecordBatch_Xlsx_RoundTrips_Every_Supported_Type()
             ms.Position = 0;
 
             using XlsxWorkbook reader = Excel.FromXlsx(ms.ToArray());
-            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(ReadBackSchema());
+            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = ReadBackSchema() });
 
             AssertRoundTrips(roundTripped);
         }
@@ -133,7 +133,7 @@ public void WriteRecordBatch_Xlsb_RoundTrips_Every_Supported_Type()
             ms.Position = 0;
 
             using var reader = Excel.FromXlsb(ms.ToArray());
-            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(ReadBackSchema());
+            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = ReadBackSchema() });
 
             AssertRoundTrips(roundTripped);
         }
@@ -202,7 +202,7 @@ public void WriteRecordBatch_WithHeaderFalse_OmitsTheHeaderRow()
             using var ms = new MemoryStream();
             using (XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(ms, leaveOpen: true))
             {
-                workbook.WriteRecordBatch(batch, writeHeader: false);
+                workbook.WriteRecordBatch(batch, new ArrowWriteOptions { WriteHeader = false });
             }
             ms.Position = 0;
 
@@ -300,7 +300,7 @@ private static void AssertWideRoundTrips(IExcelSheet sheet)
             {
                 schema[i] = new() { Index = i, Name = "c" + i, Type = types[i], IsNullable = true };
             }
-            RecordBatch batch = sheet.ToArrowRecordBatch(schema);
+            RecordBatch batch = sheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema });
 
             Assert.Equal(2, batch.Length);
             long[] integers = [-8, -16, -32, 8, 16, 32, 64];
@@ -375,7 +375,7 @@ public async Task WriteRecordBatchAsync_Xlsx_RoundTrips()
             ms.Position = 0;
 
             using XlsxWorkbook reader = Excel.FromXlsx(ms.ToArray());
-            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(ReadBackSchema());
+            RecordBatch roundTripped = reader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = ReadBackSchema() });
 
             AssertRoundTrips(roundTripped);
         }
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
index 2d8332f9..4d7e5367 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
@@ -44,7 +44,7 @@ public void A_Schema_Inferred_From_A_NonSeekable_Stream_Leaves_Every_Row_To_Read
             using NonSeekableStream stream = new(BuildCsv(rows));
             using CsvReader reader = Excel.FromCsv(stream);
 
-            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, headerRow: 1, sampleSize: 100, parseText: true);
+            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
 
             Assert.Equal(["name", "value"], schema.Select(c => c.Name), StringComparer.Ordinal);
             Assert.Equal(ExcelColumnType.Int64Column, schema[1].Type);
diff --git a/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs b/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs
index bc4c7f62..94d059ad 100644
--- a/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs
@@ -69,7 +69,7 @@ public async Task NoHeaderSynthesizesColumnNamesFromFirstRowWidth()
         {
             await using var ms = await TypedWorkbook.BuildAsync([1, 2, 3]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet, headerRow: 0);
+            using var data = new ExcelDataReader(reader.FirstSheet, new ExcelDataReaderOptions { HeaderRow = 0 });
 
             Assert.Equal(3, data.FieldCount);
             Assert.Equal("Column0", data.GetName(0));
@@ -83,7 +83,7 @@ public async Task HeaderRowBeyondSheetSizeIsAnEmptyResultSet()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet, headerRow: 5);
+            using var data = new ExcelDataReader(reader.FirstSheet, new ExcelDataReaderOptions { HeaderRow = 5 });
 
             Assert.Equal(0, data.FieldCount);
             Assert.False(data.Read());
diff --git a/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs b/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
index 984a013c..3ba9cda7 100644
--- a/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
@@ -67,7 +67,7 @@ public void InferSchema_Should_Type_The_Fixture_Csv_When_Parsing_Text()
         {
             using CsvReader reader = Excel.FromCsvFile(FixtureCsv());
 
-            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, parseText: true);
+            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
 
             ExcelColumnType s = ExcelColumnType.StringColumn, d = ExcelColumnType.DateColumn,
                 i = ExcelColumnType.Int64Column, f = ExcelColumnType.Float64Column;
diff --git a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
index 88b396ec..caee015e 100644
--- a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
@@ -162,7 +162,7 @@ public void InferSchema_Samples_The_Sheet_It_Is_Given()
             Assert.Equal(2, schema.Length);
             Assert.Equal("Name", schema[0].Name);
             Assert.Equal(ExcelColumnType.Int64Column, schema[1].Type);
-            Assert.Equal(schema.Length, Excel.InferSchema(workbook.Sheets[1], 1, 5).Length);
+            Assert.Equal(schema.Length, Excel.InferSchema(workbook.Sheets[1], new SchemaInferenceOptions { SampleSize = 5 }).Length);
             Assert.Throws<ArgumentNullException>(() => Excel.InferSchema((IExcelSheet)null!));
         }
 
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
index 725d0d49..633b4ba8 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
@@ -82,7 +82,7 @@ public void HeaderlessTableReadsWithoutAHeader(string file)
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
             IExcelSheet view = Table(workbook, "NoHeader").AsSheet();
 
-            using ExcelDataReader reader = new(view, headerRow: 0);
+            using ExcelDataReader reader = new(view, new ExcelDataReaderOptions { HeaderRow = 0 });
             List<string> letters = [];
             while (reader.Read())
             {
@@ -90,7 +90,7 @@ public void HeaderlessTableReadsWithoutAHeader(string file)
             }
 
             Assert.Equal(["a", "b", "c"], letters);
-            Assert.Equal(2, Excel.InferSchema(view, headerRow: 0).Length);
+            Assert.Equal(2, Excel.InferSchema(view, new SchemaInferenceOptions { HeaderRow = 0 }).Length);
         }
 
         [Theory]
@@ -115,9 +115,9 @@ public void DataReaderOrdinalsLineUpWithOrWithoutAHeaderRow(string file)
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
             IExcelSheet view = Table(workbook, "NoStyle").AsSheet();
 
-            using ExcelDataReader named = new(view, headerRow: 1);
+            using ExcelDataReader named = new(view, new ExcelDataReaderOptions { HeaderRow = 1 });
             Assert.True(named.Read());
-            using ExcelDataReader unnamed = new(view, headerRow: 0);
+            using ExcelDataReader unnamed = new(view, new ExcelDataReaderOptions { HeaderRow = 0 });
             Assert.True(unnamed.Read());
 
             Assert.Equal((2, "Name", "Value", "x"), (named.FieldCount, named.GetName(0), named.GetName(1), named.GetString(0)));

From 30af28e733a3b5507979d46f6cb81b1949b7837d Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:33:06 -0300
Subject: [PATCH 087/115] refactor!: give the XLS writer an options record and
 the XLSX writer a 1904 date system

XlsWorkbookWriter.Create takes XlsWriterOptions instead of a bare date1904 flag, matching
the XLSX and XLSB writers. XlsxWriterOptions gains Date1904, which writes workbookPr
date1904 and serializes dates against the 1904 epoch; the CLI and the native writer now
pass it through for XLSX as they already did for XLSB and XLS.
---
 src/ExcelReader.Cli/CliCommands.cs            |  4 +--
 .../PublicAPI/PublicAPI.Shipped.txt           |  1 -
 .../PublicAPI/PublicAPI.Unshipped.txt         | 15 ++++++++++
 .../Writer/Internal/CellFormatter.cs          |  4 +--
 .../Writer/Xls/XlsWorkbookWriter.cs           |  6 ++--
 .../Writer/Xls/XlsWriterOptions.cs            | 12 ++++++++
 .../Writer/Xlsx/XlsxRowWriter.cs              |  4 +--
 .../Writer/Xlsx/XlsxSheetWriter.cs            |  2 ++
 .../Writer/Xlsx/XlsxWorkbookWriter.cs         |  7 +++++
 .../Writer/Xlsx/XlsxWriterOptions.cs          |  5 +++-
 .../Writer/NativeWriterHandle.cs              |  4 +--
 src/ExcelReader.Native/Writer/WriteApi.cs     |  4 +--
 .../Writer/WorkbookWriterTests.cs             | 30 +++++++++++++++++++
 .../Writer/Xls/XlsWriterTests.cs              |  2 +-
 14 files changed, 84 insertions(+), 16 deletions(-)
 create mode 100644 src/ExcelReader.Core/Writer/Xls/XlsWriterOptions.cs

diff --git a/src/ExcelReader.Cli/CliCommands.cs b/src/ExcelReader.Cli/CliCommands.cs
index 85c2c391..ca914cfa 100644
--- a/src/ExcelReader.Cli/CliCommands.cs
+++ b/src/ExcelReader.Cli/CliCommands.cs
@@ -120,7 +120,7 @@ private static void WriteCsv(IExcelSheet sheet, Stream target, bool leaveOpen, c
 
         private static void WriteXlsx(IExcelSheet sheet, Stream target, bool leaveOpen, Action<int>? onProgress)
         {
-            using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(target, leaveOpen);
+            using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(target, leaveOpen, new XlsxWriterOptions { Date1904 = sheet.IsDate1904 });
             WriteRows<XlsxWorkbookWriter, XlsxSheetWriter, XlsxRowWriter>(workbook, sheet, onProgress);
         }
 
@@ -132,7 +132,7 @@ private static void WriteXlsb(IExcelSheet sheet, Stream target, bool leaveOpen,
 
         private static void WriteXls(IExcelSheet sheet, Stream target, bool leaveOpen, Action<int>? onProgress)
         {
-            using XlsWorkbookWriter workbook = XlsWorkbookWriter.Create(target, leaveOpen, date1904: sheet.IsDate1904);
+            using XlsWorkbookWriter workbook = XlsWorkbookWriter.Create(target, leaveOpen, new XlsWriterOptions { Date1904 = sheet.IsDate1904 });
             WriteRows<XlsWorkbookWriter, XlsSheetWriter, XlsRowWriter>(workbook, sheet, onProgress);
         }
 
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 649515e1..c68e72c8 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -761,7 +761,6 @@ static ExcelReader.Core.Writer.SheetWriterExtensions.WriteRecordsAsync<T, TRow>(
 static ExcelReader.Core.Writer.SheetWriterExtensions.WriteRecordsAsync<T, TRow>(this ExcelReader.Core.Writer.ISheetWriter<TRow>! sheet, System.Collections.Generic.IEnumerable<T>! records, ExcelReader.Core.Writer.ExcelRecordLayout<T>! layout, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 static ExcelReader.Core.Writer.SheetWriterExtensions.WriteRecordsAsync<T, TRow>(this ExcelReader.Core.Writer.ISheetWriter<TRow>! sheet, System.Collections.Generic.IEnumerable<T>! records, System.Action<TRow, T>! writeRow, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 static ExcelReader.Core.Writer.SheetWriterExtensions.WriteRecordsAsync<T>(this ExcelReader.Core.Writer.Xlsx.XlsxSheetWriter! sheet, System.Collections.Generic.IEnumerable<T>! records, System.Action<ExcelReader.Core.Writer.Xlsx.XlsxRowWriter!, T>! writeRow, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
-static ExcelReader.Core.Writer.Xls.XlsWorkbookWriter.Create(System.IO.Stream! stream, bool leaveOpen = false, bool date1904 = false) -> ExcelReader.Core.Writer.Xls.XlsWorkbookWriter!
 static ExcelReader.Core.Writer.Xlsb.XlsbCell.Create(System.DateTime value) -> ExcelReader.Core.Writer.Xlsb.XlsbCell
 static ExcelReader.Core.Writer.Xlsb.XlsbCell.Create(System.DateTime? value) -> ExcelReader.Core.Writer.Xlsb.XlsbCell
 static ExcelReader.Core.Writer.Xlsb.XlsbCell.Create(bool value) -> ExcelReader.Core.Writer.Xlsb.XlsbCell
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index f262ae01..7e565c10 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -86,3 +86,18 @@ ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SchemaInferenceOptions() -
 static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.SchemaInferenceOptions? options = null) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
 static ExcelReader.Core.Reader.ExcelDataReaderOptions.Default.get -> ExcelReader.Core.Reader.ExcelDataReaderOptions!
 static ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.Default.get -> ExcelReader.Core.Reader.Schema.SchemaInferenceOptions!
+ExcelReader.Core.Writer.Xls.XlsWriterOptions
+ExcelReader.Core.Writer.Xls.XlsWriterOptions.<Clone>$() -> ExcelReader.Core.Writer.Xls.XlsWriterOptions!
+ExcelReader.Core.Writer.Xls.XlsWriterOptions.Date1904.get -> bool
+ExcelReader.Core.Writer.Xls.XlsWriterOptions.Date1904.init -> void
+ExcelReader.Core.Writer.Xls.XlsWriterOptions.Equals(ExcelReader.Core.Writer.Xls.XlsWriterOptions? other) -> bool
+ExcelReader.Core.Writer.Xls.XlsWriterOptions.XlsWriterOptions() -> void
+ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions.Date1904.get -> bool
+ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions.Date1904.init -> void
+override ExcelReader.Core.Writer.Xls.XlsWriterOptions.Equals(object? obj) -> bool
+override ExcelReader.Core.Writer.Xls.XlsWriterOptions.GetHashCode() -> int
+override ExcelReader.Core.Writer.Xls.XlsWriterOptions.ToString() -> string!
+static ExcelReader.Core.Writer.Xls.XlsWorkbookWriter.Create(System.IO.Stream! stream, bool leaveOpen = false, ExcelReader.Core.Writer.Xls.XlsWriterOptions? options = null) -> ExcelReader.Core.Writer.Xls.XlsWorkbookWriter!
+static ExcelReader.Core.Writer.Xls.XlsWriterOptions.Default.get -> ExcelReader.Core.Writer.Xls.XlsWriterOptions!
+static ExcelReader.Core.Writer.Xls.XlsWriterOptions.operator !=(ExcelReader.Core.Writer.Xls.XlsWriterOptions? left, ExcelReader.Core.Writer.Xls.XlsWriterOptions? right) -> bool
+static ExcelReader.Core.Writer.Xls.XlsWriterOptions.operator ==(ExcelReader.Core.Writer.Xls.XlsWriterOptions? left, ExcelReader.Core.Writer.Xls.XlsWriterOptions? right) -> bool
diff --git a/src/ExcelReader.Core/Writer/Internal/CellFormatter.cs b/src/ExcelReader.Core/Writer/Internal/CellFormatter.cs
index 9c84874d..d3616f74 100644
--- a/src/ExcelReader.Core/Writer/Internal/CellFormatter.cs
+++ b/src/ExcelReader.Core/Writer/Internal/CellFormatter.cs
@@ -111,11 +111,11 @@ internal static void WriteBool(BiffBuffer xml, bool value, int columnIndex, int
             xml.Write("</v></c>"u8);
         }
 
-        internal static void WriteDateTime(BiffBuffer xml, DateTime value, int columnIndex, int rowNumber, bool includeReference, int styleId)
+        internal static void WriteDateTime(BiffBuffer xml, DateTime value, bool date1904, int columnIndex, int rowNumber, bool includeReference, int styleId)
         {
             WriteCellOpen(xml, columnIndex, rowNumber, includeReference, styleId, default, selfClose: false);
             xml.Write("<v>"u8);
-            WriteValue(xml, ExcelEpoch.OADateToSerial(value.ToOADate(), date1904: false), sizeHint: 32);
+            WriteValue(xml, ExcelEpoch.OADateToSerial(value.ToOADate(), date1904), sizeHint: 32);
             xml.Write("</v></c>"u8);
         }
 
diff --git a/src/ExcelReader.Core/Writer/Xls/XlsWorkbookWriter.cs b/src/ExcelReader.Core/Writer/Xls/XlsWorkbookWriter.cs
index a2a64eb1..2e88bd17 100644
--- a/src/ExcelReader.Core/Writer/Xls/XlsWorkbookWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xls/XlsWorkbookWriter.cs
@@ -39,11 +39,11 @@ private XlsWorkbookWriter(Stream stream, bool leaveOpen, bool date1904)
         /// </summary>
         /// <param name="stream">The destination stream.</param>
         /// <param name="leaveOpen">If <see langword="true"/>, the stream is left open when the writer is disposed.</param>
-        /// <param name="date1904">If <see langword="true"/>, dates are serialized using the 1904 epoch instead of the default 1900 epoch.</param>
-        public static XlsWorkbookWriter Create(Stream stream, bool leaveOpen = false, bool date1904 = false)
+        /// <param name="options">The date system; <see cref="XlsWriterOptions.Default"/> when <see langword="null"/>.</param>
+        public static XlsWorkbookWriter Create(Stream stream, bool leaveOpen = false, XlsWriterOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(stream);
-            return new XlsWorkbookWriter(stream, leaveOpen, date1904);
+            return new XlsWorkbookWriter(stream, leaveOpen, (options ?? XlsWriterOptions.Default).Date1904);
         }
 
         /// <inheritdoc/>
diff --git a/src/ExcelReader.Core/Writer/Xls/XlsWriterOptions.cs b/src/ExcelReader.Core/Writer/Xls/XlsWriterOptions.cs
new file mode 100644
index 00000000..ea7c1885
--- /dev/null
+++ b/src/ExcelReader.Core/Writer/Xls/XlsWriterOptions.cs
@@ -0,0 +1,12 @@
+namespace ExcelReader.Core.Writer.Xls
+{
+    /// <summary>Configures how a BIFF8 (.xls) workbook is written.</summary>
+    public sealed record XlsWriterOptions
+    {
+        /// <summary>Whether the workbook uses the 1904 date system instead of the default 1900 system. Defaults to <see langword="false"/>.</summary>
+        public bool Date1904 { get; init; }
+
+        /// <summary>The default options: 1900 date system.</summary>
+        public static XlsWriterOptions Default { get; } = new();
+    }
+}
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxRowWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxRowWriter.cs
index 72c5d3cc..bf1ebb5a 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxRowWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxRowWriter.cs
@@ -112,7 +112,7 @@ public void Write(DateTime value)
         {
             ThrowIfDisposed();
             int styleId = EffectiveStyle();
-            CellFormatter.WriteDateTime(_row, value, _columnIndex, _rowNumber, ConsumeCellReference(), styleId == 0 ? 1 : styleId);
+            CellFormatter.WriteDateTime(_row, value, _owner.Date1904, _columnIndex, _rowNumber, ConsumeCellReference(), styleId == 0 ? 1 : styleId);
             _columnIndex++;
         }
 
@@ -138,7 +138,7 @@ public void Write(DateOnly value)
         {
             ThrowIfDisposed();
             int styleId = EffectiveStyle();
-            CellFormatter.WriteDateTime(_row, value.ToDateTime(TimeOnly.MinValue), _columnIndex, _rowNumber, ConsumeCellReference(), styleId == 0 ? 1 : styleId);
+            CellFormatter.WriteDateTime(_row, value.ToDateTime(TimeOnly.MinValue), _owner.Date1904, _columnIndex, _rowNumber, ConsumeCellReference(), styleId == 0 ? 1 : styleId);
             _columnIndex++;
         }
 
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
index d7639d0d..9bb2c5f1 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxSheetWriter.cs
@@ -45,6 +45,8 @@ internal XlsxSheetWriter(XlsxWorkbookWriter owner, ZipArchive zip, string name,
         internal int SheetId { get; }
         internal ExcelSheetVisibility Visibility { get; }
         internal bool UseSharedStrings => _owner.UseSharedStrings;
+
+        internal bool Date1904 => _owner.Date1904;
         internal bool ResourcesReleased => _stream is null && _rowBuffer.IsReleased;
 
         internal int GetSharedStringIndex(string value)
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
index d06da584..34b40541 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxWorkbookWriter.cs
@@ -34,6 +34,7 @@ private XlsxWorkbookWriter(ZipArchive zip, Stream stream, bool leaveOpen, XlsxWr
             _stream = stream;
             _leaveOpen = leaveOpen;
             UseSharedStrings = options.UseSharedStrings;
+            Date1904 = options.Date1904;
             _compression = options.Compression;
             _prefetchWrite = options.PrefetchWrite;
             _sharedStrings = options.UseSharedStrings ? new SharedStringTable() : null;
@@ -132,6 +133,8 @@ internal void NotifySheetEnded(bool faulted)
 
         internal bool UseSharedStrings { get; }
 
+        internal bool Date1904 { get; }
+
         internal int GetSharedStringIndex(string value)
         {
             return _sharedStrings!.GetOrAdd(value);
@@ -488,6 +491,10 @@ private string BuildWorkbookXml()
             StringBuilder sb = new();
             sb.Append("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>");
             sb.Append($"<workbook xmlns=\"{XlsxConstants.MainNs}\" xmlns:r=\"{XlsxConstants.RelationshipsNs}\">");
+            if (Date1904)
+            {
+                sb.Append("<workbookPr date1904=\"1\"/>");
+            }
             sb.Append("<sheets>");
             bool anyVisible = false;
             foreach ((string name, int sheetId, ExcelSheetVisibility visibility) in _sheets)
diff --git a/src/ExcelReader.Core/Writer/Xlsx/XlsxWriterOptions.cs b/src/ExcelReader.Core/Writer/Xlsx/XlsxWriterOptions.cs
index 5689d024..02dccd4d 100644
--- a/src/ExcelReader.Core/Writer/Xlsx/XlsxWriterOptions.cs
+++ b/src/ExcelReader.Core/Writer/Xlsx/XlsxWriterOptions.cs
@@ -5,6 +5,9 @@ namespace ExcelReader.Core.Writer.Xlsx
     /// <summary>Configures how an XLSX package is written.</summary>
     public sealed record XlsxWriterOptions
     {
+        /// <summary>Whether the workbook uses the 1904 date system instead of the default 1900 system. Defaults to <see langword="false"/>.</summary>
+        public bool Date1904 { get; init; }
+
         /// <summary>The compression level applied to each ZIP entry. Defaults to <see cref="CompressionLevel.Fastest"/>.</summary>
         public CompressionLevel Compression { get; init; } = CompressionLevel.Fastest;
 
@@ -23,7 +26,7 @@ public sealed record XlsxWriterOptions
         /// </remarks>
         public bool PrefetchWrite { get; init; }
 
-        /// <summary>The default options: fastest compression, inline strings, no background deflate.</summary>
+        /// <summary>The default options: 1900 date system, fastest compression, inline strings, no background deflate.</summary>
         public static XlsxWriterOptions Default { get; } = new();
     }
 }
diff --git a/src/ExcelReader.Native/Writer/NativeWriterHandle.cs b/src/ExcelReader.Native/Writer/NativeWriterHandle.cs
index 29f90a04..f16c627a 100644
--- a/src/ExcelReader.Native/Writer/NativeWriterHandle.cs
+++ b/src/ExcelReader.Native/Writer/NativeWriterHandle.cs
@@ -52,13 +52,13 @@ internal static NativeWriterHandle Create(Stream stream, int format, NativeWrite
             {
                 case NativeFormat.Xlsx:
                     return new NativeWriterHandle<XlsxSheetWriter, XlsxRowWriter>(
-                        XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { UseSharedStrings = sharedStrings }));
+                        XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { Date1904 = date1904, UseSharedStrings = sharedStrings }));
                 case NativeFormat.Xlsb:
                     return new NativeWriterHandle<XlsbSheetWriter, XlsbRowWriter>(
                         XlsbWorkbookWriter.Create(stream, options: new XlsbWriterOptions { Date1904 = date1904, UseSharedStrings = sharedStrings }));
                 case NativeFormat.Xls:
                     return new NativeWriterHandle<XlsSheetWriter, XlsRowWriter>(
-                        XlsWorkbookWriter.Create(stream, date1904: date1904));
+                        XlsWorkbookWriter.Create(stream, options: new XlsWriterOptions { Date1904 = date1904 }));
                 case NativeFormat.Csv:
                     return new NativeWriterHandle<CsvSheetWriter, CsvRowWriter>(
                         CsvWorkbookWriter.Create(stream, options: options.ToCsvWriterOptions()));
diff --git a/src/ExcelReader.Native/Writer/WriteApi.cs b/src/ExcelReader.Native/Writer/WriteApi.cs
index 2d4f8290..1fa5a81a 100644
--- a/src/ExcelReader.Native/Writer/WriteApi.cs
+++ b/src/ExcelReader.Native/Writer/WriteApi.cs
@@ -194,7 +194,7 @@ private static void WriteToStream(Stream stream, int format, NativeColumnSpec[]
             {
                 case NativeFormat.Xlsx:
                     WriteWorkbook<XlsxSheetWriter, XlsxRowWriter>(
-                        XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { UseSharedStrings = sharedStrings }), specs, table, sheetName, hasHeader);
+                        XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { Date1904 = date1904, UseSharedStrings = sharedStrings }), specs, table, sheetName, hasHeader);
                     return;
                 case NativeFormat.Xlsb:
                     WriteWorkbook<XlsbSheetWriter, XlsbRowWriter>(
@@ -202,7 +202,7 @@ private static void WriteToStream(Stream stream, int format, NativeColumnSpec[]
                     return;
                 case NativeFormat.Xls:
                     WriteWorkbook<XlsSheetWriter, XlsRowWriter>(
-                        XlsWorkbookWriter.Create(stream, date1904: date1904), specs, table, sheetName, hasHeader);
+                        XlsWorkbookWriter.Create(stream, options: new XlsWriterOptions { Date1904 = date1904 }), specs, table, sheetName, hasHeader);
                     return;
                 default:
                     WriteWorkbook<CsvSheetWriter, CsvRowWriter>(
diff --git a/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs b/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
index aed46749..1c575393 100644
--- a/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/WorkbookWriterTests.cs
@@ -12,6 +12,36 @@ namespace ExcelReader.Tests.Writer
 {
     public class WorkbookWriterTests
     {
+        [Fact]
+        public async Task XlsxDate1904RoundTrips()
+        {
+            CancellationToken ct = TestContext.Current.CancellationToken;
+            var date = new DateTime(1904, 1, 2, 6, 0, 0, DateTimeKind.Unspecified);
+            var day = new DateOnly(2024, 5, 6);
+            var ms = new MemoryStream();
+            await using (XlsxWorkbookWriter wb = XlsxWorkbookWriter.Create(ms, leaveOpen: true, new XlsxWriterOptions { Date1904 = true }))
+            {
+                XlsxSheetWriter sheet = wb.AddSheet("S");
+                await using (XlsxRowWriter row = await sheet.StartRowAsync(ct))
+                {
+                    row.Write(date);
+                    row.Write(day);
+                }
+                await sheet.EndAsync(ct);
+                await wb.EndAsync(ct);
+            }
+            ms.Position = 0;
+
+            using XlsxWorkbook reader = Excel.FromXlsx(ms);
+            Assert.True(reader.IsDate1904);
+            using XlsxWorkbook.Enumerator e = reader.FirstSheet.GetEnumerator();
+            Assert.True(e.MoveNext());
+            Assert.True(e.Current[0].TryGetDateTime(isDate1904: true, out DateTime parsed));
+            Assert.Equal(date, parsed);
+            Assert.True(e.Current[1].TryGetDateTime(isDate1904: true, out DateTime parsedDay));
+            Assert.Equal(day.ToDateTime(TimeOnly.MinValue), parsedDay);
+        }
+
 
         private sealed class StringRow
         {
diff --git a/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs b/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
index acdd2aab..b9d80a7c 100644
--- a/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
@@ -13,7 +13,7 @@ private static async Task<byte[]> WriteAsync(
             Action<XlsWorkbookWriter> build, bool date1904 = false, CancellationToken ct = default)
         {
             var ms = new MemoryStream();
-            await using (var wb = XlsWorkbookWriter.Create(ms, leaveOpen: true, date1904: date1904))
+            await using (var wb = XlsWorkbookWriter.Create(ms, leaveOpen: true, new XlsWriterOptions { Date1904 = date1904 }))
             {
                 build(wb);
                 await wb.EndAsync(ct);

From fda69b853de750b70af78bab086331a896e86a7b Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:41:19 -0300
Subject: [PATCH 088/115] refactor!: open CSV with ExcelReaderOptions like
 every other format

The Excel.FromCsv* factories take ExcelReaderOptions instead of CsvReaderOptions; the
delimiter, quote and encoding stay in ExcelReaderOptions.Csv. MaxCellBytes and
InternStrings leave CsvReaderOptions and come from ExcelReaderOptions, which also fixes
Excel.Open with ExcelFileFormat.Csv silently ignoring those two reader limits. The native
ABI keeps its separate csv_max_cell_bytes and csv_intern_strings fields.
---
 docs/guide/csv.md                             | 10 +--
 .../Parser/ParallelCsv/CsvChunkWorker.cs      |  4 +-
 .../PublicAPI/PublicAPI.Shipped.txt           |  9 ---
 .../PublicAPI/PublicAPI.Unshipped.txt         |  5 ++
 .../Reader/Csv/CsvReaderOptions.cs            | 26 +++-----
 src/ExcelReader.Core/Reader/Excel.cs          | 65 ++++++++++++-------
 .../Reader/ExcelReaderOptions.cs              | 26 ++++----
 src/ExcelReader.Native/Csv/CsvAggregateApi.cs |  4 +-
 src/ExcelReader.Native/NativeOpenOptions.cs   |  2 +-
 .../Reading/ReadApi.Sources.cs                |  3 +-
 tests/ExcelReader.Fuzz/Harnesses.cs           |  6 +-
 .../Native/CsvAggregateNativeTests.cs         |  2 +-
 .../ParallelCsv/ParseCsvParallelTests.cs      |  2 +-
 .../Reader/Csv/CsvBlockBoundaryTests.cs       |  4 +-
 .../Reader/Csv/CsvDialectAndFormatTests.cs    |  6 +-
 .../Reader/Csv/CsvLifetimeTests.cs            |  4 +-
 .../Reader/Csv/CsvReaderTests.cs              | 36 ++++++----
 .../Reader/Csv/CsvReplayTests.cs              |  2 +-
 .../Reader/Csv/CsvSnifferTests.cs             |  2 +-
 .../Reader/FileOwnershipTests.cs              |  4 +-
 .../Reader/Utf8StringCacheTests.cs            |  3 +-
 .../Writer/Csv/CsvWriterOptionsTests.cs       |  2 +-
 .../Writer/Csv/CsvWriterTests.cs              |  2 +-
 23 files changed, 121 insertions(+), 108 deletions(-)

diff --git a/docs/guide/csv.md b/docs/guide/csv.md
index dc9a0fc2..3cea059e 100644
--- a/docs/guide/csv.md
+++ b/docs/guide/csv.md
@@ -25,10 +25,10 @@ foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(csv.FirstShee
 }
 ```
 
-`Excel.FromCsv`/`FromCsvFile`/`FromCsvAsync`/`FromCsvFileAsync` mirror the other formats' factory shape. Pass `CsvReaderOptions` to change the delimiter/quote character, supply a non-UTF-8 `Encoding` (transcoded to UTF-8 internally), or turn off BOM detection:
+`Excel.FromCsv`/`FromCsvFile`/`FromCsvAsync`/`FromCsvFileAsync` mirror the other formats' factory shape and take the same `ExcelReaderOptions`. Its `Csv` property, a `CsvReaderOptions`, changes the delimiter/quote character, supplies a non-UTF-8 `Encoding` (transcoded to UTF-8 internally), or turns off BOM detection; `MaxCellBytes` and `InternStrings` stay on `ExcelReaderOptions`, as for every format:
 
 ```csharp
-var options = new CsvReaderOptions { Delimiter = (byte)';' };
+var options = new ExcelReaderOptions { Csv = new CsvReaderOptions { Delimiter = (byte)';' } };
 using var csv = Excel.FromCsvFile("relatorio.csv", options);
 ```
 
@@ -59,7 +59,7 @@ using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
 
 CsvDialect dialect = CsvSniffer.DetectFile("export.csv");
-using var csv = Excel.FromCsvFile("export.csv", CsvReaderOptions.Default.WithDialect(dialect));
+using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default.WithDialect(dialect) });
 ```
 
 `CsvSniffer.Detect` takes a span of bytes or a seekable `Stream`, `DetectFile` takes a path, and `DetectAsync`/`DetectFileAsync` are the async siblings; only the first 64 KiB are examined. The `Stream` overloads require a seekable source — they read a bounded sample and restore the stream's position — so a non-seekable stream throws `ArgumentException`; buffer it first, or pass the bytes as a span instead. Pass `CsvSnifferOptions` to change the candidate delimiters/quotes (and their priority order) or the number of sample lines considered.
@@ -67,7 +67,7 @@ using var csv = Excel.FromCsvFile("export.csv", CsvReaderOptions.Default.WithDia
 `CsvReaderOptions.SniffDialect` does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, and `Excel.Open` with `ExcelFileFormat.Csv`. The dialect of a parallel read is the one the CSV workbook was opened with:
 
 ```csharp
-using var csv = Excel.FromCsvFile("export.csv", CsvReaderOptions.Default with { SniffDialect = true });
+using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
 ```
 
 An explicitly set `Encoding` survives sniffing unless the source carries a byte-order mark naming a different one — a sniffed encoding only ever comes from a BOM, so it never silently overrides a caller who knows their file is Windows-1252.
@@ -101,7 +101,7 @@ using (CsvRowWriter row = writer.StartRow())
 
 Fields are quoted only when they contain the delimiter, quote character, `\r`, or `\n`; embedded quotes are doubled. `bool` writes as lowercase `true`/`false` and `DateTime`/`DateOnly` as round-trip ISO 8601 (`"O"`); `TimeOnly` as a time-of-day fraction — all matching what `ExcelParser<T>.Parse(CsvSheet)` expects, so a file written by `CsvWorkbookWriter` parses back without configuration. `Skip(count)` writes empty fields to keep column positions aligned (CSV has no sparse-cell concept).
 
-`CsvWriterOptions` mirrors `CsvReaderOptions` property for property, so a file written with one set of settings reads back with the matching set:
+`CsvWriterOptions` mirrors `CsvReaderOptions`'s delimiter, quote and encoding, so a file written with one set of settings reads back with the matching set:
 
 ```csharp
 using var workbook = CsvWorkbookWriter.Create(stream, leaveOpen: false, new CsvWriterOptions
diff --git a/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs b/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
index df4614f8..a61b39ab 100644
--- a/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
+++ b/src/ExcelReader.Core/Parser/ParallelCsv/CsvChunkWorker.cs
@@ -48,9 +48,9 @@ internal CsvReader OpenReader(CsvReaderOptions options)
         {
             if (IsMemory)
             {
-                return Excel.FromCsv(SliceAt(0), options);
+                return Excel.OpenCsv(SliceAt(0), options);
             }
-            return Excel.FromCsv(OpenAt(0), leaveOpen: false, options);
+            return Excel.OpenCsv(OpenAt(0), leaveOpen: false, options);
         }
 
         internal int ReadWindow(long offset, Span<byte> buffer)
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index c68e72c8..f30f97e8 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -152,10 +152,6 @@ ExcelReader.Core.Reader.Csv.CsvReaderOptions.DetectEncodingFromByteOrderMark.ini
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.Encoding.get -> System.Text.Encoding?
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.Encoding.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.Equals(ExcelReader.Core.Reader.Csv.CsvReaderOptions? other) -> bool
-ExcelReader.Core.Reader.Csv.CsvReaderOptions.InternStrings.get -> bool
-ExcelReader.Core.Reader.Csv.CsvReaderOptions.InternStrings.init -> void
-ExcelReader.Core.Reader.Csv.CsvReaderOptions.MaxCellBytes.get -> int
-ExcelReader.Core.Reader.Csv.CsvReaderOptions.MaxCellBytes.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.Quote.get -> byte
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.Quote.init -> void
 ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect.get -> bool
@@ -705,11 +701,6 @@ static ExcelReader.Core.Reader.Excel.EncryptPackage(System.IO.Stream! package, S
 static ExcelReader.Core.Reader.Excel.EncryptPackage(string! packagePath, string! destinationPath, ExcelReader.Core.Reader.ExcelPassword! password) -> void
 static ExcelReader.Core.Reader.Excel.EncryptPackageAsync(System.IO.Stream! package, System.IO.Stream! destination, ExcelReader.Core.Reader.ExcelPassword! password, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
 static ExcelReader.Core.Reader.Excel.EncryptPackageAsync(string! packagePath, string! destinationPath, ExcelReader.Core.Reader.ExcelPassword! password, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask
-static ExcelReader.Core.Reader.Excel.FromCsv(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
-static ExcelReader.Core.Reader.Excel.FromCsv(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
-static ExcelReader.Core.Reader.Excel.FromCsvAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
-static ExcelReader.Core.Reader.Excel.FromCsvFile(string! path, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
-static ExcelReader.Core.Reader.Excel.FromCsvFileAsync(string! path, ExcelReader.Core.Reader.Csv.CsvReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
 static ExcelReader.Core.Reader.Excel.FromXls(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
 static ExcelReader.Core.Reader.Excel.FromXls(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Xls.XlsWorkbook!
 static ExcelReader.Core.Reader.Excel.FromXlsAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Xls.XlsWorkbook!>
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 7e565c10..71ce2edc 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -101,3 +101,8 @@ static ExcelReader.Core.Writer.Xls.XlsWorkbookWriter.Create(System.IO.Stream! st
 static ExcelReader.Core.Writer.Xls.XlsWriterOptions.Default.get -> ExcelReader.Core.Writer.Xls.XlsWriterOptions!
 static ExcelReader.Core.Writer.Xls.XlsWriterOptions.operator !=(ExcelReader.Core.Writer.Xls.XlsWriterOptions? left, ExcelReader.Core.Writer.Xls.XlsWriterOptions? right) -> bool
 static ExcelReader.Core.Writer.Xls.XlsWriterOptions.operator ==(ExcelReader.Core.Writer.Xls.XlsWriterOptions? left, ExcelReader.Core.Writer.Xls.XlsWriterOptions? right) -> bool
+static ExcelReader.Core.Reader.Excel.FromCsv(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
+static ExcelReader.Core.Reader.Excel.FromCsv(System.ReadOnlyMemory<byte> data, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
+static ExcelReader.Core.Reader.Excel.FromCsvAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
+static ExcelReader.Core.Reader.Excel.FromCsvFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
+static ExcelReader.Core.Reader.Excel.FromCsvFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
diff --git a/src/ExcelReader.Core/Reader/Csv/CsvReaderOptions.cs b/src/ExcelReader.Core/Reader/Csv/CsvReaderOptions.cs
index 6c05d781..86a2bf5f 100644
--- a/src/ExcelReader.Core/Reader/Csv/CsvReaderOptions.cs
+++ b/src/ExcelReader.Core/Reader/Csv/CsvReaderOptions.cs
@@ -2,7 +2,8 @@
 
 namespace ExcelReader.Core.Reader.Csv
 {
-    /// <summary>Options controlling how <see cref="CsvReader"/> parses a CSV source.</summary>
+    /// <summary>The delimited-text settings for a CSV source, carried by <see cref="ExcelReaderOptions.Csv"/>.</summary>
+    /// <remarks>Size limits and string interning come from <see cref="ExcelReaderOptions"/>, as for every other format.</remarks>
     public sealed record CsvReaderOptions
     {
         /// <summary>Gets the byte used to separate fields within a record. Defaults to <c>,</c>.</summary>
@@ -21,23 +22,14 @@ public sealed record CsvReaderOptions
         /// <summary>Gets a value indicating whether a leading UTF-8 byte-order mark should be detected and skipped. Defaults to <see langword="true"/>.</summary>
         public bool DetectEncodingFromByteOrderMark { get; init; } = true;
 
-        /// <summary>Gets the maximum byte length allowed for a single buffered record/field. Defaults to 32 MiB.</summary>
-        /// <remarks>Mirrors <see cref="ExcelReaderOptions.MaxCellBytes"/> for the Excel readers.</remarks>
-        public int MaxCellBytes { get; init; } = 32 * 1024 * 1024;
+        internal int MaxCellBytes { get; init; } = 32 * 1024 * 1024;
 
-        /// <summary>
-        /// Gets a value indicating whether repeated field text is deduplicated through a small
-        /// content-keyed cache when materialized via <see cref="Cell.GetString"/>.
-        /// Defaults to <see langword="false"/>. Has no effect on the zero-copy
-        /// <see cref="Cell.Value"/> span path — only <c>GetString()</c> consults the
-        /// cache. Worth enabling for genuinely categorical columns (low-cardinality repeated text);
-        /// for high-cardinality data (unique IDs, or numeric/date columns read back as text, which CSV
-        /// has no other representation for) every lookup is a cache miss, so the per-call hashing cost
-        /// is pure overhead with no dedup benefit — measured roughly doubling wall-clock time on a
-        /// real-world, mixed-cardinality CSV corpus. Off by default so this never regresses a caller
-        /// who hasn't measured their own data.
-        /// </summary>
-        public bool InternStrings { get; init; }
+        internal bool InternStrings { get; init; }
+
+        // ponytail: the native ABI keeps separate csv_max_cell_bytes/csv_intern_strings fields; these let it win over ExcelReaderOptions.
+        internal int? MaxCellBytesOverride { get; init; }
+
+        internal bool? InternStringsOverride { get; init; }
 
         /// <summary>
         /// Gets a value indicating whether the source's dialect is inferred from a sample of its leading
diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index 64d843c8..ccfca244 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -199,13 +199,13 @@ public static ValueTask<XlsbWorkbook> FromXlsbAsync(Stream stream, bool leaveOpe
 
         /// <summary>Opens a CSV (or other delimited-text) source from a file path, taking ownership of the file stream.</summary>
         /// <param name="path">The path to the CSV file.</param>
-        /// <param name="options">Delimiter, quote, encoding, and size-limit settings; <see cref="CsvReaderOptions.Default"/> when <see langword="null"/>.</param>
-        public static CsvReader FromCsvFile(string path, CsvReaderOptions? options = null)
+        /// <param name="options">Size limits and interning, plus the delimiter, quote and encoding in <see cref="ExcelReaderOptions.Csv"/>; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>.</param>
+        public static CsvReader FromCsvFile(string path, ExcelReaderOptions? options = null)
         {
             FileStream stream = File.OpenRead(path);
             try
             {
-                return new CsvReader(stream, leaveOpen: false, CsvDialectResolver.Resolve(stream, options ?? CsvReaderOptions.Default));
+                return new CsvReader(stream, leaveOpen: false, CsvDialectResolver.Resolve(stream, CsvOf(options)));
             }
             catch
             {
@@ -217,33 +217,46 @@ public static CsvReader FromCsvFile(string path, CsvReaderOptions? options = nul
         /// <summary>Opens a CSV (or other delimited-text) source from an existing stream.</summary>
         /// <param name="stream">The stream containing the CSV data.</param>
         /// <param name="leaveOpen">When <see langword="true"/> (the default), <paramref name="stream"/> is not disposed when the workbook is disposed, but the caller must not use, reposition or dispose it until the workbook and every enumerator obtained from it are disposed.</param>
-        /// <param name="options">Delimiter, quote, encoding, and size-limit settings; <see cref="CsvReaderOptions.Default"/> when <see langword="null"/>.</param>
-        public static CsvReader FromCsv(Stream stream, bool leaveOpen = true, CsvReaderOptions? options = null)
+        /// <param name="options">Size limits and interning, plus the delimiter, quote and encoding in <see cref="ExcelReaderOptions.Csv"/>; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>.</param>
+        public static CsvReader FromCsv(Stream stream, bool leaveOpen = true, ExcelReaderOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(stream);
-            CsvReaderOptions effective = CsvDialectResolver.Resolve(stream, options ?? CsvReaderOptions.Default);
-            return new CsvReader(stream, leaveOpen, effective);
+            return OpenCsv(stream, leaveOpen, CsvOf(options));
+        }
+
+        internal static CsvReader OpenCsv(Stream stream, bool leaveOpen, CsvReaderOptions options)
+        {
+            return new CsvReader(stream, leaveOpen, CsvDialectResolver.Resolve(stream, options));
         }
 
         /// <summary>Opens a CSV (or other delimited-text) source directly from an in-memory buffer.</summary>
         /// <param name="data">The whole CSV source's bytes. Must stay valid and unmodified until the workbook and every enumerator obtained from it are disposed.</param>
-        /// <param name="options">Delimiter, quote, encoding, and size-limit settings; <see cref="CsvReaderOptions.Default"/> when <see langword="null"/>.</param>
-        public static CsvReader FromCsv(ReadOnlyMemory<byte> data, CsvReaderOptions? options = null)
+        /// <param name="options">Size limits and interning, plus the delimiter, quote and encoding in <see cref="ExcelReaderOptions.Csv"/>; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>.</param>
+        public static CsvReader FromCsv(ReadOnlyMemory<byte> data, ExcelReaderOptions? options = null)
+        {
+            return OpenCsv(data, CsvOf(options));
+        }
+
+        internal static CsvReader OpenCsv(ReadOnlyMemory<byte> data, CsvReaderOptions options)
         {
-            CsvReaderOptions effective = CsvDialectResolver.Resolve(data, options ?? CsvReaderOptions.Default);
-            return new CsvReader(data, effective);
+            return new CsvReader(data, CsvDialectResolver.Resolve(data, options));
         }
 
         /// <summary>Asynchronously opens a CSV (or other delimited-text) source from a file path, taking ownership of the file stream.</summary>
         /// <param name="path">The path to the CSV file.</param>
-        /// <param name="options">Delimiter, quote, encoding, and size-limit settings; <see cref="CsvReaderOptions.Default"/> when <see langword="null"/>.</param>
+        /// <param name="options">Size limits and interning, plus the delimiter, quote and encoding in <see cref="ExcelReaderOptions.Csv"/>; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>.</param>
         /// <param name="ct">A token to cancel the open operation.</param>
-        public static async ValueTask<CsvReader> FromCsvFileAsync(string path, CsvReaderOptions? options = null, CancellationToken ct = default)
+        public static ValueTask<CsvReader> FromCsvFileAsync(string path, ExcelReaderOptions? options = null, CancellationToken ct = default)
+        {
+            return OpenCsvFileAsync(path, CsvOf(options), ct);
+        }
+
+        internal static async ValueTask<CsvReader> OpenCsvFileAsync(string path, CsvReaderOptions options, CancellationToken ct)
         {
             FileStream stream = OpenAsyncFile(path);
             try
             {
-                CsvReaderOptions effective = await CsvDialectResolver.ResolveAsync(stream, options ?? CsvReaderOptions.Default, ct).ConfigureAwait(false);
+                CsvReaderOptions effective = await CsvDialectResolver.ResolveAsync(stream, options, ct).ConfigureAwait(false);
                 return await CsvReader.CreateAsync(stream, leaveOpen: false, effective, ct).ConfigureAwait(false);
             }
             catch
@@ -256,12 +269,12 @@ public static async ValueTask<CsvReader> FromCsvFileAsync(string path, CsvReader
         /// <summary>Asynchronously opens a CSV (or other delimited-text) source from an existing stream.</summary>
         /// <param name="stream">The stream containing the CSV data.</param>
         /// <param name="leaveOpen">When <see langword="true"/> (the default), <paramref name="stream"/> is not disposed when the workbook is disposed, but the caller must not use, reposition or dispose it until the workbook and every enumerator obtained from it are disposed.</param>
-        /// <param name="options">Delimiter, quote, encoding, and size-limit settings; <see cref="CsvReaderOptions.Default"/> when <see langword="null"/>.</param>
+        /// <param name="options">Size limits and interning, plus the delimiter, quote and encoding in <see cref="ExcelReaderOptions.Csv"/>; <see cref="ExcelReaderOptions.Default"/> when <see langword="null"/>.</param>
         /// <param name="ct">A token to cancel the open operation.</param>
-        public static async ValueTask<CsvReader> FromCsvAsync(Stream stream, bool leaveOpen = true, CsvReaderOptions? options = null, CancellationToken ct = default)
+        public static async ValueTask<CsvReader> FromCsvAsync(Stream stream, bool leaveOpen = true, ExcelReaderOptions? options = null, CancellationToken ct = default)
         {
             ArgumentNullException.ThrowIfNull(stream);
-            CsvReaderOptions effective = await CsvDialectResolver.ResolveAsync(stream, options ?? CsvReaderOptions.Default, ct).ConfigureAwait(false);
+            CsvReaderOptions effective = await CsvDialectResolver.ResolveAsync(stream, CsvOf(options), ct).ConfigureAwait(false);
             return await CsvReader.CreateAsync(stream, leaveOpen, effective, ct).ConfigureAwait(false);
         }
 
@@ -453,7 +466,7 @@ public static IExcelWorkbook Open(string path, ExcelFileFormat format, ExcelRead
             RequireOpenableFormat(format);
             return format switch
             {
-                ExcelFileFormat.Csv => FromCsvFile(path, CsvOf(options)),
+                ExcelFileFormat.Csv => FromCsvFile(path, options),
                 ExcelFileFormat.Xlsx => FromXlsxFile(path, options),
                 ExcelFileFormat.Xlsb => FromXlsbFile(path, options),
                 ExcelFileFormat.Xls => FromXlsFile(path, options),
@@ -483,7 +496,7 @@ public static IExcelWorkbook Open(Stream stream, ExcelFileFormat format, bool le
             RequireOpenableFormat(format);
             return format switch
             {
-                ExcelFileFormat.Csv => FromCsv(stream, leaveOpen, CsvOf(options)),
+                ExcelFileFormat.Csv => FromCsv(stream, leaveOpen, options),
                 ExcelFileFormat.Xlsx => FromXlsx(stream, leaveOpen, options),
                 ExcelFileFormat.Xlsb => FromXlsb(stream, leaveOpen, options),
                 ExcelFileFormat.Xls => FromXls(stream, leaveOpen, options),
@@ -508,7 +521,7 @@ public static IExcelWorkbook Open(ReadOnlyMemory<byte> data, ExcelFileFormat for
             RequireOpenableFormat(format);
             return format switch
             {
-                ExcelFileFormat.Csv => FromCsv(data, CsvOf(options)),
+                ExcelFileFormat.Csv => FromCsv(data, options),
                 ExcelFileFormat.Xlsx => FromXlsx(data, options),
                 ExcelFileFormat.Xlsb => FromXlsb(data, options),
                 ExcelFileFormat.Xls => FromXls(data, options),
@@ -536,7 +549,7 @@ public static ValueTask<IExcelWorkbook> OpenAsync(string path, ExcelFileFormat f
             RequireOpenableFormat(format);
             return format switch
             {
-                ExcelFileFormat.Csv => AsWorkbookAsync(FromCsvFileAsync(path, CsvOf(options), ct)),
+                ExcelFileFormat.Csv => AsWorkbookAsync(FromCsvFileAsync(path, options, ct)),
                 ExcelFileFormat.Xlsx => AsWorkbookAsync(FromXlsxFileAsync(path, options, ct)),
                 ExcelFileFormat.Xlsb => AsWorkbookAsync(FromXlsbFileAsync(path, options, ct)),
                 ExcelFileFormat.Xls => AsWorkbookAsync(FromXlsFileAsync(path, options, ct)),
@@ -567,7 +580,7 @@ public static ValueTask<IExcelWorkbook> OpenAsync(Stream stream, ExcelFileFormat
             RequireOpenableFormat(format);
             return format switch
             {
-                ExcelFileFormat.Csv => AsWorkbookAsync(FromCsvAsync(stream, leaveOpen, CsvOf(options), ct)),
+                ExcelFileFormat.Csv => AsWorkbookAsync(FromCsvAsync(stream, leaveOpen, options, ct)),
                 ExcelFileFormat.Xlsx => AsWorkbookAsync(FromXlsxAsync(stream, leaveOpen, options, ct)),
                 ExcelFileFormat.Xlsb => AsWorkbookAsync(FromXlsbAsync(stream, leaveOpen, options, ct)),
                 ExcelFileFormat.Xls => AsWorkbookAsync(FromXlsAsync(stream, leaveOpen, options, ct)),
@@ -577,7 +590,13 @@ public static ValueTask<IExcelWorkbook> OpenAsync(Stream stream, ExcelFileFormat
 
         private static CsvReaderOptions CsvOf(ExcelReaderOptions? options)
         {
-            return options?.Csv ?? CsvReaderOptions.Default;
+            options ??= ExcelReaderOptions.Default;
+            CsvReaderOptions csv = options.Csv ?? CsvReaderOptions.Default;
+            return csv with
+            {
+                MaxCellBytes = csv.MaxCellBytesOverride ?? options.MaxCellBytes,
+                InternStrings = csv.InternStringsOverride ?? options.InternStrings,
+            };
         }
 
         private static async ValueTask<IExcelWorkbook> AsWorkbookAsync<TWorkbook>(ValueTask<TWorkbook> pending)
diff --git a/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs b/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
index 574b6e44..4f2d0285 100644
--- a/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
+++ b/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
@@ -3,7 +3,7 @@
 namespace ExcelReader.Core.Reader
 {
     /// <summary>
-    /// Resource limits and behavior toggles applied when opening and reading an Excel workbook (XLSX/XLSB/XLS).
+    /// Resource limits and behavior toggles applied when opening and reading a workbook or a CSV source.
     /// Exceeding a byte or entry-count limit throws <see cref="ExcelLimitExceededException"/>.
     /// </summary>
     public sealed record ExcelReaderOptions
@@ -15,7 +15,7 @@ public sealed record ExcelReaderOptions
         /// materialize.</remarks>
         public long MaxTotalDecompressedBytes { get; init; } = 512L * 1024 * 1024;
 
-        /// <summary>Gets the maximum byte length allowed for a single cell's value. Defaults to 32 MiB.</summary>
+        /// <summary>Gets the maximum byte length allowed for a single cell's value, or a single buffered CSV record. Defaults to 32 MiB.</summary>
         public int MaxCellBytes { get; init; } = 32 * 1024 * 1024;
 
         /// <summary>Gets the maximum total byte size allowed for the shared string table. Defaults to 128 MiB.</summary>
@@ -34,15 +34,15 @@ public sealed record ExcelReaderOptions
         public bool PrefetchDecompression { get; init; }
 
         /// <summary>
-        /// Gets a value indicating whether inline/formula-string text cells (cells not served by the
-        /// workbook's shared-string table) are deduplicated through a small content-keyed cache when
-        /// materialized via <see cref="Cell.GetString"/>. Defaults to <see langword="false"/>.
+        /// Gets a value indicating whether text cells not served by a shared-string table (inline and
+        /// formula-string cells, and every CSV field) are deduplicated through a small content-keyed cache
+        /// when materialized via <see cref="Cell.GetString"/>. Defaults to <see langword="false"/>.
         /// Has no effect on shared-string cells, which already dedup through the shared-string table's
         /// own index-keyed cache, nor on the zero-copy <see cref="Cell.Value"/> span path —
-        /// only <c>GetString()</c> consults this cache. Worth enabling only when inline/formula-string
-        /// cells are known to repeat; for mostly-unique text the per-call hashing cost has no dedup
-        /// benefit to offset it (see <see cref="CsvReaderOptions.InternStrings"/> for measurements
-        /// against a real-world corpus — the risk is the same shape here).
+        /// only <c>GetString()</c> consults this cache. Worth enabling only for genuinely categorical
+        /// (low-cardinality, repeated) text; for high-cardinality data every lookup is a cache miss, so the
+        /// per-call hashing cost is pure overhead — measured roughly doubling wall-clock time on a
+        /// real-world, mixed-cardinality CSV corpus.
         /// </summary>
         public bool InternStrings { get; init; }
 
@@ -77,11 +77,9 @@ public sealed record ExcelReaderOptions
         /// <summary>Gets the delimited-text settings used when a source is opened as
         /// <see cref="ExcelFileFormat.Csv"/>. Defaults to <see langword="null"/>, meaning
         /// <see cref="CsvReaderOptions.Default"/>.</summary>
-        /// <remarks>Lets one options object carry both format families, so a caller that does not know
-        /// which one it will get — <see cref="Excel.Open(string,ExcelFileFormat,ExcelReaderOptions?)"/>,
-        /// or the <c>xl_open_options</c> struct the native ABI passes through — configures both in one
-        /// place. The other properties on this record cover the Excel formats only and are ignored on the
-        /// CSV path, as this one is on every other path.</remarks>
+        /// <remarks>Ignored for the Excel formats. On the CSV path, <see cref="MaxCellBytes"/> and
+        /// <see cref="InternStrings"/> still apply; the ZIP, shared-string, encryption and prefetch
+        /// settings have nothing to act on.</remarks>
         public CsvReaderOptions? Csv { get; init; }
 
         /// <summary>Gets the default options instance, used whenever a reader is opened without explicit options.</summary>
diff --git a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
index 213e9a13..6e56156b 100644
--- a/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
+++ b/src/ExcelReader.Native/Csv/CsvAggregateApi.cs
@@ -92,7 +92,7 @@ internal static int AggregateCsvMemory(
             {
                 using PointerMemoryManager manager = new(data, dataLength);
                 CsvAggregateContext context = new(aggregation);
-                using CsvReader csv = Excel.FromCsv(manager.Memory, reader);
+                using CsvReader csv = Excel.OpenCsv(manager.Memory, reader);
                 return Run(context, Task.Run(() => SheetParallel.AggregateAsync(csv.FirstSheet, Build(context), options, CancellationToken.None)), out result);
             }
             catch (Exception exception)
@@ -184,7 +184,7 @@ internal static class CsvAggregateFile
         internal static async Task<CsvAggregateState> AggregateAsync(
             string path, CsvReaderOptions reader, RowAggregation<CsvAggregateState> aggregation, SheetParallelOptions options)
         {
-            CsvReader csv = await Excel.FromCsvFileAsync(path, reader, CancellationToken.None).ConfigureAwait(false);
+            CsvReader csv = await Excel.OpenCsvFileAsync(path, reader, CancellationToken.None).ConfigureAwait(false);
             await using (csv.ConfigureAwait(false))
             {
                 return await SheetParallel.AggregateAsync(csv.FirstSheet, aggregation, options, CancellationToken.None).ConfigureAwait(false);
diff --git a/src/ExcelReader.Native/NativeOpenOptions.cs b/src/ExcelReader.Native/NativeOpenOptions.cs
index bf7e0d8c..5728fe5a 100644
--- a/src/ExcelReader.Native/NativeOpenOptions.cs
+++ b/src/ExcelReader.Native/NativeOpenOptions.cs
@@ -144,7 +144,7 @@ internal CsvReaderOptions ToCsvReaderOptions()
             {
                 options = options with { InternStrings = internStrings };
             }
-            return options;
+            return options with { MaxCellBytesOverride = options.MaxCellBytes, InternStringsOverride = options.InternStrings };
         }
 
         internal ExcelReaderOptions ToExcelReaderOptions()
diff --git a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
index a7d51e28..c08e7a60 100644
--- a/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
+++ b/src/ExcelReader.Native/Reading/ReadApi.Sources.cs
@@ -1,4 +1,5 @@
 using ExcelReader.Core.Reader;
+using ExcelReader.Core.Reader.Csv;
 using ExcelReader.Core.Reader.Sources;
 using ExcelReader.Core.Reader.Xls;
 
@@ -74,7 +75,7 @@ internal static int OpenStream(CallbackReadStream stream, int format, NativeOpen
                 IExcelWorkbook workbook;
                 if (format == NativeFormat.Csv || (format == NativeFormat.Auto && !IsWorkbookSignature(stream.Peek(8))))
                 {
-                    workbook = Excel.FromCsv(stream, leaveOpen: false, readerOptions.Csv);
+                    workbook = Excel.OpenCsv(stream, leaveOpen: false, readerOptions.Csv ?? CsvReaderOptions.Default);
                 }
                 else
                 {
diff --git a/tests/ExcelReader.Fuzz/Harnesses.cs b/tests/ExcelReader.Fuzz/Harnesses.cs
index 81f1fdb8..5f97c322 100644
--- a/tests/ExcelReader.Fuzz/Harnesses.cs
+++ b/tests/ExcelReader.Fuzz/Harnesses.cs
@@ -315,7 +315,7 @@ internal static void Csv(ReadOnlySpan<byte> data)
             FuzzOracle.Guard(() =>
             {
                 using var ms = new MemoryStream(bytes, writable: false);
-                using CsvReader reader = Excel.FromCsv(ms, leaveOpen: true, CsvLimits);
+                using CsvReader reader = Excel.FromCsv(ms, leaveOpen: true, Limits);
                 DrainRows(reader.FirstSheet);
             });
         }
@@ -327,7 +327,7 @@ internal static void CsvSniff(ReadOnlySpan<byte> data)
             {
                 CsvDialect dialect = CsvSniffer.Detect(bytes);
                 using var ms = new MemoryStream(bytes, writable: false);
-                using CsvReader reader = Excel.FromCsv(ms, leaveOpen: true, CsvLimits.WithDialect(dialect));
+                using CsvReader reader = Excel.FromCsv(ms, leaveOpen: true, Limits with { Csv = CsvReaderOptions.Default.WithDialect(dialect) });
                 DrainRows(reader.FirstSheet);
             });
         }
@@ -396,7 +396,7 @@ internal static void CsvParallel(ReadOnlySpan<byte> data)
 
         private static List<string> ParseSequential(byte[] bytes)
         {
-            using CsvReader reader = Excel.FromCsv(bytes, CsvLimits);
+            using CsvReader reader = Excel.FromCsv(bytes, Limits);
             var rows = new List<string>();
             foreach (FuzzRow row in ExcelParser.FromAttributes<FuzzRow>().Parse(reader.FirstSheet))
             {
diff --git a/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs b/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
index eb3f5c86..2d55a3a5 100644
--- a/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
+++ b/tests/ExcelReader.Tests/Native/CsvAggregateNativeTests.cs
@@ -136,7 +136,7 @@ public void AggregateCsvMemory_Should_Clear_A_Previous_Error_On_Success()
 
         private static Row FirstRowOf(string csv)
         {
-            CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes(csv), CsvReaderOptions.Default);
+            CsvReader reader = Excel.FromCsv(Encoding.UTF8.GetBytes(csv), new ExcelReaderOptions { Csv = CsvReaderOptions.Default });
             CsvReader.Enumerator rows = reader.FirstSheet.GetEnumerator();
             Assert.True(rows.MoveNext());
             return rows.Current;
diff --git a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
index 960740c3..47f82a13 100644
--- a/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
+++ b/tests/ExcelReader.Tests/Parser/ParallelCsv/ParseCsvParallelTests.cs
@@ -96,7 +96,7 @@ public async Task ANonUtf8EncodingFallsBackAndStillDecodesCorrectly()
             byte[] csv = latin1.GetBytes("Name,Age\nJosé,30\nRenée,41\n");
             var options = new CsvReaderOptions { Encoding = latin1 };
 
-            using CsvReader source = Excel.FromCsv(csv, options);
+            using CsvReader source = Excel.FromCsv(csv, new ExcelReaderOptions { Csv = options });
 
             List<Row> actual = await DrainAsync(
                 SheetParallel.ParseAsync(source.FirstSheet, ExcelParser.FromAttributes<Row>(), options: new SheetParallelOptions { DegreeOfParallelism = 8 }, ct: TestContext.Current.CancellationToken));
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvBlockBoundaryTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvBlockBoundaryTests.cs
index 28d22f04..f09a02ec 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvBlockBoundaryTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvBlockBoundaryTests.cs
@@ -167,10 +167,10 @@ public void QuoteEqualToDelimiterIsRejectedByBothSourcesAlike()
             var options = CsvReaderOptions.Default with { Delimiter = (byte)',', Quote = (byte)',' };
             byte[] bytes = Encoding.UTF8.GetBytes("a,,b,c\n,d,\ne");
 
-            Assert.Throws<ArgumentException>(() => Excel.FromCsv(bytes, options));
+            Assert.Throws<ArgumentException>(() => Excel.FromCsv(bytes, new ExcelReaderOptions { Csv = options }));
 
             using var ms = new MemoryStream(bytes);
-            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: options));
+            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options }));
         }
     }
 }
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
index c8f8f657..39e20d54 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvDialectAndFormatTests.cs
@@ -135,7 +135,7 @@ public void Should_InferDelimiter_When_SniffDialectIsSet()
             string path = WriteTemp("Name;City;Age\nAda;London;36\n");
             try
             {
-                using CsvReader reader = Excel.FromCsvFile(path, CsvReaderOptions.Default with { SniffDialect = true });
+                using CsvReader reader = Excel.FromCsvFile(path, new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
 
                 Assert.Equal(["Ada", "London", "36"], ReadAll(reader.FirstSheet)[1]);
             }
@@ -152,7 +152,7 @@ public void Should_KeepExplicitEncoding_When_SniffingFindsNoByteOrderMark()
             try
             {
                 var options = CsvReaderOptions.Default with { SniffDialect = true, Encoding = Encoding.Latin1 };
-                using CsvReader reader = Excel.FromCsvFile(path, options);
+                using CsvReader reader = Excel.FromCsvFile(path, new ExcelReaderOptions { Csv = options });
 
                 Assert.Equal(["José", "São Paulo"], ReadAll(reader.FirstSheet)[1]);
             }
@@ -174,7 +174,7 @@ public async Task Should_InferDelimiter_When_SniffingOnTheParallelPath()
             try
             {
                 var options = new SheetParallelOptions { DegreeOfParallelism = 4 };
-                using CsvReader reader = Excel.FromCsvFile(path, CsvReaderOptions.Default with { SniffDialect = true });
+                using CsvReader reader = Excel.FromCsvFile(path, new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
 
                 var rows = new List<Person>();
                 await foreach (Person person in SheetParallel.ParseAsync(reader.FirstSheet, ExcelParser.FromAttributes<Person>(), options, ct: TestContext.Current.CancellationToken))
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvLifetimeTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvLifetimeTests.cs
index 551122f0..42a986c9 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvLifetimeTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvLifetimeTests.cs
@@ -127,7 +127,7 @@ public void A_Transcoded_Stream_Serves_Two_Enumerators()
             List<string> expected = Expected();
             using CsvReader reader = Excel.FromCsv(
                 new TrickleStream(BuildCsv(Encoding.Unicode)), leaveOpen: false,
-                new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false });
+                new ExcelReaderOptions { Csv = new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false } });
             using CsvReader.Enumerator first = reader.FirstSheet.GetEnumerator();
             using CsvReader.Enumerator second = reader.FirstSheet.GetEnumerator();
             Assert.Equal(expected, Drain(first), StringComparer.Ordinal);
@@ -213,7 +213,7 @@ public void A_Transcoded_File_Offers_No_Raw_Chunk_Source()
             File.WriteAllBytes(path, BuildCsv(Encoding.Unicode));
             _paths.Add(path);
 
-            using CsvReader utf16 = Excel.FromCsvFile(path, new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false });
+            using CsvReader utf16 = Excel.FromCsvFile(path, new ExcelReaderOptions { Csv = new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false } });
             Assert.False(utf16.TryGetChunkSource(out _));
 
             using CsvReader utf8 = Excel.FromCsvFile(path);
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
index 74739c0b..771f6e33 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReaderTests.cs
@@ -292,24 +292,32 @@ public async Task QuotedFieldSplitAcrossBufferBoundaryIsHandledAsync()
         public void FieldExceedingMaxCellBytesThrows()
         {
             using var ms = Csv("a," + new string('x', 128 * 1024) + ",c\n");
-            var options = new CsvReaderOptions { MaxCellBytes = 1024 };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { MaxCellBytes = 1024 });
             using CsvReader.Enumerator e = reader.FirstSheet.GetEnumerator();
 
             ExcelLimitExceededException ex = Assert.Throws<ExcelLimitExceededException>(() => e.MoveNext());
-            Assert.Equal(nameof(CsvReaderOptions.MaxCellBytes), ex.LimitName);
+            Assert.Equal(nameof(ExcelReaderOptions.MaxCellBytes), ex.LimitName);
+        }
+
+        [Fact]
+        public void OpenAppliesTheReaderLimitsToCsv()
+        {
+            using var ms = Csv("a," + new string('x', 128 * 1024) + ",c\n");
+            using IExcelWorkbook reader = Excel.Open(ms, ExcelFileFormat.Csv, options: new ExcelReaderOptions { MaxCellBytes = 1024 });
+            using IExcelRowEnumerator e = reader.FirstSheet.GetEnumerator();
+
+            Assert.Throws<ExcelLimitExceededException>(() => e.MoveNext());
         }
 
         [Fact]
         public void EmptyFieldsExceedingMaxCellBytesThrows()
         {
             using var ms = Csv(new string(',', 32));
-            var options = new CsvReaderOptions { MaxCellBytes = 1024 };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { MaxCellBytes = 1024 });
             using CsvReader.Enumerator e = reader.FirstSheet.GetEnumerator();
 
             ExcelLimitExceededException ex = Assert.Throws<ExcelLimitExceededException>(() => e.MoveNext());
-            Assert.Equal(nameof(CsvReaderOptions.MaxCellBytes), ex.LimitName);
+            Assert.Equal(nameof(ExcelReaderOptions.MaxCellBytes), ex.LimitName);
         }
 
         [Fact]
@@ -317,7 +325,7 @@ public void SemicolonDelimiterIsRespected()
         {
             using var ms = Csv("a;b;c\n");
             var options = new CsvReaderOptions { Delimiter = (byte)';' };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options });
 
             var rows = ReadAll(reader);
 
@@ -329,7 +337,7 @@ public void TabDelimiterIsRespected()
         {
             using var ms = Csv("a\tb\tc\n");
             var options = new CsvReaderOptions { Delimiter = (byte)'\t' };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options });
 
             var rows = ReadAll(reader);
 
@@ -375,7 +383,7 @@ public void DelimiterEqualToQuoteThrows()
             using var ms = Csv("a,b\n");
             var options = new CsvReaderOptions { Delimiter = (byte)'"' };
 
-            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: options));
+            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options }));
         }
 
         [Fact]
@@ -487,7 +495,7 @@ public void BomDetectionCanBeDisabled()
             byte[] body = Encoding.UTF8.GetBytes("a,b\n");
             using var ms = new MemoryStream([.. bom, .. body]);
             var options = new CsvReaderOptions { DetectEncodingFromByteOrderMark = false };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options });
 
             var rows = ReadAll(reader);
 
@@ -501,7 +509,7 @@ public async Task BomDetectionCanBeDisabledAsync()
             byte[] body = Encoding.UTF8.GetBytes("a,b\n");
             using var ms = new MemoryStream([.. bom, .. body]);
             var options = new CsvReaderOptions { DetectEncodingFromByteOrderMark = false };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options });
 
             var rows = await ReadAllAsync(reader);
 
@@ -514,7 +522,7 @@ public void NonUtf8EncodingIsTranscoded()
             byte[] latin1Bytes = Encoding.Latin1.GetBytes("nome,cidade\nGabriel,São Paulo\n");
             using var ms = new MemoryStream(latin1Bytes);
             var options = new CsvReaderOptions { Encoding = Encoding.Latin1 };
-            using var reader = Excel.FromCsv(ms, options: options);
+            using var reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options });
 
             var rows = ReadAll(reader);
 
@@ -529,7 +537,7 @@ public void DelimiterAsLineTerminatorThrows(byte delimiter)
             using var ms = Csv("a,b\n");
             var options = new CsvReaderOptions { Delimiter = delimiter };
 
-            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: options));
+            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options }));
         }
 
         [Theory]
@@ -540,7 +548,7 @@ public void QuoteAsLineTerminatorThrows(byte quote)
             using var ms = Csv("a,b\n");
             var options = new CsvReaderOptions { Quote = quote };
 
-            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: options));
+            Assert.Throws<ArgumentException>(() => Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = options }));
         }
 
 
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
index 4d7e5367..b67e0ffc 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
@@ -71,7 +71,7 @@ public void A_Transcoded_NonSeekable_Stream_Is_Replayed_Too()
             using NonSeekableStream stream = new(BuildCsv(rows, Encoding.Unicode));
             using CsvReader reader = Excel.FromCsv(
                 stream, leaveOpen: false,
-                new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false });
+                new ExcelReaderOptions { Csv = new CsvReaderOptions { Encoding = Encoding.Unicode, DetectEncodingFromByteOrderMark = false } });
 
             Excel.InferSchema(reader.FirstSheet);
 
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvSnifferTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvSnifferTests.cs
index b4620e2a..6820038a 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvSnifferTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvSnifferTests.cs
@@ -177,7 +177,7 @@ public void SniffedDialectRoundTripsThroughReader()
             byte[] data = Bytes("nome;idade\nAna;30\nBia;25\n");
             CsvDialect dialect = CsvSniffer.Detect(data);
             CsvReaderOptions options = CsvReaderOptions.Default.WithDialect(dialect);
-            using var reader = Excel.FromCsv(data, options);
+            using var reader = Excel.FromCsv(data, new ExcelReaderOptions { Csv = options });
             using CsvReader.Enumerator e = reader.FirstSheet.GetEnumerator();
 
             Assert.True(e.MoveNext());
diff --git a/tests/ExcelReader.Tests/Reader/FileOwnershipTests.cs b/tests/ExcelReader.Tests/Reader/FileOwnershipTests.cs
index e0db4145..f680d5d7 100644
--- a/tests/ExcelReader.Tests/Reader/FileOwnershipTests.cs
+++ b/tests/ExcelReader.Tests/Reader/FileOwnershipTests.cs
@@ -79,10 +79,10 @@ private async Task Open(string entryPoint)
                     Excel.FromXlsbFile(_path).Dispose();
                     break;
                 case "FromCsvFile":
-                    Excel.FromCsvFile(_path, DelimiterEqualsQuote).Dispose();
+                    Excel.FromCsvFile(_path, new ExcelReaderOptions { Csv = DelimiterEqualsQuote }).Dispose();
                     break;
                 case "FromCsvFileAsync":
-                    (await Excel.FromCsvFileAsync(_path, DelimiterEqualsQuote)).Dispose();
+                    (await Excel.FromCsvFileAsync(_path, new ExcelReaderOptions { Csv = DelimiterEqualsQuote })).Dispose();
                     break;
                 default:
                     (await Excel.FromCsvFileAsync(_path, ct: new CancellationToken(canceled: true))).Dispose();
diff --git a/tests/ExcelReader.Tests/Reader/Utf8StringCacheTests.cs b/tests/ExcelReader.Tests/Reader/Utf8StringCacheTests.cs
index cf354554..6ed9cf32 100644
--- a/tests/ExcelReader.Tests/Reader/Utf8StringCacheTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Utf8StringCacheTests.cs
@@ -95,9 +95,8 @@ public void CsvInternStringsDefaultsToFalse()
         [Fact]
         public void CsvInternStringsTrueEnablesDedupAcrossRows()
         {
-            var options = new CsvReaderOptions { InternStrings = true };
             using MemoryStream ms = new(Encoding.UTF8.GetBytes("alpha,1\nalpha,2\nbeta,3\n"));
-            using CsvReader reader = Excel.FromCsv(ms, options: options);
+            using CsvReader reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { InternStrings = true });
             using CsvReader.Enumerator e = reader.FirstSheet.GetEnumerator();
 
             Assert.True(e.MoveNext());
diff --git a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterOptionsTests.cs b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterOptionsTests.cs
index e5c17422..091eb792 100644
--- a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterOptionsTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterOptionsTests.cs
@@ -80,7 +80,7 @@ public void Should_RoundTripThroughTheReader_When_BothAreGivenTheSameDialect()
             });
 
             var options = CsvReaderOptions.Default with { Delimiter = (byte)';', Encoding = Encoding.Latin1 };
-            using CsvReader reader = Excel.FromCsv(written.AsMemory(), options);
+            using CsvReader reader = Excel.FromCsv(written.AsMemory(), new ExcelReaderOptions { Csv = options });
             using CsvReader.Enumerator rows = reader.FirstSheet.GetEnumerator();
 
             Assert.True(rows.MoveNext());
diff --git a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
index 63e027f1..dc608a88 100644
--- a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
@@ -246,7 +246,7 @@ public void NumericFieldContainingQuoteByteIsEscaped()
             }
             ms.Position = 0;
 
-            using IExcelWorkbook reader = Excel.FromCsv(ms, options: new CsvReaderOptions { Quote = (byte)'5' });
+            using IExcelWorkbook reader = Excel.FromCsv(ms, options: new ExcelReaderOptions { Csv = new CsvReaderOptions { Quote = (byte)'5' } });
             using IExcelRowEnumerator e = reader.FirstSheet.GetEnumerator();
             Assert.True(e.MoveNext());
             Assert.Equal("155", e.Current[0].GetString());

From 3f9fff875d7c3a7a320c5a4667db736a7f2a92ac Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:42:05 -0300
Subject: [PATCH 089/115] docs: list the v7 options and converter-context
 changes in the migration guide

---
 docs/guide/migrating-to-v7.md | 48 +++++++++++++++++++++++++++++++----
 1 file changed, 43 insertions(+), 5 deletions(-)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 32716cfe..7e542feb 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -1,6 +1,6 @@
 # Migrating from v6 to v7
 
-What changed in parallel reading and how to port v6 code.
+What changed in parallel reading and in the rest of the public API, and how to port v6 code.
 See also [reading.md](reading.md#parallel-reading-opt-in) for the full guide.
 
 ## What changed
@@ -32,7 +32,7 @@ await foreach (Sale s in CsvParallel.ParseAsync(path, parser, new CsvParallelOpt
 }
 
 // v7
-using CsvReader csv = Excel.FromCsvFile(path, options);
+using CsvReader csv = Excel.FromCsvFile(path, new ExcelReaderOptions { Csv = options });
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
@@ -49,7 +49,7 @@ await foreach (Sale s in CsvParallel.ParseAsync(data, parser, new CsvParallelOpt
 }
 
 // v7
-using CsvReader csv = Excel.FromCsv(data, options);
+using CsvReader csv = Excel.FromCsv(data, new ExcelReaderOptions { Csv = options });
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
@@ -66,7 +66,7 @@ await foreach (Sale s in CsvParallel.ParseAsync(stream, parser, new CsvParallelO
 }
 
 // v7
-using CsvReader csv = Excel.FromCsv(stream, leaveOpen: true, options);
+using CsvReader csv = Excel.FromCsv(stream, leaveOpen: true, new ExcelReaderOptions { Csv = options });
 await foreach (Sale s in SheetParallel.ParseAsync(csv.FirstSheet, parser, new SheetParallelOptions { DegreeOfParallelism = 8 }))
 {
     Total += s.Revenue;
@@ -86,14 +86,52 @@ await foreach (Sale s in SheetParallel.ParseAsync(workbook.FirstSheet, parser, n
 ## Behavior changes
 
 - The caller owns the workbook and keeps it open until the task completes or the enumeration ends. v6 opened and closed its own source.
-- The CSV dialect is given when the workbook is opened (`CsvReaderOptions`), not in the parallel options.
+- The CSV dialect is given when the workbook is opened (`ExcelReaderOptions.Csv`), not in the parallel options.
 - A CSV in a `MemoryStream` is no longer partitioned: the stream overload of `Excel.FromCsv` reads it sequentially. Pass the bytes as `ReadOnlyMemory<byte>` to keep partitioning.
 - `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from `ExcelParserOptions.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`; the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
 - XLSX and XLSB sheets are now read on several threads when `DegreeOfParallelism` allows it. XLS, a table view (`ExcelTable.AsSheet()`), a sheet under 256 KB uncompressed and a CSV that cannot be partitioned still read sequentially with the same results.
 - `PrefetchDecompression` does not apply to a parallel XLSX or XLSB read; the pipeline already overlaps inflate and parse.
 
+## Other breaking changes
+
+These changes replace positional parameters and loose arguments with types that can grow without another break.
+
+| v6 | v7 |
+|---|---|
+| `ExcelParserConfig` | `ExcelParserOptions`; the `ExcelParser` factories' parameter is `options` |
+| `IExcelCellConverter<T>.TryConvert(in Cell, bool isDate1904, IFormatProvider provider, out T)` | `TryConvert(in Cell, in ExcelRowContext context, out T)` |
+| `ExcelCellReader<T>`, `ExcelRowParser<T>`, `ExcelCellReaders.*`: `(…, bool isDate1904, IFormatProvider provider, …)` | `(…, in ExcelRowContext context, …)` |
+| `Excel.InferSchema(sheet, headerRow, sampleSize, parseText)` | `Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = …, SampleSize = …, ParseText = … })` |
+| `new ExcelDataReader(sheet, headerRow)` | `new ExcelDataReader(sheet, new ExcelDataReaderOptions { HeaderRow = … })` |
+| `sheet.ToArrowRecordBatch(schema, headerRow)` | `sheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = … })` |
+| `WriteRecordBatch(batch, sheetName, writeHeader)` and the async form | `WriteRecordBatch(batch, new ArrowWriteOptions { SheetName = …, WriteHeader = … })` |
+| `XlsWorkbookWriter.Create(stream, leaveOpen, date1904)` | `XlsWorkbookWriter.Create(stream, leaveOpen, new XlsWriterOptions { Date1904 = … })` |
+| `Excel.FromCsv*(…, CsvReaderOptions options)` | `Excel.FromCsv*(…, new ExcelReaderOptions { Csv = options })` |
+| `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | `ExcelReaderOptions.MaxCellBytes`, `ExcelReaderOptions.InternStrings` |
+
+A converter reads the date system and culture from the context:
+
+```csharp
+// v6
+public bool TryConvert(in Cell cell, bool isDate1904, IFormatProvider provider, out decimal value)
+    => decimal.TryParse(cell.GetString(), NumberStyles.Currency, provider, out value);
+
+// v7
+public bool TryConvert(in Cell cell, in ExcelRowContext context, out decimal value)
+    => decimal.TryParse(cell.GetString(), NumberStyles.Currency, context.FormatProvider, out value);
+```
+
+To unit-test a converter, build the context with an initializer: `new ExcelRowContext { IsDate1904 = false, FormatProvider = CultureInfo.InvariantCulture }`.
+
+Two behavior changes come with them:
+
+- `Excel.Open` with `ExcelFileFormat.Csv` now applies `ExcelReaderOptions.MaxCellBytes` and `InternStrings`. v6 ignored both and used the CSV defaults.
+- `XlsxWriterOptions` gains `Date1904`, which v6 lacked. It defaults to `false`, so existing output is unchanged.
+
 ## Native bindings
 
 The C ABI is unchanged: no signature moved, and `XL_ABI_VERSION` stays 6. Behavior changed. `degree_of_parallelism` of `0` on `xl_parse_typed` and the Arrow exports now parallelises XLSX and XLSB as well as CSV, using every processor. Pass `1` for the old sequential behavior. The Rust, Python and C++ bindings take the same value (`degree_of_parallelism`, `parallelism`) and need no code change; a `parallelism=0` call on an XLSX or XLSB sheet is now faster, and holds every partition's columns until they merge, so its peak memory is higher.
 
+`xl_write_options.date1904` now applies to XLSX as well as XLSB and XLS; v6 ignored it for XLSX.
+
 `xl_csv_aggregate` keeps its signature. Inside, it opens a `CsvReader` with the dialect from the native struct and calls `SheetParallel`.

From 1cc50aeed12f44c8476578feab9792a150cf67cb Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:48:29 -0300
Subject: [PATCH 090/115] refactor!: return the inferred schema as
 IReadOnlyList<ExcelColumnSchema>

Matches ArrowReadOptions.Schema and stops handing callers a mutable array.
---
 docs/guide/migrating-to-v7.md                          |  2 +-
 src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt |  2 +-
 src/ExcelReader.Core/Reader/Excel.cs                   |  2 +-
 tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs  |  8 ++++----
 tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs   |  2 +-
 tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs | 10 +++++-----
 tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs   |  6 +++---
 .../Reader/Tables/TableBindingTests.cs                 |  4 ++--
 8 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 7e542feb..1149878b 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -101,7 +101,7 @@ These changes replace positional parameters and loose arguments with types that
 | `ExcelParserConfig` | `ExcelParserOptions`; the `ExcelParser` factories' parameter is `options` |
 | `IExcelCellConverter<T>.TryConvert(in Cell, bool isDate1904, IFormatProvider provider, out T)` | `TryConvert(in Cell, in ExcelRowContext context, out T)` |
 | `ExcelCellReader<T>`, `ExcelRowParser<T>`, `ExcelCellReaders.*`: `(…, bool isDate1904, IFormatProvider provider, …)` | `(…, in ExcelRowContext context, …)` |
-| `Excel.InferSchema(sheet, headerRow, sampleSize, parseText)` | `Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = …, SampleSize = …, ParseText = … })` |
+| `Excel.InferSchema(sheet, headerRow, sampleSize, parseText)` returning `ExcelColumnSchema[]` | `Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = …, SampleSize = …, ParseText = … })` returning `IReadOnlyList<ExcelColumnSchema>` |
 | `new ExcelDataReader(sheet, headerRow)` | `new ExcelDataReader(sheet, new ExcelDataReaderOptions { HeaderRow = … })` |
 | `sheet.ToArrowRecordBatch(schema, headerRow)` | `sheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = … })` |
 | `WriteRecordBatch(batch, sheetName, writeHeader)` and the async form | `WriteRecordBatch(batch, new ArrowWriteOptions { SheetName = …, WriteHeader = … })` |
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index 71ce2edc..c0fabc56 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -83,7 +83,6 @@ ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.ParseText.init -> void
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.get -> int
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.init -> void
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SchemaInferenceOptions() -> void
-static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.SchemaInferenceOptions? options = null) -> ExcelReader.Core.Reader.Schema.ExcelColumnSchema[]!
 static ExcelReader.Core.Reader.ExcelDataReaderOptions.Default.get -> ExcelReader.Core.Reader.ExcelDataReaderOptions!
 static ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.Default.get -> ExcelReader.Core.Reader.Schema.SchemaInferenceOptions!
 ExcelReader.Core.Writer.Xls.XlsWriterOptions
@@ -106,3 +105,4 @@ static ExcelReader.Core.Reader.Excel.FromCsv(System.ReadOnlyMemory<byte> data, E
 static ExcelReader.Core.Reader.Excel.FromCsvAsync(System.IO.Stream! stream, bool leaveOpen = true, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
 static ExcelReader.Core.Reader.Excel.FromCsvFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
 static ExcelReader.Core.Reader.Excel.FromCsvFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
+static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.SchemaInferenceOptions? options = null) -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.Schema.ExcelColumnSchema>!
diff --git a/src/ExcelReader.Core/Reader/Excel.cs b/src/ExcelReader.Core/Reader/Excel.cs
index ccfca244..76ebff13 100644
--- a/src/ExcelReader.Core/Reader/Excel.cs
+++ b/src/ExcelReader.Core/Reader/Excel.cs
@@ -294,7 +294,7 @@ public static async ValueTask<CsvReader> FromCsvAsync(Stream stream, bool leaveO
         /// <see cref="SchemaInferenceOptions.SampleSize"/> is not positive.</exception>
         /// <exception cref="ArgumentException">The sheet has fewer rows than <see cref="SchemaInferenceOptions.HeaderRow"/>.</exception>
         /// <exception cref="InvalidOperationException"><see cref="SchemaInferenceOptions.HeaderRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
-        public static ExcelColumnSchema[] InferSchema(IExcelSheet sheet, SchemaInferenceOptions? options = null)
+        public static IReadOnlyList<ExcelColumnSchema> InferSchema(IExcelSheet sheet, SchemaInferenceOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(sheet);
             options ??= SchemaInferenceOptions.Default;
diff --git a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
index 07ef7aa8..068b20ba 100644
--- a/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
+++ b/tests/ExcelReader.Tests/Arrow/ArrowConversionTests.cs
@@ -227,14 +227,14 @@ public void ToArrowRecordBatch_Should_Match_The_Native_Arrow_Path_On_RealExcel()
             string path = Path.Combine(AppContext.BaseDirectory, "data", "RealExcel.xlsb");
 
             using IExcelWorkbook managedReader = Excel.Open(path);
-            ExcelColumnSchema[] schema = Excel.InferSchema(managedReader.FirstSheet);
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(managedReader.FirstSheet);
             RecordBatch managedBatch = managedReader.FirstSheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = 1 });
 
             Assert.Equal(NativeStatus.Ok, NativeApiTests.OpenPath(path, NativeFormat.Xlsb, out NativeHandle? handle));
             try
             {
-                NativeColumnSpec[] specs = new NativeColumnSpec[schema.Length];
-                for (int i = 0; i < schema.Length; i++)
+                NativeColumnSpec[] specs = new NativeColumnSpec[schema.Count];
+                for (int i = 0; i < schema.Count; i++)
                 {
                     specs[i] = new NativeColumnSpec
                     {
@@ -249,7 +249,7 @@ public void ToArrowRecordBatch_Should_Match_The_Native_Arrow_Path_On_RealExcel()
                 try
                 {
                     Assert.Equal(managedBatch.Length, nativeArray.Length);
-                    for (int i = 0; i < schema.Length; i++)
+                    for (int i = 0; i < schema.Count; i++)
                     {
                         ArrowArray nativeColumn = NativeApiTests.ArrowChildArray(nativeArray, i);
                         Assert.Equal(nativeColumn.Length, managedBatch.Column(i).Length);
diff --git a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
index b67e0ffc..e68f5592 100644
--- a/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Csv/CsvReplayTests.cs
@@ -44,7 +44,7 @@ public void A_Schema_Inferred_From_A_NonSeekable_Stream_Leaves_Every_Row_To_Read
             using NonSeekableStream stream = new(BuildCsv(rows));
             using CsvReader reader = Excel.FromCsv(stream);
 
-            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
 
             Assert.Equal(["name", "value"], schema.Select(c => c.Name), StringComparer.Ordinal);
             Assert.Equal(ExcelColumnType.Int64Column, schema[1].Type);
diff --git a/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs b/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
index 3ba9cda7..d9ca2f9e 100644
--- a/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SchemaInferenceTests.cs
@@ -45,9 +45,9 @@ private static ExcelColumnSchema[] InferFromXlsx(string sheetRows, int headerRow
             return SchemaInference.Infer(rows, isDate1904: false, headerRow, sampleSize, parseText);
         }
 
-        private static ExcelColumnType[] TypesOf(ExcelColumnSchema[] schema)
+        private static ExcelColumnType[] TypesOf(IReadOnlyList<ExcelColumnSchema> schema)
         {
-            return Array.ConvertAll(schema, column => column.Type);
+            return [.. schema.Select(column => column.Type)];
         }
 
         private static string FixtureCsv()
@@ -67,7 +67,7 @@ public void InferSchema_Should_Type_The_Fixture_Csv_When_Parsing_Text()
         {
             using CsvReader reader = Excel.FromCsvFile(FixtureCsv());
 
-            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(reader.FirstSheet, new SchemaInferenceOptions { ParseText = true });
 
             ExcelColumnType s = ExcelColumnType.StringColumn, d = ExcelColumnType.DateColumn,
                 i = ExcelColumnType.Int64Column, f = ExcelColumnType.Float64Column;
@@ -292,11 +292,11 @@ public void Should_SampleAtMostSampleSizeRows_When_TheSheetIsLonger()
         public void Should_InferAcrossEveryFormat_When_CalledThroughTheExcelFacade()
         {
             using IExcelWorkbook reader = Excel.Open(Path.Combine("data", "RealExcel.xlsb"));
-            ExcelColumnSchema[] schema = Excel.InferSchema(reader.FirstSheet);
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(reader.FirstSheet);
 
             Assert.NotEmpty(schema);
             Assert.All(schema, column => Assert.True(column.Index >= 0));
-            for (int i = 0; i < schema.Length; i++)
+            for (int i = 0; i < schema.Count; i++)
             {
                 Assert.Equal(i, schema[i].Index);
             }
diff --git a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
index caee015e..28a9c550 100644
--- a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
@@ -158,11 +158,11 @@ public void One_Parse_Result_Can_Be_Enumerated_Twice_And_Sheets_Stay_Independent
         public void InferSchema_Samples_The_Sheet_It_Is_Given()
         {
             using XlsxWorkbook workbook = Excel.FromXlsx(BuildXlsx());
-            ExcelColumnSchema[] schema = Excel.InferSchema(workbook.Sheets[1]);
-            Assert.Equal(2, schema.Length);
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(workbook.Sheets[1]);
+            Assert.Equal(2, schema.Count);
             Assert.Equal("Name", schema[0].Name);
             Assert.Equal(ExcelColumnType.Int64Column, schema[1].Type);
-            Assert.Equal(schema.Length, Excel.InferSchema(workbook.Sheets[1], new SchemaInferenceOptions { SampleSize = 5 }).Length);
+            Assert.Equal(schema.Count, Excel.InferSchema(workbook.Sheets[1], new SchemaInferenceOptions { SampleSize = 5 }).Count);
             Assert.Throws<ArgumentNullException>(() => Excel.InferSchema((IExcelSheet)null!));
         }
 
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
index 633b4ba8..e4fa5500 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
@@ -90,7 +90,7 @@ public void HeaderlessTableReadsWithoutAHeader(string file)
             }
 
             Assert.Equal(["a", "b", "c"], letters);
-            Assert.Equal(2, Excel.InferSchema(view, new SchemaInferenceOptions { HeaderRow = 0 }).Length);
+            Assert.Equal(2, Excel.InferSchema(view, new SchemaInferenceOptions { HeaderRow = 0 }).Count);
         }
 
         [Theory]
@@ -130,7 +130,7 @@ public void InferSchemaDropsColumnsLeftOfTheTableAndKeepsAbsoluteIndexes(string
         {
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
 
-            ExcelColumnSchema[] schema = Excel.InferSchema(Table(workbook, "Sales").AsSheet());
+            IReadOnlyList<ExcelColumnSchema> schema = Excel.InferSchema(Table(workbook, "Sales").AsSheet());
 
             Assert.Equal([("Product", 2), ("Qty", 3), ("Price", 4)], schema.Select(static c => (c.Name, c.Index)));
         }

From b2891ff190ace99e15a3f8f04bb50980d398ae06 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:50:30 -0300
Subject: [PATCH 091/115] refactor!: remove Cell.TryGetDateTime(out DateTime),
 which assumed the 1900 date system

A cell does not know its workbook's date system, so the overload silently returned dates
four years early for a 1904 workbook. Callers now pass IsDate1904. The CLI convert command
had exactly that bug and now passes the sheet's date system.
---
 docs/guide/migrating-to-v7.md                 |  2 +
 src/ExcelReader.Cli/CliCommands.cs            |  2 +-
 .../PublicAPI/PublicAPI.Shipped.txt           |  1 -
 src/ExcelReader.Core/Reader/Cell.cs           | 12 ------
 .../Read/CsvReadBenchmark.cs                  |  2 +-
 .../Shared/BenchmarkAccumulators.cs           |  4 +-
 tests/ExcelReader.Tests/Cli/CliTests.cs       | 39 +++++++++++++++++++
 .../Reader/CellVariantTests.cs                | 10 ++---
 .../ExcelReader.Tests/Reader/FastDateTests.cs |  4 +-
 tests/ExcelReader.Tests/Reader/SampleTest.cs  |  6 +--
 .../Reader/Xls/XlsWorkbookTests.cs            |  2 +-
 .../Reader/Xlsx/RealWorldXlsxCorpusTests.cs   |  6 +--
 .../Writer/Csv/CsvWriterTests.cs              |  2 +-
 .../Writer/Xls/XlsWriterTests.cs              |  4 +-
 .../Writer/Xlsb/XlsbWriterTests.cs            |  2 +-
 15 files changed, 63 insertions(+), 35 deletions(-)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 1149878b..bf55f019 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -108,6 +108,7 @@ These changes replace positional parameters and loose arguments with types that
 | `XlsWorkbookWriter.Create(stream, leaveOpen, date1904)` | `XlsWorkbookWriter.Create(stream, leaveOpen, new XlsWriterOptions { Date1904 = … })` |
 | `Excel.FromCsv*(…, CsvReaderOptions options)` | `Excel.FromCsv*(…, new ExcelReaderOptions { Csv = options })` |
 | `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | `ExcelReaderOptions.MaxCellBytes`, `ExcelReaderOptions.InternStrings` |
+| `Cell.TryGetDateTime(out DateTime)`, which silently assumed the 1900 date system | `Cell.TryGetDateTime(workbook.IsDate1904, out DateTime)` |
 
 A converter reads the date system and culture from the context:
 
@@ -126,6 +127,7 @@ To unit-test a converter, build the context with an initializer: `new ExcelRowCo
 Two behavior changes come with them:
 
 - `Excel.Open` with `ExcelFileFormat.Csv` now applies `ExcelReaderOptions.MaxCellBytes` and `InternStrings`. v6 ignored both and used the CSV defaults.
+- The CLI `convert` command no longer shifts dates by four years when the source workbook uses the 1904 date system.
 - `XlsxWriterOptions` gains `Date1904`, which v6 lacked. It defaults to `false`, so existing output is unchanged.
 
 ## Native bindings
diff --git a/src/ExcelReader.Cli/CliCommands.cs b/src/ExcelReader.Cli/CliCommands.cs
index ca914cfa..8f1833d8 100644
--- a/src/ExcelReader.Cli/CliCommands.cs
+++ b/src/ExcelReader.Cli/CliCommands.cs
@@ -170,7 +170,7 @@ private static void WriteRows<TWorkbook, TSheet, TRow>(TWorkbook workbook, IExce
                             }
                             break;
                         case CellType.Date:
-                            var dateValue = cellValue.TryGetDateTime(out var date) ? date : throw new InvalidOperationException($"cell {cell.ColumnIndex} is a date but TryGetDateTime failed to parse it.");
+                            var dateValue = cellValue.TryGetDateTime(sheet.IsDate1904, out var date) ? date : throw new InvalidOperationException($"cell {cell.ColumnIndex} is a date but TryGetDateTime failed to parse it.");
                             row.Write(dateValue);
                             break;
                         default:
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index f30f97e8..3a15a7d9 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -98,7 +98,6 @@ ExcelReader.Core.Reader.Cell.GetString() -> string!
 ExcelReader.Core.Reader.Cell.StyleIndex.get -> int
 ExcelReader.Core.Reader.Cell.TryFormat(System.Span<byte> destination, out int bytesWritten) -> bool
 ExcelReader.Core.Reader.Cell.TryGetDateTime(bool isDate1904, out System.DateTime result) -> bool
-ExcelReader.Core.Reader.Cell.TryGetDateTime(out System.DateTime result) -> bool
 ExcelReader.Core.Reader.Cell.TryGetDouble(out double value) -> bool
 ExcelReader.Core.Reader.Cell.TryParse<T>(System.IFormatProvider? provider, out T result) -> bool
 ExcelReader.Core.Reader.Cell.Type.get -> ExcelReader.Core.Reader.CellType
diff --git a/src/ExcelReader.Core/Reader/Cell.cs b/src/ExcelReader.Core/Reader/Cell.cs
index 27ec5356..92e6d66e 100644
--- a/src/ExcelReader.Core/Reader/Cell.cs
+++ b/src/ExcelReader.Core/Reader/Cell.cs
@@ -271,18 +271,6 @@ private static bool UsesDotDecimalSeparator(IFormatProvider provider)
                 || string.Equals(NumberFormatInfo.GetInstance(provider).NumberDecimalSeparator, ".", StringComparison.Ordinal);
         }
 
-        /// <summary>
-        /// Interprets the cell's numeric value as an Excel serial date under the 1900 date system, or,
-        /// when the value is not numeric, parses it as an ISO-8601 date or date-time. Works on any cell,
-        /// not only cells whose <see cref="Type"/> is <see cref="CellType.Date"/> — text formats such as
-        /// CSV carry dates as text rather than serials. Use the
-        /// <see cref="TryGetDateTime(bool, out DateTime)"/> overload for workbooks using the 1904 date system.
-        /// </summary>
-        public bool TryGetDateTime(out DateTime result)
-        {
-            return TryGetDateTime(isDate1904: false, out result);
-        }
-
         /// <summary>
         /// Interprets the cell's numeric value as an Excel serial date, falling back to an ISO-8601
         /// text date (<c>yyyy-MM-dd</c>, optionally followed by <c>T</c> or a space, a time, and up to
diff --git a/tests/ExcelReader.Benchmarks/Read/CsvReadBenchmark.cs b/tests/ExcelReader.Benchmarks/Read/CsvReadBenchmark.cs
index 12a7a87c..eb4f6067 100644
--- a/tests/ExcelReader.Benchmarks/Read/CsvReadBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Read/CsvReadBenchmark.cs
@@ -76,7 +76,7 @@ private static long AccumulateRow(Row row)
             {
                 acc += id;
             }
-            if (row[2].TryGetDateTime(out DateTime date))
+            if (row[2].TryGetDateTime(isDate1904: false, out DateTime date))
             {
                 acc += date.Ticks;
             }
diff --git a/tests/ExcelReader.Benchmarks/Shared/BenchmarkAccumulators.cs b/tests/ExcelReader.Benchmarks/Shared/BenchmarkAccumulators.cs
index 884df90b..5a2f8bc3 100644
--- a/tests/ExcelReader.Benchmarks/Shared/BenchmarkAccumulators.cs
+++ b/tests/ExcelReader.Benchmarks/Shared/BenchmarkAccumulators.cs
@@ -21,7 +21,7 @@ internal static long AccumulateRow(Row row)
                         if (cell.TryParse(null, out double n)) { acc += (long)n; }
                         break;
                     case CellType.Date:
-                        if (cell.TryGetDateTime(out DateTime d)) { acc += d.Ticks; }
+                        if (cell.TryGetDateTime(isDate1904: false, out DateTime d)) { acc += d.Ticks; }
                         break;
                 }
             }
@@ -43,7 +43,7 @@ internal static long AccumulateRowMaterialized(Row row)
                         if (cell.TryParse(null, out double n)) { acc += (long)n; }
                         break;
                     case CellType.Date:
-                        if (cell.TryGetDateTime(out DateTime d)) { acc += d.Ticks; }
+                        if (cell.TryGetDateTime(isDate1904: false, out DateTime d)) { acc += d.Ticks; }
                         break;
                 }
             }
diff --git a/tests/ExcelReader.Tests/Cli/CliTests.cs b/tests/ExcelReader.Tests/Cli/CliTests.cs
index 75c774a6..0643d294 100644
--- a/tests/ExcelReader.Tests/Cli/CliTests.cs
+++ b/tests/ExcelReader.Tests/Cli/CliTests.cs
@@ -284,6 +284,45 @@ public void Should_ConvertToAnotherSpreadsheetFormat_When_OutputExtensionNamesOn
             }
         }
 
+        [Theory]
+        [InlineData("xlsx")]
+        [InlineData("xlsb")]
+        [InlineData("xls")]
+        public void Should_KeepDates_When_ConvertingA1904Workbook(string extension)
+        {
+            var date = new DateTime(2024, 5, 6, 12, 30, 0, DateTimeKind.Unspecified);
+            string source = Path.Combine(Path.GetTempPath(), $"excelreader-cli-{Guid.NewGuid():N}.xlsx");
+            string target = Path.ChangeExtension(source, "out." + extension);
+            try
+            {
+                using (XlsxWorkbookWriter wb = XlsxWorkbookWriter.Create(File.Create(source), options: new XlsxWriterOptions { Date1904 = true }))
+                {
+                    XlsxSheetWriter sheet = wb.AddSheet("S");
+                    using (XlsxRowWriter row = sheet.StartRow())
+                    {
+                        row.Write(date);
+                    }
+                    sheet.End();
+                    wb.End();
+                }
+
+                (int code, _, string error) = Convert(source, output: target);
+
+                Assert.Equal(0, code);
+                Assert.Empty(error);
+                using IExcelWorkbook written = Excel.Open(target);
+                using IExcelRowEnumerator rows = written.FirstSheet.GetEnumerator();
+                Assert.True(rows.MoveNext());
+                Assert.True(rows.Current[0].TryGetDateTime(written.IsDate1904, out DateTime readBack));
+                Assert.Equal(date, readBack);
+            }
+            finally
+            {
+                File.Delete(source);
+                File.Delete(target);
+            }
+        }
+
         [Fact]
         public void Should_UseTheExplicitFormat_When_FormatOverridesTheOutputExtension()
         {
diff --git a/tests/ExcelReader.Tests/Reader/CellVariantTests.cs b/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
index 08ee5612..44f1aac1 100644
--- a/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
+++ b/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
@@ -167,7 +167,7 @@ public async Task TryGetDateTimeOnInlineStringReturnsFalse()
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
             await using var e = reader.FirstSheet.GetEnumerator();
             Assert.True(await e.MoveNextAsync());
-            Assert.False(e.Current[0].TryGetDateTime(out _));
+            Assert.False(e.Current[0].TryGetDateTime(isDate1904: false, out _));
         }
 
         [Fact]
@@ -177,7 +177,7 @@ public async Task TryGetDateTimeOutOfRangeSerialReturnsFalse()
             await using var reader = await Excel.FromXlsxAsync(ms, ct: TestContext.Current.CancellationToken);
             await using var e = reader.FirstSheet.GetEnumerator();
             Assert.True(await e.MoveNextAsync());
-            Assert.False(e.Current[0].TryGetDateTime(out _));
+            Assert.False(e.Current[0].TryGetDateTime(isDate1904: false, out _));
         }
 
         [Fact]
@@ -278,9 +278,9 @@ public void Excel1900SerialsOneToSixtyMapToExcelCalendar()
             using var e = reader.FirstSheet.GetEnumerator();
 
             Assert.True(e.MoveNext());
-            Assert.True(e.Current[0].TryGetDateTime(out DateTime first));
-            Assert.True(e.Current[1].TryGetDateTime(out DateTime leapBoundary));
-            Assert.True(e.Current[2].TryGetDateTime(out DateTime phantomLeapDay));
+            Assert.True(e.Current[0].TryGetDateTime(isDate1904: false, out DateTime first));
+            Assert.True(e.Current[1].TryGetDateTime(isDate1904: false, out DateTime leapBoundary));
+            Assert.True(e.Current[2].TryGetDateTime(isDate1904: false, out DateTime phantomLeapDay));
             Assert.Equal(new DateTime(1900, 1, 1), first);
             Assert.Equal(new DateTime(1900, 2, 28), leapBoundary);
             Assert.Equal(new DateTime(1900, 2, 28), phantomLeapDay);
diff --git a/tests/ExcelReader.Tests/Reader/FastDateTests.cs b/tests/ExcelReader.Tests/Reader/FastDateTests.cs
index b4833bd3..b8edd98e 100644
--- a/tests/ExcelReader.Tests/Reader/FastDateTests.cs
+++ b/tests/ExcelReader.Tests/Reader/FastDateTests.cs
@@ -146,7 +146,7 @@ public void CsvTextDatesAreReadableThroughTryGetDateTime()
                 {
                     if (col == 1)
                     {
-                        Assert.True(rowCell.Value.TryGetDateTime(out DateTime d));
+                        Assert.True(rowCell.Value.TryGetDateTime(isDate1904: false, out DateTime d));
                         dates.Add(d);
                     }
                     col++;
@@ -165,7 +165,7 @@ public void NumericCellsStillReadAsExcelSerials()
 
             foreach (Row row in reader.FirstSheet)
             {
-                Assert.True(row[1].TryGetDateTime(out DateTime d));
+                Assert.True(row[1].TryGetDateTime(isDate1904: false, out DateTime d));
                 Assert.Equal(new DateTime(2024, 3, 15), d);
             }
         }
diff --git a/tests/ExcelReader.Tests/Reader/SampleTest.cs b/tests/ExcelReader.Tests/Reader/SampleTest.cs
index 86e0bddc..590755d9 100644
--- a/tests/ExcelReader.Tests/Reader/SampleTest.cs
+++ b/tests/ExcelReader.Tests/Reader/SampleTest.cs
@@ -135,11 +135,11 @@ public void DetectsDateStylesAndConvertsSerial()
             var row = e.Current;
 
             Assert.Equal(CellType.Date, row[0].Type);
-            Assert.True(row[0].TryGetDateTime(out var d0));
+            Assert.True(row[0].TryGetDateTime(isDate1904: false, out var d0));
             Assert.Equal(new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Unspecified), d0);
 
             Assert.Equal(CellType.Date, row[1].Type);
-            Assert.True(row[1].TryGetDateTime(out var d1));
+            Assert.True(row[1].TryGetDateTime(isDate1904: false, out var d1));
             Assert.Equal(new DateTime(2024, 1, 1, 12, 0, 0, DateTimeKind.Unspecified), d1);
 
             Assert.Equal(CellType.Number, row[2].Type);
@@ -188,7 +188,7 @@ public async Task AsyncHandlesBufferGrowthAndDates()
 
             Assert.True(await e.MoveNextAsync());
             Assert.Equal(CellType.Date, e.Current[0].Type);
-            Assert.True(e.Current[0].TryGetDateTime(out var d));
+            Assert.True(e.Current[0].TryGetDateTime(isDate1904: false, out var d));
             Assert.Equal(new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Unspecified), d);
 
             Assert.True(await e.MoveNextAsync());
diff --git a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
index 5b5c4d54..79fe49be 100644
--- a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
@@ -211,7 +211,7 @@ public void CustomDateFormatMarksDateCells()
             Assert.True(e.MoveNext());
             Assert.True(e.MoveNext());
             Assert.Equal(CellType.Date, e.Current[0].Type);
-            Assert.True(e.Current[0].TryGetDateTime(out DateTime parsed));
+            Assert.True(e.Current[0].TryGetDateTime(isDate1904: false, out DateTime parsed));
             Assert.Equal(date, parsed);
         }
 
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
index 0516f401..a35682eb 100644
--- a/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
@@ -30,19 +30,19 @@ public void ReadsSheetJsGeneratedWorkbook()
             Assert.Equal(CellType.Boolean, e.Current[3].Type);
             Assert.Equal("1", e.Current[3].GetString());
             Assert.Equal(CellType.Date, e.Current[4].Type);
-            Assert.True(e.Current[4].TryGetDateTime(out DateTime restock));
+            Assert.True(e.Current[4].TryGetDateTime(isDate1904: false, out DateTime restock));
             Assert.Equal(new DateTime(2024, 1, 14, 21, 0, 0, DateTimeKind.Unspecified), restock);
 
             Assert.True(e.MoveNext());
             Assert.Equal("Gadget", e.Current[0].GetString());
             Assert.True(e.Current[1].TryParse(null, out int gadgetQty));
             Assert.Equal(0, gadgetQty);
-            Assert.True(e.Current[4].TryGetDateTime(out DateTime gadgetDate));
+            Assert.True(e.Current[4].TryGetDateTime(isDate1904: false, out DateTime gadgetDate));
             Assert.Equal(new DateTime(2024, 2, 29, 21, 0, 0, DateTimeKind.Unspecified), gadgetDate);
 
             Assert.True(e.MoveNext());
             Assert.Equal("Gizmo", e.Current[0].GetString());
-            Assert.True(e.Current[4].TryGetDateTime(out DateTime gizmoDate));
+            Assert.True(e.Current[4].TryGetDateTime(isDate1904: false, out DateTime gizmoDate));
             Assert.Equal(new DateTime(2024, 6, 29, 21, 0, 0, DateTimeKind.Unspecified), gizmoDate);
 
             Assert.False(e.MoveNext());
diff --git a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
index dc608a88..7973709c 100644
--- a/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Csv/CsvWriterTests.cs
@@ -340,7 +340,7 @@ public void WrittenCsvRoundTripsThroughCsvReader()
             Assert.Equal("has, comma", row2[0].GetString());
             Assert.Equal(CellType.ExcelString, row2[1].Type);
             Assert.Equal("true", row2[1].GetString());
-            Assert.True(row2[2].TryGetDateTime(out DateTime readBack));
+            Assert.True(row2[2].TryGetDateTime(isDate1904: false, out DateTime readBack));
             Assert.Equal(date, readBack);
             Assert.Equal(date.ToString("O"), row2[2].GetString());
         }
diff --git a/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs b/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
index b9d80a7c..7fa3c62d 100644
--- a/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Xls/XlsWriterTests.cs
@@ -51,7 +51,7 @@ public async Task RoundTripsAllCellTypes()
             Assert.Equal(CellType.Boolean, e.Current[3].Type);
             Assert.Equal("1", e.Current[3].GetString());
             Assert.Equal(CellType.Date, e.Current[4].Type);
-            Assert.True(e.Current[4].TryGetDateTime(out DateTime parsed));
+            Assert.True(e.Current[4].TryGetDateTime(isDate1904: false, out DateTime parsed));
             Assert.Equal(date, parsed);
             Assert.False(e.MoveNext());
         }
@@ -130,7 +130,7 @@ public async Task NullableAndGenericOverloadsRoundTrip()
             Assert.True(e.MoveNext());
             Assert.Equal(CellType.Boolean, e.Current[0].Type);
             Assert.Equal(CellType.Empty, e.Current[1].Type);
-            Assert.True(e.Current[2].TryGetDateTime(out DateTime parsed));
+            Assert.True(e.Current[2].TryGetDateTime(isDate1904: false, out DateTime parsed));
             Assert.Equal(date, parsed);
             Assert.Equal(CellType.Empty, e.Current[3].Type);
             Assert.True(e.Current[4].TryParse(Inv, out double nullableFloat));
diff --git a/tests/ExcelReader.Tests/Writer/Xlsb/XlsbWriterTests.cs b/tests/ExcelReader.Tests/Writer/Xlsb/XlsbWriterTests.cs
index dc4fd2c4..1e21e32c 100644
--- a/tests/ExcelReader.Tests/Writer/Xlsb/XlsbWriterTests.cs
+++ b/tests/ExcelReader.Tests/Writer/Xlsb/XlsbWriterTests.cs
@@ -205,7 +205,7 @@ public async Task NullableAndGenericOverloadsRoundTrip()
             Assert.True(e.MoveNext());
             Assert.Equal(CellType.Boolean, e.Current[0].Type);
             Assert.Equal(CellType.Empty, e.Current[1].Type);
-            Assert.True(e.Current[2].TryGetDateTime(out DateTime parsed));
+            Assert.True(e.Current[2].TryGetDateTime(isDate1904: false, out DateTime parsed));
             Assert.Equal(date, parsed);
             Assert.Equal(CellType.Empty, e.Current[3].Type);
             Assert.True(e.Current[4].TryParse(null, out double nullableFloat));

From b1f098031fe61c508f0b9abc394c0d70b7cbb649 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:51:54 -0300
Subject: [PATCH 092/115] refactor!: rename ExcelDataReader to SheetDataReader

ExcelDataReader and ExcelDataReaderOptions collided with Sylvan.Data.Excel's types and
with the ExcelDataReader package's namespace, so code importing either needed global::
qualification. SheetDataReaderOptions follows the same rename.
---
 docs/guide/migrating-to-v7.md                 |  3 +-
 docs/guide/reading.md                         | 12 ++---
 docs/performance/benchmarks.md                |  2 +-
 .../PublicAPI/PublicAPI.Shipped.txt           | 34 --------------
 .../PublicAPI/PublicAPI.Unshipped.txt         | 46 ++++++++++++++++---
 ...{ExcelDataReader.cs => SheetDataReader.cs} | 18 ++++----
 ...erOptions.cs => SheetDataReaderOptions.cs} |  6 +--
 .../Interop/DataReaderBenchmark.cs            |  8 ++--
 .../Reader/SheetConsumerTests.cs              |  6 +--
 ...ReaderTests.cs => SheetDataReaderTests.cs} | 44 +++++++++---------
 .../Reader/Tables/TableBindingTests.cs        | 10 ++--
 11 files changed, 95 insertions(+), 94 deletions(-)
 rename src/ExcelReader.Core/Reader/{ExcelDataReader.cs => SheetDataReader.cs} (96%)
 rename src/ExcelReader.Core/Reader/{ExcelDataReaderOptions.cs => SheetDataReaderOptions.cs} (76%)
 rename tests/ExcelReader.Tests/Reader/{ExcelDataReaderTests.cs => SheetDataReaderTests.cs} (90%)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index bf55f019..235c0476 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -102,12 +102,13 @@ These changes replace positional parameters and loose arguments with types that
 | `IExcelCellConverter<T>.TryConvert(in Cell, bool isDate1904, IFormatProvider provider, out T)` | `TryConvert(in Cell, in ExcelRowContext context, out T)` |
 | `ExcelCellReader<T>`, `ExcelRowParser<T>`, `ExcelCellReaders.*`: `(…, bool isDate1904, IFormatProvider provider, …)` | `(…, in ExcelRowContext context, …)` |
 | `Excel.InferSchema(sheet, headerRow, sampleSize, parseText)` returning `ExcelColumnSchema[]` | `Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = …, SampleSize = …, ParseText = … })` returning `IReadOnlyList<ExcelColumnSchema>` |
-| `new ExcelDataReader(sheet, headerRow)` | `new ExcelDataReader(sheet, new ExcelDataReaderOptions { HeaderRow = … })` |
+| `new ExcelDataReader(sheet, headerRow)` | `new SheetDataReader(sheet, new SheetDataReaderOptions { HeaderRow = … })` |
 | `sheet.ToArrowRecordBatch(schema, headerRow)` | `sheet.ToArrowRecordBatch(new ArrowReadOptions { Schema = schema, HeaderRow = … })` |
 | `WriteRecordBatch(batch, sheetName, writeHeader)` and the async form | `WriteRecordBatch(batch, new ArrowWriteOptions { SheetName = …, WriteHeader = … })` |
 | `XlsWorkbookWriter.Create(stream, leaveOpen, date1904)` | `XlsWorkbookWriter.Create(stream, leaveOpen, new XlsWriterOptions { Date1904 = … })` |
 | `Excel.FromCsv*(…, CsvReaderOptions options)` | `Excel.FromCsv*(…, new ExcelReaderOptions { Csv = options })` |
 | `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | `ExcelReaderOptions.MaxCellBytes`, `ExcelReaderOptions.InternStrings` |
+| `ExcelDataReader` (its name collided with Sylvan.Data.Excel and the ExcelDataReader package) | `SheetDataReader` |
 | `Cell.TryGetDateTime(out DateTime)`, which silently assumed the 1900 date system | `Cell.TryGetDateTime(workbook.IsDate1904, out DateTime)` |
 
 A converter reads the date system and culture from the context:
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index 8852fb1a..fcd04718 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -251,11 +251,11 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
   rows; `Ref` is the same range in A1 notation.
 - Column indexes inside `AsSheet()` rows stay those of the sheet: a table starting at column C reports
   its first cell at index 2. `Excel.InferSchema` keeps those indexes in `ExcelColumnSchema.Index` but
-  lists only the table's columns. `ExcelDataReader` ordinals are relative to the table: ordinal 0 is
+  lists only the table's columns. `SheetDataReader` ordinals are relative to the table: ordinal 0 is
   its first column.
 - A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but `Parse` throws
-  `InvalidOperationException` for every map, and `ExcelDataReader` and `InferSchema` throw it when
-  `HeaderRow` is greater than 0. Read it with `new ExcelDataReader(table.AsSheet(), new ExcelDataReaderOptions { HeaderRow = 0 })`,
+  `InvalidOperationException` for every map, and `SheetDataReader` and `InferSchema` throw it when
+  `HeaderRow` is greater than 0. Read it with `new SheetDataReader(table.AsSheet(), new SheetDataReaderOptions { HeaderRow = 0 })`,
   `Excel.InferSchema(table.AsSheet(), new SchemaInferenceOptions { HeaderRow = 0 })`, or by column index on the rows.
 - `StyleName` is the table style's name, such as `TableStyleMedium2`, or `null` when the table has none.
 
@@ -359,20 +359,20 @@ Writing has the same option, under a different name: see
 
 ## Bridge to ADO.NET (`IDataReader`)
 
-`ExcelDataReader` adapts one `IExcelSheet` to `System.Data.IDataReader`, so it drops straight into `SqlBulkCopy`, `DataTable.Load`, Dapper, or any other ADO.NET consumer:
+`SheetDataReader` adapts one `IExcelSheet` to `System.Data.IDataReader`, so it drops straight into `SqlBulkCopy`, `DataTable.Load`, Dapper, or any other ADO.NET consumer:
 
 ```csharp
 using System.Data;
 using ExcelReader.Core.Reader;
 
 using IExcelWorkbook workbook = Excel.Open("report.xlsx");
-using IDataReader data = new ExcelDataReader(workbook.FirstSheet); // header on row 1 by default
+using IDataReader data = new SheetDataReader(workbook.FirstSheet); // header on row 1 by default
 
 var table = new DataTable();
 table.Load(data);
 ```
 
-The header row (1-based, default 1) fixes the column shape; pass `new ExcelDataReaderOptions { HeaderRow = 0 }` for a header-less sheet, whose columns come back named `Column0`, `Column1`, ... sized from the first data row. There is no schema-inference pass — `GetFieldType`/`GetValue`/the typed getters read the *current* row's own cell type, so a consumer building its schema from the first row (like `DataTable.Load`) locks in that row's types for the whole load. `NextResult()` always returns `false`; build one `ExcelDataReader` per sheet instead of chaining result sets.
+The header row (1-based, default 1) fixes the column shape; pass `new SheetDataReaderOptions { HeaderRow = 0 }` for a header-less sheet, whose columns come back named `Column0`, `Column1`, ... sized from the first data row. There is no schema-inference pass — `GetFieldType`/`GetValue`/the typed getters read the *current* row's own cell type, so a consumer building its schema from the first row (like `DataTable.Load`) locks in that row's types for the whole load. `NextResult()` always returns `false`; build one `SheetDataReader` per sheet instead of chaining result sets.
 
 The bridge costs ~1.3–1.4x over iterating rows directly, and `GetBytes` stays within ~10% of the direct read. See [ADO.NET bridge](../performance/benchmarks.md#adonet-bridge-idatareader) in the benchmarks.
 
diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index 58598563..2960ca10 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -253,7 +253,7 @@ Parsing into a `ref struct` with a `ReadOnlySpan<byte>` text column removes esse
 
 ### ADO.NET bridge (`IDataReader`)
 
-`DataReaderBenchmark`: the generated 50,000-row XLSX workbook (header plus four columns) read through [`ExcelDataReader`](../guide/reading.md#bridge-to-adonet-idatareader), against iterating the same rows directly. The reader is held as `IDataReader`, the way `SqlBulkCopy`, `DataTable.Load` and Dapper hold it.
+`DataReaderBenchmark`: the generated 50,000-row XLSX workbook (header plus four columns) read through [`SheetDataReader`](../guide/reading.md#bridge-to-adonet-idatareader), against iterating the same rows directly. The reader is held as `IDataReader`, the way `SqlBulkCopy`, `DataTable.Load` and Dapper hold it.
 
 | Access | Mean | Ratio | Allocated |
 |---|---:|---:|---:|
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 3a15a7d9..9a57304e 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -183,40 +183,6 @@ ExcelReader.Core.Reader.IRowAccumulator<TSelf, TModel>.Merge(TSelf following) ->
 ExcelReader.Core.Reader.IRowRecord<TSelf>
 ExcelReader.Core.Reader.IRowRecord<TSelf>.TryParse(ExcelReader.Core.Reader.Row row, out TSelf record) -> bool
 ExcelReader.Core.Reader.Excel
-ExcelReader.Core.Reader.ExcelDataReader
-ExcelReader.Core.Reader.ExcelDataReader.Close() -> void
-ExcelReader.Core.Reader.ExcelDataReader.Depth.get -> int
-ExcelReader.Core.Reader.ExcelDataReader.Dispose() -> void
-ExcelReader.Core.Reader.ExcelDataReader.FieldCount.get -> int
-ExcelReader.Core.Reader.ExcelDataReader.GetBoolean(int i) -> bool
-ExcelReader.Core.Reader.ExcelDataReader.GetByte(int i) -> byte
-ExcelReader.Core.Reader.ExcelDataReader.GetBytes(int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length) -> long
-ExcelReader.Core.Reader.ExcelDataReader.GetChar(int i) -> char
-ExcelReader.Core.Reader.ExcelDataReader.GetChars(int i, long fieldoffset, char[]? buffer, int bufferoffset, int length) -> long
-ExcelReader.Core.Reader.ExcelDataReader.GetData(int i) -> System.Data.IDataReader!
-ExcelReader.Core.Reader.ExcelDataReader.GetDataTypeName(int i) -> string!
-ExcelReader.Core.Reader.ExcelDataReader.GetDateTime(int i) -> System.DateTime
-ExcelReader.Core.Reader.ExcelDataReader.GetDecimal(int i) -> decimal
-ExcelReader.Core.Reader.ExcelDataReader.GetDouble(int i) -> double
-ExcelReader.Core.Reader.ExcelDataReader.GetFieldType(int i) -> System.Type!
-ExcelReader.Core.Reader.ExcelDataReader.GetFloat(int i) -> float
-ExcelReader.Core.Reader.ExcelDataReader.GetGuid(int i) -> System.Guid
-ExcelReader.Core.Reader.ExcelDataReader.GetInt16(int i) -> short
-ExcelReader.Core.Reader.ExcelDataReader.GetInt32(int i) -> int
-ExcelReader.Core.Reader.ExcelDataReader.GetInt64(int i) -> long
-ExcelReader.Core.Reader.ExcelDataReader.GetName(int i) -> string!
-ExcelReader.Core.Reader.ExcelDataReader.GetOrdinal(string! name) -> int
-ExcelReader.Core.Reader.ExcelDataReader.GetSchemaTable() -> System.Data.DataTable!
-ExcelReader.Core.Reader.ExcelDataReader.GetString(int i) -> string!
-ExcelReader.Core.Reader.ExcelDataReader.GetValue(int i) -> object!
-ExcelReader.Core.Reader.ExcelDataReader.GetValues(object![]! values) -> int
-ExcelReader.Core.Reader.ExcelDataReader.IsClosed.get -> bool
-ExcelReader.Core.Reader.ExcelDataReader.IsDBNull(int i) -> bool
-ExcelReader.Core.Reader.ExcelDataReader.NextResult() -> bool
-ExcelReader.Core.Reader.ExcelDataReader.Read() -> bool
-ExcelReader.Core.Reader.ExcelDataReader.RecordsAffected.get -> int
-ExcelReader.Core.Reader.ExcelDataReader.this[int i].get -> object!
-ExcelReader.Core.Reader.ExcelDataReader.this[string! name].get -> object!
 ExcelReader.Core.Reader.ExcelEncryptionException
 ExcelReader.Core.Reader.ExcelEncryptionException.ExcelEncryptionException() -> void
 ExcelReader.Core.Reader.ExcelEncryptionException.ExcelEncryptionException(ExcelReader.Core.Reader.ExcelEncryptionReason reason, string! message) -> void
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
index c0fabc56..772cc5ed 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Unshipped.txt
@@ -70,11 +70,6 @@ static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TModel>(ExcelReader.Co
 static ExcelReader.Core.Reader.SheetParallel.ForEachAsync<TRecord>(ExcelReader.Core.Reader.IExcelSheet! sheet, System.Action<TRecord>! body, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.Task!
 static ExcelReader.Core.Reader.SheetParallel.ParseAsync<T>(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Parser.ExcelParser<T>! parser, ExcelReader.Core.Reader.SheetParallelOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Collections.Generic.IAsyncEnumerable<T>!
 static ExcelReader.Core.Reader.SheetParallelOptions.Default.get -> ExcelReader.Core.Reader.SheetParallelOptions!
-ExcelReader.Core.Reader.ExcelDataReader.ExcelDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.ExcelDataReaderOptions? options = null) -> void
-ExcelReader.Core.Reader.ExcelDataReaderOptions
-ExcelReader.Core.Reader.ExcelDataReaderOptions.ExcelDataReaderOptions() -> void
-ExcelReader.Core.Reader.ExcelDataReaderOptions.HeaderRow.get -> int
-ExcelReader.Core.Reader.ExcelDataReaderOptions.HeaderRow.init -> void
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.HeaderRow.get -> int
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.HeaderRow.init -> void
@@ -83,7 +78,6 @@ ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.ParseText.init -> void
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.get -> int
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SampleSize.init -> void
 ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.SchemaInferenceOptions() -> void
-static ExcelReader.Core.Reader.ExcelDataReaderOptions.Default.get -> ExcelReader.Core.Reader.ExcelDataReaderOptions!
 static ExcelReader.Core.Reader.Schema.SchemaInferenceOptions.Default.get -> ExcelReader.Core.Reader.Schema.SchemaInferenceOptions!
 ExcelReader.Core.Writer.Xls.XlsWriterOptions
 ExcelReader.Core.Writer.Xls.XlsWriterOptions.<Clone>$() -> ExcelReader.Core.Writer.Xls.XlsWriterOptions!
@@ -106,3 +100,43 @@ static ExcelReader.Core.Reader.Excel.FromCsvAsync(System.IO.Stream! stream, bool
 static ExcelReader.Core.Reader.Excel.FromCsvFile(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null) -> ExcelReader.Core.Reader.Csv.CsvReader!
 static ExcelReader.Core.Reader.Excel.FromCsvFileAsync(string! path, ExcelReader.Core.Reader.ExcelReaderOptions? options = null, System.Threading.CancellationToken ct = default(System.Threading.CancellationToken)) -> System.Threading.Tasks.ValueTask<ExcelReader.Core.Reader.Csv.CsvReader!>
 static ExcelReader.Core.Reader.Excel.InferSchema(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.Schema.SchemaInferenceOptions? options = null) -> System.Collections.Generic.IReadOnlyList<ExcelReader.Core.Reader.Schema.ExcelColumnSchema>!
+ExcelReader.Core.Reader.SheetDataReader
+ExcelReader.Core.Reader.SheetDataReader.Close() -> void
+ExcelReader.Core.Reader.SheetDataReader.Depth.get -> int
+ExcelReader.Core.Reader.SheetDataReader.Dispose() -> void
+ExcelReader.Core.Reader.SheetDataReader.FieldCount.get -> int
+ExcelReader.Core.Reader.SheetDataReader.GetBoolean(int i) -> bool
+ExcelReader.Core.Reader.SheetDataReader.GetByte(int i) -> byte
+ExcelReader.Core.Reader.SheetDataReader.GetBytes(int i, long fieldOffset, byte[]? buffer, int bufferoffset, int length) -> long
+ExcelReader.Core.Reader.SheetDataReader.GetChar(int i) -> char
+ExcelReader.Core.Reader.SheetDataReader.GetChars(int i, long fieldoffset, char[]? buffer, int bufferoffset, int length) -> long
+ExcelReader.Core.Reader.SheetDataReader.GetData(int i) -> System.Data.IDataReader!
+ExcelReader.Core.Reader.SheetDataReader.GetDataTypeName(int i) -> string!
+ExcelReader.Core.Reader.SheetDataReader.GetDateTime(int i) -> System.DateTime
+ExcelReader.Core.Reader.SheetDataReader.GetDecimal(int i) -> decimal
+ExcelReader.Core.Reader.SheetDataReader.GetDouble(int i) -> double
+ExcelReader.Core.Reader.SheetDataReader.GetFieldType(int i) -> System.Type!
+ExcelReader.Core.Reader.SheetDataReader.GetFloat(int i) -> float
+ExcelReader.Core.Reader.SheetDataReader.GetGuid(int i) -> System.Guid
+ExcelReader.Core.Reader.SheetDataReader.GetInt16(int i) -> short
+ExcelReader.Core.Reader.SheetDataReader.GetInt32(int i) -> int
+ExcelReader.Core.Reader.SheetDataReader.GetInt64(int i) -> long
+ExcelReader.Core.Reader.SheetDataReader.GetName(int i) -> string!
+ExcelReader.Core.Reader.SheetDataReader.GetOrdinal(string! name) -> int
+ExcelReader.Core.Reader.SheetDataReader.GetSchemaTable() -> System.Data.DataTable!
+ExcelReader.Core.Reader.SheetDataReader.GetString(int i) -> string!
+ExcelReader.Core.Reader.SheetDataReader.GetValue(int i) -> object!
+ExcelReader.Core.Reader.SheetDataReader.GetValues(object![]! values) -> int
+ExcelReader.Core.Reader.SheetDataReader.IsClosed.get -> bool
+ExcelReader.Core.Reader.SheetDataReader.IsDBNull(int i) -> bool
+ExcelReader.Core.Reader.SheetDataReader.NextResult() -> bool
+ExcelReader.Core.Reader.SheetDataReader.Read() -> bool
+ExcelReader.Core.Reader.SheetDataReader.RecordsAffected.get -> int
+ExcelReader.Core.Reader.SheetDataReader.SheetDataReader(ExcelReader.Core.Reader.IExcelSheet! sheet, ExcelReader.Core.Reader.SheetDataReaderOptions? options = null) -> void
+ExcelReader.Core.Reader.SheetDataReader.this[int i].get -> object!
+ExcelReader.Core.Reader.SheetDataReader.this[string! name].get -> object!
+ExcelReader.Core.Reader.SheetDataReaderOptions
+ExcelReader.Core.Reader.SheetDataReaderOptions.HeaderRow.get -> int
+ExcelReader.Core.Reader.SheetDataReaderOptions.HeaderRow.init -> void
+ExcelReader.Core.Reader.SheetDataReaderOptions.SheetDataReaderOptions() -> void
+static ExcelReader.Core.Reader.SheetDataReaderOptions.Default.get -> ExcelReader.Core.Reader.SheetDataReaderOptions!
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReader.cs b/src/ExcelReader.Core/Reader/SheetDataReader.cs
similarity index 96%
rename from src/ExcelReader.Core/Reader/ExcelDataReader.cs
rename to src/ExcelReader.Core/Reader/SheetDataReader.cs
index 62b286f1..95cfee9c 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReader.cs
+++ b/src/ExcelReader.Core/Reader/SheetDataReader.cs
@@ -15,12 +15,12 @@ namespace ExcelReader.Core.Reader
     /// </summary>
     /// <remarks>
     /// The column shape is fixed once, at construction time, from the header row (or from the first data
-    /// row when <see cref="ExcelDataReaderOptions.HeaderRow"/> is 0) — it never grows as later, wider rows come in. There is no schema
+    /// row when <see cref="SheetDataReaderOptions.HeaderRow"/> is 0) — it never grows as later, wider rows come in. There is no schema
     /// pass, so <see cref="GetFieldType"/>, <see cref="GetValue"/>, and the typed getters all read the
     /// <em>current</em> row's own cell type; a consumer that builds a schema from the first
     /// <see cref="Read"/> (e.g. <c>DataTable.Load</c>) locks in that row's types for the whole load.
     /// <para>
-    /// One <see cref="ExcelDataReader"/> reads one sheet: <see cref="NextResult"/> always returns
+    /// One <see cref="SheetDataReader"/> reads one sheet: <see cref="NextResult"/> always returns
     /// <see langword="false"/>. To read every sheet, construct one per <see cref="IExcelWorkbook.SheetAt"/>.
     /// </para>
     /// <para>
@@ -28,7 +28,7 @@ namespace ExcelReader.Core.Reader
     /// from — the caller still owns that.
     /// </para>
     /// </remarks>
-    public sealed class ExcelDataReader : IDataReader
+    public sealed class SheetDataReader : IDataReader
     {
         private readonly IExcelRowEnumerator _rows;
         private readonly bool _isDate1904;
@@ -45,14 +45,14 @@ public sealed class ExcelDataReader : IDataReader
         /// Wraps <paramref name="sheet"/>.
         /// </summary>
         /// <param name="sheet">The sheet to read. Its workbook stays owned by the caller.</param>
-        /// <param name="options">The header row; <see cref="ExcelDataReaderOptions.Default"/> when <see langword="null"/>.</param>
+        /// <param name="options">The header row; <see cref="SheetDataReaderOptions.Default"/> when <see langword="null"/>.</param>
         /// <exception cref="ArgumentNullException"><paramref name="sheet"/> is null.</exception>
-        /// <exception cref="ArgumentOutOfRangeException"><see cref="ExcelDataReaderOptions.HeaderRow"/> is negative.</exception>
-        /// <exception cref="InvalidOperationException"><see cref="ExcelDataReaderOptions.HeaderRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
-        public ExcelDataReader(IExcelSheet sheet, ExcelDataReaderOptions? options = null)
+        /// <exception cref="ArgumentOutOfRangeException"><see cref="SheetDataReaderOptions.HeaderRow"/> is negative.</exception>
+        /// <exception cref="InvalidOperationException"><see cref="SheetDataReaderOptions.HeaderRow"/> is positive and <paramref name="sheet"/> is a table view (<see cref="ExcelTable.AsSheet"/>) of a table without a header row.</exception>
+        public SheetDataReader(IExcelSheet sheet, SheetDataReaderOptions? options = null)
         {
             ArgumentNullException.ThrowIfNull(sheet);
-            int headerRow = (options ?? ExcelDataReaderOptions.Default).HeaderRow;
+            int headerRow = (options ?? SheetDataReaderOptions.Default).HeaderRow;
             ArgumentOutOfRangeException.ThrowIfNegative(headerRow, nameof(options));
             if (headerRow > 0)
             {
@@ -364,7 +364,7 @@ public long GetChars(int i, long fieldoffset, char[]? buffer, int bufferoffset,
         /// <inheritdoc/>
         public IDataReader GetData(int i)
         {
-            throw new NotSupportedException("ExcelDataReader has no nested result sets.");
+            throw new NotSupportedException("SheetDataReader has no nested result sets.");
         }
 
         /// <inheritdoc/>
diff --git a/src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs b/src/ExcelReader.Core/Reader/SheetDataReaderOptions.cs
similarity index 76%
rename from src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs
rename to src/ExcelReader.Core/Reader/SheetDataReaderOptions.cs
index 95f87a1b..4c14d7c8 100644
--- a/src/ExcelReader.Core/Reader/ExcelDataReaderOptions.cs
+++ b/src/ExcelReader.Core/Reader/SheetDataReaderOptions.cs
@@ -1,10 +1,10 @@
 namespace ExcelReader.Core.Reader
 {
-    /// <summary>Options for adapting a sheet to <see cref="System.Data.IDataReader"/> with <see cref="ExcelDataReader"/>.</summary>
-    public sealed class ExcelDataReaderOptions
+    /// <summary>Options for adapting a sheet to <see cref="System.Data.IDataReader"/> with <see cref="SheetDataReader"/>.</summary>
+    public sealed class SheetDataReaderOptions
     {
         /// <summary>Gets the default options: column names on row 1.</summary>
-        public static ExcelDataReaderOptions Default { get; } = new();
+        public static SheetDataReaderOptions Default { get; } = new();
 
         /// <summary>
         /// Gets the 1-based row holding column names. <c>0</c> means a header-less sheet, whose columns come
diff --git a/tests/ExcelReader.Benchmarks/Interop/DataReaderBenchmark.cs b/tests/ExcelReader.Benchmarks/Interop/DataReaderBenchmark.cs
index dd62d122..81710035 100644
--- a/tests/ExcelReader.Benchmarks/Interop/DataReaderBenchmark.cs
+++ b/tests/ExcelReader.Benchmarks/Interop/DataReaderBenchmark.cs
@@ -48,7 +48,7 @@ public long Baseline_RawRows()
         public long DataReader_GetValue()
         {
             using IExcelWorkbook reader = OpenReader();
-            using IDataReader data = new ExcelDataReader(reader.FirstSheet);
+            using IDataReader data = new SheetDataReader(reader.FirstSheet);
             long acc = 0;
             while (data.Read())
             {
@@ -64,7 +64,7 @@ public long DataReader_GetValue()
         public long DataReader_TypedGetters()
         {
             using IExcelWorkbook reader = OpenReader();
-            using IDataReader data = new ExcelDataReader(reader.FirstSheet);
+            using IDataReader data = new SheetDataReader(reader.FirstSheet);
             long acc = 0;
             while (data.Read())
             {
@@ -80,7 +80,7 @@ public long DataReader_TypedGetters()
         public long DataReader_GetBytes()
         {
             using IExcelWorkbook reader = OpenReader();
-            using IDataReader data = new ExcelDataReader(reader.FirstSheet);
+            using IDataReader data = new SheetDataReader(reader.FirstSheet);
             long acc = 0;
             while (data.Read())
             {
@@ -93,7 +93,7 @@ public long DataReader_GetBytes()
         public int DataTable_Load()
         {
             using IExcelWorkbook reader = OpenReader();
-            using IDataReader data = new ExcelDataReader(reader.FirstSheet);
+            using IDataReader data = new SheetDataReader(reader.FirstSheet);
             var table = new DataTable();
             table.Load(data);
             return table.Rows.Count;
diff --git a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
index 28a9c550..3c100dff 100644
--- a/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SheetConsumerTests.cs
@@ -167,16 +167,16 @@ public void InferSchema_Samples_The_Sheet_It_Is_Given()
         }
 
         [Fact]
-        public void ExcelDataReader_Reads_The_Sheet_It_Is_Given_And_Names_Its_Table_After_It()
+        public void SheetDataReader_Reads_The_Sheet_It_Is_Given_And_Names_Its_Table_After_It()
         {
             using XlsxWorkbook workbook = Excel.FromXlsx(BuildXlsx());
-            using ExcelDataReader data = new(workbook.Sheets[1]);
+            using SheetDataReader data = new(workbook.Sheets[1]);
             Assert.Equal(2, data.FieldCount);
             Assert.True(data.Read());
             Assert.Equal("s1-0", data.GetString(0));
             using DataTable schema = data.GetSchemaTable()!;
             Assert.Equal("S1", schema.Rows[0][SchemaTableColumn.BaseTableName]);
-            Assert.Throws<ArgumentNullException>(() => new ExcelDataReader((IExcelSheet)null!));
+            Assert.Throws<ArgumentNullException>(() => new SheetDataReader((IExcelSheet)null!));
         }
 
         [Fact]
diff --git a/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs b/tests/ExcelReader.Tests/Reader/SheetDataReaderTests.cs
similarity index 90%
rename from tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs
rename to tests/ExcelReader.Tests/Reader/SheetDataReaderTests.cs
index 94d059ad..e725b8f9 100644
--- a/tests/ExcelReader.Tests/Reader/ExcelDataReaderTests.cs
+++ b/tests/ExcelReader.Tests/Reader/SheetDataReaderTests.cs
@@ -9,7 +9,7 @@
 
 namespace ExcelReader.Tests.Reader
 {
-    public class ExcelDataReaderTests
+    public class SheetDataReaderTests
     {
         [Fact]
         public async Task HeaderRowFixesNamesAndFieldCount()
@@ -18,7 +18,7 @@ public async Task HeaderRowFixesNamesAndFieldCount()
                 ["Id", "Name"],
                 [1, "alice"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             Assert.Equal(2, data.FieldCount);
             Assert.Equal("Id", data.GetName(0));
@@ -36,7 +36,7 @@ public async Task ReadWalksEveryDataRowAfterTheHeader()
                 [2],
                 [3]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             var seen = new List<int>();
             while (data.Read())
@@ -53,7 +53,7 @@ public async Task GetValueMapsEachCellTypeToItsClrType()
                 ["Text", "Number", "Flag", "When", "Blank"],
                 ["hi", 42, true, new DateTime(2024, 1, 1), null]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             Assert.True(data.Read());
             Assert.Equal("hi", data.GetValue(0));
@@ -69,7 +69,7 @@ public async Task NoHeaderSynthesizesColumnNamesFromFirstRowWidth()
         {
             await using var ms = await TypedWorkbook.BuildAsync([1, 2, 3]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet, new ExcelDataReaderOptions { HeaderRow = 0 });
+            using var data = new SheetDataReader(reader.FirstSheet, new SheetDataReaderOptions { HeaderRow = 0 });
 
             Assert.Equal(3, data.FieldCount);
             Assert.Equal("Column0", data.GetName(0));
@@ -83,7 +83,7 @@ public async Task HeaderRowBeyondSheetSizeIsAnEmptyResultSet()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet, new ExcelDataReaderOptions { HeaderRow = 5 });
+            using var data = new SheetDataReader(reader.FirstSheet, new SheetDataReaderOptions { HeaderRow = 5 });
 
             Assert.Equal(0, data.FieldCount);
             Assert.False(data.Read());
@@ -94,7 +94,7 @@ public async Task GetOrdinalForUnknownNameThrows()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id"], [1]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             Assert.Throws<KeyNotFoundException>(() => data.GetOrdinal("DoesNotExist"));
         }
@@ -104,7 +104,7 @@ public async Task GetValueBeforeReadThrows()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id"], [1]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             Assert.Throws<InvalidOperationException>(() => data.GetValue(0));
         }
@@ -116,7 +116,7 @@ public async Task NextResultAlwaysReturnsFalse()
                 ("A", [[1]]),
                 ("B", [[2]]));
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             Assert.False(data.NextResult());
         }
@@ -126,7 +126,7 @@ public async Task GetBytesReturnsTheCellsUtf8BytesWindowedByOffsetAndLength()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Text"], ["héllo"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             byte[] expected = Encoding.UTF8.GetBytes("héllo");
@@ -148,7 +148,7 @@ public async Task GetBytesFormatsANumericCellInsteadOfReturningNothing()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Number"], [42]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             byte[] buffer = new byte[8];
@@ -161,7 +161,7 @@ public async Task GetBytesOnADbNullCellReturnsZero()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Blank"], [null]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal(0, data.GetBytes(0, 0, null, 0, 0));
@@ -174,7 +174,7 @@ public async Task GetCharsReturnsTheCellsTextWindowedByOffsetAndLength()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Text"], ["hello world"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal(11, data.GetChars(0, 0, null, 0, 0));
@@ -206,7 +206,7 @@ public async Task GetBytesFormatsAnXlsbNumericCellFromItsBinaryValue()
 
             ms.Position = 0;
             using XlsbWorkbook reader = Excel.FromXlsb(ms);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             byte[] buffer = new byte[8];
@@ -219,7 +219,7 @@ public async Task TypedGettersParseANumericCellIntoEveryIntegralAndFloatingType(
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Number"], [42]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal((byte)42, data.GetByte(0));
@@ -238,7 +238,7 @@ public async Task GetBooleanAndGetDateTimeReadTheirOwnCellTypesAndRejectText()
                 ["Flag", "When", "Text"],
                 [true, new DateTime(2024, 3, 7), "nope"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.True(data.GetBoolean(0));
@@ -255,7 +255,7 @@ public async Task GetGuidParsesATextCellAndRejectsOneThatIsNotAGuid()
                 ["Id", "Text"],
                 [guid.ToString(), "nope"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal(guid, data.GetGuid(0));
@@ -269,7 +269,7 @@ public async Task GetCharTakesTheFirstCharacterAndRejectsAnEmptyCell()
                 ["Text", "Blank"],
                 ["hello", null]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal('h', data.GetChar(0));
@@ -283,7 +283,7 @@ public async Task GetFieldTypeFollowsTheCurrentRowsOwnCellTypes()
                 ["Text", "Number", "Flag", "When", "Blank"],
                 ["hi", 42, true, new DateTime(2024, 1, 1), null]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal(typeof(string), data.GetFieldType(0));
@@ -299,7 +299,7 @@ public async Task IndexersAndTheFixedAdoMembersReportTheDocumentedValues()
         {
             await using var ms = await TypedWorkbook.BuildAsync(["Id", "Name"], [1, "alice"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
             Assert.True(data.Read());
 
             Assert.Equal(1.0, data[0]);
@@ -317,7 +317,7 @@ public async Task DataTableLoadPopulatesFromTheSheet()
                 [1, "alice"],
                 [2, "bob"]);
             await using IExcelWorkbook reader = await Excel.OpenAsync(ms, ct: TestContext.Current.CancellationToken);
-            using var data = new ExcelDataReader(reader.FirstSheet);
+            using var data = new SheetDataReader(reader.FirstSheet);
 
             var table = new DataTable();
             table.Load(data);
@@ -353,7 +353,7 @@ public void AFailedConstructorDoesNotKeepTheReaderAlive()
             XlsxWorkbook reader = Excel.FromXlsx(stream, leaveOpen: false, new ExcelReaderOptions { MaxCellBytes = 64 });
             Assert.Throws<ExcelLimitExceededException>(() =>
             {
-                using ExcelDataReader data = new(reader.FirstSheet);
+                using SheetDataReader data = new(reader.FirstSheet);
             });
             reader.Dispose();
             Assert.False(stream.CanRead);
diff --git a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
index e4fa5500..ff90b8c3 100644
--- a/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Tables/TableBindingTests.cs
@@ -71,7 +71,7 @@ public void HeaderlessTableRejectsBindingByName(string file)
             IExcelSheet view = Table(workbook, "NoHeader").AsSheet();
 
             Assert.Throws<InvalidOperationException>(() => ExcelParser.FromAttributes<StockRow>().Parse(view));
-            Assert.Throws<InvalidOperationException>(() => new ExcelDataReader(view));
+            Assert.Throws<InvalidOperationException>(() => new SheetDataReader(view));
             Assert.Throws<InvalidOperationException>(() => Excel.InferSchema(view));
         }
 
@@ -82,7 +82,7 @@ public void HeaderlessTableReadsWithoutAHeader(string file)
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
             IExcelSheet view = Table(workbook, "NoHeader").AsSheet();
 
-            using ExcelDataReader reader = new(view, new ExcelDataReaderOptions { HeaderRow = 0 });
+            using SheetDataReader reader = new(view, new SheetDataReaderOptions { HeaderRow = 0 });
             List<string> letters = [];
             while (reader.Read())
             {
@@ -99,7 +99,7 @@ public void DataReaderOrdinalsStartAtTheTableFirstColumn(string file)
         {
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
 
-            using ExcelDataReader reader = new(Table(workbook, "Sales").AsSheet());
+            using SheetDataReader reader = new(Table(workbook, "Sales").AsSheet());
             Assert.True(reader.Read());
 
             Assert.Equal(3, reader.FieldCount);
@@ -115,9 +115,9 @@ public void DataReaderOrdinalsLineUpWithOrWithoutAHeaderRow(string file)
             using IExcelWorkbook workbook = Excel.Open(TableMetadataTests.FixturePath(file));
             IExcelSheet view = Table(workbook, "NoStyle").AsSheet();
 
-            using ExcelDataReader named = new(view, new ExcelDataReaderOptions { HeaderRow = 1 });
+            using SheetDataReader named = new(view, new SheetDataReaderOptions { HeaderRow = 1 });
             Assert.True(named.Read());
-            using ExcelDataReader unnamed = new(view, new ExcelDataReaderOptions { HeaderRow = 0 });
+            using SheetDataReader unnamed = new(view, new SheetDataReaderOptions { HeaderRow = 0 });
             Assert.True(unnamed.Read());
 
             Assert.Equal((2, "Name", "Value", "x"), (named.FieldCount, named.GetName(0), named.GetName(1), named.GetString(0)));

From 584acd44c9b997a9d54e5831b6598fcb54225eee Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 01:55:00 -0300
Subject: [PATCH 093/115] refactor!: type formula cells by their cached result
 and remove CellType.Formula

CellType.Formula meant a different thing per format: XLSX used it for a text result, XLS
for a numeric result (dropping Date for a date-styled formula), and XLSB never used it.
Every format now reports the result's own type. CellType.Error keeps its value 6, and the
native XL_CELL_FORMULA constant stays defined but is no longer produced.
---
 docs/guide/migrating-to-v7.md                    |  4 ++++
 .../PublicAPI/PublicAPI.Shipped.txt              |  1 -
 src/ExcelReader.Core/Reader/CellType.cs          | 10 ++++++----
 .../Reader/Xls/XlsWorkbook.Enumerator.cs         |  6 +++---
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs       |  4 ++--
 src/ExcelReader.Native/include/excelreader.h     |  2 +-
 .../ExcelReader.Tests/Reader/CellVariantTests.cs |  4 ++--
 .../Reader/Xls/XlsWorkbookBuilder.cs             |  4 ++++
 .../Reader/Xls/XlsWorkbookTests.cs               | 16 +++++++++++++++-
 .../Reader/Xlsx/RealWorldXlsxCorpusTests.cs      |  2 +-
 .../Reader/Xlsx/XlsxDialectShapeTests.cs         |  2 +-
 .../Reader/Xlsx/XlsxProducerDialectShapeTests.cs |  2 +-
 12 files changed, 40 insertions(+), 17 deletions(-)

diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 235c0476..1f4e5c09 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -108,6 +108,7 @@ These changes replace positional parameters and loose arguments with types that
 | `XlsWorkbookWriter.Create(stream, leaveOpen, date1904)` | `XlsWorkbookWriter.Create(stream, leaveOpen, new XlsWriterOptions { Date1904 = … })` |
 | `Excel.FromCsv*(…, CsvReaderOptions options)` | `Excel.FromCsv*(…, new ExcelReaderOptions { Csv = options })` |
 | `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | `ExcelReaderOptions.MaxCellBytes`, `ExcelReaderOptions.InternStrings` |
+| `CellType.Formula` | Removed. A formula cell reports its cached result's type: `Number`, `Date`, `ExcelString`, `Boolean` or `Error` |
 | `ExcelDataReader` (its name collided with Sylvan.Data.Excel and the ExcelDataReader package) | `SheetDataReader` |
 | `Cell.TryGetDateTime(out DateTime)`, which silently assumed the 1900 date system | `Cell.TryGetDateTime(workbook.IsDate1904, out DateTime)` |
 
@@ -128,6 +129,7 @@ To unit-test a converter, build the context with an initializer: `new ExcelRowCo
 Two behavior changes come with them:
 
 - `Excel.Open` with `ExcelFileFormat.Csv` now applies `ExcelReaderOptions.MaxCellBytes` and `InternStrings`. v6 ignored both and used the CSV defaults.
+- Formula cells are typed by their cached result in every format. v6 reported an XLSX text result and an XLS numeric result as `Formula`, so an XLS formula with a date style lost its `Date` type, and XLSB never used `Formula`.
 - The CLI `convert` command no longer shifts dates by four years when the source workbook uses the 1904 date system.
 - `XlsxWriterOptions` gains `Date1904`, which v6 lacked. It defaults to `false`, so existing output is unchanged.
 
@@ -135,6 +137,8 @@ Two behavior changes come with them:
 
 The C ABI is unchanged: no signature moved, and `XL_ABI_VERSION` stays 6. Behavior changed. `degree_of_parallelism` of `0` on `xl_parse_typed` and the Arrow exports now parallelises XLSX and XLSB as well as CSV, using every processor. Pass `1` for the old sequential behavior. The Rust, Python and C++ bindings take the same value (`degree_of_parallelism`, `parallelism`) and need no code change; a `parallelism=0` call on an XLSX or XLSB sheet is now faster, and holds every partition's columns until they merge, so its peak memory is higher.
 
+`XL_CELL_FORMULA` (5) is no longer produced; formula cells come back with their result's cell type. The constant stays defined in the header and in the bindings.
+
 `xl_write_options.date1904` now applies to XLSX as well as XLSB and XLS; v6 ignored it for XLSX.
 
 `xl_csv_aggregate` keeps its signature. Inside, it opens a `CsvReader` with the dialect from the native struct and calls `SheetParallel`.
diff --git a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
index 9a57304e..64ceb60b 100644
--- a/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
+++ b/src/ExcelReader.Core/PublicAPI/PublicAPI.Shipped.txt
@@ -108,7 +108,6 @@ ExcelReader.Core.Reader.CellType.Date = 3 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.Empty = 0 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.Error = 6 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.ExcelString = 1 -> ExcelReader.Core.Reader.CellType
-ExcelReader.Core.Reader.CellType.Formula = 5 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.CellType.Number = 2 -> ExcelReader.Core.Reader.CellType
 ExcelReader.Core.Reader.RowAggregation<TState>
 ExcelReader.Core.Reader.RowAggregation<TState>.Accumulate.get -> ExcelReader.Core.Reader.RowAction<TState>!
diff --git a/src/ExcelReader.Core/Reader/CellType.cs b/src/ExcelReader.Core/Reader/CellType.cs
index c40c279a..d770a84d 100644
--- a/src/ExcelReader.Core/Reader/CellType.cs
+++ b/src/ExcelReader.Core/Reader/CellType.cs
@@ -1,13 +1,17 @@
+using System.Diagnostics.CodeAnalysis;
+
 namespace ExcelReader.Core.Reader
 {
     /// <summary>
     /// Identifies the kind of value a <see cref="Cell"/> holds.
     /// </summary>
+    /// <remarks>A formula cell reports the type of its cached result, the same in every format.</remarks>
+    [SuppressMessage("Design", "CA1027:Mark enums with FlagsAttribute", Justification = "Not flags: the values match the native XL_CELL_* codes, and 5 belonged to the removed Formula.")]
     public enum CellType
     {
         /// <summary>The cell has no value.</summary>
         Empty,
-        /// <summary>The cell holds text (a shared string or inline string).</summary>
+        /// <summary>The cell holds text (a shared string, an inline string, or a formula's text result).</summary>
         ExcelString,
         /// <summary>The cell holds a numeric value.</summary>
         Number,
@@ -15,9 +19,7 @@ public enum CellType
         Date,
         /// <summary>The cell holds a boolean value.</summary>
         Boolean,
-        /// <summary>The cell holds a formula's cached result.</summary>
-        Formula,
         /// <summary>The cell holds an Excel error value (e.g. #DIV/0!).</summary>
-        Error,
+        Error = 6,
     }
 }
diff --git a/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.Enumerator.cs
index 82e65d56..84beb389 100644
--- a/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xls/XlsWorkbook.Enumerator.cs
@@ -308,12 +308,12 @@ private void ParseFormula(ReadOnlySpan<byte> data)
                     }
                     return;
                 }
-                AddDouble(col, style, BinaryPrimitives.ReadDoubleLittleEndian(result), CellType.Formula);
+                AddDouble(col, style, BinaryPrimitives.ReadDoubleLittleEndian(result));
             }
 
-            private void AddDouble(int col, int style, double value, CellType? forced = null)
+            private void AddDouble(int col, int style, double value)
             {
-                CellType type = forced ?? (_reader.IsDateStyle(style) ? CellType.Date : CellType.Number);
+                CellType type = _reader.IsDateStyle(style) ? CellType.Date : CellType.Number;
                 _acc.Add(col, _acc.ValueLength, 0, type, style, CellValueSource.RowValues, number: value, hasNumber: true);
             }
 
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 12741b73..a9110bb9 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -859,7 +859,7 @@ private void EmitScalarValue(Kind kind, ReadOnlySpan<byte> v, int col, int style
                 {
                     Kind.Bool => CellType.Boolean,
                     Kind.Error => CellType.Error,
-                    Kind.Formula => CellType.Formula,
+                    Kind.Formula => CellType.ExcelString,
                     _ => WorkbookLookups.IsDateStyle(_styleIsDate, style) ? CellType.Date : CellType.Number,
                 };
                 int vStart = _acc.ValueLength;
@@ -887,7 +887,7 @@ private void EmitScalarValueFast(Kind kind, ReadOnlySpan<byte> v, int valueStart
                 {
                     Kind.Bool => CellType.Boolean,
                     Kind.Error => CellType.Error,
-                    Kind.Formula => CellType.Formula,
+                    Kind.Formula => CellType.ExcelString,
                     _ => WorkbookLookups.IsDateStyle(_styleIsDate, style) ? CellType.Date : CellType.Number,
                 };
                 double number = 0;
diff --git a/src/ExcelReader.Native/include/excelreader.h b/src/ExcelReader.Native/include/excelreader.h
index 4b53d87f..12cf422c 100644
--- a/src/ExcelReader.Native/include/excelreader.h
+++ b/src/ExcelReader.Native/include/excelreader.h
@@ -29,7 +29,7 @@ extern "C" {
 #define XL_CELL_NUMBER  2
 #define XL_CELL_DATE    3
 #define XL_CELL_BOOL    4
-#define XL_CELL_FORMULA 5
+#define XL_CELL_FORMULA 5  /* no longer produced: a formula cell reports its cached result type */
 #define XL_CELL_ERROR   6
 
 #define XL_MAX_COLUMN_SPECS      16384
diff --git a/tests/ExcelReader.Tests/Reader/CellVariantTests.cs b/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
index 44f1aac1..2bc0f781 100644
--- a/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
+++ b/tests/ExcelReader.Tests/Reader/CellVariantTests.cs
@@ -31,14 +31,14 @@ public void ErrorCellHasErrorType()
         }
 
         [Fact]
-        public void FormulaCellHasFormulaType()
+        public void AFormulaTextResultIsAString()
         {
             using var ms = WorkbookBuilder.Build(
                 """<row r="1"><c r="A1" t="str"><v>Hello</v></c></row>""");
             using var reader = Excel.FromXlsx(ms);
             using var e = reader.FirstSheet.GetEnumerator();
             Assert.True(e.MoveNext());
-            Assert.Equal(CellType.Formula, e.Current[0].Type);
+            Assert.Equal(CellType.ExcelString, e.Current[0].Type);
             Assert.Equal("Hello", e.Current[0].GetString());
         }
 
diff --git a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookBuilder.cs b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookBuilder.cs
index 5230335f..04dd0027 100644
--- a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookBuilder.cs
+++ b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookBuilder.cs
@@ -12,6 +12,7 @@ internal sealed record XlsDate(DateTime Value);
     internal sealed record XlsError(byte Code);
     internal sealed record XlsFormula(double Value);
     internal sealed record XlsFormulaBool(bool Value);
+    internal sealed record XlsFormulaDate(DateTime Value);
     internal sealed record XlsFormulaError(byte Code);
     internal sealed record XlsRkInt(int Value);
     internal sealed record XlsRkRaw(uint Value);
@@ -319,6 +320,9 @@ private static void WriteCell(
                     byte[] data = [.. U16(row), .. U16(col), .. U16(0), .. Double(f.Value), .. new byte[8]];
                     WriteRecord(sheet, 0x0006, data);
                     break;
+                case XlsFormulaDate f:
+                    WriteRecord(sheet, 0x0006, [.. U16(row), .. U16(col), .. U16(1), .. Double(f.Value.ToOADate()), .. new byte[8]]);
+                    break;
                 case XlsFormulaBool f:
                     WriteRecord(sheet, 0x0006, [.. U16(row), .. U16(col), .. U16(0), .. FormulaSpecial(1, (byte)(f.Value ? 1 : 0)), .. new byte[8]]);
                     break;
diff --git a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
index 79fe49be..514e1d66 100644
--- a/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xls/XlsWorkbookTests.cs
@@ -38,11 +38,25 @@ public void ReadsBasicBiff8Cells()
             Assert.Equal("1", row[2].GetString());
             Assert.Equal(CellType.Error, row[3].Type);
             Assert.Equal("#DIV/0!", row[3].GetString());
-            Assert.Equal(CellType.Formula, row[4].Type);
+            Assert.Equal(CellType.Number, row[4].Type);
             Assert.Equal("12.5", row[4].GetString());
             Assert.False(e.MoveNext());
         }
 
+        [Fact]
+        public void AFormulaWithADateStyleReadsAsADate()
+        {
+            var date = new DateTime(2024, 5, 6, 0, 0, 0, DateTimeKind.Unspecified);
+            using var ms = XlsWorkbookBuilder.Build(sheets: [("S1", [[new XlsFormulaDate(date)]])]);
+            using var reader = Excel.FromXls(ms);
+
+            using var e = reader.FirstSheet.GetEnumerator();
+            Assert.True(e.MoveNext());
+            Assert.Equal(CellType.Date, e.Current[0].Type);
+            Assert.True(e.Current[0].TryGetDateTime(isDate1904: false, out DateTime parsed));
+            Assert.Equal(date, parsed);
+        }
+
         [Fact]
         public void ReadsAdditionalBiff8CellEncodings()
         {
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
index a35682eb..ccb3324f 100644
--- a/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/RealWorldXlsxCorpusTests.cs
@@ -19,7 +19,7 @@ public void ReadsSheetJsGeneratedWorkbook()
             Assert.Equal("price", e.Current[2].GetString());
             Assert.Equal("in_stock", e.Current[3].GetString());
             Assert.Equal("restock_date", e.Current[4].GetString());
-            Assert.Equal(CellType.Formula, e.Current[0].Type);
+            Assert.Equal(CellType.ExcelString, e.Current[0].Type);
 
             Assert.True(e.MoveNext());
             Assert.Equal("Widget", e.Current[0].GetString());
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/XlsxDialectShapeTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxDialectShapeTests.cs
index 25ca20e9..abe8e018 100644
--- a/tests/ExcelReader.Tests/Reader/Xlsx/XlsxDialectShapeTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxDialectShapeTests.cs
@@ -73,7 +73,7 @@ private static IEnumerable<object[]> LibraryAndCloudFixtures()
                     """,
                     null,
                     [
-                        new ExpectedCell(0, 0, "ab", CellType.Formula),
+                        new ExpectedCell(0, 0, "ab", CellType.ExcelString),
                         new ExpectedCell(0, 1, "#DIV/0!", CellType.Error),
                         new ExpectedCell(0, 2, "0", CellType.Boolean),
                     ])
diff --git a/tests/ExcelReader.Tests/Reader/Xlsx/XlsxProducerDialectShapeTests.cs b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxProducerDialectShapeTests.cs
index 566dfe0b..6aee085d 100644
--- a/tests/ExcelReader.Tests/Reader/Xlsx/XlsxProducerDialectShapeTests.cs
+++ b/tests/ExcelReader.Tests/Reader/Xlsx/XlsxProducerDialectShapeTests.cs
@@ -72,7 +72,7 @@ private static IEnumerable<object[]> DotNetAndJsProducerFixtures()
                     [
                         new ExpectedCell(0, 0, CellType.Date, "45292"),
                         new ExpectedCell(0, 1, CellType.Empty, ""),
-                        new ExpectedCell(0, 2, CellType.Formula, "AB"),
+                        new ExpectedCell(0, 2, CellType.ExcelString, "AB"),
                         new ExpectedCell(0, 3, CellType.Empty, ""),
                         new ExpectedCell(0, 4, CellType.Error, "#N/A"),
                     ])

From 4569c30845d637c2316e9b66ec1a4a212a955452 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 02:23:20 -0300
Subject: [PATCH 094/115] test(python): tie the GIL test's duration floor to
 the switch interval

The batch parse got fast enough (about 40 ms for a million CSV rows on CI) to fall under the
fixed 50 ms floor, which only exists so a gap is long compared with a thread switch. The test
now drops the switch interval to 1 ms for the parse and requires 20 ms, still twenty switch
intervals.
---
 python/tests/test_reader.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/python/tests/test_reader.py b/python/tests/test_reader.py
index d08c554c..1f9888ba 100644
--- a/python/tests/test_reader.py
+++ b/python/tests/test_reader.py
@@ -1,6 +1,7 @@
 import ctypes
 import gc
 import shutil
+import sys
 import threading
 import time
 from pathlib import Path
@@ -674,6 +675,8 @@ def tick():
         holding_gil = ctypes.PYFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_void_p)
         get_next = holding_gil(ctypes.cast(stream.get_next, ctypes.c_void_p).value)
         batch = _native.ArrowArray()
+        switch_interval = sys.getswitchinterval()
+        sys.setswitchinterval(0.001)
         ticker = threading.Thread(target=tick)
         ticker.start()
         try:
@@ -683,6 +686,7 @@ def tick():
         finally:
             stop.set()
             ticker.join()
+            sys.setswitchinterval(switch_interval)
         release_batch = ctypes.CFUNCTYPE(None, ctypes.c_void_p)(batch.release)
         release_batch(ctypes.addressof(batch))
         del capsule
@@ -691,7 +695,7 @@ def tick():
     assert batch.length == rows
     inside = [start] + [t for t in ticks if start < t < end] + [end]
     longest_gap = max(b - a for a, b in zip(inside, inside[1:]))
-    assert end - start > 0.05, "the batch must parse long enough for the gap to mean something"
+    assert end - start > 0.02, "the batch must parse for many switch intervals for the gap to mean something"
     assert longest_gap < (end - start) / 2
 
 

From fff70b360ebd403441c4ff167f0fbf7b9a12dee4 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 15:32:22 -0300
Subject: [PATCH 095/115] perf: load the next litlen entry before the refill
 that follows a match

Loads the offset entry before deciding whether to refill, with libdeflate's thresholds (31 bits, 38 through a subtable), so at least 11 bits remain after the offset. The next litlen entry is then loaded from those bits before the refill instead of waiting on it. Inflate only, Ryzen 7 5700X, 65K-row sheets: XLSX 15.0 -> 12.7 ms, XLSB 9.5 -> 8.6 ms under the JIT; 14.9 -> 13.5 and 9.5 -> 8.9 ms under NativeAOT. Native libdeflate on the same streams is 13.5 and 8.8 ms.
---
 .../Zip/Inflate/InflateDecoder.FastLoop.cs    | 29 +++++++++++++------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
index e8c7db58..ee9aa369 100644
--- a/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
+++ b/src/ExcelReader.Core/Reader/Zip/Inflate/InflateDecoder.FastLoop.cs
@@ -8,6 +8,9 @@ namespace ExcelReader.Core.Reader.Zip.Inflate
 {
     internal sealed partial class InflateDecoder
     {
+        private const int OffsetRefill = 21 + InflateFormat.LitlenTableBits - 1;
+        private const int SubtableOffsetRefill = 28 + InflateFormat.LitlenTableBits - 1;
+
         private enum LoopStatus
         {
             BlockDone,
@@ -35,8 +38,10 @@ private unsafe LoopStatus RunFastLoop(byte[] input, ref int inPos, int inLimit,
         // base length or offset, or the subtable start. Bits 12-15 are clear on length and offset
         // entries, so `entry >> 8` needs no mask before it shifts out the extra bits.
         //
-        // Bit budget: a refill leaves at least 56 bits. Three literals from the main table take at
-        // most 33; a length takes at most 20 and an offset at most 28, hence the refill between them.
+        // Bit budget: a refill leaves at least 56 bits, and the buffer holds one valid bit beyond
+        // `bitsleft`. Two literals and a length take at most 42. The refill before an offset (21
+        // bits, 28 through a subtable) keeps 11 bits behind it, so the next litlen entry is loaded
+        // before the refill that follows the match rather than after it.
         //
         // Only the low byte of `bitsleft` is meaningful: it subtracts whole entries, as libdeflate does.
         [SuppressMessage("Design", "MA0051:Method is too long",
@@ -125,19 +130,25 @@ private unsafe LoopStatus FastLoop(
 
                 uint length = (entry >> 16) + (uint)(LowBits(saved, entry & 0xFF) >> (int)(entry >> 8));
 
-                if ((byte)bitsleft < 30)
-                {
-                    bitbuf |= LoadWord(inNext) << (int)bitsleft;
-                    inNext += 7 - ((bitsleft >> 3) & 7);
-                    bitsleft |= 56;
-                }
                 uint offsetEntry = tables[InflateFormat.LitlenTableSize + (bitbuf & ((1 << InflateFormat.OffsetTableBits) - 1))];
                 if ((offsetEntry & InflateFormat.Exceptional) != 0)
                 {
+                    if ((byte)bitsleft < SubtableOffsetRefill)
+                    {
+                        bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                        inNext += 7 - ((bitsleft >> 3) & 7);
+                        bitsleft |= 56;
+                    }
                     bitbuf >>= InflateFormat.OffsetTableBits;
                     bitsleft -= InflateFormat.OffsetTableBits;
                     offsetEntry = tables[InflateFormat.LitlenTableSize + (offsetEntry >> 16) + (uint)LowBits(bitbuf, (offsetEntry >> 8) & 0x3F)];
                 }
+                else if ((byte)bitsleft < OffsetRefill)
+                {
+                    bitbuf |= LoadWord(inNext) << (int)bitsleft;
+                    inNext += 7 - ((bitsleft >> 3) & 7);
+                    bitsleft |= 56;
+                }
                 saved = bitbuf;
                 bitbuf >>= (int)offsetEntry;
                 bitsleft -= offsetEntry;
@@ -152,10 +163,10 @@ private unsafe LoopStatus FastLoop(
                 byte* destination = outNext;
                 outNext += length;
 
+                entry = tables[bitbuf & mask];
                 bitbuf |= LoadWord(inNext) << (int)bitsleft;
                 inNext += 7 - ((bitsleft >> 3) & 7);
                 bitsleft |= 56;
-                entry = tables[bitbuf & mask];
 
                 CopyMatch(source, destination, outNext, offset);
             }

From caa40386837465b79f40e9d0cae516c0283455ce Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 15:36:30 -0300
Subject: [PATCH 096/115] perf(native): regenerate the static PGO profile after
 the inflate fast-loop change

The fast-loop change and the v7 renames left ILC reporting "PGO data available, but IL did not match" for FastLoop. Recorded with NativePgoTrainer as the Native README describes, XLSB methods still excluded. AOT xl_parse_typed, 65K fixtures, min of three alternating runs: XLSX dop 0 19.1 -> 17.8 ms, dop 1 52.2 -> 51.0 ms; XLSB dop 0 14.8 -> 14.3 ms, dop 1 27.8 -> 27.1 ms; 160 MB CSV dop 1 396 -> 385 ms. CSV, XLS and the parallel 160 MB CSV are flat.
---
 src/ExcelReader.Native/pgo/excelreader.mibc | Bin 101715 -> 102103 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/src/ExcelReader.Native/pgo/excelreader.mibc b/src/ExcelReader.Native/pgo/excelreader.mibc
index 1a2ce5d016b86cbffd586493f5b857a0dd5e7ccf..4e912f649529bb940073f8762654b0daa65ee4f9 100644
GIT binary patch
literal 102103
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
zLInT}000000000000000000000B&V>E^TRIV=iQDY*0%D1^@s60096206G8w0EdnN
G0000*xVoeO

literal 101715
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%0AlhDY8{vy~OHL7H4RRc0iv
zG|eP@^!Gf0T*#Hzj)u_ZM`y@}(6y)PWPW<*`9(56U3h+x>>6Gd7b;xxgv>!7*|uKh
zLjJ-{vTjtca<8l#omvX`@zRs%8X9`7OLiUaN5D8VN<Vezl<XFI>d;l$b?jde)cS;G
z;yOOxMdHNDTQWbrBK>!n3*E!@=}6v6#hhW~tyK9LPEIg}vtDFi&Xfem$LV`GdrP?7
zg)Ehcau*8AX-6(}D%T?KK(Rp}`H~=z{Om1Rau=GJ+rpZe*;@+aE;J9X)Vw^q+=cKC
zMUzF4-gggsk%gJPWs2OwV7tWp(NQbEgJ%sGhjE$Qg$l$~au@PF3bg=TXnf{+c@r9%
zxnAx<&vtK;cc9N!1OLBxFMqKb_Hx&1ppUF>1?yA=PY3YRrB$tL6N)Hqm3N?;#W0tP
z^AqJwXwTwZat}IQzhCY_FD`yr?m<tkI4<u-cXQ9mo#^#cXkk+=v@rGAf62i*y)VCu
zWqt=s_zwD5xF)}Yt{(nMeiyAz_(|?UAoE_dKH)ccFIq(YCclHKs{WMUL67W!lEi5!
zlTg=8T*G<}5~CDmCT)vaVP|qZaf()I@-eHz$q4Rjg_9}YQlM}$t+f>xYZSGN$<a*I
zGJnj=M2*ag3u+auWbuNh6dVCI-^ujv+^ldiCjxdUTugpJ8R5d^J<R^jJqiy4ayB!b
z*iHp-E-IW%Z(Sy8rT(3BS>a)(*LjhL>8}Lbko%dUm0CY{MA1gUNZP26tTz;G6zEJF
zRloXYg_ZzY0sFBXnVCtecVVd_u8mRUfhPQ3BjKD(Re_H4FtJr$<Yb<!4Ch?TAM;|k
z4#vMaf%7o$;J(^1=Dz{B`Uqfir5DMV%~t6BBWnuR&HSB~!Syo#j?3jb@E&v_Zfz0g
zLKh~0h5+_6urA}+;+YvvTfq%7f_oNcW_}8+<vOrO)K6!<v78IV-k=|ApdZ&7#`G|z
zJ5co-YdOHJ825256fqC*%;uAvi~6qjB4;B0nD;p+V@dux$Foq^z{07@|9`Y184J?p
z*?zAT8Ck)7lQUz!g$*qJfwQpsx;vbR`8Lew*)NYgN$~8&$Nu1Ww&xhBw6h;AQz;#6
z_3{v<gKc&L-k54s^6bW~u}Ypj{8)yPXT8S?l}@&buU0zPhWqC#9W1*4VWorZdAdP4
zgg)Q24C5-Lhk3k?mpYjrHx(#4Xyam7k>IR@O0aS*h$nuiJFGMit4aYs(Hv8D(1BA<
zDZA;5+fOMC#GYB_lm=o(*V`B`DGfxx)Q^<)>;++1*-OJ6VVn`%H<Tk-hJL&XPKMd_
zv(iO@hPc>&Z>Cg$6I5-~4^C0#LT?q`r}D6W=gd%f*jvJURW~y!&5K-AaO`5$5V{o8
zq#8oCVmorsf_sCi9=AD+v73S0%@Atot&`Q$h38*XIp~qiohk>NV?C_$u!8%T%ELk#
z2i;S4TGh=6?q3-P{nqw#szLgVQ&VN#=#$DfRU?cp_L6Fx(ZznKa<TtiGprh>!LrrU
zJI}wU@~}_5I-)WW^!x>ciRhjZg^~zZ(<I{aqrh3R@+Z|e16F#RxzhHVYMkj=@VClA
zyD=VX`%UGb^9y8Z2i--=)ZMJ$R;#<&+C#x=C+%yC!I+`$W?k*;<sP=Das*4GQtf1H
zI|>x(#QsjFI-L;Qb+U8<to=3g$GnB=apr7Z3p>t0%i|2}M`(GGx|{9F1^c{daiV;j
ziHiMD<)F8^ma84~$hNg=2aQ&E)Pt<x-iq-BwU0e&->)8Fr73O12pd{{Ts^{;&jftF
z{4g=XrlhnH4*Gw%?(Liw)<w;o;YAJ_yeS9$T8tNY*rA8}VRpGKtb>lA-cUQ}rxv}f
z?q&gp>0Loy<YU(zxTJQWYdPmsgDi|E4_m4dj4->e)r0Iu?Kjmvw$LlpjI)VhZNwnE
z+-uMbvI}G4G(PtG)(IM!q_1eAMkW#56&erwZOkN1Ka+2|$&E9xru|Gt#!YS<Ju&?+
zWM(d`nyKlhKaG1((@(!pv<TzVnttZ1=PpycL~w7=RO34xU>q_^U`>q@!<;saQL<zD
zehn|#eWXiclz?Z&OAclp)fgq#B&d78zF%XMJmATd7$pZ1-_jT*o2L6TykuwQWlc2!
zx7}(2ZoAc3XQ~OfYgZF+QdARg3L7QA%>Ivtmw2DOuIWJ6UIRN8I1kR3FJEhAdCA?w
zR@BJMsQOOR$b7PZ<Xg$N7HD{o(haHuEfd3e7g{Eoco&MyO6GZDZe=EKAc}KxF;?;h
z;x%F(KbyGnii@u!zMtH}gBP@ycTsh{ukb@?{^rxXlMyx-D4I}Y#v8m7kD;HuAY9}P
z#H6lIFka(b=t$nzd<VL#hg05q2F5wT_5<%i_cTG13vrddbKrch6<b&ry1Vf&-i5Yr
zmIk;edv9>S5IVXsI$#KWw=p?j2)({BIl##bZG^MTzq25q3Dz;7ULv?>1k_4kEnKMi
zS&+kiPhCL01oo6jgvT@l)JwouX_A1RH%VM#3+rSatqkY7S(n(3MB>-UPX%<K!t+lB
zxX_8r%an_H0}!pUw6ZQrp7m@%6Ow0b41n9&)&Lg*U)MziXI-Y6BxlRh*d|F!`L2Lg
zNlW>j04H;#{N;c)3E1;CJgRQ=!|9U&O%kZpO~b8L#@?RvdO#}~9Y4hI#H{<?3E<ha
zJ^lcm{p>NobH_dnaI&$b*8?1EZRw8z4t9nc@B?hOD|Y=Fz_b025rI6r?-&>8WPeu&
z2Rc}VCLz$lPJ22nke9p{n-kc8^%F1-HDFz8z`E3cb*V!FK1Ku9C<hzwo*cLmulP#h
zexWhY!G1sanZT9A#qC=H9jvCVEwEdnE_gX`9dUl*TY>9v$#uk`mtA}V!B$$41x07)
zBB1?&{q);suLL^LXCnANLcbUF)1N!O3Ungvi(celEzAEK*g`z{ii>X{{t98WEyTs`
zq1t*@Qx~V*LBM^yov5E!r>$qz1xvN<xMVv~{<4ejBp{~OiBI0;cy^r_mlGGaZ_su~
zE^gnd?Uj_izC&9_+!bEbx)AJZUb1KUK5aD~C!jwN*72Om!MdJ4q~#^ACGOKYuutot
zK|>rgc&82;JW}widbHqep4K{O@VHz^+3(Z3D8ONQ%WN+ai76{T&^qYCh^tyNQy4L#
zwJ?Pd-)YTET*MuWe`(vOc~-d&kk|DPaC2!wtt~M+4_mr6Q#U9P+yy!hYh6;V8<fCV
zV`gr|-KPVbt8=00fnH>k{JHRPolo-o$|rQK<foBqbPxlvk-%xu`6Z^JcAbZO>*z6^
zh0Tfs-(VsKIP39qjD=0)e&Cj)BXQ?+%Tf3nUgVbu?ss&3#L9A@aikIJs$cSc##g#A
ziLT;1-Iydk^p0*!vTVs+-I!#TL#rRdCC4RwMG^W|vguf|egIpQamg!575WPVxp2PT
z!d9QJ*IU>b0noeg!Fv4#;*C@D^}IAZs*Ny6Tcg?tUV3rz5<NjZ8`i8RsLf$(^cMDD
z*e3lYLU8Zb58*YnNZ&4llAXoJ^fqb6fhfdFRh{ScqEv9dt*>YMiax^ljow2ZIs2FX
z5^?0LCWx0FIco^wr6m(BLA*3_nIp(7-SFIFLA>->{+b}W^scZs=o(QF<KjUYeL-WA
zO|9pH#w35Ne=lfE@~Y=bkYBPU>#LyU2=*z&PHzVJC4cAq95gHu+*Ghnvado29+o_o
z?nOSyc@gMWqr7NX0(QeE(d9)44@(-eEWtiW?*`!inw`&#VdRMiv85%JX9XLGa%^wQ
z!QM(ME1wB8NFS`s3I;3)Hb^%-R})+-U3GkKkU@G^s1No@7Hx_SCYYxDHNo{#!M!z@
zVBk&!oSnhfiPNFSf<4mHp@YE=)*c4_n`QZ>U<bR`{Yh{?`DfyH!A+>V|Bqm!<UtQ@
zFiO@Lnh6ID7Rkc~XDJMT0R|5nnPD*8!aL3=`K|+Wd+VVh15dm<wb}rYw;F?o+%s#g
zp%?v;y2N0Vypp)w;GlhNzp0$eS38>xPFirg4IS7Q6^U(zT?Qw8Gq;81B}+UVh6a4P
zHQ>{2IRQ7FJ9tOm!8^JJulpU0HTbC$k5D8YKXS|<68k4#HaO^A{ht^dbn?u0<Y9O9
zUo*5xy|3LcT*p!3>o`h$9sRZUmf<cTxXF;aMAdp#2u%V_lMr>JNr*aLN8o$cV7oz3
z7q^>2`lXwuHxo1o(F_j#*?&#WA+VXe<nD7I2l)nbh*2`Oupp$C+~z3`>6Z%b@(`m$
zyKQQSQ8Mzvj1Zn!whAJ6v-r6oe(5b^8{wDYoyA6Y7le#R1@~hiBhuPK%^{;wzmY&P
zX6Jcth>R&b?+qD~9!PHw8IiuS{t(6^AtO@oe@3L>7ZI{cE02c&`a=kr;2sMhWVMHA
z0Z=UvvYUZXh>*Ef>IJ|kfsnaZ#0!M%xR@dkvc$YhfspmK=L>|avm44}?t!!Nn@8ak
z{^rqk<f0Ctc0|a26{7?f+S6VwG$D0RwLr)k3#JN$tgihkG7^JlX9y7ITqq2~Tm)Vw
zxStZnrLbNG86YA1V&$^}jBq0!+eX2N`6e70HsQ#y2}g!aI5KRM6|eCMW*NT4%LMl>
zftLjx+Ar|3pUy=gUZy^@U$DsDF6$C3vP%`sghlq3u9@IvRrVu-MOHh_i=aHv7q_1f
zc-dBU6ap<hBS2i}24$1I{h&{1C8v}O33k~p^S%<`F7_?P9|RY^&3V|9GsguFJC~ZT
z8kPnfB10WC+%<-!#cQ}w7@;oIArsu;p%&TTl(<lfEP82N=qUTc>EuwmtVjoK2FGTG
zy3oUO3qxIK&12I;q3#k~_sP(1^xf%Ip-t$0uRGL<5?|aL3ca-AGB4sX`$I?Bz4yHo
z>X-fy-bUDE`rTg%Bht5vj)#s&e{mmH@iOLMGchdvU(DIi5h?5lqwJ4){|Yr>PrhCz
zxZe$J#B%0kv+T_T#Ebl)ysUKRl~7)`?zI~RLiXruHw<l5SImDx0dI$LWI;R~=8=98
zstof;A(mJxt9u|I%){c_6Z)mdi)v-#!Qo*|XgoL;qdT-#W?YgK1}KJg6FXum!$w(u
zt0T-VYb=`;)`1>0)rPsygQiEqz-L<;*2}_;sZAD{;R)-I32tv#FTPLJN_L*_2&<J8
zp6>_)X&ecwmw-=LFZn;opA74e1zBGYYm*7?3t=Fo_riK*f_o^eUN&vX=VA3S^UiO>
zMx=e)y{KL`x8R1MUbgGRk74z)%DP{}+GNm6hs;w(h8rallWuZ8baA^hoR@SiQiX$c
z)rNz0HHU+B%?`J)KX(4W@sjGND#9)J9JEM&H{Bl&I6It|yt!xrrt2|29&V8oTb>HH
zNW9Zlhr?TmFeyO=?DvGrs7u_Qa2aLUa5CJ&{yqOfxIx+w;S1;Sxe0ZL!!43G7tRj1
zNFbuJ9LFs!63MhE<fJCQ_9gCpG`s=r@B9(BTqlEQ|7A)>Wo-B}+#<oJl4N!U8PP8*
z$dyO9kTDlL=M}YH)Gy1*wafeQZsO2~0v`c=86x_n2NDZHt|Rb&0R4d-XnsO?gbO_}
zH#WjWMJ2>WbfEhZk|JDGN<w-Bhf4zb1GV@q22XI4D<gQKYEosyC@ra)65*5mcygD*
zhx_6s-P+oS(0e5%Z0`*NFZp%SWy(Yf?x!QV(aqSCD4m2jRW$*aPM%r3Bf>-$9BYs0
zrwfjCN0g9@4qc2W!7Y@K2UcB-$ouErN^IOolt&gE`!FJp%sF;Ff+LQ^{TPu)RxG+3
zkw>OHD~Ze_&(!jfdE{q}KyP~x=%iypWHpYifTtH5$)WbGiILU#6sW<cfD8Sfw^kJi
z-r6p?OdhPRiR9(9+8GJ-{74zKm0lPrqjoo~jI^*W*AJYGineWtlu-|CXo=)0zI{(5
zyj9r~DWe>_4n)F=AB{9n|JOoaWHkXNQ9AB-Htx3pbLuds0n4WjOQr!!rVdM{0ZV2j
z2^MS}mdrXVnRQq)Em$%wSSBr4CM!vhNeh-q3zkU>mPreiNeh-q3zo@_f5rfk;qWQh
zjz`jt`{i&fu@m>$iF@qCJ@()pdvK3^<f21*V;_Fnh8}t5C>p>|`!Jg2+g8UL&2o5p
z0l!bYK%PtyjTcCZw!(OU{QBTLqbL{Li;Wk^*&Ty~D2F@91@hv7r;HcKU%K4JOXS$X
zmyM$Q;`UdJX8FdG@x}|J^}qt6lMFf5XY3?%j=gQn!#dDORxBDe4x>-<zB6``DbJ1>
zc_Q4&M0Jv%H7cTbB4riONyqw(gX9MV!Hfen6b45*(7e;(Q9fE_i-~fep@X@|f%fJB
zet0rC$|>(FN{VvIA(rJp&z{bVs+G^{m>V)kK2rei0e50NRS?X;-n5YoIL_aIeZ@gi
z%qob2H+nZYz_KVGd7rjA3N*0V;3t#L!aG4gAE{WA&(zD;bmcQ1^4FxAC<F1r@&y<l
zk7|@3nYAIxApJFIGsYL9;6&RW1?4wHTG$(_e&Bp$uC_YLN3!`|<R>54-bVQGiulR%
zCxCX8ABpml^77s&9~qMGMLv?v?2odruXRG*M>F1xYLY*i;fq?1em?Jy@{xwjt5H5O
zJfNBIk#PYxqFnNUS8qkR<P$Q1F3h|W<&xjrdX90)eJ$shQ0zGyhy{!PjN;{s7E7XC
z^2>qe7$12q>oVmdTl2YSANk;td#H_Wk`GJ@i}sOx!c{a#KAka*;U$$xanVC~%qIL^
z_!<fCg|A`#yoNorbaeJWL3BE5I<TD*iF8w0v`9P~2~Y36Z~DF6iu$GC$F^a8Ym<Wp
zw#mQMRY!Nom*v((cgXKNJ~z5op0MGO=zd(L7j!SWTQ0bx1fP6-;Hl_g%pb;ed*x@j
zN1}V>VVXyx`=t+f)<^eC)pH6$`laCYwaL45p6CwwOvj7S9rE1J@Q60~yHD?r20Rws
zA@9<?5pAZgrum|K<zp&n=K~Aiky^lwrGRrxfFI*tLe!5$i^Qs?kE40o)&8Gop6)h%
z8!Zx_9Qr=GU;4}Jf)J6YeeCyWk*I4@nM7jzScpj^zB3g_n}}VLBTY@%XNGKto7|{e
zaL1Zzi852NNk(m-pJ(!rJLkhqa5GnJ0=op7^S{^Y^|eG<K(gsN2@x}R+dI=#OB9zj
znz~7D**S)nhfiK<;^irm*P2G<_nXS1oBn@JMT@Bk=S7G_Zd4o5ODx^B+te@rY|;@^
zzkG9MpUFU&b1HebclVnhw*0Os3H#4UI9DVIzv-wYV818fcS)mUXX}t@6zjmae9p2j
zOyhDK0hTMa_n8O<yU@kU6qohin0SS$=(dShz}=8n7>j;0@rpO<Pz<ktd#*ttxaBdT
z;>JV4F=oZi^N}%TMdA6#7#;<ko5t7_YqJ9wn?f-Yu*;YbV^@5!_6N?c_;J|}oK5la
z%(NJI*Pj;CfR4o3Vs4QTe*n${F%Ct@)<<F-isfmGV_b^C_BAms#g*viV_b@q*!CEk
z;+rY?j9roNMnVivJhJ0pjDgsY^Ky)VcqZrN7@K1GOn5puG$F>LIAhOeS`~u(M2ttV
zD)U@StK!ph%|xrBApSGTNv;TdH^xEkTeC~yAY0bB_*O-VBMP-D4lNkMqxvxd{DEsR
z9`eD;TQMH;;`Z?vo=_~7$9l+QCm-9YfF0pf{8<+f+o9+y%8hlBX^FO2ry@SRBGyU9
zr_YMDD-@x4JaLB!Cpla^E7qyN?<w%xoQ{85cwid5yPq2AMNY*_Vl&|+UlNzZIu#9$
z_0dknL-hJ+CmDU}$yl&RuGn71I|o~1or>gODF5H*_r>-qMlFY8ouoSbXslE5KdTox
zNh<ApY$$>#G-MRi$p#gB2QI`8DsJ!NrNfHjYY60!*XVrOQ2Z{^NzHiiYOIfbF62M4
zKDs^RKd}xpsq{xwFZ;@FMI(63W(2g4ej>z*?vR~_wo`+Oo+oa{-X-^UqPV-{y<Yy<
zr;PI}w!EN?Be+F}LgEMxG>zbJltXc3OJp2P;pm4VZfj~B_YX~Mjg0dvHf~Cd^DFcZ
z7shG-;TN<P#`zVm$6lrgjzG|+;GPoaR~&p{dYoU8(BVZgZqcDRaWdSC?4MqU)eGW6
z|7l@<$$~h)LN^`S$=(X>J6a3l2=2QR%i;{&pLMI^3|#-dt#Jk};I$Xx?vhap4#oAN
z)%L@r6D_iPk(tXcILCO%(^KafjNImd7vd~jU(u^^BDa0uT%3&)+`c#w_Y3?_;%uDB
zu|E1P34W%Hdt>0MII!F2bQW&WoZE30&L{j8XW?#cfi~w>O5zQ~+{!<rY_dBK2FJIO
zcMQgO3s)1H6mOHYJy;NLq9A7`i4xqi;w{{@q=)1C>HSk({9W=$+~RnU`HFZ8x6$N^
zC%BE9nu$E>^@x|_^KjlsI?i(_!B|ZR?ziLfFg-|1mVOkUPJP^UHQt4-nG0JR7q&Al
zF86dUa&aREa*>F06)c?j+>Lmf?AU|9#ap<%Xu|B_EZaD<hx5b$ep{h6dpM09(BlA3
zCB{Wl0ecSuKW<y7*~6`H0OnwHP7O6%IC5L0*~5KYu{qSk{ef}!!Ofu-?x%AZ=31`h
zXo0zw^Ed!|50;y2xo;}~HTH6|hkGU_6rRR#=2|?SR_?`3lg$?HYRhzU8(xvwSQ@jj
zG-~kNXJf3vbFZWNiki(0l;GZOuEYE~3cRd3Tz>gI>0$q;1p7ZF*sE!vKFK>|ZsSsz
zSIo8CGe?_=T5birr6m_Emc-XkIg3x2YpAd9J8LeXAZM?dnsV+<a|w0m9MD0pdr>tt
zZU_47^H$W$3GR2zD{+r2@2w8!a9uGEa)SG7^EwJL*19>t{j1r+3GTnlMow@CB>3^{
zhB@%`T5zpVPH;yj5ZsY1>!Zgx!JUv`;Z7Y&O|Wpi=O!jtxFwOGpWtWipy1wQ;cmZL
zlVIVdCND^+<^HIETGXWV(Sy_-!{Z69+=h)$CRn(zgR2s1x!niXM_ah_Ni7K?xAkmm
z!X<36ZQLD0dxA{)SVdPtD85f!!q(ElWk1oA(1|7AiRaaRFW&}ZJC?kKGfcUV(2ix*
zj%C$@OZMP07VdoXrwO&(#}(_NYw;>uxZ?w$haGVv2^Q{`S8pXasXf$};TG=Lyzzuq
z^4r&##Jl9CsfNTpJi9)s^tCQo9~E%0ndqZn)&`~Ej!y)%B$}1D7mU18aOWn9n7)9=
zd;yPS0FUGX#sNI$OX%G>TSx=(?wl!!Myg!JOU=ryXJ;jvmFW`~Ci2QVhQ>r*nQ$DC
ziT5H=xiqmkQB)>8(UK@Ce+_vd(L-)|wLQ^8u6p%WjDcv&$>lFmcZD;FymHxb7)j`U
zD*_q*7!FaCI+;Ov$M9aFS@~7_M~MdIyhteX=y53X{xT~v61rKbGErH&__IV&d3^U*
zi8k5i4}K&OmFITfP85~OO<yHCl{i0BIkEkxM5oe$F`@mZ#9HNg)31rO%8VWQq*^6g
zl9*Jh^qnhBs#W&JRwdOcR}?vthA21zhbXuW0d0#JqF|LpWvjO?NmOpx*PH~J@MFX^
z3i2dHrM6{j(sc^_bEp+2y+y(4bBltxh)PdrSCXjQu=G@tsC;he+exCbDE4ZSsQlON
zFOx*2ddh#3L}gX%SdyrmFwKfYWklpxiJ~$w5^9BSvLdrGthAW`Ilq_aA-f00lkVVN
z?oj(XHOYiha2u1&N;pr=%Aai@E6B)dr=EX4IoX5Pw-rmHRoU3%;#-wbsmIl$WZ~R=
z#!1>z)00QZ>{oz4cae*4!{t57Pp9N1`{+juF1|x~4{^4t^2?ewqC>eR$i+L*CVac;
zJsBM3qd#5l;+^E8Q^m=>xMZ)gzP~EDSE*cDmE49~gWTE=2@#KT0PFt%*8jU$>+WKG
zGvJZKT&|*V?qi`PVUYS*n3n8Oic9Atw_zld^9B|q8@c7X8<Ioun}tE;OFP#kLpJO(
zxlbv$y~#f1>b3imeafo!hmw6t@bJNtffMJ!%0HuM8aze=ao_2IWS_GA@CV60<+j6V
z<e>7Q4Ofx}m9I=1O&(M(P5dbt;{0$|8pwgW(m>ARQ3m2f&f`(MeDCYT1Zd|)E#R3%
zXiYMK!*BUHoLe=hJbpTHf{}~bmOa5p37s!6gUT;ny&2?Jg6#^WVaJ8yl3H9V6r*2R
zF?Fg;OT)hNE1#KlljDigi>FQSE0d!4>zAX`i|0@9E8kppner>YJU$fTSHh0a(jZSQ
z4e~VMHchxSBX{Wh(g_asCEKbANi>|N91U4s91YP?j)v$cM?-X!qaixV(clrK({O61
z(>UK%S>3XCLap-9?z0n&++*9`nUF_={{|R`@@Vj}ja*6PrxO5gOen!m2bJ5FjZYX>
z8jGluVWm2NPZ?4E*vU&rmA_Yor{vKPInSdZa-K(nXFjH!S;R|A@YqW57>r!I%A8{4
zKI^rn5Gui)pJL<=tGuY1hCL-yT@a?G$W$FqontKAzSE5<M%6~siWH;j=kvQ$YUrQO
zznW5m<xoQl?$=TXtaUzx;C?HGP++f2abV%QDK-^I$)-Br@?nZiWfTj{HdSxxXDN2o
ziHNUL?5g6FJ1KS*l%I{|S*to@&qa3Cof%)J)T{oiQ>WThueTdhZK{(kNvSqfu-Hrt
zDvA$SQhkb^Y5A!}u5e#*s*$VTZA~$9+1Zt;qnsFdg{`I`jykH0KRqSYMhDEEmP$~I
z7H1+t_4~T{sf4O({X?mQDr03sDxtb?s+llyvkxpy9p!H4U15#fuwX@g?(1wX>c(U1
z#<TEqw#7}U-KsQVOX@JUxYLUIRo`bnpE}I(6L+T$bJ`-{_@e+d(Oxu+{l<P(mFr+?
zzslh{mO7{cDH%CmgcXe{A4(obB{*X1`e-Bf)WAEbMs8bUGvQMS?hjLassmM5kxzBD
zD#YYdt=$=ge5&6T0Ja=#NicFx_Wvi<r_vSNO!cXLTmZG2cLJWMx?%9E1osEYM$R+&
zr&J?1*!Nee5s##mb6TdP8i<l(5{r==k5F2ST-(0+l#xq0Xs{SLRb;fq$Q|v=u+-6T
zV={6R&sAFnm5=S5W$~$Atb!R`u{9HbnP^mb?%XpL3-`{vjTQ@cW!{UHQROF%uUH69
z|F9Ril!E)br9&mS-?I>0+}37dR7t!(Y#CMw?*CX|j<+l$D#87;WjWrb%dsvsU>#VF
zu>tQ;f-7kCBD<<_2X7ry?dUUFJ5*q8I#kQztY}!JD~LkFs=xa{GJp4hG~S()o9I)K
zPg{`-+jEz4?yFI#LuGy%%D+{0!!WGcw6mEQR{ggQaK}z~`nn;}+Mz001}#5WDT(e-
zy?1tha))YDA8?lJGlh(({ytzuBdQBWqR@!yeFxNfso#n^RDN9M^ihkoLsh@vy~GaH
zS5>05LuHMrvUaGxKQ+xdsx<7IZ(WJ)!-(o*;VJ8g3Ot8V)r^G&=24aYC}4^M&?s)S
zj;el12YPS3*E*`&w7lIqszOhEmNKgP&#3})hw72gPHTs1+u>KNBdXa8PFUB`a9XXS
z!AEMrR%JvrX+at}qB`dQ-A-JPMjE->$w{e3j+&5^I;x~5d|)-I1^35RyK2|MJ64|9
zIsY<cRR6mDuGND17IoEnph4Oe^|r%g+NkQjg)ru`bEIjbs_pSnX``xOF+Ocn#T^Ac
z+)74OtCvqm8&&<Z+>1t4x6*<0!Kr4#rWV}RG*K<M%hN>l+hvo}Z0g&SE>kx3+hu7a
zPpBT4!r0X>*&ax<s~=hZK$;!rv)S3n_s>nUv)23T(nPiTbTeUB7rGx!v$KZ#p9x$?
z6rNv|wu3G_|3aEmtx9@1t)0HO{q?kUIK!b{CAi;Ct5;p0{BfFH)w1jJG@Gh3)r%U{
zg4-Y1iFK?8V;{x=jE(9YyXo{kY$y9@Sff5{!+UUUXAfd4Rq1^+=s<_+nPY+Jqe_$!
zmENRgcAL|i)W)Lp^d@yBDok%uqq@>`yJ~sged$K^AM@s>8`Te1W}-&*x%msz8`aAu
zEl%&GJCmMF@5H@y;$8-DF9W!jPTWhQI`j3bs8Kz+Xkofb&7EDHZd3o2wJqJIK4)o5
zZ&Mc*?MrV}XA~VuZ&i<bd(vCgg1a}}qaMrZPxq+5&3ZGvRsDl^eY8gnUx;|rswbL>
zMm2s%rWV{jTpsXm@4wSq)u)&7(pL4W>MQB3>YimUFpcWpO<$xps(({0Oz&3zl=^+T
zO>HdtE8V7UnI+5U!BXnM<L|-azktVo0gu1upYea9T9`h7OAg?Y1Gr=#F4>1m4&aha
z>YsQ27H?CxuGM9LBtf44$qUVBQioN<WDL?N^O7?hWbup&<RnLeGctx%hruGL-koDb
zKGmv&>!U^GmdN~!4%Lc%usYw{(#Q_gQ=vr}9jYZklQTM0kz3|xbf`+=_9qW215f`J
z-=TVHL34&(wJ>E}Mla|mYE(~uwVAN1^wYLw*i~1}&u7f0-!9uu^{W?`@5_L%Z?<Jz
zpur2hK!aCcS1n(7G^0_y(R4PWQ4MEPqk8r3iy4jT_go)k^wFm#L(czLH0T&u4?mW?
z|DV1#?E6oKUu`1($mpbBb$|{)`ObezPEtuS`!L_HE>s6*_F%dPm+ASZ%orDuIe_^C
zm_LB|_4t&jSADb>EFRD<?C%Y$x^{uAau$Of18l%vO#}97E@2CN3Gad-OpkI`Y;aon
zpR=Mt>aVW+Oz;(pGwrG)DV3QHRpP#>nReCch0aX7Dr;J8rd@T*{7|NYoI0a6(?Q16
zo{x2spC&HJG;$BW(o77idyAgT99H)gt<D@#3vN&5FqXrJ8g7V2F2>%PX;+QRej)Q3
z?)^F*33x$P1aF-Haa<AC8po0xSI_Dh$Q)PyvZjp~B>_iBL-iY(fEP2z)$t1lGOyFm
z7%pdytCiwV=D51Va5ZyWT^aFZrcBdezmX}^z`l@arbm0xxVrh|?M#{GT8I_#n!g|T
zHIvr}?!PdWQoLr(175^yz6^t>MafJSuPHpQ&5~*I4Vyy=jo=Q?GU4|=d05X)<WJ`^
zk%`3b$4UHtoCFUrkA|Cj9t{yxLIbNau72oHeAc*HJ`Y-+G%Y0yq@A6`YseS9=obC{
zKv~u;EEBWlz3Ef3ZowBES)xX8Kbmz1%g3gHr*_Rf`X1&Rnu$Rw|K<ElQFASSRaU>M
zJKT%<)waUctbQ!Lek@5*Q+xC(5^)PoT=y<+zaDeyF~@@=IUXFz@!&{~P4mU{{aJR+
zjp_TdM9tObyRt-$B=(i8M$N{VeOZmTZWFFc<Gf!E$0VCDzZLV_G)L`Lq{aEwO`6hh
zD{95PwBlY`aWA7}S4A7qfopYZMvnQjx-}mh^Jk5cpDY~C8YQnU9M0<1RGs=Ft5-Ap
z&=*-|h2XxC)vXcSKVTfs>eh@cq_fS6+BMCD54YpPy*Fy&=C%<{n#eMFHqAtqZ6P@(
ztn8Y+Npm&|p4NsC$dAj9kd4)EWcoGPuMT9wTX;>jU$ei*#TzJNkv<zREPF&_Zc4}=
zA?4MUY`<p31{V)>cD5h)HHvXeBe)B*{hES}ZG>MleItC~xMX8_HpIcEV4RsfuF0MC
za5m&2YqG~R3(6X@{hDw0T9IFK>*%%&CrKS!n(fydUSUN9U$kOH_P8c>dY3S+d7#Xd
zJ+6tL1vI}Aux$Fnz}X0xmF&(Q*9dNJ_PD0-{LXBG$No7#p<*C&guK5xJ6nc1G9E`Q
zc){I~ZQvC>rIdlsDm#+R^L<58i07}^qL6_XF#nGun?ntJd|7X{f&Z%~)NJ6(%1&h)
z_`#ln5Ci{b+1YH6RaKIKpEdzFS;=o?8+aIlfiFCNDcitb-2O>6!A}YykdGGJpJ$tS
z!F@g3M}t=QXk*A#<fE%&0L^LNWm|a2I`GjGGvMiWp*J}n9hp3q?W30-1<ue>D4BW`
zT1%K{MIxU%X+^e=PO1U={++o<<m*qa$Tst~#lRUi5Xj6otbn?L`}b@!|5pLfkS$E`
zlaCU}#@9bgiXtC*ltAN}_Y9mUYE~M(NYs21!%Lk+>CpgD)XeELh@wU|(IE2t;!dMD
z&YJrPBx>Hy_96qH&;$FcqSGLbkXx%W8G@fZJx(NeU2m#5O5Q%=;ziA)ou-gcGE!ZY
z+@wjK(ndIWqQ04^#Vb<FgC%j2|7*z-Yxy&AQOHJn9-Nliq*=M$CN}<4CMO?umTS9B
ztmg%Hx#*)G?cAjREvicL(NCB_-%j4|MJ~L)KKjeXT?!|~HBJ(nG+&ew2<RHI4L>!K
z)mzW&J22hN3+_3hhZo!nL>qmgc3P^3_ib4p?csNBSsx9t#7D(${-}M92oc5QqKL=S
z&EMA(g?e!dq9&*Q8PUPRw-2J`%}3ngATPLEL_g*<YHo$K5yQCT2>-FLL-cEIg?Z5+
zA2P8;9Ko&mXn6>5eoWXcHfnC~-y-Se7k3&&C%OC70nx9yy+4ihYku0F#*X54Mm7K5
zpT-XJ?P)#YF#lAx7Y*}i51bIYd3et_&I|5yVmBXtz>8WnxAS0*=EtVWh=6T}FNm$0
zn|WT;%@_1E6T|#t`R|I|{OyB&u~h@-U^o9pq!q~ml-VF{^&_8(-S>7)K=y056TA7F
zZOufJMpt$n_iGC2=6`96Lf!n?GxI42vAFZL*vp43O=E%nS)`eOvVv$1W20vMeQkt`
zKh13pZPF;`|1P@t+p6LaQNz#G=8W*ITZJ4^6Op9N>E*j;coD(RSg|5o)W986)cC_e
z)4s);=9v+dV+>f_nVjRJA7Th(;6LoKA_E`&3Ovm}k)Ffzw9^zK<JFWE^{We)=H%3C
zzM!wLP9nK8K)gjqr&v)EV^q$~Nn+&e+#Gv=mZ{6(d48fP#7VMym*j{6H-egT(wV-Z
zLpkZp(9xqgjR8YP2Xpe6y~nLc3@`=zb4swa_XPA6{gKleu&k5Ft!4ywXl^z0=(@z*
z5+-w<Be!35ar@ldI!16mmRrZX72K3t!fXv*liR?6590~gd;Dll32rk9pCBV@xZRJa
zGghXtBkG`qCvuHk!<40|MsCIwZCr<HVcfag4pqQG@Fkv`_g3z(nq2yBt|3rxf0%0w
z#F=b?g8ORjc!17)J$F0+dl3PVb+>cJ10aIk54X`=bKuO--*eY7f;%j)1^2rHpHS_X
z?!@Q_6x@&G0WQgdQ~0U89!79)&g;WZ2N=P9JnsU=OBkC1?;*~m2>^Ns^E;V_C$8sR
z!*#FYy0<X@4#o~#tCI;^ZOrcu1bO!2S@Z_FpSX&81LId;MKIc=e88Oi?m&3|*d6$1
z!sPtk!1>R6(Oo<X8s}|t7_}HfS?JM(=_D3<Nyn&VVLW;GX$gK>{SP0;AZl!jd-H9Y
zMTg$ZzeC6MUCb9XeArj{x9GUO@AAPXQA`AB#7q=5juUwkd->B-uCNAv&xBHn=hx>)
zAtxERw|HU=E4XVW8hF(!pqWoi0L^^pg|4h#{?v@w6T$ablIQ2=ufEP|+1e)_oapC^
zk{c$P*r4DiC;It^4qZi^4Dd(P5LK9szoilbh~P~VjX2KG$poxEGEvI{&Svkdb>xZx
zCxcE-oXt)RUX$w!>?<0XIGY8%@&$tS)?vB<V<>wl$WSmI06Xh0({X<qOS2IFT#2P|
zm-)CTxqt}FoF^7QRHvYT2<&uCE*KARxE?4N3p52UEa+okoH8xwl0hrDHx$UUZ#-Z{
zGVL!9SP`#<URJU{(pw4!Rf2nG!8$yCvo^A<r{EHEbk7#@67&4=Eo2J|`(=o!4}7bj
zg@s+SgB9FE1v}VfonIEL!}D?}j|6>J0Q^4-+F95~ovh#vDePpweKxkRorOKs!}b+r
z74~6%4-4~Mhvm@6!dbQhqaBZG9hSf)=8e6R3VGaeQy@I`1lWxa6!tJ6nE}>rTv0f{
zUOT<H(0Q*GmXd>zI6fp=7?9OEETuaXL<8<nQ497JItaa^yRb3fPJJ73i8-)mJ9Xin
zJhATzI%7o_*wNzyg*~j;wS|OU-YV?DU(a1)A^zXPZkqm|!XZo#VF@$^));@loIeY$
z;n`iov%Ze$>v&#67#o<eg<ZmR*3h+`YQVD_Vl^)Tomcm8wjoe+oU^TC%l1wxoQ=^C
z`2Nu#n=cS%J)8YA@`plW;AvYFYG9zp@j$_yYAa!&q)XdZlx0h2pyVw)BbOE=d<)M7
z_$vz6;TF;vkeDxU)AYGHcd(pA&9NzPCb}A}h{M^5qGnepc>8#_N}vT%b1Tt`pq;l0
zMNRJWR-~1H<r$>x$z3*}!TwBs{t64VmgJQ%(3e)SY5FI&JocBMFKy`z&`$K=F*qqE
z)juQFuz4x_vufD#{QX(!l6!Q-44{ESvpAPe0vxk;M(WQtQ8TdTuI&~L5;JQ9%E%&7
zlmDm})vzjD3y@}?n6rfxHTH)IM6=8(I9akoltpIk+SH$IJ~}%DJnF!b+oE3+SfVYu
z#IzjWPBjItP4yzbCTReXKyJTxNKsSZ%DUURqniAeKO_cKV3Wr*`7c|MSu1@$vdFJ_
zy22FFtp$A;VxqfJikbogAGM-xEy$`VaHcDxXizoN1s=}X<FA-y+L^ArqF(K3uB1q&
z{n%1n<kvh?0VNyGdQnrL>k$}_b^iTDy~^RNSw*dyu_>kyLc6SULD8UAaJM87{EWU-
zk<be6M~eovYR`nUQO%hn>!W>I!QEKY6!>k475TK^KHF5(6xi~J75OxqsVi)wX7189
zVoY=9$mUQ#F4?W!TJ&s@UkiFjVDxJZT~<VBZ=bQE8j0Y(RCEFB!!-uh3utZ51+4kC
zvWXoPWVcqE{AE$U`u5Cki&_|1oo?+1N4_j-VL;{=*qoXViEiy*kN#ZL!hq!au%0`K
zn(n(rJFuR+v|<<h|D-IPEgoVFU0ksXOLA1Zf5wEgP<G5v5bf72n$;!D#u=?W%sq~|
zyGwu_x`lKS#k+;#9_G6jp|wrZ6N*Dwpm}9+aB4Bl9ye^KS{OjHmVdsWxPgIPJcjK<
z0|P5%!1m-8p6P6M!%OyJptU&-jG=2%aUBD>VYl$CXS0{Ow^O%hF}SAq7M|U>wsL-L
z@j6^<9FM%6h4O?BpWs*r*5O*M_*PpZxtjfOF|_bxagAi@v<=1MfxkX=!!RBQ7O6(U
z!e2@xg8TX65%tPx2a9Do1AD&M9+0a1S229$G(%{Ryc+sx@p3GU<@Yj&0|fWY;#>5x
z&Yy}$>AA1`S-esrxC2VoVO%Ns_SyK7brM)#6M|ECls>dzVu_94>zr94YSwfvENPKI
z1gu4}x%7#WYdEIlK(FAx7=7^g>JkS!8p%r?DB~pjOJ{S+hLUUa<dfT}YxKX%wvgB8
z*(bdv*XUe(E;3T7su!3Y62bj)$u+v})xMH;Ot(n-Lf$KBk-Ymr8rvxm+@F_pN={Gt
zwxmUJwDi3ahyy&H&?AA>gqZwqB@l;Klr~5nEDkB{P+69FktN`Fld04auwY>`QO(lx
z;UpTHo=^<CAf?o$1uNHwrO}726Y%$E4Pef|KlW-_=aSNTo#1}5v=L*y?%QWqmp1A^
zG8b^k3%F#5YKzH>v=Y!0tt7MSn!K7~E4xc?(Ljrubwwvjn{@asC$}#W&M6pqFV}V;
zjqT;S56oww{Mk~-Jh@m}C)t(YMTP*u{Z*+U0QP2`WN5<vERQa@{#L0+$4_b_Y?_x3
zznL#;UOs%Mbe#nDh>hQ4BE?(ul^3^DoCGuzP@BWyb>}3YdnF8LT?r#Oyq&tkWOn^t
zdI#H|YW9zL+o=Z0v)QQ360kN~Rb~mW?+Gb0q0XeIBTNV~Z|fwJmw{D3`p6Zw54R7f
z&FRDK_u=+0G5(hx&hF(8=BKd(Y~f3(Wp}Xz25@;mZO#BLKY+{kNlcGg(YR*Pto$-x
zAnfZ4xFn!9=K?Ny0heslft_(FuLdO)x9Oma8PhK1JSL&|I#XU!S$2&nDRGpU@t*3?
zLCzr{jCtBiQ?krB`ccPR4VqmxB!P&~Z1&BdgkrO%WP5#?C!oB<icjY`Sr=Fs)pfkS
zv)OHM!eaV5K8a?tFh{etyyW?^@c>2e+?;k6+H?eFc6re{+@`1jdOYC!C@(T=dmHwZ
z)v$k0f4NN5ygzWPtQ(K2_ntmrx?eXpX&U3y#PyvjyNl1Je%;1N`HZNE=(|*Q3y-H?
zC)w9Vh#I)j^y<9i71pntLtbI~aXbAwOL-eH9&mEkRn)Kh@##Bd2Kd@na3T2XMH4!D
z=Jzs#_T&4ls0n>b{$A!n3*#<R;{kaoWVwr48+Vyn$Hdag@(u)FiaD9JaR-&~?cUew
zrob=5=jIwD_aCyNkwC$%D+jcqVcpsAY0NMl=P(}IFdoSWp3yKK&!|pthn5fPR!_=j
z#&m)^x_nHxF)5)O{=AV@-it1{3o%_*4u9b&D>vNxc8@+&;wUHd_vqPM=9J6y#-cq0
z;G^XP1K&K#^tHBx82Iw>iE<CQ#m2`H%*%Dpmdo^ZTS5%Myp#UBY#7UdV6LVkxraHb
zhyN{%Rl@9k-Wkq$nBB{~h}VOj@cPz=-Q~O<{&6%&zPAK&q${&p$_GjLsh#Bp$?Zw|
zFm{z2Bv(3m$_GjK!o`Qts2AKP%Z>V~^>37$_1OE>!#gIkzWnfe<p#+c9scq$-I0!K
z<zu>rWj~aU>NJJ#l@F4WGred`*L>!;@=;ymLtZqh+k1wUkLspAL{u0g=N=*|Ms*nv
z$ty;6J0H4=Ms>jt(b;3VWoP&bf?0MZvO<RQ3<>7#{u>6F;-mf$6Tz5UQ!8W&%eKr4
zg1Pn(oeh{@AyfRhP+lQZoLy2~K``etE>kiEjtem_3-?#Z6jog8-*wQ=m$)^UmrMcD
zkSXrP8yBr<Cd`Uv6JYnkX2PKt+z(ek3ri~O`j<`+$gW>>$W_5Jh37X^jOvbLv{pFr
z3Oe;TPeTG6yIyebsu&~}Wfn0O_RCKA`m$_bUxkHzzw@OE$Y_0~f@gM~-%v3~4tBp+
zZrAU&c+ogP7*1CB$b_uR)Hory&sRYHwl;d4h~Mx|g^&Ex>_v7xed2=(m;8r}e8wgJ
zy5QpqyWYF!^9q+dn9M~k`Rz%g$#?KB28=_aI)AXc{Eh@-*9OVnhk=F&_L%PedH<^*
znEU7bT|qD(m|43`DY$w29SP(u)awOzguPyW)E;4%DIrhzjs&t1;Lkq^c32UMeN4B$
zL$r$ukiT6&^GvC|UJp5|<3!ko$@Y3ZWIT=&Uq#nu*6Sfp31;*wQ?CzS1pKB0X>6k&
z@~p;*@5@XS(9`UY0o#%Qt<~D=_1_r0$iQyv$wZC%H@Rj4`n}0D>OVC+YH!rT-5;`%
zpSIg@o>jfxlHZtU*YC`F)^6AT@AyW0y*@D2itPIGGp+VU{hUdcDS~Nz_%dZv^kn5T
zHpN2+U$om5tEK|>#z8jnLoentjr!WIW};CaR$36!sMnPigw*RH%cx$TxTqyzO!wqw
zY51saXGaTbkc8z;VGPpyP9L-zq@#!S20?~1jWe79U!M5@&S&nm!`G%CU>veH={M{-
zOnAt4;+U>Ue|5=cc7tAUe`B{Ry4ONh@Y`z-6Ba$h*_`BtQ@8D{_q2=rt{7;1|B^sH
z4`3W>(m%0=m)i9SM@sF4UT{;Dc75=XT06)yu#(Wf^&Ci`^vJVzLjUG-@MYP_-mpp<
zz7wn@^#95|OwiJ*^<pKV|Mw&-qNT8-8}*OP6ANl(h3AVa>-Dpz-B)SXKVR`cWxf8~
zYGs&R&m5UoY1WV1K-(8|G*lY&w<oQtH0a;nzqazO1Tt9eN+5%U(4RFwNwn&3)Zd6A
z^n0dcB0`_4ey)<xXD<T!r_9*MR(-g0TctsNwQN@<p?_r3p~^OW%!I?0ZF<4oTX|Ok
zS?hPP#@@x6*{X;C9Nxv+XhKo@qR=3=Y(9(~I{GEJm5=W@T{#lyt<#nJ^|r#nO21xk
zSC+Nv;k&ao{o7?}Y=>@Z@w=5~?VTO}t{m12?rW7p*iYc_SE7D>*eNS2Vd1pp@Hdqm
zx)sGgRpzm9@@l1!WntD@=hIcA`tDQVRTuF24tJBdsxf`-A$j%y=8WnKPi0nxN(Hy0
zN*09QCg?wGNMl9KbIo(BLZ!-5D6=b|u1eIrGUt)1aeeKfrB$*Z;2VO(L#r_VxhhUN
z$n2~d*N^kcFk_J5K3p}fe|Gg(f#dqtfUg2a_1of3R*mW>=-;U_2EpBMRR7(IPpY(1
z_?w?r3V-u6YtL2m6c~c8tpBD;)XWO^qH+D%<3Cp!g1V0XStV-xXS`@sUvN-S4c?%x
z+7NX7czCrX=>CJT)#G~kPI&s?hQ#UyM*di3Sp%c!f;bG&1FZb9^y(3O6BIRHh8I_h
znz-I7jNp^hN8ev9YCfgzuNJWc`c*s6JF7*_H;d%iwjl6DZ9yLkKtI!Pg|!8(4Tt;n
z*Lo`wgIbJ$-`o%F9GVVzua{d(7F64U0F6O)M18fWX~PkI<p5x7I7A5X8@d2^e_FzT
zuab^$H|Y#`Yv~g3QrdWsRX3k;0HVYh2d<)SKK{T}<RIGSd`NJ31x+{;-hoH%2%1+5
zk^Iy~`0v@2MqcU+s#>$W+8MNe#rkR!))RtCnti!C=^y%Xxr_JwQx`_=2&$aZOgMr{
zY5|ut&#kg)Cd_FjWXkZ#*Q#a8l*wOLw+0FBTh$%Rr3x3{hTp8U{qxVv|HC`gfPYkr
z#7q-?Uq6#>x=i&m_x|~|tLrjVkH4d-m&5-I0lE8p<VYs)FBV@#_3|%Pb(Po48y^e2
zuU_8W<wbT@x!kA(PQ-l<_KQ_1_rd=J%I|}`%^Q@1ooI93=OOp(oNEC3sr%r2_O<sl
z%Ksm2Zv!65aTSVI&uFC4Y9-CgT0fhW*5lauS^p@O_QziDk3IU^ovbu7(#&e@1Yfx|
zQ<6H{(>?C)S!oh;z0zU_zXXgEgyDh-A(-HeeS?WZfY|q4LjrdR3HSxyyg>5u3>ff(
zTnO9%1_JLp=Tvo9&q%fd!Txqs=bY;5>iRi#>YP)j_U9j-y?56;@;^4KMNj8HGJEeX
z`#rxfJJ<f+rT;oR*Iu`NYxb!2J4e1Y+u8m@H~h)&CkD{UFtG2zKc0PJ0AeV0w*TP6
zugpF%08x_Q_pfH37=W`X@cZiQuMYhFC&$>Y4*cVFU%Cl?Ykj{ukmP{*#lpL9fKxDU
zx(<H7bkk97@Rr><_)X=GigPhv>>I=A7W;C~_hqcN<eo_M-TxEX6N&#){0Z&(zI_iK
z%gqhk{l5Qn=1_d!gEP4+efu8#zT68a*S#QQ>3t9K+?774!_maMKU>QkO%y-7mOGmG
z{52n9nZy@w1u1v;{tvNi;^|v|VfsoR%-KWnkL(#^&-dN_OB=~X^1oeuf3AVHhOgon
zXrT4vs{^3x`0Bt@_dJmM>cBJO59E#}e*crT+@bi5#-Frb7eCbgf!x!*(b${Wl>xAB
zKQizu@BOjdm4ST^{#5SDfN}2Q`1?z_<8jzqY0>?8h}-av{AT}+@pb2GyB-?Y_>uQ%
zcMbgfC!Wt~(cjd6cLpMfWxy-OdiM>_;_s9At3~6#aE#qG@SUNLUw@?!{Nj!#<nP|2
zKZkif*a74JgB`zf=1<x`*m35m_h~<ezaQ-QjbHiA+|PA<-1^Pj2Rr`fnLl8oIODQC
zKYRC=a`*N^`sdo<_euPH27jL=41<V>Pck@@@+_vG#q{Se{W(lOgXw25{e0KoX8vdH
z3Z9F(W;gu4vKzd4ui0IE2YB}Z=BxhiAFxqOA3{&sL*#XjTzwK}Wd^CwcYWih|1|f?
zz`h6nCilv~c;QXgJ>T{5XI{;{G7z2p5PN0dw}1Mcn_n3?QuwpI-x_!{8_#EYQ$MpO
zKZIVUnO^js8esEpX0HsSX8(Y_GVs6Vz`t?)nXB`!4BY(8^?7X&ty%*|pSd}&4gU7s
zx8$|KXC8ht(+0ov@S9oZV8`CWhqb{M_hs_h;0-@I#<am-ES$-AruO{`*s7lYz%@s|
z*4BCRe7^Il|E%4U2OA=s*MPG&cSS#!{lB!Ax*+|vHu{CH{*$)Fy)W!J-uB$-ukE@n
z0$PjbcLViz+Wv_>*Yji)ey_vyeVCq%!|y+1`Uj%0TmOM5obr2Bd-7WS$g|N$@A(kh
z*gbUn|B;`JKKuhelAnpb>$&%76^Qup_6o`gGtsA?`$Ycf-GA`$U(Q$JKXUomd?gNT
zJBRhWstrmo@%Ipx_EX{)JRA;SRK16~AHC;)<bMKxOGv#g0{)-ZMPOyW()Kq=jeV{i
ztZC1p&-SzU>=Rf0;uA0AU%6`EgMXNR<*HxiFXdmk>MuV#a`2U_9(zChp8D)x<X^e!
z5#!rP{dWFJ+yBEfX3`iyJ?$iVWlW;4?<D#)O`@;wB>MV3vU}+9?gB(_OAL6p*54Ng
z55P=kSNZ0`HG@x$9xYrm_~!l7h3DHId;jyf1B0obDHTQs|HtDWVx7^6_g4xK>-Dkp
zM?1!Q+(KvcmLFd)Jm2<Li<b&NfTeXt>kq^EzOUZ%Xkm14--AC@7#;lEyMMMYI(Yov
z+usBw{5(GO%LT9F8(R0N=X<`X{d(cm)IHaHh;?3d{p1I)hjsQp9oxJ6<U4=6pzZ$S
zPn~<)-rWPwe7SIR@FS=HsL;84??*qx9_rcm;I|47_3Zkwe<^hC{@eR+e^ck~g-Q55
zIUAdMsOL*Jbj>}~<IN7wHG1|vc-`Cw<KRF1P!IU!KGb9U<e|BTdcbn`!8r6t1O0Cs
zJ!c-ceXh}?*Qe$l>iNE(Ju_$Y?t8E_*NGOK&fVWyfU{TN`I#Bq_u$H0X7E2hri~cr
zi)i%z;MHTy=>41by_p%k6YG$E{H^etSO=>2*6Lhl@Lzv+ZSJL><c~t0Z~Wl>b1(Jm
z|Izo)Wd<_~Q06uGd*~xSJeL_f@`0b4%M3nq%~Nxk!S;tH-jo^a{UP}Mg-^auGkU-H
zlh4c<z2~p{?3~ft_s-v%GkQ1OFU=Xf<+r{#ml=Gj__aBsw~PPL+)F*z%-$0<dT$$s
znt*4f(X0LFr^X)Y0iWu*!E46<a&B%g{Zp^b%?<wPPqxoL();W4^PP|MjwYUqJ<>aw
z0FS$$?0qhl8NB+#sd=LpJhe)6z5qSA9_j%vtP+k}@L1bFzn2x+vB<f|V&uWdCnIyw
z<>>v<$D^N&{=d<Gh(6Nxv9@otrQ1)mf35u=+W)n^y`#IMKYk^CN9R+Wzt?$w*YEH8
z|8_mt^^aZe+x_L;f8I0S`}@6L>wP5gmBf3K4<zr{b9&Ev_B^}iU-x9Ly8Eh)tM>PO
zwQs!tuKpkGf1>}XfsYT4?Y+GBANIcKP5(TUx%xd<-+T3?t3Pn{uU-B8)wiTG>0eF%
z_w<$Y@1_6m^f%Ifn*L_`f2aQ?-F{8aHR)^Kam`O(bMv*gTswE&%v=8Ct*^fIz}t?#
zE&Dd}ZKvNp_x2xq`$yjXOK*Sn?aK$M2fPCxJn+*8e(%6v9T>X)%=Hgk|J?O2Tz}0C
z<2Ph)_|y$|-}r+!{+Am+dSmBJ`I|m{)83KOBl(f@BOe&~@sSrs{$?cmj-P)=$IX+Y
zuZ~8>tg+|Desk>MgP%G0=Li4l;NKnm&cUBQe8Z7LN1i<L%#o9~)Ngt8mS4N&*Khgl
zTe@yLecQrqkKK0Vw!gjYs$++bojk^mec;%Kj{VHB#POSs-*)`e@zU{&$AA3z<HtXD
z{L9Dx@c3UH|L5bKC;CsEJ#qI5exiC}?Zo{j-hblZ6F+g{qbHs?apvTulmB!wdVAOH
zZ@K*=xBv3(U%b8jjy-qWd`ISvd+&Jqj<4MD=Xd<e9kI-8W+h{1HZwnx`AFu!W}eM_
zG4mIh503xr_@~A{H=dgKp^4v{_@jwklj+Io<j+k0#^j5We?2)lRi66r)LW;Qrrqfu
zp8n?aH&4Hsz5bmqzw;m8Iez9hXI`9{$o*RG>$&B;m%l&%(Y#jZD_mW8xNyT9Yx(c-
z{$|Yos>1Is1ruWf{mr<Z$n)Pv_YJ83z4LS{?hEg0#eMsDb9s^5e)q$z?|Aky{2gVN
zS%Y0>m)L@~#kMqEThPkdg2uH4t)a2l!`fwbMO)Cmpe<-GXbakx@!yvAZS69PMlQ2V
z<T86IvZXy8>5f0FZE2U-miC8{%k1ls%S?+xxtH17qE|Y<7_D{vZnQgou<bJA+LrdQ
zwk_@6*k$&A#{MqxeC+QMzY)94em6Fqd?9u=`Q_Mql3$5!C0~whX=mEEv_|{8_uSw9
zz@AI(@80u3`!DTjwEy*<``h<ib*cTY_dL*Eyy_F}EOu{fOFP_gqW@^ef|l)A(9U!$
zXtNy)TE3$@ey(FdTkP1<^o}j9+_9jobi8H2=r}oWzT+(ecE^toe57MK`O%KE$&YnR
zCqLeCdhn@^#^9H=%j`EgwzMzD-n{oKv7>vx-m##4qhmpPF21GxM!Y-za*V~+Ivaxz
zYYW;#o!#+AIv2DLcLIGud%SZ&JJ@#Y>aTZR={(rBeD&XVLfdr5xz-)OVb_9oaMyx%
zbk~CR_npgEKddcZ%{9n#nf?8)1?|;cEcQ>kzW>c1>tHdht1)=6ZA<$=*OS+NpzGOd
zKhV`3|3KH4_Svol?YXW6?YFuXv@dj>zm99?ulr)xg7!k!g7)RE1?}aov&mz-r;{gk
zPbc5KdqI0>_m<Yty`_DlV@tcXdrLde&0+_-pS<?*&X?YPpu0Q%cxQL~x$Z6Pq1`XN
z{bB8;w|~6@`t#XqAMf1KZt2<5j`eJ5k9R(K?JYe|Uc1<{rMW#@TD@mWTkF}<KHBlb
z4KH^+al?V`<*P5TC$D{I_mkH?tUY<{OFdg!ws%W=_wFt2BOQ?M6F0rw^@*GEfa~4T
z?(W^v7JEN&livG@n~Ywl--7l^@76osmgtV(p18~&@9Y|TXm{7x!&=wa`J{KSn)D93
zNfvuK*&Tl+`RuiSk$m>rZzi9;_T}WW*S?ZW9{!7D^6<;a<l(zgTiRWz?)Y7)XRp00
zl{|c~t!u1r&t-P7tvi1Hs_yuQuj-Cx`YyAnzR%ots_!$mo$0&G=K3zPa^Gcks_!!U
zKwtaugKh1{Ki_wm{Z`*)Hr#)iy{-Q;dq@ADoqR|Cw@#kwgMX0TxcyY$#_f0a!}IOO
z@9#f-$Em*4cRbR6&mH&opTA?P|DHQe^_{=t(f-TqGyPw><B$8(nXUeG=F$E?JNd2t
z6Pa)K-<^52|3v0g-`$z-^nd2I<iMBiI682d-9B)c<p(Y^K5$_C+x<r;zCCbY{8Zo3
ziFXWMW|_gu?2-Pl$*ume$=N|Dw=ntP!CR)b`fr(fwEynRXZlN1f877BsjdEZO+DJb
zar+<lKRC73|KQZ4{ogwInf{MWeY<~h`c&WK^eubuobKBL|GMLk^uIj4)&KJJb9*nd
ziG7#Z!}~6?$Mzi<e|lf)%xCtc&iuu`%j~Y9?)c)+f1jxjb;s9+y5m1Nw0HKSLwjcr
zcZ|<IJ~Tf2#E?Dvg2rNB)>!NdT`a~m7W>4|miE+;J^RTa7JGWAJN~Jm?)axMy`X(+
zXhHkcAr|}W&{t-)D2&JU+{fBj?3JOzxtoT&;|GVIz4q|%v)6v1t2_Rgeb9GzP9N@w
z7hdVTzHp#BdAPiPOZ&36e6_KEOZ$Shr8V|%Y46()W3_7xncMLR)3*4@>sZEhd3DJ&
zxVu<vxE`;LlvW+CR}5=qWMWmfEN;5T1f}2@7j%!0OxO;eF_w-kj^4})_S)#p?0D8P
zJVQ5)_wtiVi;JT--@JG;JAO86c?ZWz_9QPCJ!jf>&RF)ERjlf!nX6ZqxN~x4adE=o
zy2mqCWkN5na=HWgzQg$ZDej%(7I%ztsZryTeA$4v*cLtpxdk<#hzAR{X`Y&ZY?L}@
zJLkD`-z`WCs#-GL@p}0@_uPzCDLF>9YFH~+|53;|UN_7NfCt9_oU+`y!;7oB!z(kk
zUg1bPg0z$6#l=a(t(kgb!qi<Cky-14eV#)tPU}|1<R#rbf1fDI<Iap-K965wTOPNt
z_M-=Z3N--&{GHZKb4f3szi;doq|NBAm$fQ<J-@u5n{^Hi19^)^wUVvY%=?aFwvn=D
zJ6Lsqpk}s<`OfKvH*Gr;qS)+mj+eRX>Q3W6%zBD@Gj>@w`K0dYxq20vx1c*7JUh=_
z+q}T>_4kb(+U~m#9tyo3p;O#Dt-Greb_HvofTCMQ4@0&I-70f4<2I}^JUWKR749t-
zjTKAx>JC0VqrbO7BgRMHM_F5{g4k2s6C=DKUM@lL@<W(yq%5mEdIT$DS8H_~m1k=e
z-Q&=eWgYrx+SFHEC@Skt8m?}d_8PB@H|F^=bj5u~@$pmKD|+=MXk8BDgx;*8<lAov
zzx^=68PkNf@w1lUkJU=Xadi9!NzL&!#L2;ZOE5@bNEy}&x4eR5*SO;u+zp03)+YeB
z%PdNR=BIu!@#E#NndBy4(LI{$w{AND5POPy(}u}sxV7S~idF~^z(($)j3uWrZ97%n
z1D0{*5RLv2s%YA4BJ(Nk&Dxc^DTfmQvPEwVx9Hfdh$uLArC#R#@RHNJq%WEH8IVVJ
zTwYw|+{;=8-O){xn}SqYb?mk5@?^bc8qoGrmgh8bdX>8(!+hPMvMUIlwBQf)pT`}i
zUh|A4lNU|SYd60p#|0MQj>wlETO1wTc8-m{;jS4~UpKX0=H@)tE8IaIehdooYYq?W
z+z6xW__Xa%BMW#NrgzVF^(Ay>WyQgo`Rz0cXtm+S01@h`%HrZdEVBV4)-)`RLmqGo
z9J=_(As|Dw{09#C#IeIi{PgJ9t@n(wd5#@;&nTO&TjhI3**UJCpXbZm;Z~X7Gs?2W
zRdx4#(XKm)0s#1d$)TNn^el%JENd;>xD?$p%5rtngy96mOj*D?C4_Ygp(bo=*;uJN
zyh5D_=-0{xmB_5=hSx&zE3A^?vrbLWvIDtS>(=>v-7DKwth#R1b#tD(+-v$=7!{CT
z8CV6!t{N_2&suAaUJKw!+wyYQrBtDE-Ep|(&DD7w$^71Wm@=-fK;3NTJamhE^F1&|
z8&(<D9cXWy4H6o+>sEzVgeY>)D5C`!he5%%0RtmCZ<&o^O}7BF*W_3;Y(R{gcKJN7
zKsJ0)zQ&y<+BwG%15+i6(SnV7*5yv7ED82nkQQ&BuuYRoB#al`F<b<SW!=;r7zZTv
zV29x6&|H)a0F5!ry;Zw{tSKP)P1Q`DF<dWzPC51(R5ho2#sxlJUtUIZQD5dX5@vPB
zU4<EqmBA(~+KzXcn>8wc#Hm(-kT^0{W1hQp)0@?6f<PatKCNJaR#1@Hse9|XX?Ts+
zN4KHmm)^t6-Zli$g4l6XEKMBGrjJwRl0f-OIJ8=bL>vN|itA2!6`R|=XOv0)H)Gqi
zqNjTt7yo-k83-^%?zIm4B44R;3kcMRKA44<-ZRRO1tWVE2z(3%7fg$+$EyJ&U)JlU
zhtlCXmI$AO)tJ@GtA@qL?RBWL=h)T?rKhSjuYqq?2IefU+72LK1WoJksSR}u2dJ#<
zLSSgP!~xPhw`zF2SkudVM)wR0P$F?0=agv%EPYJieC|EQGL;K@%{Vy5&Tz-#=D{(R
zg;mkg&5?74b#RP{RWN(jTb@|eo#O(A^vRJ4-StW~?Ic)^ucJ6{a16hWQof)-;PGk0
zG_zK%?gcBtSXh`J+i6jxnR9G$EW9j^?Yu0GwXS!gM;C9tXN(q@F@ILz8ZidrrGh&Z
z-2@(u;s>C)17nKV_n6>~^%~Ix>w{W{7}OXOOlT~`0+m@lM#C_KIl~)Rd_gxbgIhKX
zXzI||A7j}`0}I!k29yt6_-w6Y7wk3e<d?_TjJ-0(vTng%YiitsuidzX6}#l<hQ*y@
ziwCKZ4yxaK5N4eV+Ydf^^yWhh<eaSQgK{qu$P9;kNq}W)HEva=O<VVl9AY$TjvVqw
zjh}<ka@bAS)&-DymrOoVvWW(7Eg9wW6LuY8_=K~TZW=2VuVfE}zxdELB3-Z=xFZ3N
zIJS6*KKYRP$%j~>4uhAkaED$!sW;rLHEUbm>cJz2eN@TzQLS%m*_<CnNjYG2&{~IC
z$<ZyhY*%>6KI<)y9%1K<3b$|+NDQ>q=n*z<c)l3bTB{?iwL0<!YSk)&ez#A_IeJSI
zry0GK`8|Z)=F5FF#!L2Tz8>J9_Ge4ex4tn2$l|Sxc+9D~QSl2o>n-2f)S$PrQ{0=^
z*GP{6o9K)S?fC}Z)7m^o*>SPi0nr$n1@`$I))iy}libq{(>=+~Wpf9|7N@f_Q;V5W
zX+ArCwluXknJH!1wC;MO2*J<JJI0D(=_V{Kj%^kufQ90$Lk>ELnPw)klPp`VlQsah
zIwc!%1ylEyZKs-@^dFmA*UR1{n>sD$lu#VFBSPXC*IgcF>sdFa=lm&{$5$2$_-9sM
zFBVu~K0h&4EavAIb7yDAr{+N{wAaS<O17%6aA>C*E?%~CdY(-!Oyx@O>7}Xp#mTAS
z#C*0;%FnanJS$F3oSn~>?h4wZ$WBdR=BcSW7qhwP{Nl{i!qiNWO<B;5P7ab-AQC5L
zGQ}b*WM&p;va{LJ)a2qsK3AH$v&2Xbk+ob8#O3^QNiZw950DsNd;<jRfa|7N(7jb?
z)N^dUG_#m5E=<iAv-upnaq3P{a*nSF36wRDixH77mREUI$G1RfD5sTd(fly_Sf*0J
zzf`2y;WzTmw82fHoZ{YgXut0f!i7pHXrgX{?nM@$g7bCDGpc-|?s|4L<9Uv;RQHHP
z1qO4YWwNNkzh5>@4g?nr$D^%_ZPs!0W2Om`abPos2ppBuhUsw!VX*)zn3B_gCY<Lh
zhU+;Eg>s5}t>1ah@K&?d1>G@pi^wFHg8E@zUqcLb0*JcA`Ik)4FXH-3bwJr2+c8sL
zH%vo!h#)4xJYN<o#>g!9^a|C*0^ZGi1iYi**cXfncYI`^%4s3V0;Vo-%L|n<bwM}l
z$Uur7sSSdvG_hZ?YWi~yADDLZDqk>k6nRWziJ>Gu3%bM=PQ4By=D2Au?KpbxG~FdR
zT&Q`V2SH5+QWfLtWpkuzES1H)0tH*K#><SBfC<~IS1m+fe`j2&+CyAOIbw3%s@G=h
z6+;%5<F3amh5C|dl%daQ8hZxqc?nH96=1@%oe(1H=4?;E+pPRT_=6pwHNj1@q_0R6
z=!QU_QK1nJa=l-s06<q;vi(JlshSa=bs|JU5e%&nRX$>2oeOo5NJ@=~XeUam;yiQ=
zC8$#3Io%++nuW#e*Z6u-$3PG{UOG84YhU0Xm;D<a#w}2D2~bC=E1$8;#A)U^>PiWq
zq}+NCG|xeStB$Wp?v@#J6()|i>J3j;D0hXS5<g>Ako}=}M_rk%uzBv)9V=U50j=QJ
zplG)p!e*%$oR|1O)xN-|4afB|&PsN9o}0SID<I!rFuX>#LfVu%Kh5<D!#QUxHxO8`
zVT_v``p*A61cZtZ(}Ld#u69cII8|1DIs%|i5omXNH0q36uv94N2K|ip*1797;apJv
zf{^xJABmMzn@?e9VSMnGqQ`a9uvT#I4AzVto^K(YweXMRxWsuzvKFjAF3KxlM<My{
z_|Ca}vG{oD<c+11BVY~s9u+z|cB@*b>`w%+tK=e-vk^CKSd}Tej2)b*z@Th4Qn4n>
z10$8457HA;>mCO^TfyPW#=1|;y0iNFB(Hg^z{3%BihD3oz<whiVp-QuQZEUuom3n(
zfkl3=#FU)IBnPnz$`f-!t~2wzY&#NL<h;VB9lJWKTlxyT$gVX?wuFFk)~X7qWGiXx
zdXSDlkiaKbdHH<FsB*jR&2!k82MsO8OLjTqc|;N1PlA)&G%kQd>miua9mih7eN)NC
zea52f(`AENOY}818ob$WBng$AhS-C`S4iv|7Nvv7OSb<o_p&Y+7@>-`XDm0U8HBo%
zK3Am04qMm_$Y_a`q8$%tFL{N*UI_(c!&)hFM9uSMhr6pY_R5N3txQ?4{>b8Boxm4^
z{?xE7NzJ-4HLJr4M2bm*{El}6yx?KuoR%qp@pT{}Y}WO`lG7-1uZcR@u=FY@C}Ff!
zYX(qYMbFo`B?c6>kH3v%S+`k=1xqs$WUAyea3K)piHZ<T@)x*cf|eA@MOz{=cbWhJ
zjV9l?T?G-CFfCi%5g0iYl5r@B^8u$ggE=meudUS=nSf28G*>Wn!xBirGz?N1^9md1
zD~46{Z1DuNjD*M#HeuSXXg!e>9Y6pTn6o_rOY<4YCVqcNP>@Sb-2&s9Kj(y@6Pg<v
zE<n%=V1SbxP7_K_EL9r@Qwla@CGJ!W3p4Ftb)&X&N19DQa<+}zHi(fYNAjr7HaV1q
zMwhdet1ojEtqw;af;Q897zSz+aT+wg_}#EioVRWKHnHlTweGDW0_IH7)19C}lo4L6
z*J?JBS_XeW%DS0a&1{g3yZH%Pkc{`zCZUNq%RTNW1^H`k3rUEy+hz^tD(JwE#2V2|
zloGr6QtCV*WhmoPX>o-JDjL+fmhA0wwDwm(6Iw-NhMt^=6WsC~-JCQWY^BDuvF;b6
zSlZbevd7Eb<8Ik8YM$+ch{)4Jt^o3DQAH1XNRSFlqrx%{mr0RDf<^GU0G66@B}!IS
zWbmy-@8XV~cV-Q%?&d9?4dn;*7s`g1koq42Z2SX0JK`_u5?G0^i_~5C3&o)J6dtDp
zpu|EvWmP~mYQTVmH1dDDTGcIjuS^%YRgvjQTc%(NqE5@?PJlxpTY}V^?9{{=!>TZl
zpfLdoW)KMw$W$tFCk-19#L3x*0B!ZXX%J$Bs64Kh&#yR$0Cn4}Ef(3D1M`|z)kWIm
zl9r2-ZjeL{E2gPHfi5D1pgt3OBZ13QDk7zD6^X(32Bm><36@`h$<uNh(7~I+2Z}yW
z<PHu!oEfL;x<d=kIoqLS6BEF7K@=si4XP!CB!Q5lrD#AM1(FmmO{=V+;VLB3u+szH
zwFUq&3)e*;Q>mQc4Ie)X@61>YiG%Sg6?E7k%X*p11*Qzjq-JaYPpqB?^HYFOZDB0y
z-dQy%Ib~H`P!SclW7w6vLs+Sma}k>49xr<Ve2Oc8;J~0*DLMFRyIOO&>+(v`H1K7U
z`~oD3HN(nVva;gSh(}E5R#+wJ>##zt>r=rn2Y<mSN~)=RUkI$9ZNbu6Ff5eWLbO)o
zgk8<7=?)LMRG<Lt1L!9u(xke~S`tQ~1{YkM6e0;KqJmN5AX^C(TH%^-cbe{c6N*%V
z;|)(DU{{YzyMUY5dC^)khIO7-O7?j!d_6*%Bo)7%V+agK<TnB&5l(CYR08VH)@<jz
ziuAo2RAi|Z0%6Bju-$3f0WBz^u#H6;ni1tBkTM;kLYQfX^AO^!i$-T32MbOJffg{a
z&%+M!0r@H)(X_`AC^en4t$E$5*i~4)r1u{X{B*vCe|8Yfvf-vCv*(D|4+DeK8=$Rn
zmJH9)L0+wJP_V6ouh}dBa!Ek|8>DWU2!#DheDo>PUh+8}Vv17nG37Y6gDC746u1$T
zmirt4iXt0f+U5Em$k)A*vzCE4ToH|xDXU`WmWs^R%ChxEGE=FD6uw)eeG?REx}dXJ
zv253P2~yLBWw@(FPhUZ)iPJ(e1BP4@T%jYT$f6_=Q|r837hY}xMQavncg3PbY3VQu
zJu7jzXj6mI2EgChEefv&<>?%+gCr$Kl{=$bD|Mh{DwTQIu*1RutC3-?m|S2;xWO00
z63(4`-ODeBh`wm1kODuJtfgQmIc>vM33UVv^w3VVS#_Xpn}sXN)OvYUeJl9NmTY@Q
zcLE&kvam6I676fttCUim1el^JBt+OlS}M$Oej!3pm>~>iNHVDeZ=gD;Sm8z6g2$;w
zIdqE>C>4P6fk4zsf-Y8ObG_h2XnM^r!~UN;E;{L&z)sKU=W!A^IL=-(SEhol2DAG5
zYi6U>8kdwA<NSBYJBV)(D}a7)k=0n%vcSDBoNcOVcmfyf$I+%EbiUM{gb5r>Sw_fM
z1o={y52{80cf6reVK!4rtme?vgg{Y2s$YN~NI!ER(#k_=R4Pys1}JTX=-rOJCi37O
z1cW$IHcUD+2v1oT49B*h-xfgmDC)c&8r6BIsLogw;EWE~X=K~W{h7@A+8I!M5~fsS
zIX)0Jvog{sv68+58~(t75`0*sT?D&}knXtQtr;!{r!sW7*~!iFHJvQQMgmm~v^Atk
zs8e1{D;UIJv)Ah`SOr<ug=GfV3cA&R<_Eb6+6;a5fNw<%RB@AbJ?I(%z-B`v=XtqN
zroNHBpCo056;ji-Q*2mek%2~@0C1ecE=|CK)u^ao?-I@v#?eWE5H8qYViJ~SwMg`F
zP!KS)!f#M8{#U8F=$#5?4i@B44wLJygm7gF$~$XSxMMa9YlTW~ev_;^i0BiJzGi~<
zMIdP`22Usz2KAF5fSOSxCt=BO?7E905EbmFQ2N!EIdDCJ!pW_`!0}~K9EPDk_ZjIW
z6>fm7E$!S&1Ea5?-!ggyIt1is7>Y0~5hj*{Ns^0;rtL|KlNdW7uc~&QOyxaw*8{dt
z)L~*v4G?bol+IRKN+7Vqb|9ka-zSL_ZTKu>nd6RI62ll={=9~4Sxk{f8Kps8LChTH
zuE22*R#BLv{x*(y5F~t2u=&%GdWs9VOhSPRjTF5dAqFWFc;ik4DH}mQNE|gMLRfj&
zAj5$3Un4vh{QNau25r2G&blZUtEe0>8nV3wNOBEqDo_RCeW!KTH%_Uv1@0Kjji!fH
z7Z}>SN(wMpOcQ^d;TJfvN?&SMix6q@ae#hAZLiD?LN*9;^b(TSh$W*xu`BSF>p6AW
znafQ%E7nYdQlx7Dn^4n-kK_4|K#-Ho=n4XKJh*2E*`#{{BBVAXgaoAud_o8byk5$(
z!MCm1Gu-pIlP%_Pfe|zm<@K7&E1=C{lX`>9Mo_BMamfWlf<^9uL0A}@4ela#YQ3gg
zm4X9lbP<9CdWIRx9Ofl*4et10*tE%1HIF!YfZhXnOA3nBCBx#a&LP+=&PZsRk7gFy
zl)wNXTMIkq;DQE{MBNfN^h&fvBJ29e93;+K+%4-h&V*JCH%Vm3r=(nY{2gyd#sUQi
zB4_pU^6VkPA+?;35gt9ff*9QDfI``)<Fbkn$#j@YEZp)DnDUsG3{(=r5V1OhG7c|-
zx1L{%U@;23A1W0U9bU2k1S=z^bG8*y%ln58*>)!pLwdDlYykU(g0@ySEQJ*8&}h%N
z%|k(!fT%3~A&sB^`bl0kb(s3{3tJFVR@t=O5TafUq=HcUh2#b5LGbR8FAHciCuE86
z7Z?&uMn5xZlxS25|EvH*qX_mDK1dre1f^1gCJ&-;-Iuy+{~2&tuYy%Zw2zdWr)|Py
zT(yQ|+=Nw#h?R;^4#-RswxePM^KZ)31cD8#2}N90d^vm+uuDlKPeuSpLyUH+;Ddy}
zqRc?sSjpqrl;Lu7hF1*-8AqmkZyl1&oCd`x#dFceWy|$uG(3h0secujVJnEq?Keb7
z5?oJaBgL5G%cBxcYd#(*0}O%%yCz;F$NY?KpRW@VosvRFf)GvnU9qa!grfzI$Z|I!
z3Z@YabwmV7e8OY`-wOstzX>wl42SK0xK5(JYq(g?7|V8%SM}N|KK?y+wL#t0_uSWp
zN~ImJ(015PqW}tcz{qV7$MeP{P|DNC!Dc>$!rpU3r~qh^0?%f}Xj3#f+mgdFVt`kC
zs6v?o|6M$=B_))QhgDEQvm#EVHA{AELa)iU<ZSEI1gS1y*`V!b7zR5N>V8j6sG5!z
zG8VO6j_t8x>;t552?e|3;VPuUo?I3cR=^14X};cEIKre2oWL^NY29>%Seae1Y)9ft
zPQ4XP?)Me&fm5(FJ9ok>h<Uz*h5KH9$UuVaq(q!s<yOWt#ZgTfAGqK3-9}qIMoA2p
zfD}*J{OZ){2~b^tCd#hnGaxn!gJ8)PAj#^O%(}pfJOezlg?0iGz%oI|^v_gsmho&5
z!N8l7%wK^M7V;n*8IDMU7Ye0<Q>TJgNzWzrdPkyhVH3&Oy6G8Zs9iuT)*Z*DwC@bO
zjeIK7?=os5S!)^mG{pcZKrfl)I-*eEFPH080t<GH67$?eJFnr^z*32yFK1H|Qp6wt
zr!vB{oJR!F-FJ4Ohx`q@aN?Fiq;LLnr`9D2TzI9$Sh$J#6Gft%0!EZ<pMs7-G8cFj
z<2TQNZwhsVdw~GOdga%G?WFb(aui%%uh>n-OWJ^iQCTZU<GTW|MJJpMZ`|QiN5sY=
z<U9*@LljbMJi=eHh5Ht|LLiY0Ix-)*A!XcozARB<eZ&WIHXX4-njnA_Ci8~eR9jqJ
zNk3(;S$rE>_=5xv3_{D?$(Sat0rFGbl6~4(SuHq*?HFEzj9l^&sktSWwtM{-qYfBF
zZ5VDUD5#@Hd{BXkAxN?O=COt7RE*D$R81p@Kxo|CHcN0&K*{6!Dd;>(fuYo|811Tj
z5NbexFfJjZ_Q|xNFRmG$I1x!puVJmo@p^_gT$N76WNI~R?`*l=^f00c67sV8oS%)J
z5(~VKZHDLdH5Bl45Hyu03VcOp4Qp0kN1_yiu-{H%n@JLra<pHUN#lZ$u)#d&!sxv~
zt_$EjC%mrQl6{8rS_T|pxA9k$I&fst0E6q6NETP^x+ye-v-&#e&S1X?#JnZ-9%4Hu
zeMt?gVz0Tk=AF!veSr&SdDt}IUlPaO>uVLH-vprCRupZ}%B}fYkf?!Z!QwuiY$gaR
zt{ajLC)j*gbT_J1EntLzBzDn)mVP!Nk!~?(2LfB5pkwnwtIHv>l60$Q;57%e^%0p$
z1zc0+xeJgG?@?c53!LaLa36BezF}A^Gs`T{oacd7tS^<p2P(hJCfo~vs;om=x6Zme
zv@=&#148hHfdmK3__FkHl%S;3v<@-^urKHZL=g^3K)AgHaHhgdUIibPKqLZHN9Z|#
zVEV&fIrZlGa^3-c49KDfr34Sr=2T=at=W^tis89X1aN!gCKyBt03}9=*zE@8APZ#g
zGHTfRkXDawWZdzFBl1q!%Qzz8FTjgjB*yDRfWJsssxPB~@V$IoUtwphWj_rb&~WNV
zw`|KO>!vt<BsC?IBAS6<+6TwT*5&hX0nQprWsyYJXf$WZjKU!{^duBiEtqvT?@ZcW
z4wMB=<?cZB3)_x<8Uz*70EOX-WOkE=zGB%f$m=7Zqyy46&eH%XPx+F7oR<Y|A?Sud
za2JG=PGteB?(ft`5)cj>J}m6&xS)W<>=WQfg)3b(f?|M?2pfW<V+%8|GK0W{HdN65
z;51aeLfO)C$F3E*1HNJIh&<>ISzjm2nb0j&b;FX7FbBX=C63nOaK;*uaky?FG+PN=
z41B4nSYHwtXmXK6_jF1MdujL~#ke6Tuw#&Z-U3CER>>A%NL3<m#q&l@B&8M&%$)uM
zB1L^8?L+d}`jRUiHC#8yCfv~h5k8@z5Z=Hc4YBU3r!<rTKu9U_d%+AZyJ5!0DpT+k
z7zXlK7_7s3d6h=_RLw503hsN>GVZN|M^DaJf@KNKHRv*l9+(iW1l=N;FBnTpk-&ow
zC#B@ttylT1;Z_kRw<WaFmK{vHO1kLTwKYEntTuMtgOfxYaA5burL>tKL@yM1*jcNl
zm(PQADvdDU8^-4OD*PcICZQ9nyP_(v#*Xt<{eofF9Yn*n75>iZ-l}S6Qq+KpIUCQz
z1C~y1KxnZVg6oDCK-d=;s0=?=ByrNNdycM<RG3yP9DxBQh<WB)6P3pmP*hoVkMazx
zHwuW$mQsca(<^}cDG0&Xlt;oCDHKb68#p!uBsgib14&vegI59X<d(#^Ef}E=4j__-
zP}8UsGpnx)NV?aOGLn)?FbbBTjg*_UXm^rvXx9t`sQK#=jvU&CK%eUqsDKt7O+Y+y
zXa{2J5iwGw)(jM}FhSh~DL6Xi8Z^Ek+RM^=AUX(mm$STeid$o+CgffmET3bi%04Le
zu|5o^9Z5jkPAftl-mVL7HyFfBpr!S|N00_M{1QCSf`N&A0&!_a9>SH;6sDW#p#Ra!
zC>k|q-Ht>&T8N=^^4u4mRh*FMB<TCl5kD^0IJkK7^7()To&^U)!tJ1c%h@7MA!ZU<
z{2ZOJW8v7Qi#b~fYf3r7+Nqpf<mEc-x`|3od9WMG*%mptWjv2pYhK9~oC=ON1!{Ew
z!1#a(KY%E?4+i^qJoHCQ3N#^LQUR+Zp@F|)qU1CL0&KkFjSLERF!=2<B{7FMF9`FG
z5+G{&^pbvF0B0@yBlK@Y&hZf!woX>%oz>d7DTok;PMn{?BrXe-42dIR=MzvsKw7fx
z^XL!m16f=NRoc1_gdKH+4G=u=r91{JIgFaT0|66co(cB?Wosqn>QynU3~L46Bb?Hj
zu_Vk*+6ch<p5tqn#y#V#?w)62-eDSTfRJ!yB2z&>G@+3rGg)@IU}Kb6-838WFe>I!
zyaJ(o#7XfAhXi8$H3K0!9*MFHfZ_wt<55NUr%Cd4Pf&1FVM-jXKTU%VhlWfGb2tIT
zRb$zkH&#|X48Ne8A~+ka<&tLsOIJLm#b^)-7*n9~!fIne2^1hiUg7R9A#rj85AC4m
zi*C}mD}s&-n^9^u$*WY=%u73>1Vij$M}4qt^Bo-;cFsUS?1Bs}=LvmEt3zHhN%gr4
zXs!NuK27*x1hqpGvQY~#ExrssWjj@wPZatYHM11Qn!dEfOykqvX&aVWfK>h|u{u=p
z_5^ee2{QRn4p-{1)VMwk4!+4iGRmjt>cSD+J!R{rob)P6aSJbUuZf7FjA5xL;o1b9
zPNP}|U*ao(pfOrT2UW9mixEUsq+`&w<I24TX=88P7V?j;+O@?~$TOVMs&3^SdW{hL
zx1oGD6~IOD#_a(0^)uXc)i;REC&l)m>9Ji%5L)-)sD)47DRM5`E?%E{E`f%*1W44s
zz^QjBMe8Rfg*0kZ>s3FNTe%U?rk0nXju$w(tT$yK*FxPenNX@@nmh*_*y*433@RpL
znygSaU0|$C#&I!CY0YCfZ_+eb$p%#p#MZ&TV8daP<Dk5v#Rd{`7YAur74NLl8;XtU
zl5Mhr?Vz`EU^<X|7?*?qD-6{_0jm&p_I6mz+5RaeWyV%(rg|ty!m8UZ;uJR_gu{*{
zA`5ELFny=(t{RSw>5%V>$SKS>@^!xOhk-olsdWRLv*9c>)LUkis&RzJjg{HDXhP57
zdX>!>Rl}p0vI3(xo+>I0py2jRcO@u{h63_;#{%{PR}d!>SPBC~CpQ%|JdD~z0fR%F
z3KtxE#nG#5(zr0ss|+@7i#XXlUZr!ZkdXU($$i;2MzWnawHQ_~8Oafck|IEZbbw;M
zLrBpys%oSHvJC<fDhJ9bVbDUaWjr$`lp+w%hhT9a+p(+AX|4+kICwJwVux6wAk9%M
z(bviqL>v``!vxAZ7^M`f)huV%$h2lVR4t5-vI2+emL-=lTx!}KNUDb%c$f(UCPgq4
zC3;ELVuEpQ!=V2IIrDc_G&I|d+oZQI7$a-=pghSXVGOj1)tfOq&xAAJhCsJsQEu8k
zGwsN?MUNh7LDK<>5E{pIO(y6#2Y}!kiwU9Um09Rysf2(vBOrnW2nf`au%D>c5F{r!
za?NuyF5(mmg1|^qa*$PdzZ&Wy{A`FKbXii76*BRaxJ5xgfwOXNjSD)uA<FX}fn%cY
zc1V!)y!10m!C%;Dh(J>*$kcMAmefQoSXeS-Lih_JNUB5hdH2hl*ViZ#+Zo;nu!|-X
z?m6&ht?a@d;F@gKu-L3_SVFZp2{CEu#5scvEXBwSET6N61)FblwVt+}OhvE3f)6;M
z^MYV>LfM5$^zhXo$c#XskDf@wZb>B7V0O5I(}6~%lzD!^fbAl)Ym1YHND~u;eG_it
z5r=!2;sSRN0>zpS;1CsQS4oSdUCmb1J#LzYhfymWz3i#a?MTcofhX^dWa8lvSqQdV
zul0u4&jpIBooMqO*c2pG43Z`LEW|7)9Xw$``6f1nxE&X+rKFt(brsotfkF}r8Ee$A
zMi2&>22gN_EkvgWa}YqK3|s1qRhi^V^_3Owg!0KX&IgoWc7!}@dPWszyf_TfoB_1_
zt=l7M=L#dyIRjQP0)^)XhA<GmAsO&!vWN^jW%PY$4xle7+l0?=JvA@RAc?OD#EBsO
z4IIye=*;9)3n5b|LZz_yhfqRE62^h?x&<p%qtJ=&kjtcJ_~`k%m3JUA0f?n^R8)$_
z0?Je>&4)?pDg2fe0Czx$ztXm+PuUFDFK{yO2#j4@EY_EBC@XaiVuI3PTnL4Z2mgIE
zE<3>{38H%|5SUOP-n9S8Xkt|ShJ%{n!VEEieFOx}bcB1JAHPTzv}1&?JdEpk9U|>0
zWj9L`nF>Wg|E_kh1fe(~pKm>R5!?l(?Dd-nGxkal5(qSfpz2dFv^omFRRLj|^5KF}
zK3^~{*j~n}_$O<H3ka^mZh<=iftEhB&mtqjTc6l0xDL0Xu|lv@z$kaPvDl6(V*YNE
z1w8lV!F$#cGA$r&e^g(n*=3Nf0526M!MXZY8m#sKmikYDWoS0y4go><*ZFl->L>!6
zAUzmaK?WS%AWSMa(yt?*Cl}TU*yfa04L4Mm*6IfsH0_~n%HyzYRwt)0!jrE(gtV{t
z#*rY-9hkmE8<WehK!mo&0w>uwss@65Xxj=vv`>YpD3*kCsHo<!zTgwW;0iVPi{=P<
zQd!FQ7{AkSxVsGj91?)#N!cAkhSaUlUaVyMS}dVVE!m<C&KVVNHDl40D<vCR>fX9>
zK{rvjLsPqCb%7TT1$&gS=t{P{R>AidWV4kZ-QrEi=Di>tik=k8ub{>at5UKRgra<0
zwp-oJWgb*+V43B5$WcLvtkSZJDD{}1$P*kklZS=G^)Wt(A|`p^`!7{M&<81@enf`t
zW}DphW2OnaO3jF014}iT1)Hpds6?Ug4-&H&1nfi@B^kUP1csp~R9=-NwbcGz29cz>
z387>V@!%Ybe7!unN3Qx38}i>rq&W8|ZU%vNB$)>TlF@6|<<n{aaleXE0ff)cPzMdM
zloHD*hvyx{y>UN~tcwq*L0Q&pajDU?se9lF;;l~THI%JLe1sJFPtWQ#)_lr(p6f2y
zl4_{_VZ}B0fvd(|%XJ;Mq7c-qTEpfus@(MekjIX;^RTdMsI0bY&_-cZp&U%$nvRcR
zus1w)s#1s}lO0kNqq~$AzD%Lxdy6@`T#F7p1)h0}Bs(>c)h9Dnqlqd^LahX$6?X7~
z2w7Cqc`M<oRpFIcqe44)WiyYWk_9O4)oW6XgLd<J%@^FIz&>rPi>GInGs|F|cSuc;
zwY<C&mS_sPgPsm0`!23KaPbb;YnYVoP!JXd1hpNV)#20RN$*Jqwwj2b55zR-TjW_x
z{N^?8l%)d$<{@tgnMb;_BWVX$cce9+U|A$)ChaOq+>!PaNVbIMIcvd!!YhLQy7!4H
zuJlbF0CF3oyflE&I4n;}(`9KQ?zbZYXVa#f`bh~pw9^!m2F!|hmq^OJn?ey`jR+AA
zMkSD-t`NzIT3y+#NTho~K5oEuJpyQwQZN{_#KLr!nsTu)6&x<TMR>)x0s5Kz>mvvh
zWBasipZ9TD;<Y|3Ly3j-@_~7=3GJ<g5!=<uTl2|MrK;k#zeMe|u23Ud7VL1I?Sx6E
z>&wekox<cuTqq)iL`ny6n2i!g+Q1Ns6gm=;;(AaK5(OkoUI9xccc*PcK;8X?_B7!@
zNWp1?1_j|@!)CbyQkJ($J6>=B$y(^jAbp6Jp#dEZVwr%X4U&%QqiX~anxYme6pUCr
zZdVl)Y7wXHy5pa9amAfNfxIWOl2cS^jmRj{3g@UDvO=-1pLgC~TQK;VfU*^0#d12*
z<dZn$Fh0<vRgrk9>?A!A#0C);H8H8iQMeWz)k5z}7}6*S<EWmt9k~n=lTskepulu@
z35DLKm>pucqi{59R|o^vbc!>IN7-s7Ajj+GdAJt=dLJ8RTz4EG$cqGU|1a7@>@$SO
z2cn9^H0vuQ9$SpuTiC4LSmJQDz;?iASzt*~(}b&ABIOJA0)}XIpsz+*mzH!v@vj;U
zUnIcfi3j0QgWZ7chZMgH{OM)bB@&$+RH@>^1QA0eQfRG}FgePU)Lk&_(ReuJ*cUiZ
zaqLma!F6g%s5J#CJ$j@b$q5^Yw;|EC(OL<UlzSFJ_>gB8d#x+hm{_oJG=c}WkO{~%
zSB6yv*N-B~*mXxYB{CF!1N^>4Rr6~|Z4$(G43sX&N~A}D*{18IeON&Lap{2C^p1ew
zAHWV!;=mQS_sCb)YSL#BPZbC>_@jtqt6PyzP#uB<vMIu&IB<h2v&ccaL;;W}B!S>a
zB*t<QpA4(2d?f|_3tz<vw-4xza1PlTm{nGdl-;-`FB=9$iXjv*4LP{wb(*Zj^|6@(
zxFSdW*oA=TJJz>km$3AK6jxaaY$zP45|Kx_;WPYX3v~w{E1ZuaDR<feRQK942k>W5
z&Ivf{jyv`mq@=-%mUajCRKDp|J--QykzNL5IPxx-h%DP%<xU{T69aFN?*&@MjSVo;
z^Al`L<RH3Tpt=w?9Hx$XNG8bx(nP-nC-8Mt5#)!4VyTiO2~{A%5~@Jr(E*O9t7ypk
zw<4&4SL-Gh8x%5dz;{Z7@cogxYBe83%WK6-4Xnh$&6Mgh5&{=Xp%sv*z_J4uw+rQ&
zKcCTVTmTah@K*{{iJ}&1RviFN^Ys8AONLyS6sKz(j52JzgArl^C^R#LH;~jg6bVTt
z3QU66D>(f4(0Tw(=y*H`q-`12NUUzb9Pkm)<%SMS&PQb|*C^Sz<&&Ev|BfD}gzfU3
zTEG%(5Vr=i&a@5ncOj^~Z3$fgl{BlrN2Ux5a^Y<Tcn42;6=frcq>Id2cRisbMpUsC
zg_~SJ5-6{#AV-&py5ri847LnSgK*X=oAnCMpyf?e1>z{dc=q>)O*2>WD$gdFTgEG}
z0~rx5ZldD2s}kpxlq^DgoaGe*@zD8xGyrT0yirlyNntzetjpa=8=?{!RoyItY>s&F
zhyjlTYsHTN77)S7I%{o1fV(wXkZ<&ottFGg4PC%G!dGv7cO{5xy0$4sxURjyf|W8~
zBb$1w?eWqX-ng-Z@JXzJ@~R!(cY~XmkH2=Fd3#N{RJE!2ZL%<s;N(aRQ^b7D&WIRx
zw!g(xQJ`Q^Kz|1<S1IM;)!Ni)C?A9h*q8-Z^~p`Hztsch31EeU^<(<75g0aXq>O)>
zFNa+uJy5G&N8n#0?7{0~ftA!Ros2Gs7bq}~&GThN9}F#p{@p50u9>s8WdKZCngzo}
zNI6L?Z`$zJT?GXVm$kft2g`~~IE}FONn(y1QZWK?ny&)_WHT1lp*EkT4{lKt7gEi-
zEVJY`E0jqaOBbTJXRRezg~ibK^R~u05^81NA5$!Z+nk`43c0Cu!^MpVc`HlhTr*m(
z6A%))5;!+E;q`Ti55AQG6DWB99uqoiL)VPCY@&iUs-V@z^`oaWfx?4YU}4;gBzp5S
zWfmqNm(Js1N+@+HQL;T?yl`YCc!-7zKBFYJy{>{v5!X&o%lQB~>-ZoZ3x+}GV@h@y
zrsL9d>x4_^9vq{F69y&<p5xUGFc{-i6D?yPxT{kf4St=I!>u+=ydTT)>A3ug1Dt*&
z4|nH#X(_17>s+<OAZ&n42j`Wg&>!rPg8IpDF$`6z0VpCL1qk11)K`|Ol+(JaKC4%h
z>ycb>Y8mDV!E`x+E9G2qpQOK?q{9zECA0aFBKW!R6@z0}%0R&4!-AWjr4OkH3IG^+
z7nThc{f5K}c^j3#5TR2TQVQGwC!TQhPJi$QcMaj(P{8f(Ba;4U6^a?|GI^9rfKvA_
z*pBr1cG2PpzAFUDqZ1?OH9HbSeRkQbQFd(CUiP-3fmydD&a*3wc&K+1JPI_C{;65Q
zDMG5>ev@?(W{N^xAPKgszWSRU#i*u&5nyCcYN{Ymrz?z?lrC~FFSKE^4)%gRI&C}P
z-UX5Ey+YjqXNjN-s32UX;3M(0wipHeCR`9DTbj_V3T~Mct`o+|eS(4|%X`Lk?J@+d
zqAv<UJ~1p=fvH#p0pF*9^1@mL1&&W)zDI4<f^21wFww=XR>g_WP*CJ-3YJ(rd<Y6;
zIYp2?H*ej<WHwe-gQtMkxU06QWPn?Ve05T&R5eaJ5yTa^p<K`s0b;_v5W-<V9?)h4
zS^Ov=sH}$29xW9A*?>j|I0J8D$#?`n8ax4zmRSH`GZslQ0l~0FRgJ<2Ic_=VB0c<0
z-2c7Hs2w>3v1df}^c7d0@mnDj9+kiuN2#V;bCgqRL{}9pgb8%#GU|w|mI!0!XA4I+
z3vz;?1CDGWLY}A%A%%)M;|N$PxJ4)n#L0kaR)zFB&2+h2rd>MWU{?AC&g*Mx>A>h{
z==cL8j8s-I*wZ6UDnxt)I9;z87+52}9Gp#47esM)*$g^&`yUHx5jdBJDBnNIKJOnn
z_KCjCDVC*%Pf<$BFTDp`#dj`E&Cpt+N>wjhqkwF|yJ%yICwM@dnC5Fpr1+{85wXB+
z+LY6ct*ZudV8K77r6yQ%a2qbpXS;MlN2GCR8;~MTe++$X6GkWk6pJPa0B}qTv`0G$
zF@6<cQ-BC@S}JGmEEnBrx@uTMMTP8c7sxF{r$L7&xB)~L2HJ<U)=<a`LEFIoNsLl1
zQzW+%EU)4Sh&pc4iMdb;^w4yIOb8Uf)a53F#yo0-T$Xc1LJAGywh!PqWCwLoxzeOG
zz)OU|tHxzbD~Lh~0=z0nV*d()yx`!vU*Ww(i?;(F`M!Ih8#tH&F+h(SDx^9t!%|A_
z-hqd)i(AnULLBF_*C2+&s$*N|!=~nF)n!N<JB9J}okm-BaSElyX_Ve9uJx0VM<f{1
zh)bm8M-r9;2D(S$BxjazSP3k#;+~Njw<HFK8+;Uc`ie?`KXfzBR_059^c@={%2#xw
zPFrG;!${+u`f6$P3}tLal1@;Fo+6-pa1k-{1A3AqnqO9Ep!o?wB0dr=Ug&u;U$<O3
zrUYJR2np@A^ed)ADm8(?gt)3jESz{1JiKAmsBI@)ffyA?kCS}aN65HnKEjV=7Gx1J
z7$Ky@Pd-ns>TiRBjEHlhAf!7g3ltv&V}}CUpdJJ^>w9v996el?1A9GsJ@~VNw7afw
zHkD9Qd=p`}#n}g)N477Q2_-w2fCWZa7o?G0qQNBTKLlqNQ9~y&6w(gXG>MVcCkclw
zOcE>AG7=U_7YPRDJ{VlCpQb}Zp)FQ$;EPSekrXhSVS^}y&=In2j*5|8hwjfJ!;VOc
zU2w)~s2INn6T(`8W#&MkC=6RL$SBy(@-~^lp-&nQ+#ptAt2SD4J2`LhT#SGHZOD}m
zH%Os~4%l0y)d!!1id_|eaPz2}US1x!k!M@ruqrs|+pcsC^EII}w(FXJz)MC^(Fm=a
zsZ?O6(G(aLkJRGRuXp*4r+Y$g2TElr22&bNiR;36nqOXa0hi-zVT9aNj~gCLg=NDu
zF<G!{_;<!$!@n4WWg1e%Y2+3IgS7YnY=H2v26&qw25nnv`ZQk;o)jsZn&9qgS3tW`
zHzjVy@Jw(_Q&3cKiK0*l$Ta=UmpIEU__K__fCDptwu#XIyUze9ISsjN1xOV20#Ifk
z<`LkP`;mMvG|^4mT&6JyVFm?(dKFs-=B~KDF5}RxUV@uLP%3cv4&tp7N<?)ETb{9F
zNs)`=7<H?@#2{2kQaiyxX)M+X2?)nruimm36IlO%IYLOLq%YG5_!Re0%v26k2ntM-
z9Y}I}R(Jp17pbHFz`vy=<w>0K_FA9;gfzNLLPEK0JfFA3VMnQ`by-VDUny&O!jmcE
z3BSFJhnoW25M;d9u_DQJl<u&}c;Y5wdkxEVVW&X=u>sut%<~%8J+a9T+`(b_uqwJE
z?jM)uGT;Nn4IY5Sx58i&uowXna?wv#K(l&Hq*M?2;93Y;=E|NtsSd#r0VIAMx`&)j
z2r=O+gL^uGD%dXEbq5X`0)xThDLLU75PRM9SBln$NDy;eK_Mq8Jcon}fI$19<7C9f
zV7o*&M+VtiH(bHMR`cTIvW(?rVJ4Rw`w&iUiG9nH8qZRAuHyBjfyrD7DJn{y;0`ci
z2kEFd@<3Cr`vv57@iQSWNP&(LfI^g+b?HX3;H}#RR|kP8cmz_epQ4aa=!t-%S}KqT
zP^_mxL<{sR!vuINP>PgH&I<Q@4o!Lifh2DVyax<n<wFHVoTDKCY7EYw5Zx5cKKf}9
zh1qy7Oo9L>QW$!IK68c^E!sCxG6<2Y3rwa`p(!a~e^&r13yBlbkb-Kyxl4H!I2j7i
z4THYIPF!poWNO9Il`O&Agkcpy>`aKgwcQ!Ej8zHZa=}VHZg^E4#0qK~a0hYW0(ih|
zFX@2Thym$JtK5>off1?RDT6sM5#GFsj>faU!L}IOrjTma7U5i+QKt0Nx=4rIX7Uco
zD75m2QE*Tq4AbA1bG0K7fyb{g0?M&ARkeZoB(Sg-mkn4};NaRiJ%%8iwUdiIqTrm1
z@Vi2lRXE;srczPxG(kZn)|@#nFMPq71rkJnp_wWn|Ip!hL!zdQ^|LkF%J}g+NkF4B
z5F#B2&TPRpfN^0B>V6Wi<PL)%o|+Uk;Q$LfUL>V&0w{L`O4aYmV*dRC#J{a1<w@*r
zh@g(K8Unnk8j@L&2MPdoBO(csK@RrDn8F0i%v;6{iZ+M=+`{+hFyV5A!&$|mmu7$v
zi!gdf=pe1Y-ENuSrbRXjm#E><em2jo76yv@Dse+76Vi8Z4Rh<cHDAQtK7b4!zV`Ec
z&u@1kA=p^Ks8ZkaTb{zD=TQc)TQG{tvxckt6eY5ivR)|x++ax&3@_O4z3zrEoE43{
zpg`akxPwb!)1F7&@&GS5r<3O`-WDMD9ZEC3u2&W`mS_cWM(VqJR5*0K(dU&%w~N3q
zq8wTc7wRhMz|f+buklhp=o+?Kb~$Im$sreDFf2<aWeYqy!D|jTcfuf{9tDs~Kkf@!
zF_iX6s<dTZ;1$XH1shbe;$ab7rwFELP3cVCvx8Vz<OEJhVXzXOL8xRATAI3SCrpv1
zTiL3H&V~Edj{uUf9%L~p46=>_`n*C#Vi__V4wc|TLC73^J;0KliuBe##y_Vn#I*qS
z3(4jKIlTZq?u2V#NkmXj73;IA5H`?>H9e~${YO<K?aGDcXn<1AsRIh78o!np<CgIM
z0qj!n^zY>h!W=X7f*tzBQN9<vJ84wnMkBa38vQTeZ}T0WzUUlaCJnrs4E<+)=VG|d
ztcJw|iWaeQ!PpA?`2)oxLQ-s!+v1Xq(7TKp{uTNZM+{_4fk%yhq#TMC0Tt~g<TebS
zXnqVCOCW^2i)rb|61+8l<e8fwCoVMvW?c*=MsIfvaPM?Hyl!P4ZmuSDgBpwp7j<c;
zZ0azHwwur}8f>>lN0q?h7dUqd$a8E=p{!F}g(UfHki?g*!n#V|XhTH53kFEY!kG=E
zCcNK*4g#ZC21inSPY4O189}8`=q-gBAhNC>=t^8r31QSjk*y@Y$gPUhIX9`G83eSZ
ztBAy*Ge#EDz=j$`QII*L-35+g1^zk`3jBx=({gziVz)W3DW`}Zc>$4fMO7RZg4fCm
zRApQ`;5w2jtvm?heT679l6wcNU~Ho9Z4-SkU#ImG{!Vh&bL>X3Y}Y;i%Iygo3Pvp_
zo<j6=7la~^v&EtXt8Lb*)nO-Mnw0WGC=!Sxg|CZ=00}t4hzZ(l$t1ZpBP7LrB`vH(
zgu^9ICWKB^`s+(D&<)CkTcw75^+F^plWy$uaqc!aY5Nrtk3=^|&{qzoK^5PLCrz4a
z=%1h>0@Nm3uJ5RZoNzBl#TC`ey|80gYPl_gJRrHiU;j=QU@1AiMm|XfU!&M@kbrIw
zr)|aE9W(Zta7%>yK*B-MbM_iu!GV6T^Y&VBRKwSe;_m9aQ3E3)R1$O1OX!vq1BVh#
zYk6;q50k0XUh@&*JFVfv$X*E7dq^!SBwH^qmFVqp&G(Q>3Z3`{pr`_&i*pbok47P|
z{kbP3;pM~_zg(?m_@2@R@`>#$7orOH4iqc1lkPajM;v=ihK~<~aa`l5K+q^FVdBOc
zA`ITTA2N1oJsfdwYCTw<;YotG56M8Z=DR7?3y7g~2n%noL5i=yLVkufrq<c4zAp9#
z6;3Hq)e!79!O-Ne<R~Z@KNM+P7C?G_g5PD-DB*i+Q6y<V6*+7>NRdbwA*PF<8-Vcx
z(qKyjgGF>nOTZe5r?q$;qaK6bDh1@@%f`Amh%baOfulVd?#pKN@~UC+aT^P7M!|`J
z_1AJrTF0r63H0=C-QMEKQ(Dv31wb}DM{m%@5zW>CA}I=7-wH^SakxLCAr7w6As6zL
zBt(<fi_)G%hlL3p>Gkp|IZILCX{j>7w78a$3WPWzSuozw;}%@1BwjsLt$7Xg@#1?4
zBI9p<dBU+FLM_xm>Ql-M|2Vqbi$dfp3^nKHfD!IcB&>$C0K<2U+m%K*WItkpON{}N
zObr2Hv?BF-eF>7Vw9AO6z;*&acyI*>cnU@!q@}nGY2n+{fVA+TlrDYLzheCp%|Zf=
zj|`ZskCJ8q8KBcAr~{#eIEUArsqcc=tm=FGw13|soPCBHgyBXEQ9a)kRT%%5>p&C2
zyH7l8xhfgm|G@*w66FNiVINg+c!f^13r^`G$*wJm=nKL3&DSl(=}Q*b<RFF<H^>52
zm|EA%9+VS~Vx;Vrln_Q_^M@$_{-fZIr8|vgNr-%bscEYE3PG|RCk^~UK+zbN@htMo
zbQiqb6~INF&{&WYcUY5#TedH72fKwLeTh5pCScsy;+5o*Cl-1EC=&ptuE2^rivt7<
zR*}rW^^3AdjBtt&&1;1;t)rC%t=%$B9G%1*iNmlNlvD&CiISEX-)h6o>E`(f4l!oU
z04c7r!|y;ojmrt8e3=?T{1PfFbYkSOi73S+sbJB;MFE4mI>iV34}(nQ!kR=FIg6!e
zs+SF~A!SkmND%QsAzIQ<@v)+jeVFb#^+DPW;hG3wi}F|=)89^a9E9=Q@m31?_;*n-
zEEhL!m;Uz^`$i&~{|6PDwYV%8M=qRQT!K?S4O+iZ5>b#CmxRs*A#kfqFL1|L#+yu5
zAf7MT&|#TVZ->Y`gp#4|2@={#LGc5Zm<^RIH<juJld*l%%w`U&GM#yBfpO+Aml@1v
z7GoWwY=qs+SS-(6#(K{&gITP?Y_<k)XNEbf%vKreSZ7DrA;x;=S)EzTV+N}-&RFjR
zmd)7&GnvEKXqH*bWgc@_9dkflcrU$g64N>>;;+Lz#%_9JPfTIG*tJt^os}79CYxuR
z>8yg^Gs0v&jxqMOo$};Fxfdwku{V;hz*d;eO3Yz8whiPs#@LA>YhbN8tBSXq%w(LE
z{hGT1Z?Q6~GY4x2-*$|#cZ8oVFbCfTZ{^Cj%rJv3LH@b#F8>>7qqE<e5}R7|aJbYG
zTg6f!KeXKnmb}VzW?@U3%!Q}U{ac=T1K(Kwx0L%`_DtsW-%(;ZbJ=+u4+R|cx)>`a
zl)!%f5C8Y0FZ|t8`A0sL&|XcizRaSGY4Q91@`11Xw~se|co&Omy}i-i-e^4Dm+FqB
zVyReLTGQgY(h)7*mr81TSTxPFwzL+Hw=pdq?_jJiIjqHFEHXGa*v7Q3&i204TeMUx
z&KM;2unwjrV!g?mVriC09&QIHG1$&Dtv7iSL9rOqQklV6TGM*9XqrW0Y1W&(sV&V?
znRr6elG((5*0xJaLB^rfTsw;l^=d=y42l?vGYx9iGZas2lxkxvWk9_noh+KXxG@~x
zyBFRRACAZ1g+m=I8c#@MBHqa&iR8rx67hJPMI*ghB$<sdt*18{V_F=42YaJ!OzRnp
zB{Y_tYD=@^38-x<1GMCcXqpXnCA6rP*v}IC+1}_bEgEN0{I<Ov>4>(6?a_9nqY?O<
zytoDJ*Aq>%cr2|Y;+^d*+S%FJ6;Ei9z2fm$l(9%Vi$r=7kr<0;Jw0tqi@?uN55Pk`
z?eLq3#M6<;9+udnb)>b#9&Hb6W12S9lkU<wJ33<GKd3_T;?q65({1=SdGXW3J#nTb
zFMc|C@zb5@C}M|u;=g$N;{C}Nciq;>B9Y|9r;`_-?qU&WoTuSmjIq?k7dq0|<*^w4
zwx=UnuNIG`BihhloN1|xUr%0qx}z_3@g*%4>x5C1y!dn~){~BCeW{BtYpIKmB`?0x
zp4K$+Cw1|gko{HY-n6FeVNm2A7U^J-!J*`a*3PulM&}TG|4>I?a-&;I#da}m5R-dY
zl67dk$%{|NW4m_sCO7u>YKe3Q6xth;sP=SJgJim$@B*DkGpuG`a$`7>+_)wJ`Gy7u
zd(#muwegk&5|bO(v@vaPFvhfAZEp{YYVln@rJZTXjnOU`YMt#&>r8Hp#w9JrSaM?&
z+9e+E3BRWkT5#jAwui;>Z*t?BT{w0xz62eZW_#Ff7V%4pcluBEV16HjtXfw(8i^;8
z8%Gnvv1pq0bfhCaJ*kZoZE2Q>w)Z7BGFlV{Kw=Mz!(2%YYtbI;ylCoXEgHcb`&lAR
zln^T3ozP%V3&b!3(rmOZxiP23)ZgUArz2M*^{z-Om417XKBsljZ~Q6&hYM;cVqk|?
z!mx$;v?sC`zDhpTq5P_)34BjNi$Lx<Z9nVX&!W4uj&>I9>FMcdXHl&u4zsJLrw4}m
zhK|3ygGIIBp~0a}YK!6hter(8Jv|X%36MY16M+U!ZE%>Yk)EC?V^mIOoVCS!I)R^3
zLW3^2dgJ>O(Vq6S2Hn)j+Ir$~>@cSFbOKj}pU%#XG{cO$5?Z7eE87ViLhJ0^&ybBp
z1oMscBsA<+?9}~ix9l?jBpZV9ncDb?K^TyO5g4(9IQcdnYfl3Kh7J6QbhB7IweeU_
zJf28xJO-`yX_%P_jqQh_nVgEI*--3e06Y3p8_#K}SUc19uv8|NW~q(m+tb=0%-Xc3
zC6e$>LxUag>MN-X{LQ2`u5<t`wQ;3A%@V1N7m@tcR0jC{T#RWEEGoJ2_5G|}OJx%K
zm^Rd_C3-bTX+!v%h$SMs6IvAcE&SiXqC<(Hp`ln>8-k)V4VlHuf~yc0jSO`#=%>dA
z+xt=*-_qjrr<?x7=+CY$SWq^;9qH*Aj`aX<+&C)WIDF#8$FO#<;_r9%rQ=#^6L?uX
zxfzQjH(pI{d`D#8pYGI>n=t{UE<PqQid@J8H)AyQF-w%Op*VH>9@d$T#*>@LUSut)
zi(l{QXVJl)eVrXzz}b4WUagmfF>wYn42DHI8bLlsydloow87z6JiaTTL25sX!?LXn
z_H@9o+Ru8TyEItUBXQyyv3NSF4FlJ}DgtT`YiE)8a4Zh%cj_XH9WAxli5=UUys4YD
z4aZV*@Ttkow?G4Jj&`QC;ne2g<mS=-bbDWN^Msb#JlqpcZXQi;W`<L9ktA!^lAA{p
zJ&^?bpWK|<m5vOjHV-5>r+WHs*4l>mvqWENGpp@qfJ$!8rf!BNLyV+!;NMh?2KDp1
z)6wBQGCKi1$<3+c=4>ZS8vK-0x((3utwaPF1zR3kG`Ts2t6MBi-*6zg38IIVi0zHD
zXmaytBogVMFN$?S6DFWdV=NMn$Gg%|Eg@bCRT|#IU`<VJ8mUdAm$gN(IMD>yP)AcN
z7D;VZ5i1Bdc|p{Pr5SVttfukg=Dn#zB%0W-0l1&-hgOKR??OsvUuv^~sU(Xg_Fxud
zk}MJFX3^B<_d^xtsCQDE58#}=g6W6wccUxF71_<A!#)s8YY|b`M>^7x;i1$V$XCNd
zsZ1&pfiap%WfCk(e??D!KQwo0^D!-zfgXAcno5Xidss(WOU=>u52Glhr82;cGQcV#
z5&1Vcm7MBik>te<NP&n3e<RSIy~&$;lQ(s+2v!1l4!!83H18wu5)_c)0-K4YwKz&i
zao`n+c)W|X4G*O@uEgW1%m8cGsOpGGWg-OZVv*tG<`aO!26&2w*_Ajf?}_B*)6n0^
z%}--`H*41h<MBkiH=fM)BqCxt1)dyl-xW!2J{N~oNG`H~#dLgEI;zDJP{#8h#la*?
zZhk&~ErW+XpGa;#mD;$H-28kh6A_h6q%w)r=9L6Ae>}PQ`L1*{H5VV2t(x5YG;*mg
zcBP}q6Y=5XiQ(i4oVpuVaIt_jAd=erVmFIMf>PsYExGx8a`W@;n25KfwOG6@&3d(1
zT1%dYgJ`q)B1{Dw7LlPyB*i+Q(8S<iq9+l7YC-F2i5?&%H(p2#4kkBWN<@;`WVSt_
z!6FJB0_+*;y!ovjtaER=%});}H^1GNZU-1<$L6a(HkED@!wX5kM2Ka42PS-HU-FWM
zTbK5<1|uI<@k_XmK_NN{t9LXSZBIwyz0r7Ax()uMF7+i~DD*~qqw&P9M7*6v_Vz~i
z!V{f6=?F<j#4C2CWAI3CEFS6dlZkkewI?r)3aB@l=#9l$bZ>98H-@Ej5%1_CX7Zin
z=G<G-!1?A<8JMLcBc?XLgYSrlzDRAtGLhUo3p<y1FKmGJ_QHon0LP*c++xI-)|rU4
zvq&cbk-d9SaO+E6I!a<rSGrA$!`l0NBGL<KSWT0cPQXyRp6%9>n@<552GfC-f55(x
zF(2Ipyx{=m+{4<En=ir?z;T2>yBILAR3^EJYdZYx21fZJ<jf4GGP}}#hHmI}N&-X2
zmUt0sn7outZXO*Xc6m6pc^HQ9r7Zp;FHLO%!%A+x*p}8JL!B&|7#bcLgu%&Dn}>mc
zY#xB!13ZosBei*@voCdN76%2iBkVEQaO%<=O5(#>>JrSB)TOg9pHrJxQW@AO^=k3t
zrMr@wFZKc(yfg=dO(S*b>{Tolf)lAra}g45Hm|f}fiVywlEc~_;M=h@i2AUa_Chc8
zq+{9;4e22eGU3DS#`o*=c?UYN8r9)cCdt~g;Z!D(yksPXlb5Oqu_*-J5P^n(KQz^W
zS87A4%__(}8CVKwBq3Ma!-muCSfe4t(r*N2)rJnMFN?u|FcPUtjnrl}66sDyheX!o
z=F#?aWN4^&u$Q&TTpN%JB;w?y2NL_?6aW8qz8+MLWJ@z5vNAI=vnnehZddoM_bTtp
zyU>PMw6qMtYCtezSB4D1Ttl!jE{mAChTw^zXSqhR2vk2=Sy|OGWL)DKGTM+KL&h}(
zD?>)Z$`DK&8ffDgG8*O@ZOCXtMjMwIzH=h0O8wrhx6HDvekvm(Gb1D8=bZ0+=R`^q
zW}-71_50FI?_dC+8nniwICKZPD>_Kr(0$$4Ih6kR4W*U6MK3&kY$spFq~lnR+wre-
zn4SP$=WhBWfy|kn+VQVR*+B|W9sNg`jIPV=^dyf4Zu%XpQemghpv2ulo*JbLOW`b4
z13P^#F&}y)pbIabdnA|voRJHmpmJR*cK|^Hb)1{r<gnj?%L7g5QwOPxQlr{zlB#H6
zr!P<#w1xdN@P%Z3ME(#668|U%x`#d&I%Nwb%0-8v5#yo+Lhc4+oQ4d!VJ8PMRKy*3
zgO_`2)j&#+JQ$jAm;qND*vYkA<++G~K^VK_ibT=$%ucTL%Yfz0^bBvx@^t!=<SAYB
z(oPO6DY=8ScAviV`fvKGUxrvMuk3ZK;K?=ULpS~&ZM+r>S-1mt1MHHUHh2WB&I5O#
zOO>14PGL3R0Ew38cKW7M%8^P%X9US)ud8m^$w@35JASW)B1Q>{DkrF$h#>EW+D*Yn
zK>m_cN5MWz^^hdAm+Ij#;nV#<lPsqc%W_JtWjW{iq3MIq8TP||FeEV^Brv4%jHYXb
zwT20oWkz)*t}?@6j!CvQS7RRUuuHb;f!q=O9T6ER)n>e53h+HUA~$5F-c@@N0535L
z5WT-A6JKrYYm9qBZB<ExgQBjU9J<M&4oWdhgs(TGMoq7wQPXSGC}gNn(`#G<wFaf!
z8Y<pc*tl!!cWq&B%Bg`!_}YB~+v>dm-fE^0Bw@xN4cv!R8Eoh%g31KAkU0iTnlMQT
zY)&q@8_LrAUE0E#ol+E|3^2yy+o;48140GXb~ltJjd01`pdvzdv@|HCAtvqgrtX#j
z4jw9z0NgboDhjz<*y~&Xo@@FZY7WHO<VWChz%UU3Hj)|u64KzN?D!o(59e<Ig@j!Z
zx*Pq#O~y*?CZ3Y%2YnPXFGFW`MBt_$r~p0si?q{^G*Sda3K=A&*D)F^^V19UI#DV&
z{h$m4v9i;TMiZu<e$-!xkP7HV=Co*yq~M;YO!Z(2&!m4|pXMY)C5y;Ts)C4cWMm9I
z+Y3&!C!&Fyg<wHxTmizA3W5wG&Jz=u{CZD#sb@4L0<$Nwfty)nX9GJM5~qu2qdqAE
zKYQpoc2;0!^h4bRxyXdiY~OB>kC%wMB-FP{{J|Q@uev9w`aPjb$?u+#<c>6+lBI#2
zeaQ{#nh>M|pKxiY*JlQHc1cFRH$kwq!gvYzWk!V8X7TyowsGP1Z<tCu8|Hpp`of4G
zk(ShjfE2{e`mx$dV+egZh)b!An_bp|Wo6K(X~l3;yV>P0%2?)ZcG*ooV7d_soqo`o
ztTQ+L0Hk(6x8`p80W*DenF#bC(3+H96nTyMLPmCW<<r;nJ<xAQ#lH(nnHMtZmYueG
zrI;C-jQb*#c6ODEwY{YWc6MF4aM#dC<K@|im+(w@6Mik_;!l}H&;0d4(EEW0%dUYX
zZn(*qp~gidWDfi$WNs%vf*qgS0r=a}+jtRwXr*KX%XIqGPM?B71NwNAu($|vZ8p>0
zuNWf*0Wv#%y0-Raw=9_H=^f}gZD+UK<h~YC8GuZnMmIgpauSppl$arNAzzaLldEp}
z#7!FrJwm%c%x-o7I6k{ga2C=r%)ocg?hqf4PztwaWR5dSfGh0muD=2)Tmhl12LOoe
zBLT(GI2DuvoO70zvDEN1=oFZ1Mxb_f1PVG#gz})WSB8>pJ2$D+=Vbz&f6Gp8a2b`7
zS??y5n^cgp<F}rqm^}orpFM=caI>+SRPBBKpa1^{k*rVazi=Lw2F}i^^;ryrFJk;%
z5qj}w$<K4Z7!uZmvg7wWW8Q-t+^U*r3|wD?sw+Y$V2%HpJYa5e2wus}zAi#dbn)aW
z$Y5?QBYw02{6xVXo7q!pke!_drHHub6h+F;PPZro&`v3%0I+tzus#iBF4k7jFL?q3
zjErUtPzLJ@PqwpDw5C*=6eJRMdedG9yrTpS=L=dfvxn}0s=114K8Jx$DL46*Nh?_B
zUzBmn@_kYsm6)HGaDbMDAJ1L}Qk6&qrAX+Jvs3Cv&1{Xmo{0`U7={V-+3d_6jHt`T
zZ`}+Nbi_k9dk_khrYV_sv)4IHj<;_7HZMXqd&Ne_ySxZBRB}A9vo|UXwIKV5JTLta
z{1?@4r#E5KJ^GQTsS(+PYDCM)&fXd*&s+8u?AP%dJA2Dh=PJ#1GLDFLI77!z&#2=W
zT7M27+~j}&#Ws>=c{9D6<NWk4o5GW8v>c{qZhF=Z)bxx7YWk9C^4Smk=0DP?&3^Es
zhD2HhMF@=!oi8<dgy=P+Q{n)2@t16*yCGy(9>R5$e=0q_okFT;%a_yI8$O@HGK4**
zVdruJYsLg{4QdT<hnt=Te9-zUi6ita3-Vy6?C^9Byd%nuuYX}=r1Uzw_Dbad8_7D`
z5i&^nqN7cOzuX{xP!3Rm<v~K%O-~tqgZ;&L3z=gn=8)bXFb~{;N1||X%K+BZ>?gLb
zXFvHI(TsNX6IAr%xh59NPM)Lhv^H#HZkSm}-YiIE7SV+`K<_f?Kl>RhD2w7;^U=}T
z2ix0)f<Wm9(6=D%iL<8y23YLDn0=I*Xx7=U@P{%M!Yle)vsN_h2%P~ta8joNScfvO
zs}0=9#8PuA6>HKT8X#x&aj{k(7euEd16wiM2HTCO;Es^#C@N*jKCLwT+{jR6e>RM%
zP>d^i2m^!5(m-zytj@YdcG&%uQOrSrpESWRU*+z(;|;J!KS|hQ$mfjQ(c80+eE0<i
z+>^2HLz8j!N6E)u_*lWcOubpbyNnV`F0NpAw7ZM99V%NDyLqXKfvxtbJGA;-fH(Hp
z&50b6f9pC>K=$(PZVoTXruYk?{?grW{8sz)IB3#@B!5-d&3F!6g%ArT2-(oE`XWmp
ze)}S<!#v*+o!{I{ULc+4-K|PEP6CFP3AKuZ=-cX2BBZS@8(Uog5n`*$I3wNo9^{71
z!T7lGQLeB&J*viE3?OqLdqQ`O+GLUx{*&no8N)h=WB5o-5Cl4*TcRk^so*J+Q<Id*
zV`2zQPE3Kf=)oaSIr&)$YQclv$r<qGJd;2==-gH}y%Rjt37!|?9|#?+yWCc{a$N>F
zB@z)Ta^7;08{bpBibFuktL$yUYJq%sbQVMN!v{m;hH=#$DE!<Vxatm+LB;gqfvxV5
zT~*yzBU>H0gP;_tDdQs4d7314`n0eW^q(?GhGpLm6O)jyI>|)H*?yP=sZ2F|e4$B_
ztc-UP+};lpT}oGd?IsfRCVLi%Aq=y!qgwCdP8lhm^uN<*IPa>j$wvv?Q-l=q0j(iz
z^$j3LYvkGLn03GwxD_(-tJhY?hBd?u(hykBkeAglShEnLZ^!@)HwIvcpcNfOZO}>|
zlkCx1-bRgRI2WN`;2X)!nzHbRqzrYg;hO|cfT_@@&>h(iK#cZ-zDzNJAJd#5tH@T5
zlTs;@8(TeLa9W+@wmN0}<*JjI#<Dtb)d>(e-P#if!)R^rwA?HjqC#A#od~wBpr264
zBFuM0<f<3Bt<G%q(pIl*^*V)vWK*J1L@2X*4M&ZwUPAa1*{D3b*g9i_E(rn%P+PrC
zL?<ypVuD>CpcC|43fecYyRmlngb{47bMx%<4Lxo8rYF=^`R_&iXANdzq51({pz0l#
zUt$s`!rxxF!}n@iz3SWQM_Zj~gnel@ewM-kTD{PHnZPRBg0Z?M0`007-qC_-TfK&f
zRlRrBi?mO{3D1bk>)Yx*NTS_==+JA0+PLc6H}B^_h=j23k*7kcp8@Tvk3fIb&(XkE
zzk24Yg5E6P+m^PvASeG^;@-I=d@}t-rZD?{!FuC7akjrm-R6n##Q`v5POgYKEuMMU
zUIOzShoqE$m?zTBLrd-9hS=)D%@ON_Cgei7x#bgWBQTIuK3tb)Lb`e3Uxd^?pZGGP
z>)gC>a|sp?%H>xX(wdoH>ZEC!a)$}Y3A06n_^=U}&4mn816qWV4zhTBJ817tO{xX#
zMAX!tN!Cw*&xzx6cHnZ8RHS@w104o(r1fVa<fd{Hi!j9t58V8+v~xsL&95Rs8hMV8
zsbt{h*F5xabC3cq>=K%qUn8v<3A7`PN&-=kI`b<=uto|^Vdq!y1j0Ue2_fzLCM9DY
znAjhapcL_EqVvf+Yi;LnMoX$l`%Bwn3Q42gTp~`)zYs2q=zZvLl@3);YK#Vh46lfB
z`k;k|ZAoQOyVAs=0ZEhXSnPmC5QUxJ;gfK;DmfaVjzbAv$SW8%%F0bT9@zO&8znJ0
z+$qD&3@W&-WL9BBB<lLQozmZ+{xt8E%Ff3;9p(?aB@2tt&{&b=pI^z#j-8KD<mM0a
zv`bDSp9zIbP0G_Dk4u^240jKCXjAYxY3pWH+9$EjQ&V>QY{iH|^;3WPsqf3V143w8
zs+-6%yk44i1-G4Yw00hIW{34!^()1b*!dI0lay-2&p<xZWk(`*MkQs)3EwX#+;~L2
z&acV@avF}L;htE_X?VD~b3)wjL3e1%*v_B9K+}qTld{7J(!EA^H|lmzB&iAqcK)2i
z2oAKEiS_q~xD25EG=-~$yuh@EC&%{=P)?#dLKF!sB5DP%Ui>7azi!A_8U2~)Y)-W0
zLlN@(&?)*M5kdGdN%%L(S`?XRAJ&k3UWRQ8{GHSl-Lj(-zbfgaUSi0Z$42w{sob`_
zjD6S8Z@-M}{1qkXXNU3zULN>ra7aQSGx*C@mL;%G`D8*^07=q2^VhB3K?7d<UL^@d
z`5i&4$FC3Al=C;};3PKz!ErY^jNyE@^B)5tQl5QDBvfirXfN<Tklv`^3jvd1d>iO;
z{(jxRA%Q_+^eESk7yV%3htPuabDjay7pzEL$k2KRB*pp>yWO(op=An^>u5zi*ALUf
z7h@QJyu(kcVrsk%S-l-V!rJ+J?|R_s`dCZnn>?=qu=Mk*<e2cry!U8P<QVl$KmwQF
zzQr0`MR)sQR1}Yd{$EVFgyMGSMYPsB5whT_BH}1j-U|Fy%C}i>D1v76B|QP=fu^U?
zLD%CV%7I4b`oPq2c?wKDzmT?;&~R>UHHK5Sg?pmI9D1F&`EYB%-Ta}edzw0=km2vZ
z-?@4qT|I1XpgI^S*D{65<MS~m*e<OHa!0U|r~wK{4pkpxp=`aMYt5>tfOJJd8DOUB
zTo<<9*T&YDoQO9CRD$5B`m%JP718EYYFvFa6@lVAb5I$1M)>Sp8&@MF!&Tt)Tz!jC
z(=h@HHSD*5q!#QBS0k*>)f8eew{-b|{_HEdWZ>$%n*)nf3uIXzf{96Oeb_CPt?$tl
zqfu6NY<<to&PIxyoGE%0Ag5iWDY#os>O3ohLc99N%}<zeou6oW0V+aBq(T~Ij*Jb-
zX`HI>V^07A__Wd5670FF^!m2k2Rc(pLB=35c^UcJHKM=%orty<+Hck){Q%fPF%ENE
zhHn17SCaq`sVgI2;@>e(tw52RpR@&pu{fWnJ)Vtjeu7?u#hdm(cF#|Au9dA1Ng*JH
zRpG!8t3LJ+t3IY#cie|dw7yM4UTBk(v$Vdg4VjSjI4%PP?P3KaGTxK^+PcERt}A}8
zG9*<5IL{H|TI)iSCZV(`6RcZXH`>;ZdkRJkCabNRb?UL7z&+3csEy=c{lv%YP}2!<
z)W;+gY<(OFS>%P@^Pw)bKK@OI7rCoXzysL&3BS-O{XQL*p{>9BOIOqR$Mo9-rRaTD
zYBZAtn9`c7M4#IFJG$&UipvT>eF~*A@@FRr)&!Tf?*7=4{M**y(ZJTv+Y|M3Izb1R
z-ULqS=j1ybxcW@S@Z<s*BBBT*R_GLi6_*Igs4u19`0H0VgV5#=9O3){#taS={ro}p
z;DM$*0K)DrDr*N)YvNZ5#iEepVh>(+Z*TQFLiXBCKs|8cc%ZTMlR_&4P9EKXJu1f5
z-@&~{35G@xUI>MyQ*M0S*!m4FMZsI5KYF21y&hO5TffD#(jIy`we>sj<@Fm|!(W%+
zKxjutBFKP|xkU-@X28qs3AHEsMs7WBPo!T-<&*JOQo_IvQrV-}s_}I#Ix5r3^n7hu
zEP^b{Oco1;z-vVHN!9hUlRJmlHLpFeD1Nst__JTkk^+Wo2FZP?K+l2O*kv-ey06Gy
z9=ZCbcA}rtrRRKU7d=2K*wwFiLrj~b;c@k=k&!`LOf}Mxdc)|f<Y5n8{i;ptt#rDT
z?%{!?zgc2{@~)2&N=F17#AJ-9d|Sh}W9#!adyYQZrM+PFU5WQW&%sGje}LA21B_BE
zo-L+ess}=ol5zD1R#G&bp`<)pTVuCSAVd_4PL$`7ibN3Q5%x6zJqx>l32qmFY<3Y+
z#OfkUN`(xHF~T)P;Jf-F7lB<QuD-B~#4Zxr{KP3V3dJ0bwg8IaD=FeKi3e`6=8G2y
zX~y0QDkSE!>>vW!E{3)~1hiG0#BCszcOaf;XCqr5;>6;TTVUIetAQpKJ!uzLsD+Dy
zUIyFM>|#hk`y+))5aoyCO^WuzsOVU9U?k#=-Qo`1KE^H%WB7Z3li(U!+;i0ln!_p5
z(bWmrkJu#<MG<qVNmq1KZWj-*La+%z+QoxNfDTnLwzK5kt+F`QWhi6(0iVWnVz&%h
zdU5&;rd@<5L}4sCySuwX-a)XyHoYj!Ffb4KA1=*!2#`gbpVrzNpb3mb`ib!q@|}<Q
zAK!!&5#@A{Zt;ZuV`tQdr$k*ZPRZ|sli2)+9=3~TbiqRik|c?NKD4b5;TY419YSL%
z&RV&}eP~6K;x9UH@sgi(ou=6vnj~-R;w@UN*fF_ym%yC@DibE4PjMUGBg{#SD5vb=
zoO|X^+~Mbm=(xql-8_N4A>HC5%tWn5c0s|BZt)F<x&iH>cfrU*zXIiq+~T@hyreCH
zBT7IKjYy!|TiQp99_fGl?>qnU!{zq}Jm=h^U~=Fn5~6U6KLJ`9w<xHDEJ{Li?|bmc
zPL5pt-Zg_!k8b7~8sODtpCa&uTNH$t`2+&4c1>c2W>@bU$?IoNxcbAuHJ1noHkYB`
zfDI1gfo-n%<%QG^NoknZ2~=nU20k`i68k*Y+FbwN)#@5791K=-(~%p!xy@JMHuxl(
z+Y(zA14(5&kh+J2I~r(d%{4SbH*n2ee(Qm24pG#F#BA=t0|Ue*aVIJ~ph$Pso>XKN
zHb>GY?h}L9Jdmo#b=v0Z_6gs7`UJR=o3VBc#YHp?S*0g5p1^)Y4}}GU9YMq931n>Z
zkmj;)6!IBKs^%2^!rl3`bYXYkn&UP@k>a*_3OnU4gxkP1-)&tvIp4nRw9V`cT=Pu%
zj6bmaq`j~s$S{z9b}>}A@tgKWHfow<|EN3LwZCXH7DCn5hic%OGX>e14_xz7tsjN)
zeT5CkzF7Hc@5mjAn!ewz_RV(Y?YbfUR@?mGZ+;_pL~qk$uKDpZvftXAH(=1i%~Q1C
z*tg_6e>~;gu+6j9@z{Lh&)o6H7yb%7m`lF*XWsbZTj@e0lv@<+6Im1(R0#V0VcDTc
z0y6Q@InO@37`nwiMjzsB_y<_vbV*x5dlhS*Ay6|HbIt2BpJPMq>}>R#V%DDTp>cMT
z;V%07J#-dJwE`^G$k1k2?tF5$L6<9DBv@E}J>Hcr{DYAl$eHa`>!-jTuH%X@5dYrD
z2v;^^_<!3mq#NFBtrfb9R{1$k@SoAcl=?tDx;f%ZZ)++xLm(eomcE4m9^?V{la7qp
zlfJi2eIdnxHc$F%Bh@wNq2CK?E-ywnXzwfAT-c>VJ*l)y7VXOr8*i4<HW!3)-Llu+
z5(a*c837BDP;IdnAUg=vK#N(-EQhcs$UW5@kq845+S~{I2&T){hafdaJ0eo3@1U&@
zwH%=q370l17W9ZEkqra8+~;ruB)FiEieBSOpsnSlDE&%NL(QH{5f_LH9ECJ4FKd$I
zc5wxJ*!)Gt&r5`3y5$uV`V!tL4fY7)%`UHw(t%rEQ@B5*?W6U3?2ko7Zh3_)D?E*7
zx?Xn;nu%9OaE)gYBD+L<Z*xSxoMk~DIq)c6wPB!Pziq#tB#3D#7*8&5Y@dYg>9=j$
zo@+~hv)CUY&cFXuocFdwQZvk{3X)}{-3D$+yBdYU?$+MGEpM;yH0#HCb;K)>R0L~W
z@I=ZkH|y*@<RW==XwQbQ%L8<u@-e#r9+M+NBfO&@ixqL_dooNRN@;^Wd#UPsM9{cp
zF9z}J7Kq`OoK<dlh;RVAyhn~0yFB8}^$|yS+9kpB<^3+U9T0h<dwQ_-J{t{aKJC=D
zz%@heBcKhhcK~Ud3q^fKokY9;q_)ck6cEo)1-eJ~?D7GiWiPSIuVcJxFUB?<3C?D@
zj|mEQbg%sr$JAiySEygN-%waSmL%eZR74wnB9d-Ap;<gHALba4O{+{9v=iJdTg}{D
zV6*`|h{;(L{@m}sk{vJ4nAcKXK6)wC3>l&|Lt8(=AYbxAfn_-=Z7`MK&$l(cG%&Es
z$B+ncFz{Cg_Jqb1eM}Em>*g<>q4Y^BWR_1rh|{D;nFDRi{48WIRl`#rXQ{^*g<D=>
zn2Y1UEl*g_58Uz;O~4wq%cr>5R@lp_@cbQ74D9kd-}+}HdZld3DD2XwHDB_)ePyZ@
zCD6C5ySa#JH7WY%5N&6&%zI3m1~3A$!4rqAx>>%UH55osY4DqzMcq`{<$b@Xx0XHS
zX=>cpbctOiS$mr0yj{Ljgw57A$MO|b_sZ*|Z7K4ht?m`+p80k1aFR`;X`1;GJtV>A
zJ)i|*i<aN}7$UYY+@c_axV%Dvi7+Xp+L1ka%eMgs>BDc_0pSK7`3(6VJ@C;_#2_W>
z6onk{>>%bD1`{=qqY#(x$SJaX7o?Kx@Z}MUVwDI{uu%Tpr^|d>7Dlv4z|Bk7Ja<d5
zJZ|~UE#E=b5T-!eFAvI)FboOuHPYD?F(%xi@HVwu>@!x0se8#p#vK%x`53XCld<2G
zM5_8Bqf<u6El{4a6}kM_MRe0WH))JrUa$<so@t1}>$LIlp_?@Bpxr**Y;T`NrX|n<
zgZINmma)6R@!DhRsS6_fdkS$z6iRiEJ}W_SN1amU*!1OALpQ!h0n6iih({vZYE>Xh
zTe)$LFH*{t9Zqtst097C{f$UW8YBebT-*d^1X4NL-|#tCo%9hwyUEg+R;L^fbeeON
zzNdiM&>i2~5h32Ks*GLjyVaN2%)(NCwU532eOo=Xx9sW?#m{0eR$p?^H=e^^#kdD;
zp%j8L?dnQE0Wqs9F+#fXJg3dz7x*>|j~IO;X4gKtK$PCDg62U0*Udh6Xv$xgS@GV&
z6!xS77@IT{l{!DkQxWt->^Cq8!ho;=Axu+Sy+oX>PtsNs39kyhK~^esE>(m2CgWXK
zRcP;{i(ML^`H7o`)Z^3}J>IP2y#W+z@|cEn(zuFZ-O*JI5|c3}IPw({F&x*5eG?-Q
z{x-H~E6S);I)LL>2k?mnIyZK8gQeE|M1i=??dm29>B~GWw5!{FZY)g_ySmN7i5gF2
zmR-ReNCx%_Ml64_=SNZqD_FxccC#}#JBv$|rgn9Q`@>Dfh$%#Bbr%_Y8=#$vxpAu@
zg&PAHjB=%De=~fm*n^jMMQ7wzQY&Luw=w%^!>e6^kC7UmVgW4i5@L1VE#F~gt{!AS
zmC(mH1$dhe3)pt6uUmNQr{V+ts1EM{B{fI}+@8pYo#!*4eMZKv5cvik*<XUKHmKtv
zof^2+cykK{Be1zlae;2J9|+ok=N1Ko6Fvjgx2s0=K^^1$9`+?=a0QXIi^6g2K%u-j
z?3&m74GubMg_fh??$9WM|7e7W<Y;$@BtD{%i%^XcYGGpfA$Irs=AQIrf(9gg)mOdt
z`IJk9O8OzLA&~PD+8>`-kbMF-3HWM6>8qUd$h#J!Lo~zoq5TQo23kEOGOj-K7-e-I
z`xD%vFn0CKh>l&IY3)|esi*W`8Kv#&3_Bg$GK5e!X9@)`2X6JMLn(AV!J4(lkYFin
zs?}>Gz;MBr?^fSSiZ4tz@r5Z!&@@eXPsJnJyGkFzLR|NwGwktz{5lH1lK8AoD(&ir
z{#Smx8ONvvP6T#(WvjqwY=Vm|@7Bau9$GwPg7(t(^GVX^I1S?1uHIpH*^r`|<q$*+
zyMgv-LukBda!d(0=0l<4IOdIP+dJ6WJ-?Xt>;1oS*hy6!lQ24?;9TsaL;xbbDT9w4
ztp3zpf4IP{{)Css=e-cDs)fpF10`>#!WK2&IptOWcy9HajJ?%4NtM-ee5Y#lGYUW#
zx#dqfrAv1NZCyg1ytCfwBFb`~DS~}g=dbDadxlx7^VE=*S)D`p7IyWEP8B(7*hs;2
z1M$kyNhzE{;Jh?~z2I~JN+GpcoqLbP{L02@y@I=1y81Q(1l;PQ55=K9kHB~a+ob##
zJAAQQeKdA;foc3Leb&f*E0a>%)dg-qJP=3?#M__@9#3i3@D%vKfYYl#G86?|C!mJd
zEm*VPCY*#x`E8HBNwz9@@%u>oZxfO%5FDC9^YIyukr~l$Eq@sqHQIjLOUl45kBgq}
zkx|owu3R45<*`ro?D9Bk%k1))-3F?Ys*vJj;Y?3_AS;NlHYS4xy~eho9!G14K=s;g
zf*?uTuqF+kUe;#pw?h)1*>+TamTf+2m1W+Wo@H6auJkPH2pML0fdJdf0`l8sn~eeZ
z)?T|O0F8zf3PmtSR3w5V>zi#XB%Jkb9<H<7agxx&xQV{Kz%es8;ZIN5ON1@um@zlo
z2#@QV2oUUxay7oOg7XM$cnRFOHYBJ)$LvLrA--5<zx@(E^B5)!Vzn@FLqI1{*!mdY
z!-OXDe?^devL_UvD9f@46G3O0=)f5VPWv%7JL9WNR2={SENVP7%ixR0AEUc#7p|?}
zLiczVFFcTIk1lr3x6jWI@n2uUiW2`9{V~7E|BwF?uG9a7borO>`=49a3GrY5)8GHY
zfBxei@tJY);J^Lt-~YqW(SP{6KmL)<{mYl4{OkV{P5*!6&)<ZiD}?yx|M+j+kpKTj
z{2ToFS5Qj<0u%rg000080C>JiT?JPQm)DE|002G(01W^D0000000000000000001G
lcw=lXZE0d-E@W(MP)h{{000000RRC2I{*Lx0*wIx0089c?>_(l


From c053bfd31c456d4dc5454169d5b2b59efe6ae345 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Sun, 11 Oct 2026 17:20:23 -0300
Subject: [PATCH 097/115] refactor: optimize XML parsing logic in XlsxWorkbook
 and XlsxXml classes

---
 docs/performance/benchmarks.md                | 174 +++++++++---------
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |   4 +-
 .../Reader/Xlsx/XlsxWorkbook.Loading.cs       |   4 +-
 src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs   | Bin 14872 -> 15496 bytes
 4 files changed, 90 insertions(+), 92 deletions(-)

diff --git a/docs/performance/benchmarks.md b/docs/performance/benchmarks.md
index 2960ca10..665a46fd 100644
--- a/docs/performance/benchmarks.md
+++ b/docs/performance/benchmarks.md
@@ -15,32 +15,32 @@ Compares ExcelReader against established XLSX libraries on the same generated wo
 
 | Scenario | ExcelReader | Sylvan | OfficeIMO | SpreadCheetah |
 |---|---:|---:|---:|---:|
-| Cell-by-cell read | 7.207 ms, 3.82 KB | 35.203 ms, 1.89 MB | 104.726 ms, 6.84 MB | - |
-| Cell-by-cell read async | 7.953 ms, 3.89 KB | - | - | - |
-| Typed row parsing | 10.935 ms, 3.87 MB | 56.855 ms, 10.47 MB | 104.530 ms, 5.69 MB | - |
-| Typed row parsing async | 11.241 ms, 3.87 MB | 60.501 ms, 10.48 MB | - | - |
-| Typed row parsing, shared strings | 10.849 ms, 2.29 MB | - | - | - |
+| Cell-by-cell read | 6.847 ms, 3.57 KB | 36.131 ms, 1.89 MB | 106.861 ms, 6.84 MB | - |
+| Cell-by-cell read async | 7.391 ms, 3.64 KB | - | - | - |
+| Typed row parsing | 10.668 ms, 3.87 MB | 56.150 ms, 10.48 MB | 107.805 ms, 5.70 MB | - |
+| Typed row parsing async | 10.833 ms, 3.87 MB | 59.036 ms, 10.48 MB | - | - |
+| Typed row parsing, shared strings | 9.216 ms, 2.29 MB | - | - | - |
 | Workbook writing | 10.913 ms, 4.02 MB | - | 18.166 ms, 4.02 MB | 15.128 ms, 15.84 MB |
 | Workbook writing, shared strings | 10.848 ms, 4.06 MB | - | - | - |
 
-ExcelReader is ~4.9x faster than Sylvan for raw XLSX reads, allocating ~508x less, and ~14.5x faster than OfficeIMO. For typed parsing it is ~5.2x faster than Sylvan (~5.4x async against async). For XLSX writing, ExcelReader is ~1.4x faster than SpreadCheetah while allocating ~3.9x less memory, and ~1.7x faster than OfficeIMO.
+ExcelReader is ~5.3x faster than Sylvan for raw XLSX reads, allocating ~543x less, and ~15.6x faster than OfficeIMO. For typed parsing it is ~5.3x faster than Sylvan (~5.4x async against async). For XLSX writing, ExcelReader is ~1.4x faster than SpreadCheetah while allocating ~3.9x less memory, and ~1.7x faster than OfficeIMO.
 
 OfficeIMO.Excel's typed parsing is hand-mapped from its `OpenDataReader`, because `RowsAs<T>` needs an `r` attribute on every row and cell, which the spec makes optional and ExcelReader's writer omits.
 
-Reading a shared-strings XLSX workbook with typed parsing is ~1% faster than the inline-string sheet above (10.849 ms vs. 10.935 ms) and allocates ~41% less (2.29 MB vs. 3.87 MB) — each distinct string decodes once into the shared-string cache instead of once per cell occurrence.
+Reading a shared-strings XLSX workbook with typed parsing is ~14% faster than the inline-string sheet above (9.216 ms vs. 10.668 ms) and allocates ~41% less (2.29 MB vs. 3.87 MB) — each distinct string decodes once into the shared-string cache instead of once per cell occurrence.
 
 ### XLSB (BIFF12)
 
 | Scenario | ExcelReader | OfficeIMO |
 |---|---:|---:|
-| Cell-by-cell read | 5.178 ms, 4.13 KB | 10.406 ms, 6.70 MB |
-| Cell-by-cell read async | 5.249 ms, 4.20 KB | - |
-| Typed row parsing | 8.211 ms, 3.87 MB | - |
-| Typed row parsing async | 8.261 ms, 3.87 MB | - |
+| Cell-by-cell read | 4.798 ms, 3.82 KB | 11.123 ms, 6.70 MB |
+| Cell-by-cell read async | 4.845 ms, 3.89 KB | - |
+| Typed row parsing | 7.819 ms, 3.87 MB | - |
+| Typed row parsing async | 8.061 ms, 3.87 MB | - |
 | Workbook writing | 7.478 ms, 4.02 MB | - |
 | Workbook writing, shared strings | 7.370 ms, 4.06 MB | - |
 
-XLSB is the fastest generated Excel format in these results: raw reads are ~1.4x faster than XLSX reads, typed parsing is ~1.3x faster than XLSX parsing, and writing is ~1.5x faster than XLSX writing. Against OfficeIMO's XLSB reader, ExcelReader is ~2.0x faster while allocating ~1,660x less. The XLSB writer is also ~2.0x faster than SpreadCheetah's XLSX writer on this benchmark while allocating ~75% less memory.
+XLSB is the fastest generated Excel format in these results: raw reads are ~1.4x faster than XLSX reads, typed parsing is ~1.4x faster than XLSX parsing, and writing is ~1.5x faster than XLSX writing. Against OfficeIMO's XLSB reader, ExcelReader is ~2.3x faster while allocating ~1,800x less. The XLSB writer is also ~2.0x faster than SpreadCheetah's XLSX writer on this benchmark while allocating ~75% less memory.
 
 ### XLS (BIFF8)
 
@@ -99,14 +99,12 @@ Sequentially, ExcelReader's typed parser is ~1.1x faster than Sep on narrow ints
 
 | Dop | XLSX | XLSB |
 |---:|---:|---:|
-| 1 | 54.38 ms, 8.02 MB | 36.55 ms, 8.02 MB |
-| 2 | 37.84 ms, 8.13 MB | 25.60 ms, 8.07 MB |
-| 4 | 20.07 ms, 8.11 MB | 14.94 ms, 8.07 MB |
-| 8 | 19.94 ms, 8.16 MB | 15.26 ms, 8.09 MB |
+| 1 | 52.60 ms, 8.02 MB | 35.77 ms, 8.02 MB |
+| 2 | 36.30 ms, 8.13 MB | 24.48 ms, 8.07 MB |
+| 4 | 16.89 ms, 8.11 MB | 13.32 ms, 8.07 MB |
+| 8 | 17.06 ms, 8.16 MB | 13.67 ms, 8.09 MB |
 
-This run had background load and may read a few percent high: on an idle machine a scratch harness's minimums at dop 4 were 18.85 ms for XLSX (against 20.07 ms here) and 14.44 ms for XLSB (against 14.94 ms); an idle rerun is pending.
-
-At dop 4 XLSX reads ~2.7x faster than sequentially and XLSB ~2.4x. Dop 2 is a single parse worker running alongside the inflating thread. Past dop 4 nothing improves: the one inflating thread is the floor (~15 ms for XLSX, ~10 ms for XLSB, plus the XLSB record walk that finds row boundaries). Allocation barely moves with dop (8.02 to 8.16 MB): it is the typed model's strings.
+At dop 4 XLSX reads ~3.1x faster than sequentially and XLSB ~2.7x. Dop 2 is a single parse worker running alongside the inflating thread. Past dop 4 nothing improves: the one inflating thread is the floor (~14 ms for XLSX, ~10 ms for XLSB, see [Inflate](#inflate), plus the XLSB record walk that finds row boundaries). Allocation barely moves with dop (8.02 to 8.16 MB): it is the typed model's strings.
 
 ### Real data reads
 
@@ -114,13 +112,13 @@ This benchmark reads a real workbook exported in multiple formats.
 
 | Format | ExcelReader | ExcelReader, prefetch | Sylvan |
 |---|---:|---:|---:|
-| XLSX | 43.792 ms, 7.23 KB | 29.544 ms, 23.39 KB | 201.558 ms, 644.23 KB |
-| XLSM | 44.486 ms, 7.23 KB | 29.169 ms, 23.42 KB | 207.288 ms, 644.30 KB |
-| XLSB | 25.704 ms, 6.79 KB | 17.403 ms, 17.01 KB | 30.864 ms, 338.54 KB |
-| XLS | 11.335 ms, 12.02 KB | n/a | 19.146 ms, 185.90 KB |
-| CSV | 5.284 ms, 840 B | n/a | 4.630 ms, 40.26 KB |
+| XLSX | 41.275 ms, 7.31 KB | 29.616 ms, 23.52 KB | 197.561 ms, 644.23 KB |
+| XLSM | 43.649 ms, 7.31 KB | 29.347 ms, 23.48 KB | 194.102 ms, 644.30 KB |
+| XLSB | 25.303 ms, 6.87 KB | 17.588 ms, 15.20 KB | 29.771 ms, 338.54 KB |
+| XLS | 11.280 ms, 12.02 KB | n/a | 18.379 ms, 185.90 KB |
+| CSV | 5.072 ms, 888 B | n/a | 4.585 ms, 40.26 KB |
 
-On this real-data workload, ExcelReader is ~4.6x faster than Sylvan for XLSX and ~4.7x for XLSM, ~1.2x faster for XLSB, and ~1.7x faster for XLS — allocating ~89x less for XLSX and XLSM, ~51x less for XLSB and ~15x less for XLS. On CSV, where both sides read text through spans, Sylvan.Data.Csv is ~14% faster, while ExcelReader allocates ~49x less. The prefetch column is the opt-in [`PrefetchDecompression`](../guide/reading.md#prefetch-decompression-xlsxxlsb) option; XLS and CSV are uncompressed, so it does not apply to them.
+On this real-data workload, ExcelReader is ~4.8x faster than Sylvan for XLSX and ~4.4x for XLSM, ~1.2x faster for XLSB, and ~1.6x faster for XLS — allocating ~88x less for XLSX and XLSM, ~49x less for XLSB and ~15x less for XLS. On CSV, where both sides read text through spans, Sylvan.Data.Csv is ~11% faster, while ExcelReader allocates ~46x less. The prefetch column is the opt-in [`PrefetchDecompression`](../guide/reading.md#prefetch-decompression-xlsxxlsb) option; XLS and CSV are uncompressed, so it does not apply to them.
 
 ### In-memory real-data reads
 
@@ -128,18 +126,18 @@ The real-data benchmark also measures the in-memory path for workbook content lo
 
 | Method | Mean | StdDev | Allocated |
 |---|---:|---:|---:|
-| Xlsx_ExcelReader_Memory | 44.249 ms | 0.341 ms | 6.98 KB |
-| Xlsx_ExcelReader_Memory_Prefetch | 30.115 ms | 0.803 ms | 23.19 KB |
-| Xlsm_ExcelReader_Memory | 45.242 ms | 0.357 ms | 6.98 KB |
-| Xlsm_ExcelReader_Memory_Prefetch | 29.307 ms | 0.718 ms | 23.05 KB |
-| Xlsb_ExcelReader_Memory | 25.606 ms | 0.255 ms | 8.49 KB |
-| Xlsb_ExcelReader_Memory_Prefetch | 16.688 ms | 0.857 ms | 16.64 KB |
-| Xls_ExcelReader_Memory | 11.330 ms | 0.105 ms | 11.88 KB |
-| Csv_ExcelReader_Memory | 4.919 ms | 0.043 ms | 568 B |
+| Xlsx_ExcelReader_Memory | 42.521 ms | 0.905 ms | 7.05 KB |
+| Xlsx_ExcelReader_Memory_Prefetch | 29.167 ms | 0.353 ms | 23.03 KB |
+| Xlsm_ExcelReader_Memory | 40.925 ms | 0.140 ms | 7.05 KB |
+| Xlsm_ExcelReader_Memory_Prefetch | 30.345 ms | 1.268 ms | 23.22 KB |
+| Xlsb_ExcelReader_Memory | 27.084 ms | 1.294 ms | 8.55 KB |
+| Xlsb_ExcelReader_Memory_Prefetch | 18.140 ms | 0.703 ms | 16.79 KB |
+| Xls_ExcelReader_Memory | 10.704 ms | 0.139 ms | 11.88 KB |
+| Csv_ExcelReader_Memory | 4.759 ms | 0.022 ms | 616 B |
 
-`Csv_ExcelReader_Memory` is both faster (4.919 ms vs. 5.284 ms for `Csv_ExcelReader`) and allocates less (568 B vs. 840 B) than its stream twin.
+`Csv_ExcelReader_Memory` is both faster (4.759 ms vs. 5.072 ms for `Csv_ExcelReader`) and allocates less (616 B vs. 888 B) than its stream twin.
 
-`Xls_ExcelReader_Memory` matches its stream twin (11.330 ms vs. 11.335 ms for `Xls_ExcelReader`), with near-identical allocation (11.88 KB vs. 12.02 KB). In earlier runs the in-memory path was ~33% faster, thanks to `BiffCursor` caching the enclosing contiguous sector run; the stream path has since caught up.
+`Xls_ExcelReader_Memory` is ~5% faster than its stream twin (10.704 ms vs. 11.280 ms for `Xls_ExcelReader`), with near-identical allocation (11.88 KB vs. 12.02 KB). In earlier runs the in-memory path was ~33% faster, thanks to `BiffCursor` caching the enclosing contiguous sector run; the stream path has since mostly caught up.
 
 ### String-heavy reads
 
@@ -147,22 +145,22 @@ The real-data corpus above is mostly numbers and dates — its shared-string tab
 
 | Format | ExcelReader | ExcelReader, prefetch | Sylvan |
 |---|---:|---:|---:|
-| XLSX | 33.16 ms, 2.18 MB | 23.35 ms, 2.21 MB | 187.18 ms, 17.41 MB |
-| XLSB | 35.92 ms, 2.18 MB | 21.86 ms, 2.21 MB | 66.81 ms, 17.38 MB |
+| XLSX | 32.84 ms, 2.18 MB | 24.03 ms, 2.21 MB | 186.05 ms, 17.41 MB |
+| XLSB | 32.44 ms, 2.18 MB | 21.12 ms, 2.20 MB | 65.22 ms, 17.38 MB |
 
-Both formats handle this well: ~5.6x and ~1.9x faster than Sylvan for XLSX and XLSB respectively, at roughly ~8x less memory in both cases, with no garbage collections in either configuration. XLSB's shared-string path previously materialized its table eagerly (~27 MB here); `ParseSharedStreaming` brought it in line with the XLSX streaming/pooling path, cutting allocation by ~12x on this workload.
+Both formats handle this well: ~5.7x and ~2.0x faster than Sylvan for XLSX and XLSB respectively, at roughly ~8x less memory in both cases, with no garbage collections in either configuration. XLSB's shared-string path previously materialized its table eagerly (~27 MB here); `ParseSharedStreaming` brought it in line with the XLSX streaming/pooling path, cutting allocation by ~12x on this workload.
 
 `XlsxSharedStringHotPathBenchmark` splits the XLSX read into stages on the same workbook. The stored rows re-zip it without compression, so they show what parsing costs once inflate is gone:
 
 | Stage | Mean | Allocated |
 |---|---:|---:|
-| Whole read | 33.79 ms | 2.18 MB |
-| Whole read, prefetch | 23.61 ms | 2.21 MB |
-| Shared-string table only (open + first row) | 9.72 ms | 747 KB |
-| Whole read, stored | 20.10 ms | 2.18 MB |
-| Shared-string table only, stored | 3.24 ms | 746 KB |
+| Whole read | 33.87 ms | 2.18 MB |
+| Whole read, prefetch | 23.36 ms | 2.21 MB |
+| Shared-string table only (open + first row) | 9.31 ms | 747 KB |
+| Whole read, stored | 20.23 ms | 2.18 MB |
+| Shared-string table only, stored | 3.42 ms | 746 KB |
 
-About 40% of the default read is inflate: without it the whole read drops from 33.79 ms to 20.10 ms, and the shared-string table from 9.72 ms to 3.24 ms. What remains, ~17 ms, is the worksheet scan.
+About 40% of the default read is inflate: without it the whole read drops from 33.87 ms to 20.23 ms, and the shared-string table from 9.31 ms to 3.42 ms. What remains, ~17 ms, is the worksheet scan.
 
 ### Inflate
 
@@ -170,9 +168,9 @@ About 40% of the default read is inflate: without it the whole read drops from 3
 
 | Entry | `DeflateStream` | `InflateStream` | Ratio |
 |---|---:|---:|---:|
-| XLSX `sheet1.xml` (6.7 MB → 34.4 MB) | 23.433 ms, 280 B | 16.501 ms, 200 B | 0.70 |
-| XLSB `sheet1.bin` (3.7 MB → 15.9 MB) | 13.230 ms, 280 B | 10.259 ms, 200 B | 0.78 |
-| String-heavy `sharedStrings.xml` | 10.522 ms, 281 B | 6.659 ms, 200 B | 0.63 |
+| XLSX `sheet1.xml` (6.7 MB → 34.4 MB) | 23.789 ms, 280 B | 13.741 ms, 200 B | 0.58 |
+| XLSB `sheet1.bin` (3.7 MB → 15.9 MB) | 13.143 ms, 280 B | 9.734 ms, 200 B | 0.74 |
+| String-heavy `sharedStrings.xml` | 10.571 ms, 281 B | 6.106 ms, 200 B | 0.58 |
 
 Without prefetch a read is inflate plus parse, so the faster inflate converts directly; with prefetch the two overlap and the read is bounded by the slower stage, which is why the prefetch columns above moved little.
 
@@ -186,30 +184,30 @@ Real-data workbook, per format:
 
 | Format | Mean | StdDev | Allocated |
 |---|---:|---:|---:|
-| XLSX | 46.53 ms | 0.19 ms | 16.70 KB |
-| XLSM | 46.16 ms | 0.48 ms | 16.70 KB |
-| XLSB | 28.46 ms | 0.58 ms | 16.26 KB |
-| XLS | 13.36 ms | 0.27 ms | 21.48 KB |
-| CSV | 19.38 ms | 0.10 ms | 35.71 MB |
+| XLSX | 43.03 ms | 0.15 ms | 16.78 KB |
+| XLSM | 43.64 ms | 0.28 ms | 16.78 KB |
+| XLSB | 28.01 ms | 0.90 ms | 16.34 KB |
+| XLS | 12.95 ms | 0.25 ms | 21.48 KB |
+| CSV | 19.31 ms | 0.22 ms | 35.71 MB |
 
 Generated 50,000-row XLSX workbook:
 
 | Scenario | Mean | StdDev | Allocated |
 |---|---:|---:|---:|
-| Cell-by-cell read, materialized | 8.41 ms | 0.02 ms | 1.58 MB |
+| Cell-by-cell read, materialized | 7.89 ms | 0.03 ms | 1.58 MB |
 
 String-heavy workbook (65,536 rows, ~190,000 distinct shared strings):
 
 | Format | Mean | StdDev | Gen0 | Gen1 | Gen2 | Allocated |
 |---|---:|---:|---:|---:|---:|---:|
-| XLSX | 57.19 ms | 2.01 ms | 1,111.1 | 1,000.0 | 333.3 | 15.25 MB |
-| XLSB | 57.84 ms | 1.98 ms | 1,100.0 | 1,000.0 | 300.0 | 15.25 MB |
+| XLSX | 55.51 ms | 0.58 ms | 1,111.1 | 1,000.0 | 333.3 | 15.25 MB |
+| XLSB | 55.55 ms | 0.95 ms | 1,111.1 | 1,000.0 | 333.3 | 15.25 MB |
 
 Reading the allocation columns against the tables above gives the honest shape of the tradeoff:
 
-- **CSV real data:** 35.71 MB materialized against 840 B for the span-based read of the same file. Every CSV field is a distinct string, so nothing dedupes — this is where zero-copy reading earns its keep outright.
-- **XLSB real data:** 16.26 KB, essentially cheap. That corpus repeats a small set of values, so the shared-string table dedupes and the reader's string cache materializes each distinct value once.
-- **String-heavy XLSX:** 15.25 MB materialized, against **Sylvan's 17.41 MB on the same workload** — doing matched work here, ExcelReader allocates ~12% *less* than Sylvan, with 333 Gen2 collections, and is still ~3.3x faster (57.19 ms vs. 187.18 ms). The same allocation holds for XLSB (15.25 MB vs. Sylvan's 17.38 MB, also ~12% less, 300 Gen2 collections), where matched-work time is ~14% ahead of Sylvan (57.84 ms vs. 66.81 ms). This was previously an inversion (ExcelReader allocated ~1.75x *more* than Sylvan here): the per-reader shared-string dedup cache was an unpresized `Dictionary<int,string>`, and at ~190,000 distinct values its resize/rehash churn (several of the largest resizes landing on the LOH) accounted for the entire gap — the strings themselves were never the problem, since both readers retain the same ~190,000 distinct instances. Replacing the dictionary with a `string?[]` indexed by shared-string index (sized exactly from the table's known count, no resizing) cut the allocation in half and cut wall-clock time by 14-16% on this benchmark too, since the churn was costing cycles, not just memory.
+- **CSV real data:** 35.71 MB materialized against 888 B for the span-based read of the same file. Every CSV field is a distinct string, so nothing dedupes — this is where zero-copy reading earns its keep outright.
+- **XLSB real data:** 16.34 KB, essentially cheap. That corpus repeats a small set of values, so the shared-string table dedupes and the reader's string cache materializes each distinct value once.
+- **String-heavy XLSX:** 15.25 MB materialized, against **Sylvan's 17.41 MB on the same workload** — doing matched work here, ExcelReader allocates ~12% *less* than Sylvan, with 333 Gen2 collections, and is still ~3.4x faster (55.51 ms vs. 186.05 ms). The same allocation holds for XLSB (15.25 MB vs. Sylvan's 17.38 MB, also ~12% less, 333 Gen2 collections), where matched-work time is ~17% ahead of Sylvan (55.55 ms vs. 65.22 ms). This was previously an inversion (ExcelReader allocated ~1.75x *more* than Sylvan here): the per-reader shared-string dedup cache was an unpresized `Dictionary<int,string>`, and at ~190,000 distinct values its resize/rehash churn (several of the largest resizes landing on the LOH) accounted for the entire gap — the strings themselves were never the problem, since both readers retain the same ~190,000 distinct instances. Replacing the dictionary with a `string?[]` indexed by shared-string index (sized exactly from the table's known count, no resizing) cut the allocation in half and cut wall-clock time by 14-16% on this benchmark too, since the churn was costing cycles, not just memory.
 
 The takeaway is not that one column beats the other: it is that ExcelReader's headline read numbers come from a zero-copy path competitors do not expose, and when it does the same work as them, the gap narrows — and here, with the dedup cache fixed, no longer inverts even at high shared-string cardinality.
 
@@ -245,11 +243,11 @@ A `ref struct` model (see [Parse into a ref struct](../guide/parsing.md#parse-in
 
 | Target | Mean | Allocated |
 |---|---:|---:|
-| `class` (`ExcelParser<T>`) | 10.94 ms | 3.87 MB |
-| `struct` (`ExcelParser<T>`) | 9.93 ms | 1.58 MB |
-| `ref struct` + span binding (`ExcelParser<T>`) | 9.30 ms | 4.36 KB |
+| `class` (`ExcelParser<T>`) | 11.22 ms | 3.87 MB |
+| `struct` (`ExcelParser<T>`) | 10.11 ms | 1.58 MB |
+| `ref struct` + span binding (`ExcelParser<T>`) | 9.65 ms | 4.12 KB |
 
-Parsing into a `ref struct` with a `ReadOnlySpan<byte>` text column removes essentially all per-row allocation — ~99.9% less than the `class` baseline — and is ~6% faster than the `struct` target, since there's no per-row `string` allocation for the text column. It is not AOT/trim-safe (reflection-based, same tradeoff as `ExcelParser.FromAttributes<T>`). It can be consumed with `foreach` or `await foreach` but not through `IEnumerable<T>`/`IAsyncEnumerable<T>`/LINQ — a `ref struct` element can't be boxed through those interfaces.
+Parsing into a `ref struct` with a `ReadOnlySpan<byte>` text column removes essentially all per-row allocation — ~99.9% less than the `class` baseline — and is ~5% faster than the `struct` target, since there's no per-row `string` allocation for the text column. It is not AOT/trim-safe (reflection-based, same tradeoff as `ExcelParser.FromAttributes<T>`). It can be consumed with `foreach` or `await foreach` but not through `IEnumerable<T>`/`IAsyncEnumerable<T>`/LINQ — a `ref struct` element can't be boxed through those interfaces.
 
 ### ADO.NET bridge (`IDataReader`)
 
@@ -257,13 +255,13 @@ Parsing into a `ref struct` with a `ReadOnlySpan<byte>` text column removes esse
 
 | Access | Mean | Ratio | Allocated |
 |---|---:|---:|---:|
-| Raw rows (`row[i].Value`, baseline) | 6.878 ms | 1.00 | 3.87 KB |
-| `GetBytes` (text column only) | 7.222 ms | 1.05 | 4.55 KB |
-| `GetValue` (every column) | 9.660 ms | 1.40 | 5.01 MB |
-| Typed getters (`GetString`/`GetInt32`/`GetDateTime`/`GetDouble`) | 9.059 ms | 1.32 | 1.58 MB |
-| `DataTable.Load` | 63.615 ms | 9.25 | 22.84 MB |
+| Raw rows (`row[i].Value`, baseline) | 6.845 ms | 1.00 | 3.62 KB |
+| `GetBytes` (text column only) | 7.039 ms | 1.03 | 4.31 KB |
+| `GetValue` (every column) | 9.479 ms | 1.39 | 5.01 MB |
+| Typed getters (`GetString`/`GetInt32`/`GetDateTime`/`GetDouble`) | 9.094 ms | 1.33 | 1.58 MB |
+| `DataTable.Load` | 60.509 ms | 8.85 | 22.84 MB |
 
-The bridge costs ~1.3–1.4x over reading rows directly. `GetValue` boxes every value (the 5 MB), and the typed getters allocate only the text column's `string`s. `GetBytes` copies UTF-8 without making a `string`, so it stays within ~5% of the raw read. `DataTable.Load` is dominated by `DataTable`'s own row storage: the same values cost 9.660 ms to read through `GetValue` alone.
+The bridge costs ~1.3–1.4x over reading rows directly. `GetValue` boxes every value (the 5 MB), and the typed getters allocate only the text column's `string`s. `GetBytes` copies UTF-8 without making a `string`, so it stays within ~3% of the raw read. `DataTable.Load` is dominated by `DataTable`'s own row storage: the same values cost 9.479 ms to read through `GetValue` alone.
 
 ### Arrow conversion
 
@@ -284,16 +282,16 @@ On the same file, letting `Excel.InferSchema` guess the schema costs about the s
 
 | Scenario | Mean | Allocated |
 |---|---:|---:|
-| Small, plain | 0.198 ms | 9.15 KB |
-| Small, encrypted, stream | 26.129 ms | 38.39 KB |
-| Small, encrypted, stream, `VerifyEncryptedIntegrity` | 25.641 ms | 40.54 KB |
-| Small, encrypted, in memory | 26.001 ms | 53.53 KB |
-| Small, encrypted, open only | 25.780 ms | 32.72 KB |
-| 300,000 rows, plain | 39.180 ms | 3.87 KB |
-| 300,000 rows, encrypted | 66.278 ms | 29.79 KB |
-| 300,000 rows, encrypted, open only | 25.744 ms | 29.10 KB |
+| Small, plain | 0.208 ms | 8.84 KB |
+| Small, encrypted, stream | 25.880 ms | 38.07 KB |
+| Small, encrypted, stream, `VerifyEncryptedIntegrity` | 26.150 ms | 40.16 KB |
+| Small, encrypted, in memory | 26.600 ms | 53.24 KB |
+| Small, encrypted, open only | 26.378 ms | 32.54 KB |
+| 300,000 rows, plain | 38.283 ms | 3.62 KB |
+| 300,000 rows, encrypted | 65.485 ms | 29.53 KB |
+| 300,000 rows, encrypted, open only | 26.235 ms | 28.92 KB |
 
-Nearly all of the cost is a fixed ~26 ms paid when the workbook is opened: deriving the key through 100,000 SHA-512 iterations, which the format requires so that passwords are slow to brute-force. It does not depend on file size (open-only is 25.78 ms for 15 KB and 25.74 ms for 300,000 rows). After that, decrypting while reading costs ~3% over a plain read: 66.28 ms − 25.74 ms = 40.53 ms, against 39.18 ms unencrypted. On the small fixture, integrity verification and the in-memory path cost nothing measurable. The fixture is too small to show the extra pass that verification makes over a large stream.
+Nearly all of the cost is a fixed ~26 ms paid when the workbook is opened: deriving the key through 100,000 SHA-512 iterations, which the format requires so that passwords are slow to brute-force. It does not depend on file size (open-only is 26.38 ms for 15 KB and 26.24 ms for 300,000 rows). After that, decrypting while reading costs ~3% over a plain read: 65.49 ms − 26.24 ms = 39.25 ms, against 38.28 ms unencrypted. On the small fixture, integrity verification and the in-memory path stay within ~3% of the plain encrypted read, inside the spread of the key derivation itself. The fixture is too small to show the extra pass that verification makes over a large stream.
 
 ### Cold start
 
@@ -328,25 +326,25 @@ dotnet run --project tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj
 
 | Entry point | Shape handed back | Mean | Managed allocated |
 |---|---|---:|---:|
-| `xl_next_row` | one row per call, serialized into a caller buffer | 40.35 ms | 3.71 MB |
-| `xl_read_all_blob` | whole sheet in one buffer | 43.59 ms | 21.06 MB |
-| `xl_read_all_decoded` | whole sheet as native row structs | 54.56 ms | 5.71 MB |
-| `xl_parse_typed` | typed native columns | 40.79 ms | 11.61 MB |
-| `xl_parse_arrow` | Arrow C Data Interface arrays | 39.51 ms | 11.62 MB |
+| `xl_rows_next` | one row per call, serialized into a caller buffer | 37.93 ms | 3.71 MB |
+| `xl_rows_read_all_blob` | whole sheet in one buffer | 42.74 ms | 21.06 MB |
+| `xl_rows_read_all_decoded` | whole sheet as native row structs | 56.73 ms | 5.71 MB |
+| `xl_parse_typed` | typed native columns | 35.73 ms | 3.71 MB |
+| `xl_parse_arrow` | Arrow C Data Interface arrays | 36.93 ms | 3.72 MB |
 
-The allocation column is **managed memory only**. `MemoryDiagnoser` cannot see the native blocks that `xl_read_all_decoded`, `xl_parse_typed` and `xl_parse_arrow` return their data in.
+The allocation column is **managed memory only**. `MemoryDiagnoser` cannot see the native blocks that `xl_rows_read_all_decoded`, `xl_parse_typed` and `xl_parse_arrow` return their data in.
 
-Row by row, `xl_next_row` costs ~1.6x the managed in-memory read of the same file (40.35 ms vs. 25.606 ms for `Xlsb_ExcelReader_Memory` under [In-memory real-data reads](#in-memory-real-data-reads)). The managed figure is from a later run, after `InflateStream`; this native table has not been re-run since, so read the ratio as an upper bound. Every cell crosses the ABI as text, so each binary XLSB number is formatted to UTF-8 on the way out. `xl_read_all_blob` adds ~8% over it, because the whole sheet is buffered before it is copied out. `xl_read_all_decoded` adds ~35%, because it allocates a native block per row. `xl_parse_typed` and `xl_parse_arrow` cost about the same as a row-by-row read but return columnar native buffers with numbers still binary, so they are the path to use for bulk typed loads.
+Row by row, `xl_rows_next` costs ~1.4x the managed in-memory read of the same file (37.93 ms vs. 27.084 ms for `Xlsb_ExcelReader_Memory` under [In-memory real-data reads](#in-memory-real-data-reads)). Every cell crosses the ABI as text, so each binary XLSB number is formatted to UTF-8 on the way out. `xl_rows_read_all_blob` adds ~13% over it, because the whole sheet is buffered before it is copied out. `xl_rows_read_all_decoded` adds ~50%, because it allocates a native block per row. `xl_parse_typed` and `xl_parse_arrow` are slightly faster than a row-by-row read (~3–6%) and return columnar native buffers with numbers still binary, so they are the path to use for bulk typed loads.
 
 `ChunkedParseBenchmark` compares `xl_parse_typed` on a whole sheet against draining the same sheet in batches through `xl_typed_reader_open`/`xl_typed_reader_next`. It uses the generated 50,000-row XLSX file, read from disk, with three nullable columns (string, int64, float64):
 
 | Mode | Mean | Managed allocated |
 |---|---:|---:|
-| Whole sheet (`xl_parse_typed`) | 8.73 ms | 1.29 MB |
-| Batches of 10,000 rows | 8.49 ms | 1.59 MB |
-| Batches of 1,000 rows | 8.47 ms | 1.51 MB |
+| Whole sheet (`xl_parse_typed`) | 8.93 ms | 10 KB |
+| Batches of 10,000 rows | 8.36 ms | 16.95 KB |
+| Batches of 1,000 rows | 8.53 ms | 81.29 KB |
 
-Batching costs nothing in time: both batch sizes land within ~3% of one whole-sheet table. A caller can bound its native memory to one batch at a time without paying for it.
+Batching costs nothing in time: both batch sizes are slightly faster than one whole-sheet table (~4–6%). A caller can bound its native memory to one batch at a time without paying for it.
 
 ### C++ and Rust bindings
 
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index a9110bb9..61db4709 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -510,13 +510,13 @@ private int TryEmitPlainInline(byte[] buf, int len, int p, int col, int style)
                     return -1;
                 }
                 int textStart = p + 7;
-                int rel = buf.AsSpan(textStart, len - textStart).IndexOfAny((byte)'<', (byte)'&');
+                int rel = XlsxXml.IndexOfMarkup(buf.AsSpan(textStart, len - textStart), out bool mayEscape);
                 if (rel < 0)
                 {
                     return -1;
                 }
                 int lt = textStart + rel;
-                if (!buf.AsSpan(lt, Math.Min(13, len - lt)).StartsWith("</t></is></c>"u8) || buf.AsSpan(textStart, rel).IndexOf("_x"u8) >= 0)
+                if (!buf.AsSpan(lt, Math.Min(13, len - lt)).StartsWith("</t></is></c>"u8) || (mayEscape && buf.AsSpan(textStart, rel).IndexOf("_x"u8) >= 0))
                 {
                     return -1;
                 }
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
index 4e06ef2c..33f0baf1 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Loading.cs
@@ -271,14 +271,14 @@ private int TryAppendPlainShared(BufferedStreamCursor io, SharedStringTokens tok
                 return -1;
             }
             ReadOnlySpan<byte> text = window[7..];
-            int rel = text.IndexOfAny((byte)'<', (byte)'&');
+            int rel = XlsxXml.IndexOfMarkup(text, out bool mayEscape);
             if (rel < 0 || !text[rel..].StartsWith("</t></si>"u8))
             {
                 return -1;
             }
             EnsureSharedFlat(flat + rel, flat);
             text[..rel].CopyTo(_sharedFlat.AsSpan(flat));
-            flat += XlsxXml.UnescapeXString(_sharedFlat.AsSpan(flat, rel));
+            flat += mayEscape ? XlsxXml.UnescapeXString(_sharedFlat.AsSpan(flat, rel)) : rel;
             return io.Pos + 7 + rel + 9;
         }
 
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxXml.cs
index 783da178639a4fb111ae3e0dec011c5c4a114dc0..08465db184bbf64f3fd2c280bb20e0115a348ae2 100644
GIT binary patch
delta 489
zcmaiwKTZNc7{w#;Phw(WBE$mpNx?vbMGK-4R%4;j!f*g3>##c;CgKd)nT>2k?CiI(
z^9mYz6OP~wJc37X7FLXvUo&6vz4v}^p7m4oI?0aCx$qQpkHP1G(jYAY8Gw|Cg|_HN
z&}^vjz;zE4#37(PMm<O$T*IXTJ=ynQUT1h=#sO0<9k42tOk7uyPQ8v$g|v@Qcq~w^
z3|P$%*ddz*xKe2aDHx1gfD5J57z)K)DLf3QQt%C1(HR!4_-(tec4@qZZU2e}ci|xZ
zXl!gIv{lGZqbp?}_cS`2^2C!|K1OD7lpI*8?o>qOayQbfVp>;`uBG4AA(iI5K~iMy
z2OAv6Hug{|O&eVE4s83!!y$il+(&sQ5iiYX*0;z4j~|x{4WSV*^Y3=*Vp*O4@G8yt
k>mZjiqL#@&L2VyLhGuta6yG8{e$RfcWN!AxFNG-o4Wz!8k^lez

delta 19
acmeCEoKdpjpy*};iM#BK44e5CDrEptg$C;Y


From f3e104a0ef8518ed59bb8dfccdbea449b476083e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:51 -0300
Subject: [PATCH 098/115] fix(rust): let docs.rs build the crate without the
 native library

docs.rs builds offline, so build.rs failed downloading the release asset
("curl: (6) Could not resolve host: github.com") and excelreader 6.0.0 has no
documentation there. rustdoc never links, so the build script now returns early
when DOCS_RS is set.

Also drops two explicit link targets rustdoc flags as redundant.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 rust/excelreader/build.rs             | 5 +++++
 rust/excelreader/src/lib.rs           | 2 +-
 rust/excelreader/src/writer_handle.rs | 2 +-
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/rust/excelreader/build.rs b/rust/excelreader/build.rs
index 62bffe7a..07415a99 100644
--- a/rust/excelreader/build.rs
+++ b/rust/excelreader/build.rs
@@ -20,6 +20,11 @@ fn main() {
     println!("cargo:rerun-if-env-changed=EXCELREADER_NATIVE_LIB_DIR");
     println!("cargo:rerun-if-changed=excelreader.def");
 
+    // docs.rs builds offline and rustdoc never links, so the native library is not needed there.
+    if env::var_os("DOCS_RS").is_some() {
+        return;
+    }
+
     let out_dir = PathBuf::from(env::var("OUT_DIR").unwrap());
     let target_os = env::var("CARGO_CFG_TARGET_OS").unwrap();
     let target_env = env::var("CARGO_CFG_TARGET_ENV").unwrap_or_default();
diff --git a/rust/excelreader/src/lib.rs b/rust/excelreader/src/lib.rs
index 1f2b200a..e3c775f2 100644
--- a/rust/excelreader/src/lib.rs
+++ b/rust/excelreader/src/lib.rs
@@ -121,7 +121,7 @@ pub struct XlOpenOptions {
     /// Password for an encrypted OOXML workbook, as UTF-8 bytes. NULL (with `password_len` 0) means
     /// "not encrypted, or fail with `XL_STATUS_PASSWORD_REQUIRED`". Not NUL-terminated -
     /// `password_len` is authoritative, since a password may contain any byte. The pointer need only
-    /// remain valid for the duration of the call - see [`OpenOptionsRaw`](crate::options::OpenOptionsRaw).
+    /// remain valid for the duration of the call - see [`crate::options::OpenOptionsRaw`].
     pub password: *const u8,
     pub password_len: i32,
     pub source_cache_bytes: i64,
diff --git a/rust/excelreader/src/writer_handle.rs b/rust/excelreader/src/writer_handle.rs
index 0da1f6ae..1f8abdf7 100644
--- a/rust/excelreader/src/writer_handle.rs
+++ b/rust/excelreader/src/writer_handle.rs
@@ -32,7 +32,7 @@ pub struct WriterHandle {
 
 impl WriterHandle {
     /// Creates `path` (truncating it if it already exists), inferring the format from its
-    /// extension via [`format_from_path`](crate::writer::format_from_path).
+    /// extension via [`crate::writer::format_from_path`].
     pub fn open(path: &str, options: Option<&WriteOptions>) -> Result<Self, Error> {
         Self::open_with(path, format_from_path(path), options)
     }

From 79f7fdaa99b70aa977328b5259be9c3bb337f4d9 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:51 -0300
Subject: [PATCH 099/115] docs(rust): use the README as the crate documentation
 and compile its examples

lib.rs includes README.md as the crate-level docs, so docs.rs opens on it and
cargo test compiles every example. The examples gained hidden setup lines and
no_run, since they name files that do not exist; the HttpSource one stays
ignore because the crate has no reqwest dependency. The FFI note that used to
be the crate doc is now a plain comment.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 rust/excelreader/README.md  | 72 ++++++++++++++++++++++++++++---------
 rust/excelreader/src/lib.rs |  7 ++--
 2 files changed, 59 insertions(+), 20 deletions(-)

diff --git a/rust/excelreader/README.md b/rust/excelreader/README.md
index ea970955..59549d99 100644
--- a/rust/excelreader/README.md
+++ b/rust/excelreader/README.md
@@ -13,7 +13,7 @@ parse, schema-driven writing, row-by-row decoded reads, and Arrow export.
 excelreader = "2.1"
 ```
 
-```rust
+```rust,no_run
 use excelreader::workbook::{parse_sheet, ExcelMapper, Workbook};
 
 #[derive(Default, ExcelMapper)]
@@ -27,6 +27,7 @@ struct Row {
 let workbook = Workbook::open("book.xlsx")?;
 let table = parse_sheet::<Row>(workbook.sheet(0)?, 1)?;
 for row in table.iter() { /* ... */ }
+# Ok::<(), excelreader::Error>(())
 ```
 
 `parse_sheet` takes a `Sheet`, which `Workbook::sheet` hands out (see below).
@@ -56,7 +57,8 @@ excelreader = { version = "2.1", features = ["chrono"] }
 
 ### Sheets and schema inference
 
-```rust
+```rust,no_run
+# use excelreader::workbook::Workbook;
 let workbook = Workbook::open("book.xlsx")?;
 for (index, name) in workbook.sheet_names()?.iter().enumerate() {
     println!("{index}: {name}");
@@ -66,6 +68,7 @@ for (index, name) in workbook.sheet_names()?.iter().enumerate() {
 for column in workbook.sheet(1)?.infer_schema(1, 100)? {
     println!("{:?} -> type {}", column.name, column.column_type);
 }
+# Ok::<(), excelreader::Error>(())
 ```
 
 `infer_schema_parse_text(header_row, sample_size)` also types text cells (every CSV field, or
@@ -76,7 +79,8 @@ sequential); XLSX, XLSB and CSV are split, and the result equals `parse_sheet`'s
 A workbook hands out sheets. A `Sheet` is the workbook and an index: it holds no native
 resource, it is `Copy`, and every read on it opens its own cursor.
 
-```rust
+```rust,no_run
+# use excelreader::workbook::Workbook;
 let workbook = Workbook::open("report.xlsx")?;
 
 for sheet in workbook.sheets()? {
@@ -89,12 +93,15 @@ while let Some(row) = rows.next_row() {
     let row = row?;
     // ...
 }
+# Ok::<(), excelreader::Error>(())
 ```
 
 `Workbook` is `Send + Sync`, so sheets can be read in parallel over one open workbook, which
 loads the shared-string table once:
 
-```rust
+```rust,no_run
+# use excelreader::workbook::Workbook;
+# let workbook = Workbook::open("report.xlsx")?;
 let tables = std::thread::scope(|scope| {
     let handles: Vec<_> = workbook
         .sheets()?
@@ -103,6 +110,7 @@ let tables = std::thread::scope(|scope| {
         .collect();
     handles.into_iter().map(|handle| handle.join().expect("no panic")).collect::<Result<Vec<_>, _>>()
 })?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 `Workbook::open_with` takes an explicit format and `OpenOptions`; `Workbook::open_memory` reads from
@@ -113,7 +121,7 @@ a byte slice. Note that format sniffing does not detect CSV - pass `XL_FORMAT_CS
 `OpenOptions::password` unlocks a password-protected OOXML workbook (.xlsx/.xlsb/.xlsm) through
 `Workbook::open_with`/`open_memory`:
 
-```rust
+```rust,no_run
 use excelreader::workbook::Workbook;
 use excelreader::{Error, OpenOptions, XL_FORMAT_AUTO};
 
@@ -137,12 +145,16 @@ Writing an encrypted workbook is a second step: write the plaintext package with
 `write_sheet`, then wrap it with `encrypt_package`, which produces an agile-encrypted (ECMA-376 4.4)
 CFB container - AES-256-CBC, SHA-512, 100,000 spin iterations, with a `dataIntegrity` HMAC:
 
-```rust
+```rust,no_run
 use excelreader::writer::{encrypt_package, write_columns};
 use excelreader::XL_FORMAT_XLSX;
+# use excelreader::writer::{Column, ColumnData};
+# let ids = [1i64, 2, 3];
+# let columns = [Column { name: Some("id"), data: ColumnData::I64(&ids), validity: None }];
 
 write_columns("plain.xlsx", XL_FORMAT_XLSX, &columns, None)?;
 encrypt_package("plain.xlsx", "secret.xlsx", "hunter2")?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 `package_path` is read twice (it is not disposed or removed), so it must already be a finished file.
@@ -154,7 +166,7 @@ packages can be encrypted, matching what `Workbook::open_with`/`open_memory` can
 Implement [`Source`] to read from anything you can read at an offset. The library calls `read_at`
 from several threads, fetching 4 MiB blocks it caches; every sheet can still be read in parallel.
 
-```rust
+```rust,ignore
 struct HttpSource { client: reqwest::blocking::Client, url: String, size: u64 }
 
 impl excelreader::Source for HttpSource {
@@ -179,8 +191,10 @@ let workbook = Workbook::open_source(source, XL_FORMAT_AUTO, None)?;
 Anything that implements `Read` works through `open_reader`. A CSV is read as it arrives; an XLSX,
 XLSB or XLS is read whole first.
 
-```rust
+```rust,no_run
+# use excelreader::{workbook::Workbook, XL_FORMAT_CSV};
 let workbook = Workbook::open_reader(std::io::stdin(), XL_FORMAT_CSV, None)?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 An `io::Error` from your source, or a panic in it, comes back as the `Error` of the call that
@@ -192,13 +206,21 @@ needed the bytes.
 excelreader = { version = "2.1", features = ["arrow"] }
 ```
 
-```rust
+```rust,no_run
+# #[cfg(feature = "arrow")]
+# fn main() -> Result<(), excelreader::Error> {
 use excelreader::arrow::parse_arrow;
 use excelreader::workbook::Workbook;
+# #[derive(Default, excelreader::workbook::ExcelMapper)]
+# struct Row { #[excel(name = "Name")] name: String }
 
 let workbook = Workbook::open("book.xlsx")?;
 let batch = parse_arrow::<Row>(workbook.sheet(0)?, 1)?;
 println!("{} rows x {} columns", batch.num_rows(), batch.num_columns());
+# Ok(())
+# }
+# #[cfg(not(feature = "arrow"))]
+# fn main() {}
 ```
 
 Off by default — arrow-rs is a large dependency and the typed-parse path needs none of it.
@@ -207,9 +229,13 @@ Batched: `parse_arrow_stream` is `parse_arrow` delivered a batch at a time, retu
 `ArrowChunks<'_>`, an `Iterator<Item = Result<RecordBatch, ArrowError>>` that also implements
 `RecordBatchReader`:
 
-```rust
+```rust,no_run
+# #[cfg(feature = "arrow")]
+# fn main() -> Result<(), excelreader::Error> {
 use excelreader::arrow::parse_arrow_stream;
 use excelreader::workbook::Workbook;
+# #[derive(Default, excelreader::workbook::ExcelMapper)]
+# struct Row { #[excel(name = "Name")] name: String }
 
 let workbook = Workbook::open("book.xlsx")?;
 let mut chunks = parse_arrow_stream::<Row>(workbook.sheet(0)?, 1, 10_000)?;
@@ -217,7 +243,10 @@ while let Some(batch) = chunks.next() {
     let Ok(batch) = batch else { break }; // ArrowChunks does not fuse, unlike TypedChunks
     println!("{} rows", batch.num_rows());
 }
-# Ok::<(), excelreader::Error>(())
+# Ok(())
+# }
+# #[cfg(not(feature = "arrow"))]
+# fn main() {}
 ```
 
 Same `batch_size` semantics as `typed_chunks` below. Unlike `TypedChunks`,
@@ -229,11 +258,15 @@ first `Err` rather than continuing the loop.
 `#[derive(ExcelMapper)]` generates both halves, so the same struct reads and writes - the field
 types in the table above apply unchanged:
 
-```rust
+```rust,no_run
 use excelreader::writer::write_sheet;
 use excelreader::XL_FORMAT_XLSX;
+# #[derive(Default, excelreader::workbook::ExcelMapper)]
+# struct Row { #[excel(name = "Name")] name: String }
+# let rows = vec![Row::default()];
 
 write_sheet("out.xlsx", XL_FORMAT_XLSX, &rows, None)?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 `Option<T>` fields become an LSB-first validity bitmap: `None` writes a blank cell rather than a
@@ -244,7 +277,7 @@ For buffers that are already columnar, `write_columns` borrows them and copies n
 lifetimes on `Column<'a>` are what turn the ABI's borrow contract into something the compiler
 checks:
 
-```rust
+```rust,no_run
 use excelreader::writer::{write_columns, Column, ColumnData};
 use excelreader::XL_FORMAT_XLSX;
 
@@ -255,6 +288,7 @@ let columns = [Column {
     validity: None,
 }];
 write_columns("out.xlsx", XL_FORMAT_XLSX, &columns, None)?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 `validity` is checked against the row count before the call: the ABI takes the bitmap without a
@@ -274,7 +308,7 @@ field. That transpose is the only copy it makes; `write_columns` pays nothing.
 `write_sheet`/`write_columns` build the whole table in memory first. `writer_handle::WriterHandle` is
 the row-by-row alternative, writing directly as each call arrives instead:
 
-```rust
+```rust,no_run
 use excelreader::writer_handle::WriterHandle;
 
 let mut handle = WriterHandle::open("out.xlsx", None)?;
@@ -284,6 +318,7 @@ handle.write_str(Some("Name"))?;
 handle.write_i64(Some(42))?;
 handle.end_row()?;
 handle.end_sheet()?;
+# Ok::<(), excelreader::Error>(())
 ```
 
 Call order mirrors the C ABI's `xl_writer_handle`: `open`/`open_with`/`open_memory`, then per sheet
@@ -299,7 +334,7 @@ on the drop for that.
 `Sheet::rows` returns a cursor over that sheet. Each row borrows a buffer the cursor
 reuses, so iterating a sheet allocates nothing per row:
 
-```rust
+```rust,no_run
 use excelreader::workbook::Workbook;
 
 let workbook = Workbook::open("book.xlsx")?;
@@ -318,7 +353,8 @@ Because each row borrows the cursor's buffer, only one row is alive at a time 
 enforces it. To hold every row at once, use `read_all_decoded`, which decodes the whole
 sheet in one native call and keeps it alive until dropped:
 
-```rust
+```rust,no_run
+# use excelreader::workbook::Workbook;
 let workbook = Workbook::open("book.xlsx")?;
 let rows = workbook.sheet(0)?.read_all_decoded()?;
 for row in rows.iter() {
@@ -335,8 +371,10 @@ native side and never formats a cell to text.
 For a sheet too large to hold in memory at once, `Sheet::typed_chunks` is `parse_sheet` delivered
 a batch at a time:
 
-```rust
+```rust,no_run
 use excelreader::workbook::Workbook;
+# #[derive(Default, excelreader::workbook::ExcelMapper)]
+# struct Row { #[excel(name = "Name")] name: String }
 
 let workbook = Workbook::open("book.xlsx")?;
 let chunks = workbook.sheet(0)?.typed_chunks::<Row>(1, 10_000)?;
diff --git a/rust/excelreader/src/lib.rs b/rust/excelreader/src/lib.rs
index e3c775f2..82e7f00c 100644
--- a/rust/excelreader/src/lib.rs
+++ b/rust/excelreader/src/lib.rs
@@ -1,6 +1,7 @@
-//! Raw FFI bindings to ExcelReader's C ABI (`excelreader.h`). The `extern "C"` block below is
-//! declared directly in this crate root (not a submodule), so `crate::xl_open_file` etc. resolve
-//! from anywhere in the crate. See the `workbook` module for the safe wrapper built on top of this.
+// Raw FFI bindings to ExcelReader's C ABI (`excelreader.h`). The `extern "C"` block below is
+// declared directly in this crate root (not a submodule), so `crate::xl_open_file` etc. resolve
+// from anywhere in the crate. See the `workbook` module for the safe wrapper built on top of this.
+#![doc = include_str!("../README.md")]
 #![doc(
     html_logo_url = "https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png",
     html_favicon_url = "https://raw.githubusercontent.com/GabrielMarquezMatte/ExcelReader/master/assets/icon.png"

From 0a02d7ee0aeb9d8172aa7dcddb6fa275b0839038 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:52 -0300
Subject: [PATCH 100/115] build(generator): stop adding the analyzer release
 files twice

Microsoft.CodeAnalysis.Analyzers already adds AnalyzerReleases.Shipped.md and
AnalyzerReleases.Unshipped.md as AdditionalFiles. The explicit items duplicated
them, which docfx reports as duplicate source files.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Generator/ExcelReader.Generator.csproj | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/ExcelReader.Generator/ExcelReader.Generator.csproj b/src/ExcelReader.Generator/ExcelReader.Generator.csproj
index a577c725..a6f7b9e0 100644
--- a/src/ExcelReader.Generator/ExcelReader.Generator.csproj
+++ b/src/ExcelReader.Generator/ExcelReader.Generator.csproj
@@ -36,9 +36,4 @@
     <NoWarn>$(NoWarn);RS0016;RS0026;RS0037</NoWarn>
   </PropertyGroup>
 
-  <ItemGroup>
-    <AdditionalFiles Include="AnalyzerReleases.Shipped.md" />
-    <AdditionalFiles Include="AnalyzerReleases.Unshipped.md" />
-  </ItemGroup>
-
 </Project>

From 7545986978975037e6cc8234bc7cefef79323f29 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:52 -0300
Subject: [PATCH 101/115] docs(core): inherit only the summary and exceptions
 in BeginTableAsync

Inheriting the whole BeginTable comment and restating its params made docfx see
every param twice. CS1573 still needs the params once ct is documented, so the
inheritdoc is narrowed to /summary and /exception instead.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 src/ExcelReader.Core/Writer/ITableSheetWriter.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/ExcelReader.Core/Writer/ITableSheetWriter.cs b/src/ExcelReader.Core/Writer/ITableSheetWriter.cs
index ba4ee656..d036d8e0 100644
--- a/src/ExcelReader.Core/Writer/ITableSheetWriter.cs
+++ b/src/ExcelReader.Core/Writer/ITableSheetWriter.cs
@@ -24,7 +24,8 @@ public interface ITableSheetWriter<TRow> : ISheetWriter<TRow>
         /// <exception cref="ExcelLimitExceededException">The sheet has no room left for a header row and a data row.</exception>
         void BeginTable(string name, IReadOnlyList<string> columns, ExcelTableOptions? options = null);
 
-        /// <inheritdoc cref="BeginTable"/>
+        /// <inheritdoc cref="BeginTable" path="/summary"/>
+        /// <inheritdoc cref="BeginTable" path="/exception"/>
         /// <param name="name">The table name: unique in the workbook, ignoring case, and valid as an Excel name.</param>
         /// <param name="columns">The column names, written as the header row.</param>
         /// <param name="options">Position and style. Defaults to <see cref="ExcelTableOptions.Default"/>.</param>

From 4e3d978afc3b0fc10ad28ef5fb3bf38857310b54 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:52 -0300
Subject: [PATCH 102/115] docs: fix the AOT anchor in the parsing guide

The heading became "Generate typed maps at compile time (Native AOT /
trimming)" and the link still pointed at the old slug.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/guide/parsing.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index 9c43a860..e30137ca 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -236,6 +236,6 @@ A few differences from a class or struct model:
 
 - **Span fields alias the reader's row buffer** — valid only until the next row. Copy them out (e.g. `Encoding.UTF8.GetString(span)`) if you need to keep the value past the loop body. Under `await foreach`, the same rule means the model can't be held across an `await` in the loop body.
 - **The non-generic `IEnumerator.Current` throws.** `IEnumerable<T>` and `IAsyncEnumerable<T>` both accept a `ref struct` element type on net9.0+, so the sequence flows through them normally; only the legacy non-generic `IEnumerator.Current` cannot, because it would have to box. LINQ over a `ref struct` model is still out, since its operators do not carry the `allows ref struct` anti-constraint.
-- **Not AOT/trim-safe** on this path, since it reflects over `T`'s properties and compiles setters at runtime. For an AOT-clean zero-copy model, mark the `ref partial struct` `[ExcelSerializable]` and read it with `ExcelParser.Generated<T>` — see [Generate the map at compile time](#generate-the-map-at-compile-time-aot-clean).
+- **Not AOT/trim-safe** on this path, since it reflects over `T`'s properties and compiles setters at runtime. For an AOT-clean zero-copy model, mark the `ref partial struct` `[ExcelSerializable]` and read it with `ExcelParser.Generated<T>` — see [Generate typed maps at compile time](#generate-typed-maps-at-compile-time-native-aot--trimming).
 - A regular `struct`/`class` model uses the same entry point — only a genuine `ref struct` model gets the extra zero-copy span-property binding.
 

From 2d31fa7dabf66d349530037f9b95c2332a2dcd1e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:52 -0300
Subject: [PATCH 103/115] docs: publish a docfx site with the API reference and
 guides

docfx.json builds a site from the Core and Arrow XML docs, the guides, the
performance documents and the binding READMEs, with the root README as the
landing page. The config sits at the repo root so the README's links
(docs/guide/...) resolve unchanged: docfx does not match a link that climbs out
of its own folder. docs.yml publishes the site to gh-pages next to the
benchmark dashboard.

The template sizes the navbar logo, hides the logo the binding READMEs open
with, and strips rustdoc's hidden lines from Rust examples. ARCHITECTURE,
STYLEGUIDE and docs/README link docs/README.md or #index instead of a folder,
which docfx cannot link.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs.yml    | 47 ++++++++++++++++++++++++++++++++++
 .gitignore                    |  3 +++
 ARCHITECTURE.md               |  2 +-
 STYLEGUIDE.md                 |  6 ++---
 docfx.json                    | 48 +++++++++++++++++++++++++++++++++++
 docs/README.md                |  8 +++---
 docs/index.md                 |  5 ++++
 docs/template/public/main.css |  9 +++++++
 docs/template/public/main.js  | 13 ++++++++++
 docs/toc.yml                  | 36 ++++++++++++++++++++++++++
 10 files changed, 169 insertions(+), 8 deletions(-)
 create mode 100644 .github/workflows/docs.yml
 create mode 100644 docfx.json
 create mode 100644 docs/index.md
 create mode 100644 docs/template/public/main.css
 create mode 100644 docs/template/public/main.js
 create mode 100644 docs/toc.yml

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..2e9d01c7
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,47 @@
+name: Docs -> GitHub Pages
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'src/ExcelReader.Core/**'
+      - 'src/ExcelReader.Arrow/**'
+      - 'src/ExcelReader.Native/include/excelreader.h'
+      - 'docs/**'
+      - '**.md'
+      - 'docfx.json'
+      - 'assets/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: docs-pages
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-dotnet@v6
+        with:
+          global-json-file: global.json
+
+      - name: Build site
+        run: |
+          dotnet tool install --global docfx --version 2.81.0
+          docfx docfx.json
+
+      # keep_files leaves dev/bench (benchmark-pages.yml) in place; pages removed from the docs
+      # stay on the branch until deleted by hand.
+      - name: Publish to gh-pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/_site
+          publish_branch: gh-pages
+          keep_files: true
diff --git a/.gitignore b/.gitignore
index 87734d65..bea8006c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -506,3 +506,6 @@ python/src/excelreader/_lib/*
 build/
 # Subagent-driven-development scratch (per-plan ledgers, briefs, review packages)
 .superpowers/
+# docfx output (docfx.json); CI builds and publishes it to gh-pages
+docs/_site/
+docs/api/
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 84bc9600..a627640d 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -6,7 +6,7 @@ directly rather than looking for a commentary alongside it.
 
 What the code deliberately does *not* carry is the evidence behind a decision — benchmark numbers,
 memory-footprint measurements, approaches that were tried and rejected. That lives in
-[`docs/`](docs/), and [`STYLEGUIDE.md`](STYLEGUIDE.md#comments) says why.
+[`docs/`](docs/README.md), and [`STYLEGUIDE.md`](STYLEGUIDE.md#comments) says why.
 
 ## The four format families
 
diff --git a/STYLEGUIDE.md b/STYLEGUIDE.md
index 7cb2cb22..63275833 100644
--- a/STYLEGUIDE.md
+++ b/STYLEGUIDE.md
@@ -181,7 +181,7 @@ Never reference the task, the ticket, or the caller.
 ### Findings do not belong in code
 
 Measurements, benchmark results, memory-footprint numbers, and the reasoning that picked one
-approach over another are **not comments**. They go in [`docs/`](docs/).
+approach over another are **not comments**. They go in [`docs/`](docs/README.md).
 
 This includes the whole class of "why it is this way" content: a throughput figure that justified a
 buffer size, an allocation count that motivated pooling, a design that was prototyped and measured
@@ -209,7 +209,7 @@ Comments carry maintenance cost. Two failure modes are specifically banned:
 - **Do not cite a file that can disappear.** Never point a comment at a plan, a spec, or a section
   marker ("see step Z4") as the authoritative explanation. Those are working artifacts: they get
   renamed, merged and deleted, and the comment then sends a reader to nothing, which is worse than
-  silence. A committed document under [`docs/`](docs/) is different in kind — it is permanent, and
+  silence. A committed document under [`docs/`](docs/README.md) is different in kind — it is permanent, and
   pointing at one is how a finding stays out of the code. The test is whether the target is expected
   to still exist in a year, not whether a link is involved.
 
@@ -329,7 +329,7 @@ These rules apply only when a function is on a measured hot path (cell parsing,
 - Avoid LINQ in hot paths; use `IndexOf` on spans which benefits from SIMD.
 - Split cold paths (growth, throw helpers) into `[MethodImpl(MethodImplOptions.NoInlining)]` methods so
   they do not bloat the hot caller's IL and cost it inlining.
-- Optimize against a measurement, and record what it showed in [`docs/`](docs/) — never in a comment.
+- Optimize against a measurement, and record what it showed in [`docs/`](docs/README.md) — never in a comment.
   An optimization with no number behind it is a guess that costs readability. Caches in particular are
   a trade, not a win: document the workload where the cache pays and the one where it does not, with
   the numbers that showed it.
diff --git a/docfx.json b/docfx.json
new file mode 100644
index 00000000..6c1073f6
--- /dev/null
+++ b/docfx.json
@@ -0,0 +1,48 @@
+{
+  "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "src",
+          "files": [
+            "ExcelReader.Core/ExcelReader.Core.csproj",
+            "ExcelReader.Arrow/ExcelReader.Arrow.csproj"
+          ]
+        }
+      ],
+      "output": "docs/api"
+    }
+  ],
+  "build": {
+    "content": [
+      { "files": [ "index.md", "toc.yml", "api/**.{yml,md}" ], "src": "docs" },
+      {
+        "files": [
+          "docs/README.md",
+          "docs/guide/**.md",
+          "docs/performance/**.md",
+          "python/README.md",
+          "rust/excelreader/README.md",
+          "cpp/README.md",
+          "ARCHITECTURE.md",
+          "CONTRIBUTING.md",
+          "CODE_OF_CONDUCT.md",
+          "SECURITY.md",
+          "STYLEGUIDE.md"
+        ]
+      }
+    ],
+    "resource": [
+      { "files": [ "assets/icon.png", "LICENSE", "src/ExcelReader.Native/include/excelreader.h" ] }
+    ],
+    "output": "docs/_site",
+    "template": [ "default", "modern", "docs/template" ],
+    "globalMetadata": {
+      "_appName": "ExcelReader",
+      "_appTitle": "ExcelReader",
+      "_appLogoPath": "assets/icon.png",
+      "_enableSearch": true
+    }
+  }
+}
diff --git a/docs/README.md b/docs/README.md
index 7385ab95..d4344412 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -14,7 +14,7 @@ changes. A document with the numbers, the machine and the corpus can be reproduc
   valuable documents here** — they are what stops the same idea being rebuilt next year.
 - A performance ceiling and what it is bounded by.
 
-- Usage documentation under [`guide/`](guide/), split out of the root README so the NuGet landing
+- Usage documentation under [`guide/`](#index), split out of the root README so the NuGet landing
   page stays short. This is prose for a caller deciding *how* to use the library, not a substitute
   for the `///` comments that document *what* each member does.
 
@@ -42,6 +42,6 @@ invariant) without restating the evidence for it.
   each format, the ceiling on each, and the optimizations measured and rejected.
 - [`performance/benchmarks.md`](performance/benchmarks.md) — throughput and allocation against
   Sep, Sylvan, OfficeIMO and SpreadCheetah.
-- [`guide/`](guide/) — usage documentation: [reading](guide/reading.md),
-  [parsing](guide/parsing.md), [writing](guide/writing.md), [csv](guide/csv.md),
-  [encryption](guide/encryption.md).
+- `guide/` — usage documentation: [reading](./guide/reading.md),
+  [parsing](./guide/parsing.md), [writing](./guide/writing.md), [csv](./guide/csv.md),
+  [encryption](./guide/encryption.md).
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 00000000..be2d4c13
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,5 @@
+---
+_layout: landing
+---
+
+[!INCLUDE [README](../README.md)]
diff --git a/docs/template/public/main.css b/docs/template/public/main.css
new file mode 100644
index 00000000..24c4b26c
--- /dev/null
+++ b/docs/template/public/main.css
@@ -0,0 +1,9 @@
+#logo {
+  height: 32px;
+  width: auto;
+}
+
+/* The binding READMEs open with the logo for their GitHub/PyPI/crates.io pages; the navbar already shows it. */
+article img[alt="ExcelReader logo"] {
+  display: none;
+}
diff --git a/docs/template/public/main.js b/docs/template/public/main.js
new file mode 100644
index 00000000..d1f73a5a
--- /dev/null
+++ b/docs/template/public/main.js
@@ -0,0 +1,13 @@
+// The Rust README doubles as the crate's doctests: rustdoc hides lines starting with "# " and reads
+// fence attributes like "rust,no_run". Do the same here before highlighting runs.
+export default {
+  start: () => {
+    for (const code of document.querySelectorAll('code[class^="lang-rust"]')) {
+      code.className = 'lang-rust';
+      code.textContent = code.textContent
+        .split('\n')
+        .filter(line => !/^\s*#(\s|$)/.test(line))
+        .join('\n');
+    }
+  }
+};
diff --git a/docs/toc.yml b/docs/toc.yml
new file mode 100644
index 00000000..7900f493
--- /dev/null
+++ b/docs/toc.yml
@@ -0,0 +1,36 @@
+- name: Guide
+  items:
+    - name: Reading rows
+      href: guide/reading.md
+    - name: Typed parsing
+      href: guide/parsing.md
+    - name: Writing workbooks
+      href: guide/writing.md
+    - name: CSV
+      href: guide/csv.md
+    - name: Encrypted workbooks
+      href: guide/encryption.md
+    - name: Migrating to v7
+      href: guide/migrating-to-v7.md
+    - name: Migrating to v6
+      href: guide/migrating-to-v6.md
+- name: API
+  href: api/
+- name: Bindings
+  items:
+    - name: Python
+      href: ../python/README.md
+    - name: Rust
+      href: ../rust/excelreader/README.md
+    - name: Rust API (docs.rs)
+      href: https://docs.rs/excelreader
+    - name: C++
+      href: ../cpp/README.md
+- name: Performance
+  items:
+    - name: Benchmarks
+      href: performance/benchmarks.md
+    - name: Reader performance
+      href: performance/reader-performance.md
+    - name: Live results
+      href: https://gabrielmarquezmatte.github.io/ExcelReader/dev/bench/

From 128fa438f4ff497b122f8d9215bfb6bd963a8a0f Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:52 -0300
Subject: [PATCH 104/115] docs: add a guide mapping errors across languages

One table from each kind of failure to the C# exception, the XL_* status, and
the Python, Rust and C++ error types, plus what each status code means.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 docs/README.md       |  2 +-
 docs/guide/errors.md | 47 ++++++++++++++++++++++++++++++++++++++++++++
 docs/toc.yml         |  2 ++
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 docs/guide/errors.md

diff --git a/docs/README.md b/docs/README.md
index d4344412..dfb01feb 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -44,4 +44,4 @@ invariant) without restating the evidence for it.
   Sep, Sylvan, OfficeIMO and SpreadCheetah.
 - `guide/` — usage documentation: [reading](./guide/reading.md),
   [parsing](./guide/parsing.md), [writing](./guide/writing.md), [csv](./guide/csv.md),
-  [encryption](./guide/encryption.md).
+  [encryption](./guide/encryption.md), [errors](./guide/errors.md).
diff --git a/docs/guide/errors.md b/docs/guide/errors.md
new file mode 100644
index 00000000..58afe6fd
--- /dev/null
+++ b/docs/guide/errors.md
@@ -0,0 +1,47 @@
+# Errors across languages
+
+The .NET library throws exceptions. The C ABI turns each failure into an `XL_*` status code, and the
+Python, Rust and C++ bindings turn that code into their own error type. This page maps one onto the
+other, so a failure seen in one language can be recognized in another.
+
+## Status codes
+
+Every `xl_*` function returns one of these. After a failure, `xl_last_error_ptr` returns the message
+for the calling thread.
+
+| Code | Constant | Meaning |
+|---|---|---|
+| 0 | `XL_OK` | Success. |
+| -1 | `XL_EOF` | No more rows or batches. Not an error: the bindings end iteration on it. |
+| -2 | `XL_BUFFER_TOO_SMALL` | The caller's buffer cannot hold the result. The bindings grow the buffer and retry, so it never reaches user code. |
+| -3 | `XL_INVALID_HANDLE` | The handle is null, already closed, or was never opened. |
+| -4 | `XL_INVALID_ARGUMENT` | An argument failed validation before any work started: a null pointer, a bad length, malformed options. |
+| -5 | `XL_ERROR` | Anything else. The message is the message of the .NET exception behind it. |
+| -6 | `XL_STATUS_PASSWORD_REQUIRED` | The workbook is encrypted and no password was supplied. |
+| -7 | `XL_STATUS_PASSWORD_INCORRECT` | The supplied password did not match the workbook's verifier. |
+
+## By failure
+
+| Failure | C# | Status | Python | Rust | C++ |
+|---|---|---|---|---|---|
+| Encrypted, no password | `ExcelEncryptionException`, `Reason == PasswordRequired` | -6 | `PasswordRequiredError` | `Error::PasswordRequired` | `xl::Error`, `code == XL_STATUS_PASSWORD_REQUIRED` |
+| Wrong password | `ExcelEncryptionException`, `Reason == PasswordIncorrect` | -7 | `PasswordIncorrectError` | `Error::PasswordIncorrect` | `xl::Error`, `code == XL_STATUS_PASSWORD_INCORRECT` |
+| Unsupported encryption, or failed integrity check | `ExcelEncryptionException`, `Reason` is `UnsupportedScheme` or `IntegrityFailure` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
+| Corrupt or malformed file | `InvalidDataException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
+| Feature the reader does not support | `NotSupportedException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
+| File exceeds a configured resource limit | `ExcelLimitExceededException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
+| Workbook already closed | `ObjectDisposedException` | -3 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_INVALID_HANDLE` |
+| Invalid argument | `ArgumentException` and its subclasses | -4, or -5 when the check happens past the ABI boundary | `ExcelReaderError` | `Error::Native` | `xl::Error` |
+
+`PasswordRequiredError` and `PasswordIncorrectError` derive from `ExcelReaderError`, so
+`except ExcelReaderError` catches every native failure in Python. Rust's `Error::code()` returns the
+status for every variant. The C++ header throws nothing: every entry point returns
+`std::expected<T, xl::Error>`.
+
+Only the two password cases are worth retrying with different input. The rest fail the same way on
+every attempt.
+
+Each binding also checks some arguments itself, before calling the ABI, and reports those with its
+own native types: Python raises `ValueError`, `TypeError` or `IndexError`; Rust panics on an
+out-of-range index (see the crate README's "Bounds and panics"); C++ returns `xl::Error` with
+`code == XL_INVALID_ARGUMENT`.
diff --git a/docs/toc.yml b/docs/toc.yml
index 7900f493..53c23475 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -10,6 +10,8 @@
       href: guide/csv.md
     - name: Encrypted workbooks
       href: guide/encryption.md
+    - name: Errors across languages
+      href: guide/errors.md
     - name: Migrating to v7
       href: guide/migrating-to-v7.md
     - name: Migrating to v6

From 1fb0ad15a94f388d3d78fb70b7fec8b888a836a3 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:53 -0300
Subject: [PATCH 105/115] docs(python): generate the Python API reference for
 the docfx site

python/scripts/api_markdown.py writes a Markdown page per public class, a
functions page and a toc.yml from excelreader's signatures and docstrings, so
the reference renders with the site's own layout, navigation and search. Types
are linked to their pages in parameter, return and field tables, and every
generated signature is checked with ast.parse. Importing excelreader loads the
native library lazily, so CI needs only the sources.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs.yml     |   6 +
 .gitignore                     |   3 +-
 docfx.json                     |   2 +-
 docs/toc.yml                   |   2 +
 python/scripts/api_markdown.py | 223 +++++++++++++++++++++++++++++++++
 5 files changed, 234 insertions(+), 2 deletions(-)
 create mode 100644 python/scripts/api_markdown.py

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 2e9d01c7..b5c582f8 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -7,6 +7,8 @@ on:
       - 'src/ExcelReader.Core/**'
       - 'src/ExcelReader.Arrow/**'
       - 'src/ExcelReader.Native/include/excelreader.h'
+      - 'python/src/**'
+      - 'python/scripts/api_markdown.py'
       - 'docs/**'
       - '**.md'
       - 'docfx.json'
@@ -31,6 +33,10 @@ jobs:
         with:
           global-json-file: global.json
 
+      # Importing excelreader loads the native library lazily, so this needs only the sources.
+      - name: Build Python API reference
+        run: python3 python/scripts/api_markdown.py
+
       - name: Build site
         run: |
           dotnet tool install --global docfx --version 2.81.0
diff --git a/.gitignore b/.gitignore
index bea8006c..9001b4e0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -506,6 +506,7 @@ python/src/excelreader/_lib/*
 build/
 # Subagent-driven-development scratch (per-plan ledgers, briefs, review packages)
 .superpowers/
-# docfx output (docfx.json); CI builds and publishes it to gh-pages
+# docfx output and the generated Python API pages (docfx.json, python/scripts/api_markdown.py); CI builds and publishes it to gh-pages
 docs/_site/
 docs/api/
+docs/python-api/
diff --git a/docfx.json b/docfx.json
index 6c1073f6..6e770446 100644
--- a/docfx.json
+++ b/docfx.json
@@ -16,7 +16,7 @@
   ],
   "build": {
     "content": [
-      { "files": [ "index.md", "toc.yml", "api/**.{yml,md}" ], "src": "docs" },
+      { "files": [ "index.md", "toc.yml", "api/**.{yml,md}", "python-api/**.{yml,md}" ], "src": "docs" },
       {
         "files": [
           "docs/README.md",
diff --git a/docs/toc.yml b/docs/toc.yml
index 53c23475..b11f23a0 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -22,6 +22,8 @@
   items:
     - name: Python
       href: ../python/README.md
+    - name: Python API
+      href: python-api/
     - name: Rust
       href: ../rust/excelreader/README.md
     - name: Rust API (docs.rs)
diff --git a/python/scripts/api_markdown.py b/python/scripts/api_markdown.py
new file mode 100644
index 00000000..027fd0b7
--- /dev/null
+++ b/python/scripts/api_markdown.py
@@ -0,0 +1,223 @@
+"""Write the Python API reference as Markdown pages plus a toc.yml, for docfx to render.
+
+Run from anywhere:  python python/scripts/api_markdown.py
+"""
+
+import ast
+import enum
+import inspect
+import re
+import sys
+import typing
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+OUTPUT_DIR = REPO_ROOT / "docs" / "python-api"
+MAX_LINE = 88
+
+sys.path.insert(0, str(REPO_ROOT / "python" / "src"))
+import excelreader  # type: ignore[import-not-found]  # noqa: E402
+
+LINKABLE = {name for name in excelreader.__all__ if inspect.isclass(getattr(excelreader, name))}
+
+PROTOCOLS = {
+    "__len__": "`len()`",
+    "__getitem__": "indexing",
+    "__iter__": "iteration",
+    "__contains__": "`in`",
+    "__enter__": "`with`",
+}
+
+
+class _Raw(str):
+    """An annotation kept as written, so a signature prints `int | None` rather than `'int | None'`."""
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+def _raw(annotation: object) -> object:
+    annotation = getattr(annotation, "__forward_arg__", annotation)
+    return _Raw(annotation) if isinstance(annotation, str) else annotation
+
+
+def signature(function: typing.Callable, drop_first: bool = False) -> str:
+    sig = inspect.signature(function)
+    parameters = [p.replace(annotation=_raw(p.annotation)) for p in sig.parameters.values()]
+    if drop_first:
+        parameters = parameters[1:]
+    sig = sig.replace(parameters=parameters, return_annotation=_raw(sig.return_annotation))
+    one_line = f"def {function.__name__}{sig}"
+    if len(one_line) <= MAX_LINE:
+        return one_line
+
+    lines = []
+    for index, parameter in enumerate(parameters):
+        previous = parameters[index - 1].kind if index else None
+        if previous is inspect.Parameter.POSITIONAL_ONLY and parameter.kind is not previous:
+            lines.append("/")
+        if parameter.kind is inspect.Parameter.KEYWORD_ONLY and previous not in (
+            inspect.Parameter.KEYWORD_ONLY,
+            inspect.Parameter.VAR_POSITIONAL,
+        ):
+            lines.append("*")
+        lines.append(str(parameter))
+    if parameters and parameters[-1].kind is inspect.Parameter.POSITIONAL_ONLY:
+        lines.append("/")
+    returns = "" if sig.return_annotation is inspect.Signature.empty else f" -> {sig.return_annotation}"
+    body = "".join(f"    {line},\n" for line in lines)
+    return f"def {function.__name__}(\n{body}){returns}"
+
+
+def signatures(function: typing.Callable, drop_first: bool = False) -> str:
+    overloads = typing.get_overloads(function) or [function]
+    rendered = [signature(f, drop_first) for f in overloads]
+    for text in rendered:
+        ast.parse(f"{text}: ...")
+    return "\n".join(rendered)
+
+
+def doc(obj: object) -> str:
+    return inspect.getdoc(obj) or ""
+
+
+def cell(text: object) -> str:
+    return str(text).replace("|", "\\|")
+
+
+def linked(annotation: object) -> str:
+    text = cell(_raw(annotation)).replace("[", "\\[").replace("]", "\\]")
+    return re.sub(
+        r"\b[A-Za-z_]\w*\b",
+        lambda m: f"[{m[0]}]({m[0]}.md)" if m[0] in LINKABLE else m[0],
+        text,
+    )
+
+
+def parameters_and_returns(function: typing.Callable, drop_first: bool) -> str:
+    sig = inspect.signature(function)
+    parameters = list(sig.parameters.values())[1 if drop_first else 0 :]
+    parts = []
+    if parameters:
+        rows = "\n".join(
+            f"| `{p.name}` | "
+            + ("" if p.annotation is inspect.Parameter.empty else linked(p.annotation))
+            + " | "
+            + ("" if p.default is inspect.Parameter.empty else f"`{cell(repr(p.default))}`")
+            + " |"
+            for p in parameters
+        )
+        parts.append(f"**Parameters**\n\n| Name | Type | Default |\n|---|---|---|\n{rows}")
+    if sig.return_annotation not in (inspect.Signature.empty, "None", None):
+        parts.append(f"**Returns** {linked(sig.return_annotation)}")
+    return "\n\n".join(parts)
+
+
+def code(text: str) -> str:
+    return f"```python\n{text}\n```"
+
+
+def bases(cls: type) -> str:
+    names = [getattr(b, "__name__", str(b)) for b in getattr(cls, "__orig_bases__", cls.__bases__)]
+    names = [n for n in names if n != "object"]
+    return f"({', '.join(names)})" if names else ""
+
+
+def class_page(cls: type) -> str:
+    kind = "Enum" if issubclass(cls, enum.Enum) else "Exception" if issubclass(cls, BaseException) else "Class"
+    parts = [f"# {kind} {cls.__name__}", doc(cls), code(f"class {cls.__name__}{bases(cls)}")]
+
+    inherited = [b.__name__ for b in cls.__bases__ if b.__name__ in LINKABLE]
+    if inherited:
+        parts.append("**Inherits** " + ", ".join(linked(name) for name in inherited))
+
+    supported = [label for name, label in PROTOCOLS.items() if name in vars(cls)]
+    if supported:
+        parts.append(f"Supports {', '.join(supported)}.")
+
+    if issubclass(cls, enum.Enum):
+        rows = "\n".join(f"| `{m.name}` | {cell(m.value)} |" for m in cls)
+        parts.append(f"## Members\n\n| Name | Value |\n|---|---|\n{rows}")
+    elif hasattr(cls, "_fields"):
+        annotations = inspect.get_annotations(cls)
+        defaults = getattr(cls, "_field_defaults", {})
+        rows = "\n".join(
+            f"| `{f}` | {linked(annotations.get(f, ''))} | "
+            + (f"`{cell(repr(defaults[f]))}`" if f in defaults else "")
+            + " |"
+            for f in cls._fields
+        )
+        parts.append(f"## Fields\n\n| Name | Type | Default |\n|---|---|---|\n{rows}")
+
+    members = [(n, v) for n, v in vars(cls).items() if not n.startswith("_")]
+    properties = [(n, v) for n, v in members if isinstance(v, property)]
+    methods = [(n, v) for n, v in members if inspect.isfunction(v) or isinstance(v, (staticmethod, classmethod))]
+
+    if properties:
+        parts.append("## Properties")
+        for name, prop in properties:
+            returns = inspect.signature(prop.fget).return_annotation if prop.fget else inspect.Signature.empty
+            typed = "" if returns is inspect.Signature.empty else f": {returns}"
+            parts += [f"### {name}", code(f"{name}{typed}")]
+            if "](" in linked(returns):
+                parts.append(f"**Type** {linked(returns)}")
+            parts.append(doc(prop))
+
+    if methods:
+        parts.append("## Methods")
+        for name, method in methods:
+            function: typing.Callable = method.__func__ if isinstance(method, (staticmethod, classmethod)) else method
+            drop_first = not isinstance(method, staticmethod)
+            parts += [
+                f"### {name}",
+                code(signatures(function, drop_first)),
+                doc(function),
+                parameters_and_returns(function, drop_first),
+            ]
+
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def functions_page(functions: list) -> str:
+    parts = ["# Functions"]
+    for function in functions:
+        parts += [
+            f"## {function.__name__}",
+            code(signatures(function)),
+            doc(function),
+            parameters_and_returns(function, drop_first=False),
+        ]
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def toc_section(name: str, classes: list) -> str:
+    items = "".join(f"    - name: {c.__name__}\n      href: {c.__name__}.md\n" for c in classes)
+    return f"- name: {name}\n  items:\n{items}" if classes else ""
+
+
+def main() -> None:
+    public = [getattr(excelreader, name) for name in excelreader.__all__]
+    classes = [o for o in public if inspect.isclass(o)]
+    functions = [o for o in public if inspect.isfunction(o)]
+    enums = [c for c in classes if issubclass(c, enum.Enum)]
+    exceptions = [c for c in classes if issubclass(c, BaseException)]
+    others = [c for c in classes if c not in enums and c not in exceptions]
+
+    OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
+    for stale in OUTPUT_DIR.iterdir():
+        stale.unlink()
+    for cls in classes:
+        (OUTPUT_DIR / f"{cls.__name__}.md").write_text(class_page(cls), encoding="utf-8")
+    (OUTPUT_DIR / "functions.md").write_text(functions_page(functions), encoding="utf-8")
+
+    toc = (
+        toc_section("Classes", others)
+        + toc_section("Enums", enums)
+        + toc_section("Exceptions", exceptions)
+        + "- name: Functions\n  href: functions.md\n"
+    )
+    (OUTPUT_DIR / "toc.yml").write_text(toc, encoding="utf-8")
+
+
+if __name__ == "__main__":
+    main()

From 30f640d634b58860acbddc8eade296ac2e2b810e Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:53 -0300
Subject: [PATCH 106/115] docs(cpp): generate the C++ API reference from
 Doxygen XML

cpp/scripts/api_markdown.py runs Doxygen over excelreader.hpp and
excelreader_arrow.hpp and turns its XML into Markdown pages for docfx: classes,
structs, enums, concepts and free functions, with @param, @tparam and @return in
their own tables and library types linked. xl::detail, iterator internals and
copy/move members are left out.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs.yml  |   9 +-
 .gitignore                  |   3 +-
 cpp/scripts/api_markdown.py | 360 ++++++++++++++++++++++++++++++++++++
 docfx.json                  |   2 +-
 docs/toc.yml                |   2 +
 5 files changed, 373 insertions(+), 3 deletions(-)
 create mode 100644 cpp/scripts/api_markdown.py

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index b5c582f8..a6d6a36f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -6,9 +6,10 @@ on:
     paths:
       - 'src/ExcelReader.Core/**'
       - 'src/ExcelReader.Arrow/**'
-      - 'src/ExcelReader.Native/include/excelreader.h'
+      - 'src/ExcelReader.Native/include/**'
       - 'python/src/**'
       - 'python/scripts/api_markdown.py'
+      - 'cpp/scripts/api_markdown.py'
       - 'docs/**'
       - '**.md'
       - 'docfx.json'
@@ -37,6 +38,12 @@ jobs:
       - name: Build Python API reference
         run: python3 python/scripts/api_markdown.py
 
+      - name: Build C++ API reference
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes --no-install-recommends doxygen
+          python3 cpp/scripts/api_markdown.py
+
       - name: Build site
         run: |
           dotnet tool install --global docfx --version 2.81.0
diff --git a/.gitignore b/.gitignore
index 9001b4e0..b0eb550c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -506,7 +506,8 @@ python/src/excelreader/_lib/*
 build/
 # Subagent-driven-development scratch (per-plan ledgers, briefs, review packages)
 .superpowers/
-# docfx output and the generated Python API pages (docfx.json, python/scripts/api_markdown.py); CI builds and publishes it to gh-pages
+# docfx output and the generated Python/C++ API pages (docfx.json, */scripts/api_markdown.py); CI builds and publishes it to gh-pages
 docs/_site/
 docs/api/
 docs/python-api/
+docs/cpp-api/
diff --git a/cpp/scripts/api_markdown.py b/cpp/scripts/api_markdown.py
new file mode 100644
index 00000000..34daabb4
--- /dev/null
+++ b/cpp/scripts/api_markdown.py
@@ -0,0 +1,360 @@
+"""Write the C++ API reference as Markdown pages plus a toc.yml, for docfx to render.
+
+Runs Doxygen over the public headers and reads its XML output, so Doxygen must be on PATH.
+
+Run from anywhere:  python cpp/scripts/api_markdown.py
+"""
+
+import re
+import subprocess
+import tempfile
+import textwrap
+import xml.etree.ElementTree as ET
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[2]
+HEADERS = ["cpp/include/xl/excelreader.hpp", "cpp/include/xl/excelreader_arrow.hpp"]
+OUTPUT_DIR = REPO_ROOT / "docs" / "cpp-api"
+MAX_LINE = 100
+
+
+def run_doxygen(output: Path) -> Path:
+    config = "\n".join(
+        [
+            f"INPUT = {' '.join(HEADERS)}",
+            f"OUTPUT_DIRECTORY = {output.as_posix()}",
+            "GENERATE_HTML = NO",
+            "GENERATE_LATEX = NO",
+            "GENERATE_XML = YES",
+            "XML_PROGRAMLISTING = NO",
+            "EXTRACT_ALL = YES",
+            "EXCLUDE_SYMBOLS = xl::detail*",
+            "QUIET = YES",
+            "WARNINGS = NO",
+        ]
+    )
+    subprocess.run(["doxygen", "-"], input=config, text=True, cwd=REPO_ROOT, check=True)
+    return output / "xml"
+
+
+def tidy(text: str) -> str:
+    text = re.sub(r"\s*<\s*", "<", text)
+    text = re.sub(r"\s+>", ">", text)
+    return re.sub(r"\s+", " ", text).strip()
+
+
+def flat(element) -> str:
+    return tidy("".join(element.itertext())) if element is not None else ""
+
+
+SECTIONS = ("parameterlist", "simplesect")
+
+
+def inline(node) -> str:
+    """A paragraph as Markdown text: inline code kept, @param/@return blocks left to their own readers."""
+    out = node.text or ""
+    for child in node:
+        if child.tag not in SECTIONS:
+            inner = inline(child)
+            out += f"`{inner}`" if child.tag == "computeroutput" else inner
+        out += child.tail or ""
+    return re.sub(r"\s+", " ", out).strip()
+
+
+def prose(element) -> str:
+    if element is None:
+        return ""
+    paragraphs = [inline(p) for p in element.findall("para")]
+    notes = [
+        f"**{s.get('kind', '').capitalize()}** " + " ".join(inline(p) for p in s.findall("para"))
+        for p in element.findall("para")
+        for s in p.findall("simplesect")
+        if s.get("kind") not in ("return", "returns")
+    ]
+    return "\n\n".join(p for p in paragraphs + notes if p)
+
+
+def description(node) -> str:
+    return "\n\n".join(p for p in (prose(node.find("briefdescription")), prose(node.find("detaileddescription"))) if p)
+
+
+def documented_params(node, kind: str) -> dict[str, str]:
+    """The `@param` (kind "param") or `@tparam` (kind "templateparam") texts, by name."""
+    found: dict[str, str] = {}
+    if node is None:
+        return found
+    for parameter_list in node.iter("parameterlist"):
+        if parameter_list.get("kind") != kind:
+            continue
+        for item in parameter_list.findall("parameteritem"):
+            text = " ".join(inline(p) for p in item.iter("para"))
+            for name in item.iter("parametername"):
+                found.setdefault(flat(name), text)
+    return found
+
+
+def documented_return(node) -> str:
+    if node is None:
+        return ""
+    return " ".join(
+        inline(p) for s in node.iter("simplesect") if s.get("kind") in ("return", "returns") for p in s.findall("para")
+    )
+
+
+def type_parameters(node) -> str:
+    docs = documented_params(node, "templateparam")
+    if not docs:
+        return ""
+    rows = "\n".join(f"| `{name}` | {cell(text)} |" for name, text in docs.items())
+    return f"**Type parameters**\n\n| Name | Description |\n|---|---|\n{rows}"
+
+
+def cell(text: str) -> str:
+    return text.replace("|", "\\|")
+
+
+def linked(text: str, linkable: dict[str, str]) -> str:
+    text = cell(text).replace("<", "&lt;").replace(">", "&gt;")
+    return re.sub(
+        r"(?<![\w:])[A-Za-z_]\w*\b",
+        lambda m: f"[{m[0]}]({linkable[m[0]]})" if m[0] in linkable else m[0],
+        text,
+    )
+
+
+def code(text: str) -> str:
+    return f"```cpp\n{text}\n```"
+
+
+def template_prefix(node) -> str:
+    params = node.find("templateparamlist")
+    if params is None:
+        return ""
+    names = []
+    for param in params.iter("param"):
+        declared = flat(param.find("type"))
+        name = param.findtext("declname") or param.findtext("defname") or ""
+        names.append(tidy(f"{declared} {name}"))
+    return f"template <{', '.join(names)}>\n"
+
+
+def signature(member) -> str:
+    name = member.findtext("name")
+    returns = flat(member.find("type"))
+    prefix = "static " if member.get("static") == "yes" else ""
+    head = tidy(f"{prefix}{returns} {name}")
+    args = tidy(member.findtext("argsstring") or "")
+    one_line = f"{template_prefix(member)}{head}{args}"
+    params = member.findall("param")
+    if len(one_line.splitlines()[-1]) <= MAX_LINE or not params:
+        return one_line
+
+    lines = []
+    for param in params:
+        text = tidy(f"{flat(param.find('type'))} {param.findtext('declname') or ''}")
+        default = flat(param.find("defval"))
+        lines.append(f"{text} = {default}" if default else text)
+    trailer = args[args.rindex(")") + 1 :].strip()
+    body = ",\n".join(f"    {line}" for line in lines)
+    return f"{template_prefix(member)}{head}(\n{body}){(' ' + trailer) if trailer else ''}"
+
+
+def parameters_and_returns(members: list, linkable: dict[str, str]) -> str:
+    parts = [type_parameters(members[0])]
+    docs: dict[str, str] = {}
+    for member in members:
+        for name, text in documented_params(member, "param").items():
+            docs.setdefault(name, text)
+
+    seen = set()
+    rows = []
+    for param in (p for m in members for p in m.findall("param") if p.findtext("declname")):
+        name = param.findtext("declname")
+        type_text = flat(param.find("type"))
+        if (name, type_text) in seen:
+            continue
+        seen.add((name, type_text))
+        default = flat(param.find("defval"))
+        rows.append(
+            f"| `{name}` | {linked(type_text, linkable)} | "
+            + (f"`{cell(default)}`" if default else "")
+            + (f" | {cell(docs.get(name or '', ''))}" if docs else "")
+            + " |"
+        )
+    if rows:
+        header = "| Name | Type | Default | Description |\n|---|---|---|---|" if docs else "| Name | Type | Default |\n|---|---|---|"
+        parts.append(f"**Parameters**\n\n{header}\n" + "\n".join(rows))
+
+    returns = {re.sub(r"\b(constexpr|inline|static|explicit) ", "", flat(m.find("type"))) for m in members}
+    returns -= {"", "void"}
+    if returns:
+        text = next((documented_return(m) for m in members if documented_return(m)), "")
+        parts.append(
+            "**Returns** " + ", ".join(linked(r, linkable) for r in sorted(returns)) + (f": {text}" if text else "")
+        )
+    return "\n\n".join(p for p in parts if p)
+
+
+def by_name(members: list) -> dict[str, list]:
+    grouped: dict[str, list] = {}
+    for member in members:
+        grouped.setdefault(member.findtext("name"), []).append(member)
+    return grouped
+
+
+def member_sections(title: str, members: list, linkable: dict[str, str], level: str) -> list[str]:
+    if not members:
+        return []
+    parts = [f"{level} {title}"]
+    for name, overloads in by_name(members).items():
+        parts += [
+            f"{level}# {name}",
+            code("\n".join(signature(m) for m in overloads)),
+            *dict.fromkeys(description(m) for m in overloads),
+            parameters_and_returns(overloads, linkable),
+        ]
+    return parts
+
+
+def is_copy_or_move(member, class_name: str) -> bool:
+    params = member.findall("param")
+    return (
+        member.findtext("name") in (class_name, "operator=")
+        and len(params) == 1
+        and re.fullmatch(rf"(const )?{re.escape(class_name)} ?&&?", flat(params[0].find("type"))) is not None
+    )
+
+
+def class_page(compound, linkable: dict[str, str]) -> str:
+    full_name = compound.findtext("compoundname")
+    short = full_name.removeprefix("xl::")
+    kind = compound.get("kind")
+    parts = [
+        f"# {kind.capitalize()} {short}",
+        description(compound),
+        code(f"{template_prefix(compound)}{kind} {full_name}"),
+        type_parameters(compound.find("detaileddescription")),
+    ]
+
+    public = [
+        m
+        for m in compound.iter("memberdef")
+        if m.get("prot") == "public" and "=delete" not in (m.findtext("argsstring") or "").replace(" ", "")
+    ]
+    fields = [m for m in public if m.get("kind") == "variable"]
+    functions = [
+        m
+        for m in public
+        if m.get("kind") == "function" and not m.findtext("name").startswith("~") and not is_copy_or_move(m, short)
+    ]
+    constructors = [m for m in functions if m.findtext("name") == short.split("<")[0]]
+    operators = [m for m in functions if m.findtext("name").startswith("operator")]
+    methods = [m for m in functions if m not in constructors and m not in operators]
+
+    if fields:
+        described = any(description(m) for m in fields)
+        rows = "\n".join(
+            f"| `{m.findtext('name')}` | {linked(flat(m.find('type')), linkable)} | "
+            + (f"`{cell(flat(m.find('initializer')).lstrip('= '))}`" if m.find("initializer") is not None else "")
+            + (f" | {cell(description(m)).replace(chr(10), ' ')}" if described else "")
+            + " |"
+            for m in fields
+        )
+        header = "| Name | Type | Default | Description |\n|---|---|---|---|" if described else "| Name | Type | Default |\n|---|---|---|"
+        parts.append(f"## Fields\n\n{header}\n{rows}")
+
+    parts += member_sections("Constructors", constructors, linkable, "##")
+    parts += member_sections("Methods", methods, linkable, "##")
+    parts += member_sections("Operators", operators, linkable, "##")
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def enum_page(member) -> str:
+    name = member.findtext("name")
+    underlying = flat(member.find("type"))
+    rows = "\n".join(
+        f"| `{v.findtext('name')}` | `{cell(flat(v.find('initializer')).lstrip('= '))}` | {cell(description(v))} |"
+        for v in member.iter("enumvalue")
+    )
+    parts = [
+        f"# Enum {name}",
+        description(member),
+        code(f"enum class xl::{name}" + (f" : {underlying}" if underlying else "")),
+        f"## Members\n\n| Name | Value | Description |\n|---|---|---|\n{rows}",
+    ]
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def concept_page(concept) -> str:
+    name = concept.findtext("compoundname", "").removeprefix("xl::")
+    initializer = concept.find("initializer")
+    definition = textwrap.dedent("".join(initializer.itertext())).strip() if initializer is not None else ""
+    parts = [f"# Concept {name}", description(concept), code(definition), type_parameters(concept.find("detaileddescription"))]
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def functions_page(functions: list, linkable: dict[str, str]) -> str:
+    parts = ["# Functions", "Free functions in namespace `xl`."]
+    for name, overloads in by_name(functions).items():
+        parts += [
+            f"## {name}",
+            code("\n".join(signature(m) for m in overloads)),
+            *dict.fromkeys(description(m) for m in overloads),
+            parameters_and_returns(overloads, linkable),
+        ]
+    return "\n\n".join(p for p in parts if p) + "\n"
+
+
+def toc_section(title: str, names: list[str]) -> str:
+    items = "".join(f"    - name: {n}\n      href: {n}.md\n" for n in names)
+    return f"- name: {title}\n  items:\n{items}" if names else ""
+
+
+def main() -> None:
+    with tempfile.TemporaryDirectory() as scratch:
+        xml_dir = run_doxygen(Path(scratch))
+        compounds = []
+        concepts = [ET.parse(path).getroot()[0] for path in sorted(xml_dir.glob("concept*.xml"))]
+        for path in sorted(xml_dir.glob("*.xml")):
+            if path.name.startswith(("class", "struct")):
+                compound = ET.parse(path).getroot()[0]
+                name = compound.findtext("compoundname", "")
+                if name.count("::") == 1 and "<" not in name:
+                    compounds.append(compound)
+        namespace = ET.parse(xml_dir / "namespacexl.xml").getroot()[0]
+
+    members = list(namespace.iter("memberdef"))
+    enums = [m for m in members if m.get("kind") == "enum"]
+    functions = [m for m in members if m.get("kind") == "function"]
+
+    pages = {c.findtext("compoundname", "").removeprefix("xl::"): c for c in compounds}
+    linkable = {name: f"{name}.md" for name in pages}
+    linkable.update({e.findtext("name", ""): f"{e.findtext('name')}.md" for e in enums})
+    concept_names = [c.findtext("compoundname", "").removeprefix("xl::") for c in concepts]
+    linkable.update({name: f"{name}.md" for name in concept_names})
+
+    OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
+    for stale in OUTPUT_DIR.iterdir():
+        stale.unlink()
+    for name, compound in pages.items():
+        (OUTPUT_DIR / f"{name}.md").write_text(class_page(compound, linkable), encoding="utf-8")
+    for enum in enums:
+        (OUTPUT_DIR / f"{enum.findtext('name')}.md").write_text(enum_page(enum), encoding="utf-8")
+    for name, concept in zip(concept_names, concepts):
+        (OUTPUT_DIR / f"{name}.md").write_text(concept_page(concept), encoding="utf-8")
+    (OUTPUT_DIR / "functions.md").write_text(functions_page(functions, linkable), encoding="utf-8")
+
+    classes = sorted(n for n, c in pages.items() if c.get("kind") == "class")
+    structs = sorted(n for n, c in pages.items() if c.get("kind") == "struct")
+    toc = (
+        toc_section("Classes", classes)
+        + toc_section("Structs", structs)
+        + toc_section("Enums", sorted(e.findtext("name", "") for e in enums))
+        + toc_section("Concepts", sorted(concept_names))
+        + "- name: Functions\n  href: functions.md\n"
+    )
+    (OUTPUT_DIR / "toc.yml").write_text(toc, encoding="utf-8")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/docfx.json b/docfx.json
index 6e770446..df62eea3 100644
--- a/docfx.json
+++ b/docfx.json
@@ -16,7 +16,7 @@
   ],
   "build": {
     "content": [
-      { "files": [ "index.md", "toc.yml", "api/**.{yml,md}", "python-api/**.{yml,md}" ], "src": "docs" },
+      { "files": [ "index.md", "toc.yml", "api/**.{yml,md}", "python-api/**.{yml,md}", "cpp-api/**.{yml,md}" ], "src": "docs" },
       {
         "files": [
           "docs/README.md",
diff --git a/docs/toc.yml b/docs/toc.yml
index b11f23a0..b504ac27 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -30,6 +30,8 @@
       href: https://docs.rs/excelreader
     - name: C++
       href: ../cpp/README.md
+    - name: C++ API
+      href: cpp-api/
 - name: Performance
   items:
     - name: Benchmarks

From 776d352f302d676e68bdd40d67cb220cdc611283 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:53 -0300
Subject: [PATCH 107/115] docs(cpp): document the public C++ API with Doxygen
 comments

Public types and members get @brief, @param, @tparam and @return comments that
state the contract: ownership, how long a view stays valid, threading, how the
end of data is reported, and defaults. The OpenOptions defaults come from the
managed options the native layer forwards each field to.

Also restores, as one line inside write_sheet and write_sheet_to_memory, the
invariant a truncated comment used to state: refs borrows builders' buffers, so
both must live until the write returns.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .../include/excelreader.hpp                   | 454 +++++++++++++++---
 .../include/excelreader_arrow.hpp             |  28 +-
 2 files changed, 407 insertions(+), 75 deletions(-)

diff --git a/src/ExcelReader.Native/include/excelreader.hpp b/src/ExcelReader.Native/include/excelreader.hpp
index 4094de50..29b713c6 100644
--- a/src/ExcelReader.Native/include/excelreader.hpp
+++ b/src/ExcelReader.Native/include/excelreader.hpp
@@ -28,10 +28,13 @@ namespace xl
 {
 
 
+    /// @brief A failure reported by any entry point.
+    ///
+    /// This header throws nothing: every function that can fail returns `std::expected<T, Error>`.
     struct Error
     {
-        int32_t code;
-        std::string message;
+        int32_t code;        ///< One of the `XL_*` status codes.
+        std::string message; ///< The native library's description of what went wrong.
     };
 
     namespace detail
@@ -71,6 +74,10 @@ namespace xl
     } 
 
 
+    /// @brief ABI revision of the loaded native library.
+    ///
+    /// Every open checks it against the `XL_ABI_VERSION` this header was compiled with and fails on a
+    /// mismatch.
     inline int32_t abi_version() noexcept { return xl_abi_version(); }
 
     namespace detail
@@ -119,42 +126,57 @@ namespace xl
     } 
 
 
+    /// @brief One column guessed by Sheet::infer_schema.
     struct InferredColumn
     {
-        std::optional<std::string> name;
-        int32_t index = 0;
-        int32_t type = XL_T_STRING; 
-        bool nullable = false;
+        std::optional<std::string> name; ///< Header text; empty when the column must be matched by `index`.
+        int32_t index = 0;                ///< 0-based column position.
+        int32_t type = XL_T_STRING;       ///< One of the `XL_T_*` constants.
+        bool nullable = false;            ///< Whether the column may hold empty cells.
     };
 
 
+    /// @brief Reader limits and CSV dialect for the Workbook::open family.
+    ///
+    /// A field left at 0 or `XL_OPT_DEFAULT` keeps the library default; on/off fields take
+    /// `XL_OPT_TRUE` or `XL_OPT_FALSE`. The `max_*` fields bound what a malformed or hostile file can
+    /// make the reader allocate: lower them for untrusted input. An out-of-range value fails the open
+    /// with `XL_INVALID_ARGUMENT`.
     struct OpenOptions
     {
-        int32_t csv_sniff_dialect = XL_OPT_DEFAULT;
-        int32_t csv_delimiter = 0;
-        int32_t csv_quote = 0;
-        int32_t csv_detect_bom = XL_OPT_DEFAULT;
-        int32_t csv_max_cell_bytes = 0;
-        int32_t csv_intern_strings = XL_OPT_DEFAULT;
-
-        int64_t max_total_decompressed_bytes = 0;
-        int32_t max_cell_bytes = 0;
-        int64_t max_shared_string_bytes = 0;
-        int32_t max_zip_entries = 0;
-        int32_t prefetch_decompression = XL_OPT_DEFAULT;
-        int32_t intern_strings = XL_OPT_DEFAULT;
-        int64_t source_cache_bytes = 0;
-        int64_t max_buffered_bytes = 0;
-        int32_t source_block_size = 0;
-
-        std::string password_{};
-
+        int32_t csv_sniff_dialect = XL_OPT_DEFAULT;      ///< Infer delimiter and quote from the start of a CSV. Off by default.
+        int32_t csv_delimiter = 0;                       ///< CSV field separator byte. Default `,`.
+        int32_t csv_quote = 0;                           ///< CSV quote byte. Default `"`.
+        int32_t csv_detect_bom = XL_OPT_DEFAULT;         ///< Skip a leading UTF-8 byte-order mark. On by default.
+        int32_t csv_max_cell_bytes = 0;                  ///< For CSV, replaces `max_cell_bytes`.
+        int32_t csv_intern_strings = XL_OPT_DEFAULT;     ///< For CSV, replaces `intern_strings`.
+
+        int64_t max_total_decompressed_bytes = 0;        ///< Bytes an XLSX/XLSB may inflate to, or an XLS workbook stream may declare. Default 512 MiB.
+        int32_t max_cell_bytes = 0;                      ///< Largest cell value or buffered CSV record. Default 32 MiB.
+        int64_t max_shared_string_bytes = 0;             ///< Largest shared-string table. Default 128 MiB.
+        int32_t max_zip_entries = 0;                     ///< Most entries an XLSX/XLSB archive may hold. Default 65,536.
+        int32_t prefetch_decompression = XL_OPT_DEFAULT; ///< Inflate XLSX/XLSB sheet data on a background thread ahead of parsing. Off by default.
+        int32_t intern_strings = XL_OPT_DEFAULT;         ///< Deduplicate repeated text outside the shared-string table. Off by default; pays off only for low-cardinality text.
+        int64_t source_cache_bytes = 0;                  ///< Block cache of Workbook::open_source. Default 64 MiB.
+        int64_t max_buffered_bytes = 0;                  ///< Most bytes Workbook::open_stream reads before an XLSX, XLSB or XLS opens.
+        int32_t source_block_size = 0;                   ///< Block size of Workbook::open_source's cache. Default 4 MiB; negative turns the cache off.
+
+        std::string password_{}; ///< Set through password().
+
+        /// @brief Sets the password that unlocks an encrypted OOXML workbook (.xlsx/.xlsb/.xlsm).
+        ///
+        /// Open the workbook with `XL_FORMAT_AUTO`: `XL_FORMAT_XLSX` reads the encrypted container as a
+        /// plain ZIP and fails before the password is checked.
+        /// @param value The password, as UTF-8.
+        /// @return `*this`, for chaining.
         OpenOptions &password(std::string_view value)
         {
             password_ = std::string(value);
             return *this;
         }
 
+        /// @brief These options as the C ABI's `xl_open_options`.
+        /// @return A struct pointing into this object, valid while it lives unchanged.
         xl_open_options to_c() const noexcept
         {
             xl_open_options opts{};
@@ -181,16 +203,21 @@ namespace xl
     };
 
 
+    /// @brief Settings for every writer.
+    ///
+    /// A field left at 0 or `XL_OPT_DEFAULT` keeps the library default.
     struct WriteOptions
     {
-        std::string_view sheet_name{}; 
+        std::string_view sheet_name{}; ///< Default `Sheet1`; ignored for CSV. Borrowed: must outlive the write.
 
-        int32_t csv_delimiter = 0;
-        int32_t csv_quote = 0;
+        int32_t csv_delimiter = 0; ///< CSV field separator byte. Default `,`.
+        int32_t csv_quote = 0;     ///< CSV quote byte. Default `"`.
 
-        int32_t date1904 = XL_OPT_DEFAULT;           
-        int32_t use_shared_strings = XL_OPT_DEFAULT; 
+        int32_t date1904 = XL_OPT_DEFAULT;           ///< XLS/XLSB only: use the 1904 date system. Off by default.
+        int32_t use_shared_strings = XL_OPT_DEFAULT; ///< XLSX/XLSB only: store repeated text once in a shared-string table. Off by default.
 
+        /// @brief These options as the C ABI's `xl_write_options`.
+        /// @return A struct pointing into this object, valid while it lives unchanged.
         xl_write_options to_c() const noexcept
         {
             xl_write_options opts{};
@@ -207,15 +234,19 @@ namespace xl
         }
     };
 
+    /// @brief Settings for aggregate_csv_file and aggregate_csv_memory.
+    ///
+    /// A zero field keeps the library default.
     struct CsvParallelOptions
     {
-        int32_t degree_of_parallelism = 0;
-        int32_t header_row = 0;
-        int32_t delimiter = 0;
-        int32_t quote = 0;
-        int32_t detect_bom = XL_OPT_DEFAULT;
-        int32_t max_cell_bytes = 0;
+        int32_t degree_of_parallelism = 0;   ///< Worker threads; 0 uses every processor, 1 runs sequentially.
+        int32_t header_row = 0;              ///< 1-based header row, not aggregated; 0 means none.
+        int32_t delimiter = 0;               ///< Field separator byte. Default `,`.
+        int32_t quote = 0;                   ///< Quote byte. Default `"`.
+        int32_t detect_bom = XL_OPT_DEFAULT; ///< Skip a leading UTF-8 byte-order mark. On by default.
+        int32_t max_cell_bytes = 0;          ///< Largest field or buffered record. Default 32 MiB.
 
+        /// @brief These options as the C ABI's `xl_csv_parallel_options`.
         xl_csv_parallel_options to_c() const noexcept
         {
             xl_csv_parallel_options opts{};
@@ -265,6 +296,10 @@ namespace xl
 
     } 
 
+    /// @brief The format a file name's extension names.
+    /// @param path File name or path. Only its extension is read: .xlsx, .xlsb, .xls or .csv, in any case.
+    /// @return The matching `XL_FORMAT_*` constant, or `XL_FORMAT_AUTO` when none matches, which every
+    /// writer rejects.
     constexpr int32_t format_from_path(std::string_view path) noexcept
     {
         const size_t separator = path.find_last_of("/\\");
@@ -291,6 +326,10 @@ namespace xl
     }
 
 
+    /// @brief One column handed to write_columns.
+    ///
+    /// Its buffers are borrowed, not copied, and must outlive the write. Build it with i64_column,
+    /// string_column and the other column functions rather than by hand.
     struct ColumnRef
     {
         std::string_view name{}; 
@@ -322,42 +361,79 @@ namespace xl
 
     } 
 
+    /// @brief An `XL_T_I64` column.
+    /// @param name Header text. Either every column of a table has one or none does.
+    /// @param values One value per row.
+    /// @param validity Optional LSB-first bitmap, one bit per row, set where the row has a value. Empty
+    /// means every row has one.
+    /// @return A column borrowing `values` and `validity`.
     inline constexpr ColumnRef i64_column(std::string_view name, std::span<const int64_t> values,
                                           std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_I64>(name, values, validity);
     }
 
+    /// @brief An `XL_T_F64` column.
+    /// @param name Header text, as for i64_column.
+    /// @param values One value per row.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `values` and `validity`.
     inline constexpr ColumnRef f64_column(std::string_view name, std::span<const double> values,
                                           std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_F64>(name, values, validity);
     }
 
+    /// @brief An `XL_T_BOOL` column.
+    /// @param name Header text, as for i64_column.
+    /// @param values One byte per row, 0 or 1.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `values` and `validity`.
     inline constexpr ColumnRef bool_column(std::string_view name, std::span<const uint8_t> values,
                                            std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_BOOL>(name, values, validity);
     }
 
+    /// @brief An `XL_T_DATE` column.
+    /// @param name Header text, as for i64_column.
+    /// @param days_since_epoch Days since 1970-01-01, one per row.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `days_since_epoch` and `validity`.
     inline constexpr ColumnRef date_column(std::string_view name, std::span<const int32_t> days_since_epoch,
                                            std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_DATE>(name, days_since_epoch, validity);
     }
 
+    /// @brief An `XL_T_TIME` column.
+    /// @param name Header text, as for i64_column.
+    /// @param micros_since_midnight Microseconds since midnight, one per row.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `micros_since_midnight` and `validity`.
     inline constexpr ColumnRef time_column(std::string_view name, std::span<const int64_t> micros_since_midnight,
                                            std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_TIME>(name, micros_since_midnight, validity);
     }
 
+    /// @brief An `XL_T_TIMESTAMP` column.
+    /// @param name Header text, as for i64_column.
+    /// @param micros_since_epoch Microseconds since 1970-01-01T00:00:00Z, one per row.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `micros_since_epoch` and `validity`.
     inline constexpr ColumnRef timestamp_column(std::string_view name, std::span<const int64_t> micros_since_epoch,
                                                 std::span<const uint8_t> validity = {}) noexcept
     {
         return detail::scalar_column<XL_T_TIMESTAMP>(name, micros_since_epoch, validity);
     }
 
+    /// @brief An `XL_T_STRING` column.
+    /// @param name Header text, as for i64_column.
+    /// @param offsets One entry per row plus one: row `i` is `data[offsets[i], offsets[i + 1])`.
+    /// @param data The UTF-8 text of every row, back to back.
+    /// @param validity Optional null bitmap, as for i64_column.
+    /// @return A column borrowing `offsets`, `data` and `validity`.
     inline constexpr ColumnRef string_column(std::string_view name, std::span<const int32_t> offsets,
                                              std::span<const uint8_t> data,
                                              std::span<const uint8_t> validity = {}) noexcept
@@ -436,24 +512,30 @@ namespace xl
     } 
 
 
+    /// @brief What a cell holds.
     enum class CellType : int32_t
     {
         Empty = XL_CELL_EMPTY,
         String = XL_CELL_STRING,
         Number = XL_CELL_NUMBER,
-        Date = XL_CELL_DATE,
+        Date = XL_CELL_DATE,       ///< A number in a date format; the value is its serial number.
         Bool = XL_CELL_BOOL,
-        Formula = XL_CELL_FORMULA,
-        Error = XL_CELL_ERROR,
+        Formula = XL_CELL_FORMULA, ///< No longer produced: a formula cell reports its cached result's type.
+        Error = XL_CELL_ERROR,     ///< An error value such as `#N/A`.
     };
 
+    /// @brief One cell of a row, borrowing the row's memory.
     struct CellView
     {
-        int32_t column{};
-        CellType type{};
-        std::string_view value{};
+        int32_t column{};         ///< 0-based column.
+        CellType type{};          ///< What the cell holds.
+        std::string_view value{}; ///< The text as stored, so a date is its serial number.
     };
 
+    /// @brief The cells of one row: a range of CellView.
+    ///
+    /// Borrowed from whatever produced it, so it is valid only as long as that RowCursor row,
+    /// DecodedRows or aggregation callback says.
     class RowView
     {
     public:
@@ -466,6 +548,8 @@ namespace xl
         size_t size() const { return count_; }
         bool empty() const { return count_ == 0; }
 
+        /// @brief The `index`-th cell, counting cells rather than columns. Unchecked.
+        /// @param index Position among the row's cells, below size().
         CellView operator[](size_t index) const
         {
             if (cells_ != nullptr)
@@ -560,6 +644,9 @@ namespace xl
         size_t count_{};
     };
 
+    /// @brief Every row of a sheet, or every row a cursor had left, decoded in one native call.
+    ///
+    /// Owns that memory until destruction; the RowView it hands out borrow from it.
     class DecodedRows
     {
     public:
@@ -584,6 +671,8 @@ namespace xl
         size_t size() const { return raw_.row_count > 0 ? static_cast<size_t>(raw_.row_count) : 0; }
         bool empty() const { return size() == 0; }
 
+        /// @brief The row at `index`. Unchecked.
+        /// @param index 0-based row, below size().
         RowView operator[](size_t index) const
         {
             const xl_row &row = raw_.rows[index];
@@ -636,11 +725,15 @@ namespace xl
     };
 
 
-    /// Reads one sheet row by row. Owns a native cursor and closes it on destruction. Use one
-    /// cursor from one thread at a time; any number may be open on one workbook.
+    /// @brief Reads one sheet row by row.
+    ///
+    /// Owns a native cursor and closes it on destruction. Use one cursor from one thread at a time;
+    /// any number may be open on one workbook.
     class RowCursor
     {
     public:
+        /// @brief Takes ownership of a cursor opened through the C ABI.
+        /// @param rows Cursor from `xl_rows_open`, closed by this object.
         explicit RowCursor(xl_rows *rows) noexcept : rows_(rows) {}
 
         RowCursor(const RowCursor &) = delete;
@@ -659,8 +752,9 @@ namespace xl
 
         ~RowCursor() { close(); }
 
-        /// The returned view points into memory the cursor owns and is valid until the next
-        /// next_row() on this cursor or until the cursor is destroyed.
+        /// @brief Reads the next row.
+        /// @return A view into memory the cursor owns, valid until the next next_row() or the cursor's
+        /// destruction. The end of the sheet arrives as an error whose code is `XL_EOF`.
         std::expected<RowView, Error> next_row()
         {
             xl_row row{};
@@ -676,7 +770,7 @@ namespace xl
             return RowView(row.cells, static_cast<size_t>(row.cell_count));
         }
 
-        /// Every row this cursor has not yet returned, decoded in one native call.
+        /// @brief Every row this cursor has not yet returned, decoded in one native call.
         std::expected<DecodedRows, Error> read_all_decoded()
         {
             xl_rows_decoded raw{};
@@ -688,6 +782,8 @@ namespace xl
             return DecodedRows(raw);
         }
 
+        /// @brief The native cursor, for calling the C ABI directly.
+        /// @return The cursor, still owned by this object.
         xl_rows *handle() const noexcept { return rows_; }
 
     private:
@@ -703,29 +799,38 @@ namespace xl
         xl_rows *rows_ = nullptr;
     };
 
+    /// @brief Whether a sheet's tab is shown.
     enum class SheetVisibility : int32_t
     {
         Visible = XL_SHEET_VISIBLE,
-        Hidden = XL_SHEET_HIDDEN,
-        VeryHidden = XL_SHEET_VERY_HIDDEN,
+        Hidden = XL_SHEET_HIDDEN,          ///< Hidden, but listed in Excel's Unhide dialog.
+        VeryHidden = XL_SHEET_VERY_HIDDEN, ///< Hidden and absent from the Unhide dialog; only code can show it.
     };
 
-    /// One sheet of a Workbook: the native workbook handle and an index. Holds no resource of its
-    /// own, so it is cheap to copy and may be handed to another thread; each read opens what it
-    /// needs. After its workbook is destroyed, every read on it returns XL_INVALID_HANDLE.
+    /// @brief One sheet of a Workbook: the native workbook handle and an index.
+    ///
+    /// Holds no resource of its own, so it is cheap to copy and may be handed to another thread; each
+    /// read opens what it needs. After its workbook is destroyed, every read on it returns
+    /// `XL_INVALID_HANDLE`.
     class Sheet
     {
     public:
+        /// @brief A sheet of a workbook opened through the C ABI. Workbook hands these out.
+        /// @param handle Workbook handle, not owned.
+        /// @param index 0-based sheet position.
         Sheet(xl_workbook *handle, int32_t index) noexcept : handle_(handle), index_(index) {}
 
+        /// @brief 0-based position in the workbook.
         int32_t index() const noexcept { return index_; }
 
+        /// @brief The sheet's name.
         std::expected<std::string, Error> name() const
         {
             return detail::fill_string([this](uint8_t *buffer, int32_t capacity, int32_t *out_len)
                                        { return xl_sheet_name_at(handle_, index_, buffer, capacity, out_len); });
         }
 
+        /// @brief Whether the sheet's tab is shown.
         std::expected<SheetVisibility, Error> visibility() const
         {
             int32_t raw = 0;
@@ -737,7 +842,8 @@ namespace xl
             return static_cast<SheetVisibility>(raw);
         }
 
-        /// A cursor over this sheet, from its first row. Each call opens an independent cursor.
+        /// @brief A cursor over this sheet, from its first row.
+        /// @return A new, independent cursor on every call.
         std::expected<RowCursor, Error> rows() const
         {
             xl_rows *rows = nullptr;
@@ -749,7 +855,7 @@ namespace xl
             return RowCursor(rows);
         }
 
-        /// The whole sheet from its first row, decoded in one native call.
+        /// @brief The whole sheet from its first row, decoded in one native call.
         std::expected<DecodedRows, Error> read_all_decoded() const
         {
             auto cursor = rows();
@@ -760,7 +866,12 @@ namespace xl
             return cursor->read_all_decoded();
         }
 
-        /// flags: 0, or XL_INFER_PARSE_TEXT to also type cells that hold text.
+        /// @brief Guesses each column's name and type from a sample of the sheet.
+        /// @param header_row 1-based row holding the headers; 0 when the sheet has none.
+        /// @param sample_size Rows after the header to sample.
+        /// @param flags 0, or `XL_INFER_PARSE_TEXT` to also type cells that hold text, such as every CSV
+        /// field or numbers stored as text.
+        /// @return One InferredColumn per column, in order.
         std::expected<std::vector<InferredColumn>, Error> infer_schema(int32_t header_row = 1,
                                                                        int32_t sample_size = 100,
                                                                        int32_t flags = 0) const
@@ -797,6 +908,8 @@ namespace xl
             return columns;
         }
 
+        /// @brief The native workbook handle.
+        /// @return The handle, not owned: it dies with its Workbook.
         xl_workbook *handle() const noexcept { return handle_; }
 
     private:
@@ -804,20 +917,34 @@ namespace xl
         int32_t index_ = 0;
     };
 
-    /// Random-access bytes for Workbook::open_source. read_at is called from several threads at once.
+    /// @brief Random-access bytes for Workbook::open_source.
+    ///
+    /// `read_at` is called from several threads at once.
     class Source
     {
     public:
         virtual ~Source() = default;
+        /// @brief Total length in bytes.
         virtual std::uint64_t size() const = 0;
+        /// @brief Reads the bytes at an offset.
+        /// @param offset Position of the first byte.
+        /// @param buffer Where to put them.
+        /// @return How many bytes were written, or an error message. An error, or an exception, fails
+        /// the read that needed the bytes.
         virtual std::expected<std::size_t, std::string> read_at(std::uint64_t offset, std::span<std::byte> buffer) const = 0;
     };
 
-    /// Sequential bytes for Workbook::open_stream. read is never called concurrently.
+    /// @brief Sequential bytes for Workbook::open_stream.
+    ///
+    /// `read` is never called concurrently.
     class InputStream
     {
     public:
         virtual ~InputStream() = default;
+        /// @brief Reads the next bytes.
+        /// @param buffer Where to put up to `buffer.size()` bytes.
+        /// @return How many bytes were written, 0 at the end of the stream, or an error message. An error,
+        /// or an exception, fails the open or read that needed the bytes.
         virtual std::expected<std::size_t, std::string> read(std::span<std::byte> buffer) = 0;
     };
 
@@ -873,7 +1000,10 @@ namespace xl
         }
     }
 
-    /// An open workbook. Safe to use from several threads at once: every read goes through a Sheet and opens its own cursor.
+    /// @brief An open workbook, closed on destruction.
+    ///
+    /// Safe to use from several threads at once: every read goes through a Sheet and opens its own
+    /// cursor.
     class Workbook
     {
     public:
@@ -893,6 +1023,12 @@ namespace xl
 
         ~Workbook() { close(); }
 
+        /// @brief Opens the workbook at a path.
+        /// @param path File to open.
+        /// @param format An `XL_FORMAT_*` constant. `XL_FORMAT_AUTO` detects XLSX, XLSB and XLS from the
+        /// file's signature; CSV has none and needs `XL_FORMAT_CSV`.
+        /// @param options Reader limits and CSV dialect, or null for the defaults.
+        /// @return The workbook. Fails if the native library's ABI does not match this header.
         static std::expected<Workbook, Error> open(std::string_view path, int32_t format = XL_FORMAT_AUTO,
                                                    const OpenOptions *options = nullptr)
         {
@@ -913,6 +1049,10 @@ namespace xl
             return Workbook(handle);
         }
 
+        /// @brief Opens a workbook from bytes in memory.
+        /// @param data The file's bytes. The native library copies them, so they need not outlive the call.
+        /// @param format As for Workbook::open.
+        /// @param options As for Workbook::open.
         static std::expected<Workbook, Error> open_memory(std::span<const uint8_t> data, int32_t format = XL_FORMAT_AUTO,
                                                           const OpenOptions *options = nullptr)
         {
@@ -932,7 +1072,12 @@ namespace xl
             return Workbook(handle);
         }
 
-        /// Opens a workbook over a source the library owns from here on; every sheet can be read in parallel.
+        /// @brief Opens a workbook over random-access bytes.
+        /// @param source Owned by the library from here on. Read from several threads, so every sheet can
+        /// still be read in parallel.
+        /// @param format As for Workbook::open.
+        /// @param options As for Workbook::open; `source_block_size` and `source_cache_bytes` tune the
+        /// block cache.
         static std::expected<Workbook, Error> open_source(std::unique_ptr<Source> source, int32_t format = XL_FORMAT_AUTO,
                                                           const OpenOptions *options = nullptr)
         {
@@ -965,8 +1110,14 @@ namespace xl
             return Workbook(handle);
         }
 
-        /// Opens a workbook over a stream that cannot seek: a CSV is read as it arrives, and again from the start
-        /// until 16 MiB of it were read; an XLSX, XLSB or XLS is read whole first.
+        /// @brief Opens a workbook over a stream that cannot seek.
+        ///
+        /// A CSV is read as it arrives, and again from the start until 16 MiB of it were read; an XLSX,
+        /// XLSB or XLS is read whole first.
+        /// @param stream Owned by the library from here on.
+        /// @param format As for Workbook::open.
+        /// @param options As for Workbook::open; `max_buffered_bytes` caps what an XLSX, XLSB or XLS may
+        /// buffer.
         static std::expected<Workbook, Error> open_stream(std::unique_ptr<InputStream> stream, int32_t format = XL_FORMAT_AUTO,
                                                           const OpenOptions *options = nullptr)
         {
@@ -994,6 +1145,7 @@ namespace xl
         }
 
 
+        /// @brief Number of sheets.
         std::expected<int32_t, Error> sheet_count() const
         {
             int32_t count = 0;
@@ -1005,12 +1157,15 @@ namespace xl
             return count;
         }
 
+        /// @brief Name of the sheet at `index`.
+        /// @param index 0-based sheet position.
         std::expected<std::string, Error> sheet_name_at(int32_t index) const
         {
             return detail::fill_string([this, index](uint8_t *buffer, int32_t capacity, int32_t *out_len)
                                        { return xl_sheet_name_at(handle_, index, buffer, capacity, out_len); });
         }
 
+        /// @brief Every sheet's name, in workbook order.
         std::expected<std::vector<std::string>, Error> sheet_names() const
         {
             auto count = sheet_count();
@@ -1032,11 +1187,14 @@ namespace xl
             return names;
         }
 
-        /// The sheet at `index`. Makes no native call: an index outside the workbook is reported
-        /// by the first read on the returned sheet.
+        /// @brief The sheet at `index`.
+        ///
+        /// Makes no native call: an index outside the workbook is reported by the first read on the
+        /// returned sheet.
+        /// @param index 0-based sheet position.
         Sheet sheet(int32_t index) const noexcept { return Sheet(handle_, index); }
 
-        /// Every sheet, in workbook order. Opens nothing.
+        /// @brief Every sheet, in workbook order. Opens nothing.
         std::expected<std::vector<Sheet>, Error> sheets() const
         {
             auto count = sheet_count();
@@ -1053,7 +1211,9 @@ namespace xl
             return result;
         }
 
-        /// The sheet called `name`, compared without regard to case; empty when no sheet matches.
+        /// @brief The sheet called `name`, compared without regard to case.
+        /// @param name Sheet name.
+        /// @return The sheet, or empty when no sheet matches.
         std::expected<std::optional<Sheet>, Error> sheet_by_name(std::string_view name) const
         {
             int32_t index = -1;
@@ -1070,6 +1230,9 @@ namespace xl
             return std::optional<Sheet>{Sheet(handle_, index)};
         }
 
+        /// @brief Whether dates count from 1904 instead of 1900.
+        ///
+        /// A date cell's serial number depends on it.
         std::expected<bool, Error> is_date1904() const
         {
             int32_t flag = 0;
@@ -1081,6 +1244,8 @@ namespace xl
             return flag != 0;
         }
 
+        /// @brief The native handle, for calling the C ABI directly.
+        /// @return The handle, still owned by this object.
         xl_workbook *handle() const noexcept { return handle_; }
 
     private:
@@ -1099,6 +1264,11 @@ namespace xl
     };
 
 
+    /// @brief The `XL_T_*` column type `T` reads and writes as, in `value`.
+    ///
+    /// Defined for std::string and std::string_view, integers, floating point, bool, the std::chrono
+    /// date and time types, and std::optional of any of them.
+    /// @tparam T A field type.
     template <typename T>
     struct XlType; 
 
@@ -1194,6 +1364,10 @@ namespace xl
     } 
 
 
+    /// @brief A member bound to a column by header name. Built by make_field.
+    /// @tparam Class The row type.
+    /// @tparam T The member's type.
+    /// @tparam N How many header names the binding accepts.
     template <typename Class, typename T, std::size_t N = 1>
     struct FieldBinding
     {
@@ -1202,12 +1376,20 @@ namespace xl
         using FieldType = T;
     };
 
+    /// @brief Binds a member to the column with one header.
+    /// @param name Header text.
+    /// @param member The member to fill or write.
+    /// @return The binding, for ExcelMapper::get_bindings.
     template <typename Class, typename T>
     constexpr FieldBinding<Class, T> make_field(const char *name, T Class::*member)
     {
         return {{name}, member};
     }
 
+    /// @brief Binds a member to the column headed by any of several names.
+    /// @param names Accepted header texts.
+    /// @param member The member to fill or write.
+    /// @return The binding, for ExcelMapper::get_bindings.
     template <typename Class, typename T, std::size_t N>
     constexpr FieldBinding<Class, T, N> make_field(const char *(&&names)[N], T Class::*member)
     {
@@ -1220,6 +1402,12 @@ namespace xl
         return result;
     }
 
+    /// @brief Maps a row type to columns.
+    ///
+    /// Specialize it with a `static constexpr auto get_bindings()` that returns a std::tuple of
+    /// make_field results; parse_sheet, typed_reader, parse_arrow and write_sheet all read the same
+    /// mapping.
+    /// @tparam T The row type.
     template <typename T>
     struct ExcelMapper;
 
@@ -1348,6 +1536,10 @@ namespace xl
     } 
 
 
+    /// @brief The rows of a typed parse, held in native columnar memory.
+    ///
+    /// Each row converts to `T` on access. Owns that memory; a random-access range of `T`.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
     template <typename T>
     class TableView
     {
@@ -1461,8 +1653,13 @@ namespace xl
         int64_t size() const noexcept { return table_.row_count; }
         bool empty() const noexcept { return table_.row_count == 0; }
 
+        /// @brief Row `row` as `T`. Unchecked; at() is the checked read.
+        /// @param row 0-based row, below size().
         T operator[](int64_t row) const { return detail::row_at<T>(table_, row); }
 
+        /// @brief Row `row` as `T`, bounds-checked.
+        /// @param row 0-based row.
+        /// @return The row, or empty outside `[0, size())`.
         std::optional<T> at(int64_t row) const
         {
             if (row < 0 || row >= table_.row_count)
@@ -1472,6 +1669,7 @@ namespace xl
             return (*this)[row];
         }
 
+        /// @brief Every row converted to `T`.
         std::vector<T> to_vector() const
         {
             std::vector<T> result;
@@ -1483,6 +1681,8 @@ namespace xl
             return result;
         }
 
+        /// @brief Takes ownership of a table produced by the C ABI.
+        /// @param table Table from `xl_parse_typed` or `xl_typed_reader_next`, freed by this object.
         static TableView from_raw(xl_table table) { return TableView(table); }
 
     private:
@@ -1492,6 +1692,13 @@ namespace xl
     };
 
 
+    /// @brief Reads a whole sheet as `T`.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
+    /// @param sheet The sheet to read.
+    /// @param header_row 1-based row holding the headers; 0 when the sheet has none.
+    /// @param degree_of_parallelism Threads to split an XLSX, XLSB or CSV across: 0 uses every
+    /// processor, 1 runs sequentially. The result is the same either way.
+    /// @return Every row after the header.
     template <typename T>
     std::expected<TableView<T>, Error> parse_sheet(Sheet sheet, int32_t header_row = 1,
                                                    int32_t degree_of_parallelism = 1)
@@ -1515,6 +1722,11 @@ namespace xl
     }
 
 
+    /// @brief parse_sheet delivered a batch at a time.
+    ///
+    /// An input range of `std::expected<TableView<T>, Error>` that stops after the first error. Each
+    /// batch owns its memory and outlives the reader. Use from one thread at a time.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
     template <typename T>
     class TypedReader
     {
@@ -1536,6 +1748,8 @@ namespace xl
 
         ~TypedReader() { xl_typed_reader_close(reader_); } 
 
+        /// @brief Reads the next batch.
+        /// @return The batch, or empty at the end of the sheet.
         std::expected<std::optional<TableView<T>>, Error> next()
         {
             xl_table table{};
@@ -1612,6 +1826,8 @@ namespace xl
         iterator begin() { return iterator(this); }
         std::default_sentinel_t end() const noexcept { return {}; }
 
+        /// @brief Takes ownership of a reader opened through the C ABI.
+        /// @param reader Reader from `xl_typed_reader_open`, closed by this object.
         static TypedReader from_raw(xl_typed_reader *reader) { return TypedReader(reader); }
 
     private:
@@ -1620,6 +1836,11 @@ namespace xl
         xl_typed_reader *reader_ = nullptr;
     };
 
+    /// @brief Opens a TypedReader over a sheet.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
+    /// @param sheet The sheet to read.
+    /// @param header_row As for parse_sheet.
+    /// @param batch_size Rows per batch: 0 makes one batch of the whole sheet; negative is an error.
     template <typename T>
     std::expected<TypedReader<T>, Error> typed_reader(Sheet sheet, int32_t header_row = 1,
                                                       int64_t batch_size = 10000)
@@ -1641,6 +1862,13 @@ namespace xl
         return TypedReader<T>::from_raw(reader);
     }
 
+    /// @brief Writes columns as one sheet, copying nothing.
+    /// @param path File to create.
+    /// @param format An `XL_FORMAT_*` constant. `XL_FORMAT_AUTO` is rejected: a file being created has
+    /// no signature to detect.
+    /// @param columns Columns of equal length, borrowed for the call. Either every column has a name,
+    /// written as a header row, or none does.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
     inline std::expected<void, Error> write_columns(std::string_view path, int32_t format,
                                                     std::span<const ColumnRef> columns,
                                                     const WriteOptions *options = nullptr)
@@ -1680,12 +1908,21 @@ namespace xl
         return {};
     }
 
+    /// @brief write_columns with the format taken from the file's extension.
+    /// @param path File to create; its extension picks the format.
+    /// @param columns As for the overload that takes a format.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
     inline std::expected<void, Error> write_columns(std::string_view path, std::span<const ColumnRef> columns,
                                                     const WriteOptions *options = nullptr)
     {
         return write_columns(path, format_from_path(path), columns, options);
     }
 
+    /// @brief write_columns into memory.
+    /// @param format As for write_columns. There is no default: no file name to infer it from.
+    /// @param columns As for write_columns.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
+    /// @return The file's bytes.
     inline std::expected<std::vector<uint8_t>, Error> write_columns_to_memory(int32_t format,
                                                                               std::span<const ColumnRef> columns,
                                                                               const WriteOptions *options = nullptr)
@@ -1730,6 +1967,13 @@ namespace xl
     }
 
 
+    /// @brief Encrypts a finished XLSX or XLSB.
+    ///
+    /// The encryption parameters are fixed at Excel's own defaults; the result opens in Excel, and in
+    /// Workbook::open given the same password.
+    /// @param package_path The plaintext package. Read twice, so it must already be a finished file.
+    /// @param destination_path Where to write the encrypted file.
+    /// @param password The password, as UTF-8.
     inline std::expected<void, Error> encrypt_package(std::string_view package_path,
                                                        std::string_view destination_path,
                                                        std::string_view password)
@@ -1997,7 +2241,12 @@ namespace xl
 
     } 
 
-    // NOTE for write_sheet_to_memory below: this body is intentionally NOT factored into a shared
+    /// @brief Writes rows as one sheet.
+    /// @param path File to create.
+    /// @param format As for write_columns.
+    /// @param rows Input range of a row type with an ExcelMapper, the mapping parse_sheet reads with.
+    /// An empty std::optional field writes a blank cell.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
     template <std::ranges::input_range R>
     std::expected<void, Error> write_sheet(std::string_view path, int32_t format, R &&rows,
                                            const WriteOptions *options = nullptr)
@@ -2022,10 +2271,15 @@ namespace xl
                                          "a string column exceeds 2 GiB, which int32 offsets cannot address."});
         }
 
+        // refs borrows pointers into builders, so both must stay in the scope of the write call.
         const std::array<ColumnRef, field_count> refs = detail::to_refs(builders, bindings, indices);
         return write_columns(path, format, refs, options);
     }
 
+    /// @brief write_sheet with the format taken from the file's extension.
+    /// @param path File to create; its extension picks the format.
+    /// @param rows As for the overload that takes a format.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
     template <std::ranges::input_range R>
     std::expected<void, Error> write_sheet(std::string_view path, R &&rows,
                                            const WriteOptions *options = nullptr)
@@ -2033,7 +2287,11 @@ namespace xl
         return write_sheet(path, format_from_path(path), std::forward<R>(rows), options);
     }
 
-    // In-memory equivalent of write_sheet: same transpose (see the NOTE on write_sheet above for why
+    /// @brief write_sheet into memory.
+    /// @param format As for write_columns. There is no default: no file name to infer it from.
+    /// @param rows As for write_sheet.
+    /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
+    /// @return The file's bytes.
     template <std::ranges::input_range R>
     std::expected<std::vector<uint8_t>, Error> write_sheet_to_memory(int32_t format, R &&rows,
                                                                      const WriteOptions *options = nullptr)
@@ -2058,11 +2316,17 @@ namespace xl
                                          "a string column exceeds 2 GiB, which int32 offsets cannot address."});
         }
 
+        // refs borrows pointers into builders, so both must stay in the scope of the write call.
         const std::array<ColumnRef, field_count> refs = detail::to_refs(builders, bindings, indices);
         return write_columns_to_memory(format, refs, options);
     }
 
 
+    /// @brief Writes a workbook as calls arrive instead of building it in memory first.
+    ///
+    /// Per sheet: start_sheet, then for each row start_row, one write per cell from left to right, and
+    /// end_row; then end_sheet. A call out of order returns an error rather than corrupting the
+    /// output. Closed on destruction.
     class WriterHandle
     {
     public:
@@ -2082,6 +2346,10 @@ namespace xl
 
         ~WriterHandle() { close(); }
 
+        /// @brief Creates a file to write into.
+        /// @param path File to create.
+        /// @param format An `XL_FORMAT_*` constant other than `XL_FORMAT_AUTO`.
+        /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
         static std::expected<WriterHandle, Error> open(std::string_view path, int32_t format,
                                                        const WriteOptions *options = nullptr)
         {
@@ -2102,6 +2370,9 @@ namespace xl
             return WriterHandle(handle);
         }
 
+        /// @brief Writes into memory instead of a file; read the result with bytes().
+        /// @param format An `XL_FORMAT_*` constant other than `XL_FORMAT_AUTO`.
+        /// @param options Sheet name, CSV dialect and format toggles, or null for the defaults.
         static std::expected<WriterHandle, Error> open_memory(int32_t format,
                                                               const WriteOptions *options = nullptr)
         {
@@ -2120,18 +2391,25 @@ namespace xl
             return WriterHandle(handle);
         }
 
+        /// @brief Starts a sheet.
+        /// @param name The sheet's name.
         std::expected<void, Error> start_sheet(std::string_view name)
         {
             return status_result(xl_start_sheet(handle_, reinterpret_cast<const uint8_t *>(name.data()),
                                                 static_cast<int32_t>(name.size())));
         }
 
+        /// @brief Starts a row.
         std::expected<void, Error> start_row() { return status_result(xl_start_row(handle_)); }
 
+        /// @brief Ends the current row.
         std::expected<void, Error> end_row() { return status_result(xl_end_row(handle_)); }
 
+        /// @brief Ends the current sheet.
         std::expected<void, Error> end_sheet() { return status_result(xl_end_sheet(handle_)); }
 
+        /// @brief Writes the next cell.
+        /// @param value Any type XlType covers; an empty std::optional writes a blank cell.
         template <typename T>
         std::expected<void, Error> write(const T &value)
         {
@@ -2192,8 +2470,14 @@ namespace xl
             }
         }
 
+        /// @brief Writes a blank cell.
+        /// @param type The column's `XL_T_*` constant.
         std::expected<void, Error> write_null(int32_t type) { return status_result(xl_write_null(handle_, type)); }
 
+        /// @brief Everything written so far, for a handle from open_memory.
+        ///
+        /// Finishes the workbook's trailing structure but leaves the handle open.
+        /// @return The file's bytes.
         std::expected<std::vector<uint8_t>, Error> bytes()
         {
             xl_buffer buffer{};
@@ -2210,6 +2494,8 @@ namespace xl
             return std::vector<uint8_t>(buffer.data, buffer.data + buffer.len);
         }
 
+        /// @brief The native handle, for calling the C ABI directly.
+        /// @return The handle, still owned by this object.
         xl_writer_handle *handle() const noexcept { return handle_; }
 
     private:
@@ -2237,7 +2523,9 @@ namespace xl
     };
 
 
-    /// A fold over CSV records. `Acc` must be move-constructible; the wrapper returns the surviving
+    /// @brief A fold over CSV records.
+    ///
+    /// `Acc` must be move-constructible; the wrapper returns the surviving
     /// accumulator by moving out of it. `combine` must fold `next` into `*this` without destroying
     /// it - the library owns `next`'s lifetime and frees it afterwards.
     ///
@@ -2254,6 +2542,7 @@ namespace xl
     /// All callbacks must be noexcept in effect: an exception escaping into the library is undefined
     /// behavior, so this wrapper catches everything and reports it as an error. See
     /// `excelreader.h`'s `xl_csv_aggregate_file` contract.
+    /// @tparam Acc The accumulator type.
     template <typename Acc>
     concept CsvAccumulator =
         std::move_constructible<Acc> && requires(Acc acc, Acc &next, RowView row) {
@@ -2391,7 +2680,7 @@ namespace xl
         }
     }
 
-    /// Folds the CSV file at `path` into one `Acc` across several threads.
+    /// @brief Folds the CSV file at `path` into one `Acc` across several threads.
     ///
     /// `seed` is called at least once per partition, on worker threads, and may be called again for
     /// a partition that has to be re-read - a seeded accumulator can therefore be destroyed without
@@ -2402,6 +2691,11 @@ namespace xl
     /// instead of hard-erroring inside a shim. The `remove_cvref_t` is load-bearing - `Seed` deduces
     /// to an lvalue reference for a named callable, and `const Seed &` would collapse the `const`
     /// away.
+    /// @tparam Acc The accumulator; see CsvAccumulator.
+    /// @param path CSV file to read.
+    /// @param seed Makes a fresh `Acc` for a partition.
+    /// @param options Threads, header row and CSV dialect, or null for the defaults.
+    /// @return The combined accumulator.
     template <CsvAccumulator Acc, typename Seed>
         requires std::invocable<const std::remove_cvref_t<Seed> &>
     std::expected<Acc, Error> aggregate_csv_file(std::string_view path, Seed &&seed,
@@ -2424,7 +2718,11 @@ namespace xl
         return detail::csv_finish<Acc, SeedType>(context, status, state);
     }
 
-    /// Folds the CSV file at `path` into one `Acc`, seeding each partition with `Acc()`.
+    /// @brief Folds the CSV file at `path` into one `Acc`, seeding each partition with `Acc()`.
+    /// @tparam Acc The accumulator; see CsvAccumulator.
+    /// @param path CSV file to read.
+    /// @param options Threads, header row and CSV dialect, or null for the defaults.
+    /// @return The combined accumulator.
     template <CsvAccumulator Acc>
         requires std::default_initializable<Acc>
     std::expected<Acc, Error> aggregate_csv_file(std::string_view path,
@@ -2434,8 +2732,14 @@ namespace xl
         return aggregate_csv_file<Acc>(path, seed, options);
     }
 
-    /// Folds an in-memory CSV buffer into one `Acc`. The buffer is not copied and must stay valid
-    /// for the duration of the call. Otherwise identical to `aggregate_csv_file`.
+    /// @brief Folds an in-memory CSV buffer into one `Acc`.
+    ///
+    /// Otherwise identical to aggregate_csv_file.
+    /// @tparam Acc The accumulator; see CsvAccumulator.
+    /// @param data The CSV bytes. Not copied, so they must stay valid for the call.
+    /// @param seed As for aggregate_csv_file.
+    /// @param options Threads, header row and CSV dialect, or null for the defaults.
+    /// @return The combined accumulator.
     template <CsvAccumulator Acc, typename Seed>
         requires std::invocable<const std::remove_cvref_t<Seed> &>
     std::expected<Acc, Error> aggregate_csv_memory(std::span<const uint8_t> data, Seed &&seed,
@@ -2457,7 +2761,11 @@ namespace xl
         return detail::csv_finish<Acc, SeedType>(context, status, state);
     }
 
-    /// Folds an in-memory CSV buffer into one `Acc`, seeding each partition with `Acc()`.
+    /// @brief Folds an in-memory CSV buffer into one `Acc`, seeding each partition with `Acc()`.
+    /// @tparam Acc The accumulator; see CsvAccumulator.
+    /// @param data The CSV bytes. Not copied, so they must stay valid for the call.
+    /// @param options Threads, header row and CSV dialect, or null for the defaults.
+    /// @return The combined accumulator.
     template <CsvAccumulator Acc>
         requires std::default_initializable<Acc>
     std::expected<Acc, Error> aggregate_csv_memory(std::span<const uint8_t> data,
diff --git a/src/ExcelReader.Native/include/excelreader_arrow.hpp b/src/ExcelReader.Native/include/excelreader_arrow.hpp
index e3017143..2a124184 100644
--- a/src/ExcelReader.Native/include/excelreader_arrow.hpp
+++ b/src/ExcelReader.Native/include/excelreader_arrow.hpp
@@ -16,10 +16,13 @@
 
 namespace xl
 {
+    /// @brief A sheet exported through the Arrow C Data Interface: one struct array and its schema.
+    ///
+    /// Releases both on destruction; move them out to hand them to an Arrow library.
     struct ArrowTable
     {
-        ArrowArray array{};
-        ArrowSchema schema{};
+        ArrowArray array{};   ///< One struct array holding every column.
+        ArrowSchema schema{}; ///< The struct type of `array`.
 
         ArrowTable() = default;
 
@@ -45,6 +48,7 @@ namespace xl
 
         ~ArrowTable() { release(); }
 
+        /// @brief Releases both now. Safe to call again.
         void release() noexcept
         {
             if (array.release != nullptr)
@@ -58,6 +62,11 @@ namespace xl
         }
     };
 
+    /// @brief parse_sheet into Arrow instead of `T`.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
+    /// @param sheet The sheet to read.
+    /// @param header_row As for parse_sheet.
+    /// @param degree_of_parallelism As for parse_sheet.
     template <typename T>
     std::expected<ArrowTable, Error> parse_arrow(Sheet sheet, int32_t header_row = 1,
                                                  int32_t degree_of_parallelism = 1)
@@ -80,6 +89,7 @@ namespace xl
         return result;
     }
 
+    /// @brief Owns one ArrowSchema and releases it on destruction.
     struct ArrowSchemaGuard
     {
         ArrowSchema schema{};
@@ -115,6 +125,7 @@ namespace xl
         }
     };
 
+    /// @brief Owns one ArrowArray and releases it on destruction.
     struct ArrowArrayGuard
     {
         ArrowArray array{};
@@ -150,6 +161,9 @@ namespace xl
         }
     };
 
+    /// @brief typed_reader's Arrow counterpart: record batches pulled one at a time.
+    ///
+    /// Use from one thread at a time.
     class ArrowStream
     {
     public:
@@ -173,6 +187,7 @@ namespace xl
 
         ~ArrowStream() { release(); }
 
+        /// @brief The schema every batch shares.
         std::expected<ArrowSchemaGuard, Error> schema()
         {
             if (stream_.release == nullptr)
@@ -188,6 +203,8 @@ namespace xl
             return guard;
         }
 
+        /// @brief Reads the next batch.
+        /// @return The batch, or empty at the end of the sheet.
         std::expected<std::optional<ArrowArrayGuard>, Error> next()
         {
             if (stream_.release == nullptr)
@@ -207,6 +224,8 @@ namespace xl
             return std::optional<ArrowArrayGuard>(std::move(guard));
         }
 
+        /// @brief Takes ownership of a stream produced by the C ABI.
+        /// @param stream Stream from `xl_parse_arrow_stream`, released by this object.
         static ArrowStream from_raw(ArrowArrayStream stream) { return ArrowStream(stream); }
 
     private:
@@ -234,6 +253,11 @@ namespace xl
         ArrowArrayStream stream_{};
     };
 
+    /// @brief Opens an ArrowStream over a sheet.
+    /// @tparam T Row type, mapped by `ExcelMapper<T>`.
+    /// @param sheet The sheet to read.
+    /// @param header_row As for parse_sheet.
+    /// @param batch_size As for typed_reader.
     template <typename T>
     std::expected<ArrowStream, Error> arrow_stream(Sheet sheet, int32_t header_row = 1,
                                                    int64_t batch_size = 10000)

From 0911fdb28f1fa58de879b0fb56d872e8898d7725 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:36:53 -0300
Subject: [PATCH 108/115] ci(docs): fail on Doxygen warnings and build the docs
 on pull requests

The C++ generator runs Doxygen with WARN_NO_PARAMDOC, WARN_IF_INCOMPLETE_DOC and
FAIL_ON_WARNINGS, so an @param that no longer matches its signature fails the
build. The workflow also runs on pull requests, building without publishing,
and uses a per-ref concurrency group so a pull request run cannot cancel a
publish.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .github/workflows/docs.yml  | 12 +++++++++---
 cpp/scripts/api_markdown.py |  9 +++++++--
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a6d6a36f..3863db23 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -3,7 +3,7 @@ name: Docs -> GitHub Pages
 on:
   push:
     branches: [master]
-    paths:
+    paths: &docs-paths
       - 'src/ExcelReader.Core/**'
       - 'src/ExcelReader.Arrow/**'
       - 'src/ExcelReader.Native/include/**'
@@ -15,17 +15,21 @@ on:
       - 'docfx.json'
       - 'assets/**'
       - '.github/workflows/docs.yml'
+  # Builds without publishing, so a broken page or a Doxygen @param that no longer matches its
+  # signature fails the pull request instead of the next publish.
+  pull_request:
+    paths: *docs-paths
   workflow_dispatch:
 
 concurrency:
-  group: docs-pages
+  group: docs-${{ github.ref }}
   cancel-in-progress: true
 
 permissions:
   contents: write
 
 jobs:
-  publish:
+  docs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
@@ -38,6 +42,7 @@ jobs:
       - name: Build Python API reference
         run: python3 python/scripts/api_markdown.py
 
+      # Fails on any Doxygen documentation warning, such as an @param naming no parameter.
       - name: Build C++ API reference
         run: |
           sudo apt-get update
@@ -52,6 +57,7 @@ jobs:
       # keep_files leaves dev/bench (benchmark-pages.yml) in place; pages removed from the docs
       # stay on the branch until deleted by hand.
       - name: Publish to gh-pages
+        if: github.event_name != 'pull_request'
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/cpp/scripts/api_markdown.py b/cpp/scripts/api_markdown.py
index 34daabb4..f5ac9f37 100644
--- a/cpp/scripts/api_markdown.py
+++ b/cpp/scripts/api_markdown.py
@@ -30,10 +30,15 @@ def run_doxygen(output: Path) -> Path:
             "EXTRACT_ALL = YES",
             "EXCLUDE_SYMBOLS = xl::detail*",
             "QUIET = YES",
-            "WARNINGS = NO",
+            "WARN_IF_UNDOCUMENTED = NO",
+            "WARN_IF_DOC_ERROR = YES",
+            "WARN_IF_INCOMPLETE_DOC = YES",
+            "WARN_NO_PARAMDOC = YES",
+            "WARN_AS_ERROR = FAIL_ON_WARNINGS",
         ]
     )
-    subprocess.run(["doxygen", "-"], input=config, text=True, cwd=REPO_ROOT, check=True)
+    if subprocess.run(["doxygen", "-"], input=config, text=True, cwd=REPO_ROOT).returncode != 0:
+        raise SystemExit("Doxygen reported documentation problems in the headers; see its warnings above.")
     return output / "xml"
 
 

From 58a279bbf79bb9f93e0956cfa44cc437c4a1434f Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 19:46:26 -0300
Subject: [PATCH 109/115] Enhance documentation with cross-references and
 clarifications

- Updated error handling section to include cross-references for exceptions.
- Migrating guide updated to include cross-references for new types and methods.
- Migration to v7 guide improved with cross-references for new options and types.
- Parsing guide enhanced with cross-references for interfaces and methods.
- Reading guide updated to include cross-references for workbook and sheet types.
- Writing guide improved with cross-references for options and interfaces.
---
 .github/workflows/docs.yml    |  3 ++-
 docs/guide/csv.md             | 20 ++++++++++----------
 docs/guide/encryption.md      |  6 +++---
 docs/guide/errors.md          |  4 ++--
 docs/guide/migrating-to-v6.md | 14 +++++++-------
 docs/guide/migrating-to-v7.md | 30 +++++++++++++++---------------
 docs/guide/parsing.md         | 18 +++++++++---------
 docs/guide/reading.md         | 30 +++++++++++++++---------------
 docs/guide/writing.md         | 24 ++++++++++++------------
 9 files changed, 75 insertions(+), 74 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3863db23..16476ba7 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -49,10 +49,11 @@ jobs:
           sudo apt-get install --yes --no-install-recommends doxygen
           python3 cpp/scripts/api_markdown.py
 
+      # Fails on a broken page link or an xref naming a member that no longer exists.
       - name: Build site
         run: |
           dotnet tool install --global docfx --version 2.81.0
-          docfx docfx.json
+          docfx docfx.json --warningsAsErrors
 
       # keep_files leaves dev/bench (benchmark-pages.yml) in place; pages removed from the docs
       # stay on the branch until deleted by hand.
diff --git a/docs/guide/csv.md b/docs/guide/csv.md
index 3cea059e..54b0dd49 100644
--- a/docs/guide/csv.md
+++ b/docs/guide/csv.md
@@ -5,7 +5,7 @@ Parallel CSV parsing is covered in [reading.md](reading.md#parallel-reading-opt-
 
 ## Read CSV
 
-`CsvReader` is a workbook with exactly one, unnamed sheet (`csv.FirstSheet`, the same sheet as `csv.Sheets[0]`). It streams RFC 4180 CSV (quoted fields, embedded delimiters/newlines, `""`-escaped quotes) through the same `Row`/`Cell` model as the Excel workbooks, so `ExcelParser<T>` works on it unchanged.
+[`CsvReader`](xref:ExcelReader.Core.Reader.Csv.CsvReader) is a workbook with exactly one, unnamed sheet (`csv.FirstSheet`, the same sheet as `csv.Sheets[0]`). It streams RFC 4180 CSV (quoted fields, embedded delimiters/newlines, `""`-escaped quotes) through the same [`Row`](xref:ExcelReader.Core.Reader.Row)/[`Cell`](xref:ExcelReader.Core.Reader.Cell) model as the Excel workbooks, so [`ExcelParser<T>`](xref:ExcelReader.Core.Parser.ExcelParser%601) works on it unchanged.
 
 ```csharp
 using ExcelReader.Core.Parser;
@@ -25,18 +25,18 @@ foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(csv.FirstShee
 }
 ```
 
-`Excel.FromCsv`/`FromCsvFile`/`FromCsvAsync`/`FromCsvFileAsync` mirror the other formats' factory shape and take the same `ExcelReaderOptions`. Its `Csv` property, a `CsvReaderOptions`, changes the delimiter/quote character, supplies a non-UTF-8 `Encoding` (transcoded to UTF-8 internally), or turns off BOM detection; `MaxCellBytes` and `InternStrings` stay on `ExcelReaderOptions`, as for every format:
+[`Excel.FromCsv`](xref:ExcelReader.Core.Reader.Excel.FromCsv*)/`FromCsvFile`/`FromCsvAsync`/`FromCsvFileAsync` mirror the other formats' factory shape and take the same [`ExcelReaderOptions`](xref:ExcelReader.Core.Reader.ExcelReaderOptions). Its `Csv` property, a [`CsvReaderOptions`](xref:ExcelReader.Core.Reader.Csv.CsvReaderOptions), changes the delimiter/quote character, supplies a non-UTF-8 `Encoding` (transcoded to UTF-8 internally), or turns off BOM detection; `MaxCellBytes` and `InternStrings` stay on `ExcelReaderOptions`, as for every format:
 
 ```csharp
 var options = new ExcelReaderOptions { Csv = new CsvReaderOptions { Delimiter = (byte)';' } };
 using var csv = Excel.FromCsvFile("relatorio.csv", options);
 ```
 
-Every CSV cell is text (`CellType.ExcelString`, or `CellType.Empty` for a blank field); at the reader level there is no binary numeric or date representation, so `Cell.TryGetDateTime`/`IsDate1904` (always `false` for CSV) do not apply. The typed parser, however, is CSV-specialized: `ExcelParser<T>.Parse(CsvSheet)` parses `DateTime`/`DateOnly` columns directly from the cell text (ISO or culture format, honoring `Culture` — e.g. pt-BR `02/07/2026`), so no `[ExcelConverter]` is needed for dates. All the usual attributes work unchanged (`[ExcelColumn]` aliases, `[ExcelRequired]`, `[ExcelConverter]`), and a converter still takes precedence over the built-in date parsing. (Holding the sheet as an `IExcelSheet` instead routes through the generic Excel pipeline, where dates use serial-number semantics — prefer the concrete `Parse(CsvSheet)` overload for CSV.)
+Every CSV cell is text ([`CellType.ExcelString`](xref:ExcelReader.Core.Reader.CellType.ExcelString), or [`CellType.Empty`](xref:ExcelReader.Core.Reader.CellType.Empty) for a blank field); at the reader level there is no binary numeric or date representation, so [`Cell.TryGetDateTime`](xref:ExcelReader.Core.Reader.Cell.TryGetDateTime*)/`IsDate1904` (always `false` for CSV) do not apply. The typed parser, however, is CSV-specialized: `ExcelParser<T>.Parse(CsvSheet)` parses `DateTime`/`DateOnly` columns directly from the cell text (ISO or culture format, honoring `Culture` — e.g. pt-BR `02/07/2026`), so no `[ExcelConverter]` is needed for dates. All the usual attributes work unchanged (`[ExcelColumn]` aliases, `[ExcelRequired]`, `[ExcelConverter]`), and a converter still takes precedence over the built-in date parsing. (Holding the sheet as an [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) instead routes through the generic Excel pipeline, where dates use serial-number semantics — prefer the concrete `Parse(CsvSheet)` overload for CSV.)
 
 A `CsvReader` over memory, a file path or a seekable stream allows several enumerators at once, each reading the sheet from the start. Over a seekable stream, every enumerator starts at the position the stream had when the `CsvReader` was created; where the stream's position ends up afterwards is unspecified, so do not rely on it (a file stream, and a memory stream with an exposed buffer, are read without touching it). A non-seekable stream can be read once: a second enumeration throws `InvalidOperationException`.
 
-`Excel.Open`/`OpenAsync` do **not** auto-detect CSV — plain text has no magic-byte signature to sniff. Name the format instead: every `Open`/`OpenAsync` overload takes an optional `ExcelFileFormat`, and `ExcelReaderOptions.Csv` carries the dialect, so a caller that decides the format from an extension or a content-type header configures both families through one options object:
+[`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*)/`OpenAsync` do **not** auto-detect CSV — plain text has no magic-byte signature to sniff. Name the format instead: every `Open`/`OpenAsync` overload takes an optional [`ExcelFileFormat`](xref:ExcelReader.Core.Reader.ExcelFileFormat), and [`ExcelReaderOptions.Csv`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.Csv) carries the dialect, so a caller that decides the format from an extension or a content-type header configures both families through one options object:
 
 ```csharp
 ExcelFileFormat format = Path.GetExtension(path) is ".csv" ? ExcelFileFormat.Csv : ExcelFileFormat.Unknown;
@@ -48,11 +48,11 @@ using IExcelWorkbook workbook = Excel.Open(path, format, new ExcelReaderOptions
 });
 ```
 
-`ExcelFileFormat.Unknown` keeps the signature-based detection the no-format overloads do; `EncryptedOoxml` is a detection result rather than something to open, so passing it throws `ArgumentOutOfRangeException`.
+[`ExcelFileFormat.Unknown`](xref:ExcelReader.Core.Reader.ExcelFileFormat.Unknown) keeps the signature-based detection the no-format overloads do; `EncryptedOoxml` is a detection result rather than something to open, so passing it throws `ArgumentOutOfRangeException`.
 
 ## Sniff a CSV dialect
 
-`CsvSniffer.Detect` infers the delimiter, quote character, and encoding (from a leading byte-order mark) from a sample of bytes, so a `;`-separated pt-BR export or a TSV can be read without the caller knowing the dialect up front. It is deterministic (ties break by candidate order) and never throws on arbitrary input — an indecisive sample returns `CsvDialect.Default` (comma, `"`, UTF-8).
+[`CsvSniffer.Detect`](xref:ExcelReader.Core.Reader.Csv.CsvSniffer.Detect*) infers the delimiter, quote character, and encoding (from a leading byte-order mark) from a sample of bytes, so a `;`-separated pt-BR export or a TSV can be read without the caller knowing the dialect up front. It is deterministic (ties break by candidate order) and never throws on arbitrary input — an indecisive sample returns [`CsvDialect.Default`](xref:ExcelReader.Core.Reader.Csv.CsvDialect.Default) (comma, `"`, UTF-8).
 
 ```csharp
 using ExcelReader.Core.Reader;
@@ -62,9 +62,9 @@ CsvDialect dialect = CsvSniffer.DetectFile("export.csv");
 using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default.WithDialect(dialect) });
 ```
 
-`CsvSniffer.Detect` takes a span of bytes or a seekable `Stream`, `DetectFile` takes a path, and `DetectAsync`/`DetectFileAsync` are the async siblings; only the first 64 KiB are examined. The `Stream` overloads require a seekable source — they read a bounded sample and restore the stream's position — so a non-seekable stream throws `ArgumentException`; buffer it first, or pass the bytes as a span instead. Pass `CsvSnifferOptions` to change the candidate delimiters/quotes (and their priority order) or the number of sample lines considered.
+`CsvSniffer.Detect` takes a span of bytes or a seekable `Stream`, `DetectFile` takes a path, and `DetectAsync`/`DetectFileAsync` are the async siblings; only the first 64 KiB are examined. The `Stream` overloads require a seekable source — they read a bounded sample and restore the stream's position — so a non-seekable stream throws `ArgumentException`; buffer it first, or pass the bytes as a span instead. Pass [`CsvSnifferOptions`](xref:ExcelReader.Core.Reader.Csv.CsvSnifferOptions) to change the candidate delimiters/quotes (and their priority order) or the number of sample lines considered.
 
-`CsvReaderOptions.SniffDialect` does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, and `Excel.Open` with `ExcelFileFormat.Csv`. The dialect of a parallel read is the one the CSV workbook was opened with:
+[`CsvReaderOptions.SniffDialect`](xref:ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect) does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, and `Excel.Open` with [`ExcelFileFormat.Csv`](xref:ExcelReader.Core.Reader.ExcelFileFormat.Csv). The dialect of a parallel read is the one the CSV workbook was opened with:
 
 ```csharp
 using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
@@ -74,7 +74,7 @@ An explicitly set `Encoding` survives sniffing unless the source carries a byte-
 
 ## Write CSV
 
-`CsvWorkbookWriter` emits RFC 4180 CSV: no styles or shared strings, so rows stream straight to the output. A CSV file is a single sheet, so `AddSheet` is called once (the name is ignored).
+[`CsvWorkbookWriter`](xref:ExcelReader.Core.Writer.Csv.CsvWorkbookWriter) emits RFC 4180 CSV: no styles or shared strings, so rows stream straight to the output. A CSV file is a single sheet, so `AddSheet` is called once (the name is ignored).
 
 ```csharp
 using ExcelReader.Core.Writer;
@@ -101,7 +101,7 @@ using (CsvRowWriter row = writer.StartRow())
 
 Fields are quoted only when they contain the delimiter, quote character, `\r`, or `\n`; embedded quotes are doubled. `bool` writes as lowercase `true`/`false` and `DateTime`/`DateOnly` as round-trip ISO 8601 (`"O"`); `TimeOnly` as a time-of-day fraction — all matching what `ExcelParser<T>.Parse(CsvSheet)` expects, so a file written by `CsvWorkbookWriter` parses back without configuration. `Skip(count)` writes empty fields to keep column positions aligned (CSV has no sparse-cell concept).
 
-`CsvWriterOptions` mirrors `CsvReaderOptions`'s delimiter, quote and encoding, so a file written with one set of settings reads back with the matching set:
+[`CsvWriterOptions`](xref:ExcelReader.Core.Writer.Csv.CsvWriterOptions) mirrors `CsvReaderOptions`'s delimiter, quote and encoding, so a file written with one set of settings reads back with the matching set:
 
 ```csharp
 using var workbook = CsvWorkbookWriter.Create(stream, leaveOpen: false, new CsvWriterOptions
diff --git a/docs/guide/encryption.md b/docs/guide/encryption.md
index d44b17b2..18e38baa 100644
--- a/docs/guide/encryption.md
+++ b/docs/guide/encryption.md
@@ -13,7 +13,7 @@ using IExcelWorkbook workbook = Excel.Open("protected.xlsx", options);
 foreach (Row row in workbook.FirstSheet) { /* ... */ }
 ```
 
-`ExcelEncryptionException.Reason` tells you what to do about a failure — only `PasswordRequired` and
+[`ExcelEncryptionException.Reason`](xref:ExcelReader.Core.Reader.ExcelEncryptionException.Reason) tells you what to do about a failure — only `PasswordRequired` and
 `PasswordIncorrect` are worth re-prompting for:
 
 ```csharp
@@ -37,7 +37,7 @@ different mechanism entirely, stored as hashes in the plaintext XML.
 only the buffers it owns: the derivation buffer and the derived key.
 
 **The `dataIntegrity` HMAC is not verified by default when reading from a stream.**
-`ExcelReaderOptions.VerifyEncryptedIntegrity` defaults to `false`, because the HMAC covers the whole
+[`ExcelReaderOptions.VerifyEncryptedIntegrity`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.VerifyEncryptedIntegrity) defaults to `false`, because the HMAC covers the whole
 encrypted package: checking it means a full pass over the file before the first row, which makes
 time-to-first-row proportional to file size and defeats streaming. With it off, decryption still
 fails loudly on corrupt ciphertext (the plaintext stops being a valid ZIP), but *targeted* tampering
@@ -61,7 +61,7 @@ that, reading is ~10% slower than reading the same workbook unencrypted — see
 [Encrypted workbooks](../performance/benchmarks.md#encrypted-workbooks) in the benchmarks.
 
 Writing an encrypted workbook is a second step: build the package with any writer, then wrap it with
-`Excel.EncryptPackage`, which produces an agile-encrypted (ECMA-376 4.4) CFB container — AES-256-CBC,
+[`Excel.EncryptPackage`](xref:ExcelReader.Core.Reader.Excel.EncryptPackage*), which produces an agile-encrypted (ECMA-376 4.4) CFB container — AES-256-CBC,
 SHA-512, 100,000 spin iterations, with a `dataIntegrity` HMAC.
 
 ```csharp
diff --git a/docs/guide/errors.md b/docs/guide/errors.md
index 58afe6fd..ff6fd667 100644
--- a/docs/guide/errors.md
+++ b/docs/guide/errors.md
@@ -24,12 +24,12 @@ for the calling thread.
 
 | Failure | C# | Status | Python | Rust | C++ |
 |---|---|---|---|---|---|
-| Encrypted, no password | `ExcelEncryptionException`, `Reason == PasswordRequired` | -6 | `PasswordRequiredError` | `Error::PasswordRequired` | `xl::Error`, `code == XL_STATUS_PASSWORD_REQUIRED` |
+| Encrypted, no password | [`ExcelEncryptionException`](xref:ExcelReader.Core.Reader.ExcelEncryptionException), `Reason == PasswordRequired` | -6 | `PasswordRequiredError` | `Error::PasswordRequired` | `xl::Error`, `code == XL_STATUS_PASSWORD_REQUIRED` |
 | Wrong password | `ExcelEncryptionException`, `Reason == PasswordIncorrect` | -7 | `PasswordIncorrectError` | `Error::PasswordIncorrect` | `xl::Error`, `code == XL_STATUS_PASSWORD_INCORRECT` |
 | Unsupported encryption, or failed integrity check | `ExcelEncryptionException`, `Reason` is `UnsupportedScheme` or `IntegrityFailure` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
 | Corrupt or malformed file | `InvalidDataException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
 | Feature the reader does not support | `NotSupportedException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
-| File exceeds a configured resource limit | `ExcelLimitExceededException` | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
+| File exceeds a configured resource limit | [`ExcelLimitExceededException`](xref:ExcelReader.Core.Reader.ExcelLimitExceededException) | -5 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_ERROR` |
 | Workbook already closed | `ObjectDisposedException` | -3 | `ExcelReaderError` | `Error::Native` | `xl::Error`, `code == XL_INVALID_HANDLE` |
 | Invalid argument | `ArgumentException` and its subclasses | -4, or -5 when the check happens past the ABI boundary | `ExcelReaderError` | `Error::Native` | `xl::Error` |
 
diff --git a/docs/guide/migrating-to-v6.md b/docs/guide/migrating-to-v6.md
index ca58d48e..3c368bb5 100644
--- a/docs/guide/migrating-to-v6.md
+++ b/docs/guide/migrating-to-v6.md
@@ -11,12 +11,12 @@ A v5 reader owned one "current sheet" that you moved with `MoveToSheet`; in v6 t
 
 | v5 | v6 |
 |---|---|
-| `XlsxReader`, `XlsbReader`, `XlsReader` | `XlsxWorkbook`, `XlsbWorkbook`, `XlsWorkbook` |
-| `XlsxReader.Enumerator` (and the other two) | `XlsxWorkbook.Enumerator` (and `XlsbWorkbook.Enumerator`, `XlsWorkbook.Enumerator`) |
-| `IExcelRowReader` | `IExcelWorkbook` and `IExcelSheet` |
-| `IExcelRowReader<TEnumerator>` | `IExcelSheet<TEnumerator>` |
-| `ExcelSheet`, `reader.Sheets()` | `XlsxSheet` / `XlsbSheet` / `XlsSheet` / `CsvSheet`, `workbook.Sheets` |
-| `CsvReader` | `CsvReader` (same name; now a workbook with one sheet) |
+| `XlsxReader`, `XlsbReader`, `XlsReader` | [`XlsxWorkbook`](xref:ExcelReader.Core.Reader.Xlsx.XlsxWorkbook), [`XlsbWorkbook`](xref:ExcelReader.Core.Reader.Xlsb.XlsbWorkbook), [`XlsWorkbook`](xref:ExcelReader.Core.Reader.Xls.XlsWorkbook) |
+| `XlsxReader.Enumerator` (and the other two) | [`XlsxWorkbook.Enumerator`](xref:ExcelReader.Core.Reader.Xlsx.XlsxWorkbook.Enumerator) (and [`XlsbWorkbook.Enumerator`](xref:ExcelReader.Core.Reader.Xlsb.XlsbWorkbook.Enumerator), [`XlsWorkbook.Enumerator`](xref:ExcelReader.Core.Reader.Xls.XlsWorkbook.Enumerator)) |
+| `IExcelRowReader` | [`IExcelWorkbook`](xref:ExcelReader.Core.Reader.IExcelWorkbook) and [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) |
+| `IExcelRowReader<TEnumerator>` | [`IExcelSheet<TEnumerator>`](xref:ExcelReader.Core.Reader.IExcelSheet%601) |
+| `ExcelSheet`, `reader.Sheets()` | [`XlsxSheet`](xref:ExcelReader.Core.Reader.Xlsx.XlsxSheet) / [`XlsbSheet`](xref:ExcelReader.Core.Reader.Xlsb.XlsbSheet) / [`XlsSheet`](xref:ExcelReader.Core.Reader.Xls.XlsSheet) / [`CsvSheet`](xref:ExcelReader.Core.Reader.Csv.CsvSheet), `workbook.Sheets` |
+| [`CsvReader`](xref:ExcelReader.Core.Reader.Csv.CsvReader) | `CsvReader` (same name; now a workbook with one sheet) |
 
 An explicit `ExcelEnumerable<T, XlsReader, XlsReader.Enumerator>` declaration becomes `ExcelEnumerable<T, XlsSheet, XlsWorkbook.Enumerator>` (likewise for XLSX and XLSB).
 
@@ -88,7 +88,7 @@ for (int i = 0; i < workbook.SheetCount; i++)
 }
 ```
 
-When you open a format directly (`Excel.FromXlsxFile` and the like), `workbook.Sheets` is a typed list: `foreach (XlsxSheet sheet in workbook.Sheets)` walks every sheet without boxing.
+When you open a format directly ([`Excel.FromXlsxFile`](xref:ExcelReader.Core.Reader.Excel.FromXlsxFile*) and the like), `workbook.Sheets` is a typed list: `foreach (XlsxSheet sheet in workbook.Sheets)` walks every sheet without boxing.
 
 v5's `ExcelSheet` had a positional `Deconstruct`, so `foreach (var (i, name) in reader.Sheets())` worked. The v6 sheets do not deconstruct; read the properties instead:
 
diff --git a/docs/guide/migrating-to-v7.md b/docs/guide/migrating-to-v7.md
index 1f4e5c09..1a73bf9d 100644
--- a/docs/guide/migrating-to-v7.md
+++ b/docs/guide/migrating-to-v7.md
@@ -5,18 +5,18 @@ See also [reading.md](reading.md#parallel-reading-opt-in) for the full guide.
 
 ## What changed
 
-Parallel reading now takes a sheet, and it works on XLSX and XLSB as well as CSV. `CsvParallel` is gone: its eighteen path, memory and stream methods became six `SheetParallel` methods that take any `IExcelSheet`. You open the workbook yourself, pass its sheet, and the library parallelises as far as the format allows. The contract types lost their `Csv` prefix because they now serve every format.
+Parallel reading now takes a sheet, and it works on XLSX and XLSB as well as CSV. `CsvParallel` is gone: its eighteen path, memory and stream methods became six [`SheetParallel`](xref:ExcelReader.Core.Reader.SheetParallel) methods that take any [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet). You open the workbook yourself, pass its sheet, and the library parallelises as far as the format allows. The contract types lost their `Csv` prefix because they now serve every format.
 
 ## Types
 
 | v6 | v7 |
 |---|---|
 | `CsvParallel` | `SheetParallel` |
-| `CsvParallelOptions` | `SheetParallelOptions` (no `Reader` property) |
-| `ICsvRecord<TSelf>` | `IRowRecord<TSelf>` |
-| `ICsvAccumulator<TSelf, TModel>` | `IRowAccumulator<TSelf, TModel>` |
-| `CsvAggregation<TState>` | `RowAggregation<TState>` |
-| `CsvRowAction<TState>` | `RowAction<TState>` |
+| `CsvParallelOptions` | [`SheetParallelOptions`](xref:ExcelReader.Core.Reader.SheetParallelOptions) (no `Reader` property) |
+| `ICsvRecord<TSelf>` | [`IRowRecord<TSelf>`](xref:ExcelReader.Core.Reader.IRowRecord%601) |
+| `ICsvAccumulator<TSelf, TModel>` | [`IRowAccumulator<TSelf, TModel>`](xref:ExcelReader.Core.Reader.IRowAccumulator%602) |
+| `CsvAggregation<TState>` | [`RowAggregation<TState>`](xref:ExcelReader.Core.Reader.RowAggregation%601) |
+| `CsvRowAction<TState>` | [`RowAction<TState>`](xref:ExcelReader.Core.Reader.RowAction%601) |
 
 The old names are removed, with no `[Obsolete]` forwarders. Members, contracts and results are unchanged.
 
@@ -86,9 +86,9 @@ await foreach (Sale s in SheetParallel.ParseAsync(workbook.FirstSheet, parser, n
 ## Behavior changes
 
 - The caller owns the workbook and keeps it open until the task completes or the enumeration ends. v6 opened and closed its own source.
-- The CSV dialect is given when the workbook is opened (`ExcelReaderOptions.Csv`), not in the parallel options.
-- A CSV in a `MemoryStream` is no longer partitioned: the stream overload of `Excel.FromCsv` reads it sequentially. Pass the bytes as `ReadOnlyMemory<byte>` to keep partitioning.
-- `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from `ExcelParserOptions.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`; the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+- The CSV dialect is given when the workbook is opened ([`ExcelReaderOptions.Csv`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.Csv)), not in the parallel options.
+- A CSV in a `MemoryStream` is no longer partitioned: the stream overload of [`Excel.FromCsv`](xref:ExcelReader.Core.Reader.Excel.FromCsv*) reads it sequentially. Pass the bytes as `ReadOnlyMemory<byte>` to keep partitioning.
+- `HeaderRow` rules are the same as v6. `ParseAsync` takes the header from [`ExcelParserOptions.HeaderRow`](xref:ExcelReader.Core.Parser.ExcelParserOptions.HeaderRow) and rejects a non-zero [`SheetParallelOptions.HeaderRow`](xref:ExcelReader.Core.Reader.SheetParallelOptions.HeaderRow); the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
 - XLSX and XLSB sheets are now read on several threads when `DegreeOfParallelism` allows it. XLS, a table view (`ExcelTable.AsSheet()`), a sheet under 256 KB uncompressed and a CSV that cannot be partitioned still read sequentially with the same results.
 - `PrefetchDecompression` does not apply to a parallel XLSX or XLSB read; the pipeline already overlaps inflate and parse.
 
@@ -98,7 +98,7 @@ These changes replace positional parameters and loose arguments with types that
 
 | v6 | v7 |
 |---|---|
-| `ExcelParserConfig` | `ExcelParserOptions`; the `ExcelParser` factories' parameter is `options` |
+| `ExcelParserConfig` | [`ExcelParserOptions`](xref:ExcelReader.Core.Parser.ExcelParserOptions); the [`ExcelParser`](xref:ExcelReader.Core.Parser.ExcelParser) factories' parameter is `options` |
 | `IExcelCellConverter<T>.TryConvert(in Cell, bool isDate1904, IFormatProvider provider, out T)` | `TryConvert(in Cell, in ExcelRowContext context, out T)` |
 | `ExcelCellReader<T>`, `ExcelRowParser<T>`, `ExcelCellReaders.*`: `(…, bool isDate1904, IFormatProvider provider, …)` | `(…, in ExcelRowContext context, …)` |
 | `Excel.InferSchema(sheet, headerRow, sampleSize, parseText)` returning `ExcelColumnSchema[]` | `Excel.InferSchema(sheet, new SchemaInferenceOptions { HeaderRow = …, SampleSize = …, ParseText = … })` returning `IReadOnlyList<ExcelColumnSchema>` |
@@ -107,9 +107,9 @@ These changes replace positional parameters and loose arguments with types that
 | `WriteRecordBatch(batch, sheetName, writeHeader)` and the async form | `WriteRecordBatch(batch, new ArrowWriteOptions { SheetName = …, WriteHeader = … })` |
 | `XlsWorkbookWriter.Create(stream, leaveOpen, date1904)` | `XlsWorkbookWriter.Create(stream, leaveOpen, new XlsWriterOptions { Date1904 = … })` |
 | `Excel.FromCsv*(…, CsvReaderOptions options)` | `Excel.FromCsv*(…, new ExcelReaderOptions { Csv = options })` |
-| `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | `ExcelReaderOptions.MaxCellBytes`, `ExcelReaderOptions.InternStrings` |
+| `CsvReaderOptions.MaxCellBytes`, `CsvReaderOptions.InternStrings` | [`ExcelReaderOptions.MaxCellBytes`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.MaxCellBytes), [`ExcelReaderOptions.InternStrings`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.InternStrings) |
 | `CellType.Formula` | Removed. A formula cell reports its cached result's type: `Number`, `Date`, `ExcelString`, `Boolean` or `Error` |
-| `ExcelDataReader` (its name collided with Sylvan.Data.Excel and the ExcelDataReader package) | `SheetDataReader` |
+| `ExcelDataReader` (its name collided with Sylvan.Data.Excel and the ExcelDataReader package) | [`SheetDataReader`](xref:ExcelReader.Core.Reader.SheetDataReader) |
 | `Cell.TryGetDateTime(out DateTime)`, which silently assumed the 1900 date system | `Cell.TryGetDateTime(workbook.IsDate1904, out DateTime)` |
 
 A converter reads the date system and culture from the context:
@@ -128,10 +128,10 @@ To unit-test a converter, build the context with an initializer: `new ExcelRowCo
 
 Two behavior changes come with them:
 
-- `Excel.Open` with `ExcelFileFormat.Csv` now applies `ExcelReaderOptions.MaxCellBytes` and `InternStrings`. v6 ignored both and used the CSV defaults.
+- [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*) with [`ExcelFileFormat.Csv`](xref:ExcelReader.Core.Reader.ExcelFileFormat.Csv) now applies `ExcelReaderOptions.MaxCellBytes` and `InternStrings`. v6 ignored both and used the CSV defaults.
 - Formula cells are typed by their cached result in every format. v6 reported an XLSX text result and an XLS numeric result as `Formula`, so an XLS formula with a date style lost its `Date` type, and XLSB never used `Formula`.
 - The CLI `convert` command no longer shifts dates by four years when the source workbook uses the 1904 date system.
-- `XlsxWriterOptions` gains `Date1904`, which v6 lacked. It defaults to `false`, so existing output is unchanged.
+- [`XlsxWriterOptions`](xref:ExcelReader.Core.Writer.Xlsx.XlsxWriterOptions) gains `Date1904`, which v6 lacked. It defaults to `false`, so existing output is unchanged.
 
 ## Native bindings
 
@@ -141,4 +141,4 @@ The C ABI is unchanged: no signature moved, and `XL_ABI_VERSION` stays 6. Behavi
 
 `xl_write_options.date1904` now applies to XLSX as well as XLSB and XLS; v6 ignored it for XLSX.
 
-`xl_csv_aggregate` keeps its signature. Inside, it opens a `CsvReader` with the dialect from the native struct and calls `SheetParallel`.
+`xl_csv_aggregate` keeps its signature. Inside, it opens a [`CsvReader`](xref:ExcelReader.Core.Reader.Csv.CsvReader) with the dialect from the native struct and calls `SheetParallel`.
diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index e30137ca..5a1179e5 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -31,7 +31,7 @@ foreach (var item in parser.Parse(workbook.FirstSheet))
 
 Built-in property types: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, and `enum`s (matched by member name or numeric value). Each also works as a `Nullable<T>`. Empty cells leave the property at its default; an unparseable cell is skipped (keeps the default) unless the column is required. `T` needs no parameterless-constructor constraint, so models with `required` members are supported, through both `FromAttributes` and the source generator. `required` alone does not make a column mandatory; that is what `[ExcelRequired]` does.
 
-`Parse` also accepts the `IExcelSheet` of the `IExcelWorkbook` from `Excel.Open`, so you can parse without knowing the concrete format:
+`Parse` also accepts the [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) of the [`IExcelWorkbook`](xref:ExcelReader.Core.Reader.IExcelWorkbook) from [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*), so you can parse without knowing the concrete format:
 
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("changes.xlsx"); // or .xlsb / .xls
@@ -40,7 +40,7 @@ foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(workbook.Firs
 
 ## Generate typed maps at compile time (Native AOT / trimming)
 
-`ExcelParser.FromAttributes<T>` and `ExcelRecordLayout.FromAttributes<T>` reflect over `T` (`GetProperties`, `MakeGenericMethod`), which trimming can break and Native AOT cannot run at all. The raw `Excel.From*` readers already use no reflection; mark a model `[ExcelSerializable]` to get the same guarantee for the typed layer — a source generator emits a compile-time map from the model's own `[ExcelColumn]`/`[ExcelRequired]`/`[ExcelConverter]`/`[ExcelIgnore]` attributes, and `ExcelParser.Generated<T>`/`ExcelRecordLayout.Generated<T>` read and write through that map instead of reflection:
+[`ExcelParser.FromAttributes<T>`](xref:ExcelReader.Core.Parser.ExcelParser.FromAttributes*) and [`ExcelRecordLayout.FromAttributes<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout.FromAttributes*) reflect over `T` (`GetProperties`, `MakeGenericMethod`), which trimming can break and Native AOT cannot run at all. The raw `Excel.From*` readers already use no reflection; mark a model `[ExcelSerializable]` to get the same guarantee for the typed layer — a source generator emits a compile-time map from the model's own `[ExcelColumn]`/`[ExcelRequired]`/`[ExcelConverter]`/`[ExcelIgnore]` attributes, and [`ExcelParser.Generated<T>`](xref:ExcelReader.Core.Parser.ExcelParser.Generated*)/[`ExcelRecordLayout.Generated<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout.Generated*) read and write through that map instead of reflection:
 
 ```csharp
 using ExcelReader.Core.Parser;
@@ -76,14 +76,14 @@ await using (var sheet = workbook.AddSheet("Changes"))
 Notes:
 
 - `[ExcelSerializable]` requires the model — and every type it's nested inside, if any — to be `partial`; the generator emits into an additional part of the same declaration. A compile error (`EXR001`/`EXR002`) names exactly what to fix.
-- Supported property types match `ExcelParser.FromAttributes<T>`'s: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, `enum`s, and `Nullable<T>` of each — plus `ReadOnlySpan<byte>`, which binds zero-copy through `ExcelCellReaders.Utf8`. The model may be a `ref struct`: mark it `ref partial struct` and the generator emits `IExcelRowMap<T>` on it like any other shape, so `ExcelParser.Generated<T>` and `ExcelParser.Build<T>` read it AOT-clean, as do the map-driven `SheetParallel.ForEachAsync`/`SheetParallel.AggregateAsync` overloads.
+- Supported property types match `ExcelParser.FromAttributes<T>`'s: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `TimeSpan`, `DateTimeOffset`, `Guid`, `char`, every integral and floating type plus `decimal`, `enum`s, and `Nullable<T>` of each — plus `ReadOnlySpan<byte>`, which binds zero-copy through [`ExcelCellReaders.Utf8`](xref:ExcelReader.Core.Parser.ExcelCellReaders.Utf8*). The model may be a `ref struct`: mark it `ref partial struct` and the generator emits [`IExcelRowMap<T>`](xref:ExcelReader.Core.Parser.IExcelRowMap%601) on it like any other shape, so `ExcelParser.Generated<T>` and [`ExcelParser.Build<T>`](xref:ExcelReader.Core.Parser.ExcelParser.Build*) read it AOT-clean, as do the map-driven [`SheetParallel.ForEachAsync`](xref:ExcelReader.Core.Reader.SheetParallel.ForEachAsync*)/[`SheetParallel.AggregateAsync`](xref:ExcelReader.Core.Reader.SheetParallel.AggregateAsync*) overloads.
 - The generator requires a build via `dotnet build`/the .NET SDK. Visual Studio's or `MSBuild.exe`'s .NET Framework host can't load it, so a project built only through those tools won't see generated code — build via the SDK, or fall back to `ExcelParser.FromAttributes<T>`/`ExcelRecordLayout.FromAttributes<T>` for that build path.
-- `ExcelParser.Generated<T>` builds one map per model and reuses it for every reader, including CSV — unlike `ExcelParser.FromAttributes<T>`, which swaps in a text-based date reader specifically for CSV. A `[ExcelSerializable]` model reads `DateTime`/`DateOnly`/`TimeOnly` via `ExcelCellReaders.DateTimeAuto`/`DateOnlyAuto`/`TimeOnlyAuto`: an Excel serial number first, falling back to date/time text when the cell isn't numeric — so a CSV column round-trips through the library's own writer either way. The one edge case this can't distinguish: a CSV cell that's only digits (e.g. an Excel serial number typed as plain text) is always read as a serial number, never as date text.
+- `ExcelParser.Generated<T>` builds one map per model and reuses it for every reader, including CSV — unlike `ExcelParser.FromAttributes<T>`, which swaps in a text-based date reader specifically for CSV. A `[ExcelSerializable]` model reads `DateTime`/`DateOnly`/`TimeOnly` via [`ExcelCellReaders.DateTimeAuto`](xref:ExcelReader.Core.Parser.ExcelCellReaders.DateTimeAuto)/`DateOnlyAuto`/`TimeOnlyAuto`: an Excel serial number first, falling back to date/time text when the cell isn't numeric — so a CSV column round-trips through the library's own writer either way. The one edge case this can't distinguish: a CSV cell that's only digits (e.g. an Excel serial number typed as plain text) is always read as a serial number, never as date text.
 - The attribute-based reflection path keeps working unchanged; `[ExcelSerializable]` is an additive, opt-in alternative for the same model shape, not a replacement.
 
 ## Map columns at runtime (fluent API)
 
-`[ExcelColumn]`/`[ExcelRequired]` fix the mapping at compile time. When the mapping itself is a runtime decision — loaded from a config file, chosen by a user in a UI, or different per input file — build it with `ExcelRowMapBuilder<T>` through `ExcelParser.Build<T>` instead:
+`[ExcelColumn]`/`[ExcelRequired]` fix the mapping at compile time. When the mapping itself is a runtime decision — loaded from a config file, chosen by a user in a UI, or different per input file — build it with [`ExcelRowMapBuilder<T>`](xref:ExcelReader.Core.Parser.ExcelRowMapBuilder%601) through `ExcelParser.Build<T>` instead:
 
 ```csharp
 using ExcelReader.Core.Parser;
@@ -120,7 +120,7 @@ var parser = ExcelParser.Build<ChangeRow>(builder => builder
 
 A builder that uses `PropertyAt` skips the header-row step entirely — the first row is already data. Mixing `PropertyAt` with `Property`/`PropertyNullable`/`Converted` on the same builder throws, since one map can't both wait for a header row and skip it.
 
-`ExcelParser.BuildWithAttributeFallback<T>` merges the builder's bindings with `[ExcelColumn]`/`[ExcelRequired]`-driven ones reflected from `T`: a builder binding replaces every attribute-driven property that shares one of its header names; a property whose header names none of the builder's bindings mention keeps its attribute-driven behavior. Useful for overriding just the one column that's a runtime decision without redeclaring the whole model — reuse one of the property's existing `[ExcelColumn]` names in the builder:
+[`ExcelParser.BuildWithAttributeFallback<T>`](xref:ExcelReader.Core.Parser.ExcelParser.BuildWithAttributeFallback*) merges the builder's bindings with `[ExcelColumn]`/`[ExcelRequired]`-driven ones reflected from `T`: a builder binding replaces every attribute-driven property that shares one of its header names; a property whose header names none of the builder's bindings mention keeps its attribute-driven behavior. Useful for overriding just the one column that's a runtime decision without redeclaring the whole model — reuse one of the property's existing `[ExcelColumn]` names in the builder:
 
 ```csharp
 var parser = ExcelParser.BuildWithAttributeFallback<ChangeRow>(builder => builder
@@ -133,7 +133,7 @@ The match is by header name, not by property identity: configuring a *different*
 
 ## Parser configuration
 
-Pass an `ExcelParserOptions` to control header handling and culture:
+Pass an [`ExcelParserOptions`](xref:ExcelReader.Core.Parser.ExcelParserOptions) to control header handling and culture:
 
 ```csharp
 using System.Globalization;
@@ -150,7 +150,7 @@ var options = new ExcelParserOptions
 var parser = ExcelParser.FromAttributes<ChangeRow>(options);
 ```
 
-`Culture` applies when parsing text-backed numeric/`Guid` cells (XLSX inline and shared strings); binary numeric cells (XLS/XLSB) carry a raw value and ignore it. `HeaderNormalization` flags (`Trim`, `CollapseSpaces`, `RemoveDiacritics`) are applied to both the sheet headers and the property names before matching.
+`Culture` applies when parsing text-backed numeric/`Guid` cells (XLSX inline and shared strings); binary numeric cells (XLS/XLSB) carry a raw value and ignore it. [`HeaderNormalization`](xref:ExcelReader.Core.Parser.HeaderNormalization) flags (`Trim`, `CollapseSpaces`, `RemoveDiacritics`) are applied to both the sheet headers and the property names before matching.
 
 ## Required columns
 
@@ -173,7 +173,7 @@ public sealed class Order
 
 ## Custom converters
 
-For types the built-in parsers do not handle — money strings, custom formats, domain value objects — implement `IExcelCellConverter<T>` and attach it with `[ExcelConverter]`. `T` must be the property's exact type. One instance is created and reused across all rows, so converters must be stateless.
+For types the built-in parsers do not handle — money strings, custom formats, domain value objects — implement [`IExcelCellConverter<T>`](xref:ExcelReader.Core.Parser.IExcelCellConverter%601) and attach it with `[ExcelConverter]`. `T` must be the property's exact type. One instance is created and reused across all rows, so converters must be stateless.
 
 ```csharp
 using System.Globalization;
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index fcd04718..0a45720e 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -26,11 +26,11 @@ foreach (var row in workbook.FirstSheet)
 }
 ```
 
-An opened workbook (`XlsxWorkbook`, `XlsbWorkbook`, `XlsWorkbook`, `CsvReader`) hands out its sheets: `FirstSheet` is the first one, `Sheets[i]` any of them. A sheet holds no resources of its own; iterating it starts a new, independent read. Dispose the workbook, not the sheets.
+An opened workbook ([`XlsxWorkbook`](xref:ExcelReader.Core.Reader.Xlsx.XlsxWorkbook), [`XlsbWorkbook`](xref:ExcelReader.Core.Reader.Xlsb.XlsbWorkbook), [`XlsWorkbook`](xref:ExcelReader.Core.Reader.Xls.XlsWorkbook), [`CsvReader`](xref:ExcelReader.Core.Reader.Csv.CsvReader)) hands out its sheets: `FirstSheet` is the first one, `Sheets[i]` any of them. A sheet holds no resources of its own; iterating it starts a new, independent read. Dispose the workbook, not the sheets.
 
 ### Parallel reading (opt-in)
 
-`SheetParallel` reads one sheet on several threads. It takes any sheet, so it works the same on XLSX, XLSB and CSV:
+[`SheetParallel`](xref:ExcelReader.Core.Reader.SheetParallel) reads one sheet on several threads. It takes any sheet, so it works the same on XLSX, XLSB and CSV:
 
 ```csharp
 using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
@@ -81,7 +81,7 @@ UnitTotal total = await SheetParallel.AggregateAsync<UnitTotal, SaleRow>(
     new SheetParallelOptions { HeaderRow = 1 });
 ```
 
-The same call takes a `RowAggregation<TState>` when you would rather pass delegates than write a type, and an `IRowRecord<TRecord>` type in place of the parser.
+The same call takes a [`RowAggregation<TState>`](xref:ExcelReader.Core.Reader.RowAggregation%601) when you would rather pass delegates than write a type, and an `IRowRecord<TRecord>` type in place of the parser.
 
 A per-row callback:
 
@@ -98,7 +98,7 @@ await SheetParallel.ForEachAsync(
 
 Unlike `ParseAsync`, the callback runs on the worker threads, so records arrive in no particular order and the callback must be safe to call from several threads at once. Spans are valid only for the duration of the call.
 
-`HeaderRow` follows the same rule as before: `ParseAsync` takes the header from the parser's `ExcelParserOptions.HeaderRow` and rejects a non-zero `SheetParallelOptions.HeaderRow`, while the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
+`HeaderRow` follows the same rule as before: `ParseAsync` takes the header from the parser's [`ExcelParserOptions.HeaderRow`](xref:ExcelReader.Core.Parser.ExcelParserOptions.HeaderRow) and rejects a non-zero [`SheetParallelOptions.HeaderRow`](xref:ExcelReader.Core.Reader.SheetParallelOptions.HeaderRow), while the parser-based `ForEachAsync` and `AggregateAsync` use `SheetParallelOptions.HeaderRow`.
 
 #### When it reads sequentially
 
@@ -121,7 +121,7 @@ These cases read on one thread with the same results and no error:
 
 A callback that writes to a database or sends messages must be idempotent on CSV, and on XLSX if the sheet may be malformed, and must also tolerate records that do not exist: deduplicating on a key does not filter those out.
 
-`ExcelParseException.Row` on `ParseAsync` counts the rows emitted so far. On `ForEachAsync` and `AggregateAsync` it is the exact row when the read is sequential and `0` when it was partitioned.
+[`ExcelParseException.Row`](xref:ExcelReader.Core.Parser.ExcelParseException.Row) on `ParseAsync` counts the rows emitted so far. On `ForEachAsync` and `AggregateAsync` it is the exact row when the read is sequential and `0` when it was partitioned.
 
 See the [parallel sheet benchmarks](../performance/benchmarks.md#parallel-sheet-reading) and the [parallel CSV benchmarks](../performance/benchmarks.md#parallel-csv) for what this buys. On a real-data XLSX the sheet stage drops from 29 ms (prefetched, sequential) to about 18 ms, and on XLSB from 16 ms to about 13 ms; the floor is inflate, which runs on one thread. CSV has no such floor: its `AggregateAsync` at dop 16 is ~2.8x faster than the typed path while allocating ~410x less, with zero garbage collections.
 
@@ -141,7 +141,7 @@ using var workbook = Excel.FromXlsxFile("report.xlsx");
 Apache.Arrow.RecordBatch batch = workbook.FirstSheet.ToArrowRecordBatch();
 ```
 
-The schema defaults to `Excel.InferSchema`'s guess; pass one in `new ArrowReadOptions { Schema = ... }` to skip inference, and set `HeaderRow` there (default 1, 0 for none). The whole sheet is materialized into one `RecordBatch` — there is no chunked/streaming variant yet. Inference costs about the same time and ~1.8x the allocation of an explicit schema on the same file. See [Arrow conversion](../performance/benchmarks.md#arrow-conversion) in the benchmarks.
+The schema defaults to [`Excel.InferSchema`](xref:ExcelReader.Core.Reader.Excel.InferSchema*)'s guess; pass one in `new ArrowReadOptions { Schema = ... }` to skip inference, and set `HeaderRow` there (default 1, 0 for none). The whole sheet is materialized into one `RecordBatch` — there is no chunked/streaming variant yet. Inference costs about the same time and ~1.8x the allocation of an explicit schema on the same file. See [Arrow conversion](../performance/benchmarks.md#arrow-conversion) in the benchmarks.
 
 `WriteRecordBatch`/`WriteRecordBatchAsync` are the write-side mirror — one call from a `RecordBatch` to a sheet, for XLSX, XLSB, XLS, and CSV:
 
@@ -158,7 +158,7 @@ Supports string, large string, string view, every integer width (signed and unsi
 
 ## Open by auto-detecting the format
 
-`Excel.Open` picks the workbook type from the file signature (XLSX/XLSB are ZIP packages, XLS is an OLE2 document) and returns an `IExcelWorkbook`. `FirstSheet` gives the first sheet, and a sheet iterates its rows directly, so no pattern-match is needed for basic row iteration.
+[`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*) picks the workbook type from the file signature (XLSX/XLSB are ZIP packages, XLS is an OLE2 document) and returns an [`IExcelWorkbook`](xref:ExcelReader.Core.Reader.IExcelWorkbook). `FirstSheet` gives the first sheet, and a sheet iterates its rows directly, so no pattern-match is needed for basic row iteration.
 
 ```csharp
 using ExcelReader.Core.Reader;
@@ -171,7 +171,7 @@ foreach (var row in workbook.FirstSheet)
 }
 ```
 
-`SheetCount`, `SheetAt(index)` and `TryGetSheet(name)` are on `IExcelWorkbook` itself, so you can walk every sheet without knowing the format. Each `IExcelSheet` carries its own `Index`, `Name` and `Visibility`:
+`SheetCount`, `SheetAt(index)` and `TryGetSheet(name)` are on `IExcelWorkbook` itself, so you can walk every sheet without knowing the format. Each [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) carries its own `Index`, `Name` and `Visibility`:
 
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("report.xlsx");
@@ -199,7 +199,7 @@ if (workbook.TryGetSheet("Totals", out var totals))
 }
 ```
 
-When you open a format directly (`Excel.FromXlsxFile` and the like) the workbook's `Sheets` is a typed, indexable list (`Sheets.Count`, `Sheets[i]`, `foreach`) of `XlsxSheet`, `XlsbSheet` or `XlsSheet` values, so walking it boxes nothing. Reaching a sheet only looks up a name and an index; the file is not read until you iterate the sheet.
+When you open a format directly ([`Excel.FromXlsxFile`](xref:ExcelReader.Core.Reader.Excel.FromXlsxFile*) and the like) the workbook's `Sheets` is a typed, indexable list (`Sheets.Count`, `Sheets[i]`, `foreach`) of [`XlsxSheet`](xref:ExcelReader.Core.Reader.Xlsx.XlsxSheet), [`XlsbSheet`](xref:ExcelReader.Core.Reader.Xlsb.XlsbSheet) or [`XlsSheet`](xref:ExcelReader.Core.Reader.Xls.XlsSheet) values, so walking it boxes nothing. Reaching a sheet only looks up a name and an index; the file is not read until you iterate the sheet.
 
 `Visibility` reports whether a sheet is shown in the workbook's tab bar, read from the format's own encoding of it (XLSX's `state` attribute, XLSB's `BrtBundleSh.hsState`, XLS's `BoundSheet8.hsState`). It is reported, never enforced — a hidden sheet enumerates its rows like any other, so converters and exporters filter on it themselves:
 
@@ -217,13 +217,13 @@ for (int i = 0; i < workbook.SheetCount; i++)
 }
 ```
 
-`ExcelSheetVisibility.VeryHidden` is the state Excel's own unhide dialog does not offer; both it and `Hidden` come back here. A sheet whose format says nothing about its state — or says something no producer agrees on — reads as `Visible`.
+[`ExcelSheetVisibility.VeryHidden`](xref:ExcelReader.Core.ExcelSheetVisibility.VeryHidden) is the state Excel's own unhide dialog does not offer; both it and `Hidden` come back here. A sheet whose format says nothing about its state — or says something no producer agrees on — reads as `Visible`.
 
 CSV is exposed as a single, unnamed sheet (`SheetCount == 1`, `Name == ""`, always `Visible`). Pattern-match to the concrete type only for workbook-specific internals beyond this surface.
 
 `OpenAsync` is the async counterpart. Both require a seekable stream (or a file path) so the signature can be read without consuming the input.
 
-Detection covers the signed formats only. To open a source whose format you already know — including CSV, which has no signature to detect — pass an `ExcelFileFormat` and let `ExcelReaderOptions.Csv` carry the dialect; see [CSV](csv.md#read-csv).
+Detection covers the signed formats only. To open a source whose format you already know — including CSV, which has no signature to detect — pass an [`ExcelFileFormat`](xref:ExcelReader.Core.Reader.ExcelFileFormat) and let [`ExcelReaderOptions.Csv`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.Csv) carry the dialect; see [CSV](csv.md#read-csv).
 
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("report.csv", ExcelFileFormat.Csv);
@@ -250,8 +250,8 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
 - `FirstRow`, `FirstColumn`, `LastRow` and `LastColumn` are zero-based and include the header and totals
   rows; `Ref` is the same range in A1 notation.
 - Column indexes inside `AsSheet()` rows stay those of the sheet: a table starting at column C reports
-  its first cell at index 2. `Excel.InferSchema` keeps those indexes in `ExcelColumnSchema.Index` but
-  lists only the table's columns. `SheetDataReader` ordinals are relative to the table: ordinal 0 is
+  its first cell at index 2. `Excel.InferSchema` keeps those indexes in [`ExcelColumnSchema.Index`](xref:ExcelReader.Core.Reader.Schema.ExcelColumnSchema.Index) but
+  lists only the table's columns. [`SheetDataReader`](xref:ExcelReader.Core.Reader.SheetDataReader) ordinals are relative to the table: ordinal 0 is
   its first column.
 - A table whose header row is turned off (`HeaderRowCount == 0`) still enumerates, but `Parse` throws
   `InvalidOperationException` for every map, and `SheetDataReader` and `InferSchema` throw it when
@@ -299,7 +299,7 @@ await foreach (var row in workbook.FirstSheet)
 }
 ```
 
-`await foreach` binds to the sheet's `GetAsyncEnumerator(CancellationToken ct = default)` by pattern. The call itself does no I/O: opening the sheet part (and, for XLSX, loading shared strings) happens asynchronously on the first `MoveNextAsync`. Because `Row` and `Cell` are `ref struct` types, the current row cannot be held across an `await` inside the loop body: read its cells (or copy the values out) before awaiting anything else.
+`await foreach` binds to the sheet's `GetAsyncEnumerator(CancellationToken ct = default)` by pattern. The call itself does no I/O: opening the sheet part (and, for XLSX, loading shared strings) happens asynchronously on the first `MoveNextAsync`. Because [`Row`](xref:ExcelReader.Core.Reader.Row) and [`Cell`](xref:ExcelReader.Core.Reader.Cell) are `ref struct` types, the current row cannot be held across an `await` inside the loop body: read its cells (or copy the values out) before awaiting anything else.
 
 `await foreach` does not accept `.WithCancellation(ct)`: `Row` being a `ref struct` rules out `IAsyncEnumerable<Row>`, so the loop binds to the pattern rather than the interface. To pass a token, or to `await` while a row is in scope, drive the enumerator manually:
 
@@ -319,7 +319,7 @@ Errors from opening the sheet, such as cancellation or a corrupt part, surface f
 ## Prefetch decompression (XLSX/XLSB)
 
 XLSX and XLSB are ZIP-backed, and inflating a sheet's compressed bytes competes for
-wall-clock time with parsing it. `ExcelReaderOptions.PrefetchDecompression` overlaps the
+wall-clock time with parsing it. [`ExcelReaderOptions.PrefetchDecompression`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.PrefetchDecompression) overlaps the
 two: a background thread inflates ahead while the calling thread parses. It is **opt-in,
 defaults to `false`**, and only affects XLSX/XLSB — XLS and CSV have nothing to
 decompress, so the option is silently ignored for them.
diff --git a/docs/guide/writing.md b/docs/guide/writing.md
index 9ed6793b..8d9e362b 100644
--- a/docs/guide/writing.md
+++ b/docs/guide/writing.md
@@ -41,7 +41,7 @@ await using var workbook = XlsxWorkbookWriter.Create(stream, options: new XlsxWr
 
 ## Hidden sheets
 
-Every `IWorkbookWriter<TSheet>` takes an optional `ExcelSheetVisibility` alongside the sheet name, written to whatever the format uses for it — XLSX's `state` attribute, XLSB's `BrtBundleSh.hsState`, XLS's `BoundSheet8.hsState` — so it reads back through [`IExcelSheet.Visibility`](reading.md#open-by-auto-detecting-the-format):
+Every [`IWorkbookWriter<TSheet>`](xref:ExcelReader.Core.Writer.IWorkbookWriter%601) takes an optional [`ExcelSheetVisibility`](xref:ExcelReader.Core.ExcelSheetVisibility) alongside the sheet name, written to whatever the format uses for it — XLSX's `state` attribute, XLSB's `BrtBundleSh.hsState`, XLS's `BoundSheet8.hsState` — so it reads back through [`IExcelSheet.Visibility`](reading.md#open-by-auto-detecting-the-format):
 
 ```csharp
 using ExcelReader.Core; // ExcelSheetVisibility, shared by the readers and writers
@@ -55,7 +55,7 @@ A workbook whose sheets are *all* hidden is rejected when it is ended (`InvalidO
 
 ## Cell styles on write
 
-Every `IWorkbookWriter<TSheet>` supports column- and row-level styling: a number format (currency, date, percentage), bold, and italic. Register a `CellStyle` once with `AddStyle` and apply its returned index to a column (before the first row) or to a whole row (when starting it):
+Every `IWorkbookWriter<TSheet>` supports column- and row-level styling: a number format (currency, date, percentage), bold, and italic. Register a [`CellStyle`](xref:ExcelReader.Core.Writer.CellStyle) once with `AddStyle` and apply its returned index to a column (before the first row) or to a whole row (when starting it):
 
 ```csharp
 using ExcelReader.Core.Writer;
@@ -90,7 +90,7 @@ Cell-level styling (one specific cell rather than a whole column or row) is out
 
 ## Read and write XLSB workbooks (BIFF12)
 
-Use `Excel.FromXlsbFile`, `Excel.FromXlsb`, `Excel.FromXlsbFileAsync`, or `Excel.FromXlsbAsync` to open XLSB directly. For writing, use `XlsbWorkbookWriter`, `XlsbSheetWriter`, and `XlsbRowWriter`.
+Use [`Excel.FromXlsbFile`](xref:ExcelReader.Core.Reader.Excel.FromXlsbFile*), [`Excel.FromXlsb`](xref:ExcelReader.Core.Reader.Excel.FromXlsb*), [`Excel.FromXlsbFileAsync`](xref:ExcelReader.Core.Reader.Excel.FromXlsbFileAsync*), or [`Excel.FromXlsbAsync`](xref:ExcelReader.Core.Reader.Excel.FromXlsbAsync*) to open XLSB directly. For writing, use [`XlsbWorkbookWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter), [`XlsbSheetWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter), and [`XlsbRowWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbRowWriter).
 
 ```csharp
 using ExcelReader.Core.Writer;
@@ -112,11 +112,11 @@ await using (XlsbSheetWriter sheet = workbook.AddSheet("Summary"))
 await workbook.EndAsync();
 ```
 
-The XLSB writer also defaults to inline string cells. Set `XlsbWriterOptions.UseSharedStrings` to deduplicate repeated text into `sharedStrings.bin`.
+The XLSB writer also defaults to inline string cells. Set [`XlsbWriterOptions.UseSharedStrings`](xref:ExcelReader.Core.Writer.Xlsb.XlsbWriterOptions.UseSharedStrings) to deduplicate repeated text into `sharedStrings.bin`.
 
 ## Write XLS workbooks (BIFF8)
 
-`XlsWorkbookWriter` emits a binary BIFF8 `.xls` file. The sheet and row APIs are synchronous; only the final `EndAsync` (which assembles and flushes the OLE container) is async. BIFF8 is capped at 65,536 rows × 256 columns per sheet.
+[`XlsWorkbookWriter`](xref:ExcelReader.Core.Writer.Xls.XlsWorkbookWriter) emits a binary BIFF8 `.xls` file. The sheet and row APIs are synchronous; only the final `EndAsync` (which assembles and flushes the OLE container) is async. BIFF8 is capped at 65,536 rows × 256 columns per sheet.
 
 ```csharp
 using ExcelReader.Core.Writer;
@@ -147,7 +147,7 @@ await workbook.EndAsync();
 
 ## Write typed records
 
-The low-level writers above give you cell-by-cell control. When you just want to dump a collection of objects to a sheet, `sheet.WriteRecordsAsync(records, layout)` writes a header row followed by one row per record, with the columns coming from an `ExcelRecordLayout<T>`. `ExcelRecordLayout.FromAttributes<T>()` maps each public readable property to a column by reflection. It is an extension on `ISheetWriter<TRow>`, so the same call works on a sheet from any of the writers above — XLSX, XLSB, XLS, and CSV.
+The low-level writers above give you cell-by-cell control. When you just want to dump a collection of objects to a sheet, `sheet.WriteRecordsAsync(records, layout)` writes a header row followed by one row per record, with the columns coming from an [`ExcelRecordLayout<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout%601). `ExcelRecordLayout.FromAttributes<T>()` maps each public readable property to a column by reflection. It is an extension on [`ISheetWriter<TRow>`](xref:ExcelReader.Core.Writer.ISheetWriter%601), so the same call works on a sheet from any of the writers above — XLSX, XLSB, XLS, and CSV.
 
 ```csharp
 using ExcelReader.Core.Writer;
@@ -175,13 +175,13 @@ await using (var sheet = workbook.AddSheet("Sales"))
 }
 ```
 
-Disposing the sheet ends it; add the next sheet after that (a duplicate name throws, ignoring case), so one workbook can hold sheets of different record types. The sheet stays open after `WriteRecordsAsync`, so you can append more rows before disposing it. `CsvWorkbookWriter` is the exception: a CSV file is a single sheet, so a second `AddSheet` throws (the sheet name is ignored). An `IAsyncEnumerable<T>` overload streams records that are produced asynchronously. The written file round-trips straight back through `ExcelParser<T>` because the headers are the property names.
+Disposing the sheet ends it; add the next sheet after that (a duplicate name throws, ignoring case), so one workbook can hold sheets of different record types. The sheet stays open after `WriteRecordsAsync`, so you can append more rows before disposing it. [`CsvWorkbookWriter`](xref:ExcelReader.Core.Writer.Csv.CsvWorkbookWriter) is the exception: a CSV file is a single sheet, so a second `AddSheet` throws (the sheet name is ignored). An `IAsyncEnumerable<T>` overload streams records that are produced asynchronously. The written file round-trips straight back through [`ExcelParser<T>`](xref:ExcelReader.Core.Parser.ExcelParser%601) because the headers are the property names.
 
 Column behavior mirrors the parser attributes:
 
 - **`[ExcelColumn("Header")]`** — use a custom header instead of the property name (the first alias wins).
 - **`[ExcelIgnore]`** — exclude a property from both writing and parsing (for computed/transient members).
-- **`[ExcelConverter(typeof(MyConverter))]`** — if the converter also implements `IExcelCellWriter<T>`, it controls how the value is written, so a custom type round-trips through the same converter it reads with.
+- **`[ExcelConverter(typeof(MyConverter))]`** — if the converter also implements [`IExcelCellWriter<T>`](xref:ExcelReader.Core.Writer.IExcelCellWriter%601), it controls how the value is written, so a custom type round-trips through the same converter it reads with.
 
 `DateTime` and `DateOnly` are written as Excel date serials; `TimeOnly` as a time-of-day fraction. Numeric properties (including `Half`) become number cells; any other type is written as text formatted with the invariant culture — `DateTimeOffset` as ISO 8601 (`"O"`), enums by name — so the file parses back the same whatever the writing machine's culture. `Int128`/`UInt128` stay text because a number cell is a double and would drop their low digits. (`CsvWorkbookWriter` follows the CSV rules instead — see [Write CSV](csv.md#write-csv) — writing `DateTime`/`DateOnly` as ISO text and `TimeOnly` as a time-of-day fraction, all still round-tripping through `ExcelParser<T>`.)
 
@@ -189,10 +189,10 @@ For a model marked `[ExcelSerializable]`, pass `ExcelRecordLayout.Generated<T>()
 
 ## Write an Excel table
 
-The XLSX and XLSB sheet writers implement `ITableSheetWriter<TRow>`. `BeginTable` writes the header row
+The XLSX and XLSB sheet writers implement [`ITableSheetWriter<TRow>`](xref:ExcelReader.Core.Writer.ITableSheetWriter%601). `BeginTable` writes the header row
 and opens a table there; every row written until `EndTable` (or the end of the sheet) belongs to it. The
 file opens in Excel already formatted as a table, with filter buttons and the chosen built-in style, and
-reads back through `IExcelWorkbook.Tables`.
+reads back through [`IExcelWorkbook.Tables`](xref:ExcelReader.Core.Reader.IExcelWorkbook.Tables).
 
 ```csharp
 using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("report.xlsx"));
@@ -214,7 +214,7 @@ For records, `WriteTableAsync` does all three steps with the same layouts as `Wr
 await sheet.WriteTableAsync(sales, "Sales", ExcelRecordLayout.FromAttributes<Sale>());
 ```
 
-- `ExcelTableOptions` sets `FirstColumn`, `StyleName` (a built-in `TableStyleLight1`–`21`,
+- [`ExcelTableOptions`](xref:ExcelReader.Core.Writer.ExcelTableOptions) sets `FirstColumn`, `StyleName` (a built-in `TableStyleLight1`–`21`,
   `TableStyleMedium1`–`28` or `TableStyleDark1`–`11`, or `null` for none; default `TableStyleMedium2`) and
   the banding flags `ShowRowStripes`, `ShowColumnStripes`, `ShowFirstColumn`, `ShowLastColumn`.
 - With `FirstColumn > 0`, rows you write yourself must `Skip(FirstColumn)` to reach the table;
@@ -246,7 +246,7 @@ foreach (var record in records)
 await sheet.EndAsync();
 ```
 
-`XlsbWriterOptions` has the same property. XLS and CSV are uncompressed, so
+[`XlsbWriterOptions`](xref:ExcelReader.Core.Writer.Xlsb.XlsbWriterOptions) has the same property. XLS and CSV are uncompressed, so
 they have nothing to overlap and do not offer it.
 
 Writing a 50,000-row workbook (`WriteBenchmark`, both figures from one run):

From c957491cc036bc212aeb513d9115ea2b55b913ab Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:00:36 -0300
Subject: [PATCH 110/115] Add snippets for CSV reading, writing, and encryption
 examples

- Introduced new snippets for reading and writing CSV files, including options for custom delimiters and encoding.
- Added examples for handling encrypted Excel files, including opening, verifying integrity, and writing encrypted workbooks.
- Created a project file for snippets to ensure they compile against the current API.
- Implemented global using directives for cleaner snippet code.
- Added comprehensive examples for parsing Excel files with attributes, fluent interfaces, and converters.
- Included parallel processing examples for reading large Excel files efficiently.
- Enhanced documentation with detailed snippets for various writing scenarios, including styles, shared strings, and table writing.
- Developed a synchronization script to keep snippets in sync with documentation.
---
 .github/workflows/ci.yml                  |   1 +
 .github/workflows/docs.yml                |   4 +
 CONTRIBUTING.md                           |   8 +
 ExcelReader.slnx                          |   3 +
 docs/guide/csv.md                         |   7 +
 docs/guide/encryption.md                  |   4 +
 docs/guide/parsing.md                     |  15 +-
 docs/guide/reading.md                     |  21 +-
 docs/guide/writing.md                     |  24 +-
 docs/snippets/Csv.cs                      | 158 +++++++++
 docs/snippets/Encryption.cs               |  78 +++++
 docs/snippets/ExcelReader.Snippets.csproj |  20 ++
 docs/snippets/GlobalUsings.cs             |  17 +
 docs/snippets/Parsing.cs                  | 291 ++++++++++++++++
 docs/snippets/Reading.cs                  | 384 ++++++++++++++++++++++
 docs/snippets/Writing.cs                  | 280 ++++++++++++++++
 docs/snippets/sync.py                     |  64 ++++
 17 files changed, 1368 insertions(+), 11 deletions(-)
 create mode 100644 docs/snippets/Csv.cs
 create mode 100644 docs/snippets/Encryption.cs
 create mode 100644 docs/snippets/ExcelReader.Snippets.csproj
 create mode 100644 docs/snippets/GlobalUsings.cs
 create mode 100644 docs/snippets/Parsing.cs
 create mode 100644 docs/snippets/Reading.cs
 create mode 100644 docs/snippets/Writing.cs
 create mode 100644 docs/snippets/sync.py

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1c994a4e..7953c3bf 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -36,6 +36,7 @@ jobs:
             dotnet:
               - 'src/**'
               - 'tests/**'
+              - 'docs/snippets/**'
               - 'Directory.Build.props'
               - 'global.json'
               - 'ExcelReader.slnx'
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 16476ba7..d03d0e1d 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -38,6 +38,10 @@ jobs:
         with:
           global-json-file: global.json
 
+      # The snippets themselves are compiled by ci.yml, which builds the whole solution.
+      - name: Check guide examples match docs/snippets
+        run: python3 docs/snippets/sync.py --check
+
       # Importing excelreader loads the native library lazily, so this needs only the sources.
       - name: Build Python API reference
         run: python3 python/scripts/api_markdown.py
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 888cc58c..82fea814 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -32,6 +32,14 @@ rewrites — see [ARCHITECTURE.md](ARCHITECTURE.md) for the shape of the codebas
   [STYLEGUIDE.md § Untrusted Input](STYLEGUIDE.md#untrusted-input) before touching a parser: every
   length, offset, and size read from the file must be bounded before it drives an allocation.
 
+- **Guide examples compile.** A C# block in `docs/guide` marked `<!-- snippet: name -->` is copied
+  from `#region name` in `docs/snippets`, which builds with the solution. Edit the region, then
+  rewrite the guides; CI fails if they differ:
+
+  ```bash
+  python docs/snippets/sync.py
+  ```
+
 ## Commit messages
 
 Use [Conventional Commits](https://www.conventionalcommits.org/): `type(scope): summary`, imperative
diff --git a/ExcelReader.slnx b/ExcelReader.slnx
index cd54752f..fc0e09fe 100644
--- a/ExcelReader.slnx
+++ b/ExcelReader.slnx
@@ -13,4 +13,7 @@
     <Project Path="tests/ExcelReader.AotSanity/ExcelReader.AotSanity.csproj" />
     <Project Path="tests/ExcelReader.NativePgoTrainer/ExcelReader.NativePgoTrainer.csproj" />
   </Folder>
+  <Folder Name="/docs/">
+    <Project Path="docs/snippets/ExcelReader.Snippets.csproj" />
+  </Folder>
 </Solution>
diff --git a/docs/guide/csv.md b/docs/guide/csv.md
index 54b0dd49..f62ca67d 100644
--- a/docs/guide/csv.md
+++ b/docs/guide/csv.md
@@ -7,6 +7,7 @@ Parallel CSV parsing is covered in [reading.md](reading.md#parallel-reading-opt-
 
 [`CsvReader`](xref:ExcelReader.Core.Reader.Csv.CsvReader) is a workbook with exactly one, unnamed sheet (`csv.FirstSheet`, the same sheet as `csv.Sheets[0]`). It streams RFC 4180 CSV (quoted fields, embedded delimiters/newlines, `""`-escaped quotes) through the same [`Row`](xref:ExcelReader.Core.Reader.Row)/[`Cell`](xref:ExcelReader.Core.Reader.Cell) model as the Excel workbooks, so [`ExcelParser<T>`](xref:ExcelReader.Core.Parser.ExcelParser%601) works on it unchanged.
 
+<!-- snippet: csv-read -->
 ```csharp
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
@@ -27,6 +28,7 @@ foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(csv.FirstShee
 
 [`Excel.FromCsv`](xref:ExcelReader.Core.Reader.Excel.FromCsv*)/`FromCsvFile`/`FromCsvAsync`/`FromCsvFileAsync` mirror the other formats' factory shape and take the same [`ExcelReaderOptions`](xref:ExcelReader.Core.Reader.ExcelReaderOptions). Its `Csv` property, a [`CsvReaderOptions`](xref:ExcelReader.Core.Reader.Csv.CsvReaderOptions), changes the delimiter/quote character, supplies a non-UTF-8 `Encoding` (transcoded to UTF-8 internally), or turns off BOM detection; `MaxCellBytes` and `InternStrings` stay on `ExcelReaderOptions`, as for every format:
 
+<!-- snippet: csv-read-options -->
 ```csharp
 var options = new ExcelReaderOptions { Csv = new CsvReaderOptions { Delimiter = (byte)';' } };
 using var csv = Excel.FromCsvFile("relatorio.csv", options);
@@ -38,6 +40,7 @@ A `CsvReader` over memory, a file path or a seekable stream allows several enume
 
 [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*)/`OpenAsync` do **not** auto-detect CSV — plain text has no magic-byte signature to sniff. Name the format instead: every `Open`/`OpenAsync` overload takes an optional [`ExcelFileFormat`](xref:ExcelReader.Core.Reader.ExcelFileFormat), and [`ExcelReaderOptions.Csv`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.Csv) carries the dialect, so a caller that decides the format from an extension or a content-type header configures both families through one options object:
 
+<!-- snippet: csv-open-by-format -->
 ```csharp
 ExcelFileFormat format = Path.GetExtension(path) is ".csv" ? ExcelFileFormat.Csv : ExcelFileFormat.Unknown;
 
@@ -54,6 +57,7 @@ using IExcelWorkbook workbook = Excel.Open(path, format, new ExcelReaderOptions
 
 [`CsvSniffer.Detect`](xref:ExcelReader.Core.Reader.Csv.CsvSniffer.Detect*) infers the delimiter, quote character, and encoding (from a leading byte-order mark) from a sample of bytes, so a `;`-separated pt-BR export or a TSV can be read without the caller knowing the dialect up front. It is deterministic (ties break by candidate order) and never throws on arbitrary input — an indecisive sample returns [`CsvDialect.Default`](xref:ExcelReader.Core.Reader.Csv.CsvDialect.Default) (comma, `"`, UTF-8).
 
+<!-- snippet: csv-sniff -->
 ```csharp
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Reader.Csv;
@@ -66,6 +70,7 @@ using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = C
 
 [`CsvReaderOptions.SniffDialect`](xref:ExcelReader.Core.Reader.Csv.CsvReaderOptions.SniffDialect) does the sample-then-apply above for you, at the entry point that owns the source — the `Excel.FromCsv*` factories, and `Excel.Open` with [`ExcelFileFormat.Csv`](xref:ExcelReader.Core.Reader.ExcelFileFormat.Csv). The dialect of a parallel read is the one the CSV workbook was opened with:
 
+<!-- snippet: csv-sniff-on-open -->
 ```csharp
 using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
 ```
@@ -76,6 +81,7 @@ An explicitly set `Encoding` survives sniffing unless the source carries a byte-
 
 [`CsvWorkbookWriter`](xref:ExcelReader.Core.Writer.Csv.CsvWorkbookWriter) emits RFC 4180 CSV: no styles or shared strings, so rows stream straight to the output. A CSV file is a single sheet, so `AddSheet` is called once (the name is ignored).
 
+<!-- snippet: csv-write -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Csv;
@@ -103,6 +109,7 @@ Fields are quoted only when they contain the delimiter, quote character, `\r`, o
 
 [`CsvWriterOptions`](xref:ExcelReader.Core.Writer.Csv.CsvWriterOptions) mirrors `CsvReaderOptions`'s delimiter, quote and encoding, so a file written with one set of settings reads back with the matching set:
 
+<!-- snippet: csv-write-options -->
 ```csharp
 using var workbook = CsvWorkbookWriter.Create(stream, leaveOpen: false, new CsvWriterOptions
 {
diff --git a/docs/guide/encryption.md b/docs/guide/encryption.md
index 18e38baa..ad0cf358 100644
--- a/docs/guide/encryption.md
+++ b/docs/guide/encryption.md
@@ -7,6 +7,7 @@ Reading and writing password-protected packages.
 Password-protected `.xlsx`/`.xlsb`/`.xlsm` files open through the same entry points — the password
 goes on the options, so every overload supports it:
 
+<!-- snippet: encryption-open -->
 ```csharp
 var options = new ExcelReaderOptions { Password = "hunter2" };
 using IExcelWorkbook workbook = Excel.Open("protected.xlsx", options);
@@ -16,6 +17,7 @@ foreach (Row row in workbook.FirstSheet) { /* ... */ }
 [`ExcelEncryptionException.Reason`](xref:ExcelReader.Core.Reader.ExcelEncryptionException.Reason) tells you what to do about a failure — only `PasswordRequired` and
 `PasswordIncorrect` are worth re-prompting for:
 
+<!-- snippet: encryption-reason -->
 ```csharp
 try
 {
@@ -44,6 +46,7 @@ fails loudly on corrupt ciphertext (the plaintext stops being a valid ZIP), but
 by someone who can modify the file is not detected. Set it to `true` whenever the workbook comes from
 somewhere you do not control and you care that it was not altered:
 
+<!-- snippet: encryption-verify-integrity -->
 ```csharp
 var options = new ExcelReaderOptions
 {
@@ -64,6 +67,7 @@ Writing an encrypted workbook is a second step: build the package with any write
 [`Excel.EncryptPackage`](xref:ExcelReader.Core.Reader.Excel.EncryptPackage*), which produces an agile-encrypted (ECMA-376 4.4) CFB container — AES-256-CBC,
 SHA-512, 100,000 spin iterations, with a `dataIntegrity` HMAC.
 
+<!-- snippet: encryption-write -->
 ```csharp
 using ExcelReader.Core.Reader;
 using ExcelReader.Core.Writer;
diff --git a/docs/guide/parsing.md b/docs/guide/parsing.md
index 5a1179e5..badfac10 100644
--- a/docs/guide/parsing.md
+++ b/docs/guide/parsing.md
@@ -7,6 +7,7 @@ generator, the fluent API, converters, and the zero-copy `ref struct` path.
 
 `ExcelParser.FromAttributes<T>()` maps worksheet columns to the public settable properties of `T`. Columns match on the property name, or on `[ExcelColumn("header")]` aliases — repeat the attribute to accept several headers. The first row is the header by default.
 
+<!-- snippet: parsing-attributes -->
 ```csharp
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
@@ -33,6 +34,7 @@ Built-in property types: `string`, `bool`, `DateTime`, `DateOnly`, `TimeOnly`, `
 
 `Parse` also accepts the [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) of the [`IExcelWorkbook`](xref:ExcelReader.Core.Reader.IExcelWorkbook) from [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*), so you can parse without knowing the concrete format:
 
+<!-- snippet: parsing-attributes-open -->
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("changes.xlsx"); // or .xlsb / .xls
 foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(workbook.FirstSheet)) { /* ... */ }
@@ -42,6 +44,7 @@ foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(workbook.Firs
 
 [`ExcelParser.FromAttributes<T>`](xref:ExcelReader.Core.Parser.ExcelParser.FromAttributes*) and [`ExcelRecordLayout.FromAttributes<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout.FromAttributes*) reflect over `T` (`GetProperties`, `MakeGenericMethod`), which trimming can break and Native AOT cannot run at all. The raw `Excel.From*` readers already use no reflection; mark a model `[ExcelSerializable]` to get the same guarantee for the typed layer — a source generator emits a compile-time map from the model's own `[ExcelColumn]`/`[ExcelRequired]`/`[ExcelConverter]`/`[ExcelIgnore]` attributes, and [`ExcelParser.Generated<T>`](xref:ExcelReader.Core.Parser.ExcelParser.Generated*)/[`ExcelRecordLayout.Generated<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout.Generated*) read and write through that map instead of reflection:
 
+<!-- snippet: parsing-generated -->
 ```csharp
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
@@ -66,8 +69,8 @@ foreach (var item in ExcelParser.Generated<ChangeRow>().Parse(workbook.FirstShee
 
 var changes = new[] { new ChangeRow { File = "README.md", LinesAdded = 12 } };
 await using var stream = File.Create("changes.xlsx");
-await using var workbook = XlsxWorkbookWriter.Create(stream);   // or XlsbWorkbookWriter / XlsWorkbookWriter / CsvWorkbookWriter
-await using (var sheet = workbook.AddSheet("Changes"))
+await using var writer = XlsxWorkbookWriter.Create(stream);   // or XlsbWorkbookWriter / XlsWorkbookWriter / CsvWorkbookWriter
+await using (var sheet = writer.AddSheet("Changes"))
 {
     await sheet.WriteRecordsAsync(changes, ExcelRecordLayout.Generated<ChangeRow>());
 }
@@ -85,6 +88,7 @@ Notes:
 
 `[ExcelColumn]`/`[ExcelRequired]` fix the mapping at compile time. When the mapping itself is a runtime decision — loaded from a config file, chosen by a user in a UI, or different per input file — build it with [`ExcelRowMapBuilder<T>`](xref:ExcelReader.Core.Parser.ExcelRowMapBuilder%601) through `ExcelParser.Build<T>` instead:
 
+<!-- snippet: parsing-fluent -->
 ```csharp
 using ExcelReader.Core.Parser;
 using ExcelReader.Core.Reader;
@@ -111,6 +115,7 @@ The map is built once, when `Build` is called, from a fresh builder instance —
 
 Bind a fixed column index instead of a header name with `PropertyAt` — for files with no header row at all:
 
+<!-- snippet: parsing-fluent-index -->
 ```csharp
 var parser = ExcelParser.Build<ChangeRow>(builder => builder
     .Factory(() => new ChangeRow())
@@ -122,6 +127,7 @@ A builder that uses `PropertyAt` skips the header-row step entirely — the firs
 
 [`ExcelParser.BuildWithAttributeFallback<T>`](xref:ExcelReader.Core.Parser.ExcelParser.BuildWithAttributeFallback*) merges the builder's bindings with `[ExcelColumn]`/`[ExcelRequired]`-driven ones reflected from `T`: a builder binding replaces every attribute-driven property that shares one of its header names; a property whose header names none of the builder's bindings mention keeps its attribute-driven behavior. Useful for overriding just the one column that's a runtime decision without redeclaring the whole model — reuse one of the property's existing `[ExcelColumn]` names in the builder:
 
+<!-- snippet: parsing-fluent-fallback -->
 ```csharp
 var parser = ExcelParser.BuildWithAttributeFallback<ChangeRow>(builder => builder
     .Property(["file"], ExcelCellReaders.String, (ref ChangeRow r, string v) => r.File = v.ToUpperInvariant()));
@@ -135,6 +141,7 @@ The match is by header name, not by property identity: configuring a *different*
 
 Pass an [`ExcelParserOptions`](xref:ExcelReader.Core.Parser.ExcelParserOptions) to control header handling and culture:
 
+<!-- snippet: parsing-options -->
 ```csharp
 using System.Globalization;
 using ExcelReader.Core.Parser;
@@ -156,6 +163,7 @@ var parser = ExcelParser.FromAttributes<ChangeRow>(options);
 
 Mark a property `[ExcelRequired]` to assert its column exists and carries a value:
 
+<!-- snippet: parsing-required -->
 ```csharp
 public sealed class Order
 {
@@ -175,6 +183,7 @@ public sealed class Order
 
 For types the built-in parsers do not handle — money strings, custom formats, domain value objects — implement [`IExcelCellConverter<T>`](xref:ExcelReader.Core.Parser.IExcelCellConverter%601) and attach it with `[ExcelConverter]`. `T` must be the property's exact type. One instance is created and reused across all rows, so converters must be stateless.
 
+<!-- snippet: parsing-converter -->
 ```csharp
 using System.Globalization;
 using ExcelReader.Core.Parser;
@@ -202,6 +211,7 @@ Return `false` to signal a parse failure (the property keeps its default). Empty
 
 `ExcelParser.FromAttributes<T>` takes a `ref struct` model just as it takes a class or a struct — same attribute-driven column matching (`[ExcelColumn]`, `[ExcelRequired]`, `[ExcelConverter]`), but a `ReadOnlySpan<byte>` property binds directly to the cell's raw bytes instead of allocating a `string`:
 
+<!-- snippet: parsing-ref-struct -->
 ```csharp
 using System.Text;
 using ExcelReader.Core.Parser;
@@ -223,6 +233,7 @@ foreach (ChangeRowRef item in ExcelParser.FromAttributes<ChangeRowRef>().Parse(w
 
 The result of `Parse` supports `await foreach` (add `.WithCancellation(ct)` to pass a token), so a `ref struct` model can be parsed asynchronously — the rows are streamed via `MoveNextAsync` while the model stays a zero-copy `ref struct`:
 
+<!-- snippet: parsing-ref-struct-async -->
 ```csharp
 await using var workbook = await Excel.FromXlsxFileAsync("changes.xlsx");
 
diff --git a/docs/guide/reading.md b/docs/guide/reading.md
index 0a45720e..dcacb011 100644
--- a/docs/guide/reading.md
+++ b/docs/guide/reading.md
@@ -5,6 +5,7 @@ See also [parsing.md](parsing.md) for binding rows to types, and [csv.md](csv.md
 
 ## Read rows
 
+<!-- snippet: reading-read-rows -->
 ```csharp
 using ExcelReader.Core.Reader;
 
@@ -32,6 +33,7 @@ An opened workbook ([`XlsxWorkbook`](xref:ExcelReader.Core.Reader.Xlsx.XlsxWorkb
 
 [`SheetParallel`](xref:ExcelReader.Core.Reader.SheetParallel) reads one sheet on several threads. It takes any sheet, so it works the same on XLSX, XLSB and CSV:
 
+<!-- snippet: reading-parallel-parse -->
 ```csharp
 using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
 
@@ -57,11 +59,12 @@ Both of the next two examples read a `ref struct` model, so text columns stay as
 
 A fold over an XLSX sheet, with one accumulator per partition merged in sheet order:
 
+<!-- snippet: reading-parallel-aggregate -->
 ```csharp
 public ref struct SaleRow
 {
     [ExcelColumn("Region")] public ReadOnlySpan<byte> Region { get; set; }
-    [ExcelColumn("Units")]  public int Units { get; set; }
+    [ExcelColumn("Units")] public int Units { get; set; }
 }
 
 public sealed class UnitTotal : IRowAccumulator<UnitTotal, SaleRow>
@@ -85,6 +88,7 @@ The same call takes a [`RowAggregation<TState>`](xref:ExcelReader.Core.Reader.Ro
 
 A per-row callback:
 
+<!-- snippet: reading-parallel-foreach -->
 ```csharp
 using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
 
@@ -133,6 +137,7 @@ Properties need setters. A get-only property is skipped during binding and silen
 dotnet add package ExcelReader.Arrow
 ```
 
+<!-- snippet: reading-arrow-read -->
 ```csharp
 using ExcelReader.Arrow;
 using ExcelReader.Core.Reader;
@@ -145,6 +150,7 @@ The schema defaults to [`Excel.InferSchema`](xref:ExcelReader.Core.Reader.Excel.
 
 `WriteRecordBatch`/`WriteRecordBatchAsync` are the write-side mirror — one call from a `RecordBatch` to a sheet, for XLSX, XLSB, XLS, and CSV:
 
+<!-- snippet: reading-arrow-write -->
 ```csharp
 using ExcelReader.Arrow;
 using ExcelReader.Core.Writer;
@@ -160,6 +166,7 @@ Supports string, large string, string view, every integer width (signed and unsi
 
 [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*) picks the workbook type from the file signature (XLSX/XLSB are ZIP packages, XLS is an OLE2 document) and returns an [`IExcelWorkbook`](xref:ExcelReader.Core.Reader.IExcelWorkbook). `FirstSheet` gives the first sheet, and a sheet iterates its rows directly, so no pattern-match is needed for basic row iteration.
 
+<!-- snippet: reading-open -->
 ```csharp
 using ExcelReader.Core.Reader;
 
@@ -173,6 +180,7 @@ foreach (var row in workbook.FirstSheet)
 
 `SheetCount`, `SheetAt(index)` and `TryGetSheet(name)` are on `IExcelWorkbook` itself, so you can walk every sheet without knowing the format. Each [`IExcelSheet`](xref:ExcelReader.Core.Reader.IExcelSheet) carries its own `Index`, `Name` and `Visibility`:
 
+<!-- snippet: reading-open-every-sheet -->
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("report.xlsx");
 
@@ -189,6 +197,7 @@ for (int i = 0; i < workbook.SheetCount; i++)
 
 `TryGetSheet` matches a name ignoring case and opens nothing:
 
+<!-- snippet: reading-open-try-get-sheet -->
 ```csharp
 if (workbook.TryGetSheet("Totals", out var totals))
 {
@@ -203,6 +212,7 @@ When you open a format directly ([`Excel.FromXlsxFile`](xref:ExcelReader.Core.Re
 
 `Visibility` reports whether a sheet is shown in the workbook's tab bar, read from the format's own encoding of it (XLSX's `state` attribute, XLSB's `BrtBundleSh.hsState`, XLS's `BoundSheet8.hsState`). It is reported, never enforced — a hidden sheet enumerates its rows like any other, so converters and exporters filter on it themselves:
 
+<!-- snippet: reading-open-visibility -->
 ```csharp
 using ExcelReader.Core; // ExcelSheetVisibility, shared by the readers and writers
 
@@ -225,6 +235,7 @@ CSV is exposed as a single, unnamed sheet (`SheetCount == 1`, `Name == ""`, alwa
 
 Detection covers the signed formats only. To open a source whose format you already know — including CSV, which has no signature to detect — pass an [`ExcelFileFormat`](xref:ExcelReader.Core.Reader.ExcelFileFormat) and let [`ExcelReaderOptions.Csv`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.Csv) carry the dialect; see [CSV](csv.md#read-csv).
 
+<!-- snippet: reading-open-csv -->
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("report.csv", ExcelFileFormat.Csv);
 ```
@@ -236,11 +247,12 @@ and creation, and found by name with `TryGetTable`, ignoring case. XLSX/XLSM and
 and CSV always report none. `AsSheet()` reads only the table: its header row first, then its data rows
 without the totals row, each cut to the table's columns, so it plugs into anything that takes a sheet.
 
+<!-- snippet: reading-table -->
 ```csharp
 using IExcelWorkbook workbook = Excel.Open("sales.xlsx");
 if (workbook.TryGetTable("Sales", out ExcelTable? sales))
 {
-    foreach (SaleRow row in ExcelParser.FromAttributes<SaleRow>().Parse(sales.AsSheet()))
+    foreach (ProductRow row in ExcelParser.FromAttributes<ProductRow>().Parse(sales.AsSheet()))
     {
         Console.WriteLine($"{row.Product}: {row.Qty}");
     }
@@ -263,6 +275,7 @@ if (workbook.TryGetTable("Sales", out ExcelTable? sales))
 
 This is one thread per sheet. To read a single sheet on several threads, see [Parallel reading](#parallel-reading-opt-in). Each sheet of a workbook can be read on its own thread:
 
+<!-- snippet: reading-sheets-in-parallel -->
 ```csharp
 using XlsxWorkbook workbook = Excel.FromXlsxFile(path);
 
@@ -288,6 +301,7 @@ Disposing the workbook closes it to new sheets and enumerators; its file or stre
 
 Every sheet supports `await foreach`. For XLSX files, the async enumerator buffers one row at a time and uses the same row parser as the synchronous enumerator, so sync and async reads stay behaviorally aligned while awaits happen only when more bytes are needed.
 
+<!-- snippet: reading-async -->
 ```csharp
 using ExcelReader.Core.Reader;
 
@@ -303,6 +317,7 @@ await foreach (var row in workbook.FirstSheet)
 
 `await foreach` does not accept `.WithCancellation(ct)`: `Row` being a `ref struct` rules out `IAsyncEnumerable<Row>`, so the loop binds to the pattern rather than the interface. To pass a token, or to `await` while a row is in scope, drive the enumerator manually:
 
+<!-- snippet: reading-async-enumerator -->
 ```csharp
 await using var workbook = await Excel.FromXlsxFileAsync("report.xlsx", ct: cancellationToken);
 await using var rows = workbook.FirstSheet.GetAsyncEnumerator(cancellationToken);
@@ -324,6 +339,7 @@ two: a background thread inflates ahead while the calling thread parses. It is *
 defaults to `false`**, and only affects XLSX/XLSB — XLS and CSV have nothing to
 decompress, so the option is silently ignored for them.
 
+<!-- snippet: reading-prefetch -->
 ```csharp
 var options = new ExcelReaderOptions { PrefetchDecompression = true };
 using var workbook = Excel.FromXlsxFile("report.xlsx", options);
@@ -361,6 +377,7 @@ Writing has the same option, under a different name: see
 
 `SheetDataReader` adapts one `IExcelSheet` to `System.Data.IDataReader`, so it drops straight into `SqlBulkCopy`, `DataTable.Load`, Dapper, or any other ADO.NET consumer:
 
+<!-- snippet: reading-data-reader -->
 ```csharp
 using System.Data;
 using ExcelReader.Core.Reader;
diff --git a/docs/guide/writing.md b/docs/guide/writing.md
index 8d9e362b..650c0236 100644
--- a/docs/guide/writing.md
+++ b/docs/guide/writing.md
@@ -5,6 +5,7 @@ typed records, and prefetch compression. See [csv.md](csv.md) for CSV output.
 
 ## Write XLSX workbooks
 
+<!-- snippet: writing-xlsx -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Xlsx;
@@ -35,6 +36,7 @@ await workbook.EndAsync();
 By default, the XLSX writer emits inline strings to keep memory usage flat while rows stream out.
 If your workbook repeats many strings and smaller files matter more than the extra lookup table, opt in to shared strings:
 
+<!-- snippet: writing-xlsx-shared-strings -->
 ```csharp
 await using var workbook = XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { UseSharedStrings = true });
 ```
@@ -43,12 +45,13 @@ await using var workbook = XlsxWorkbookWriter.Create(stream, options: new XlsxWr
 
 Every [`IWorkbookWriter<TSheet>`](xref:ExcelReader.Core.Writer.IWorkbookWriter%601) takes an optional [`ExcelSheetVisibility`](xref:ExcelReader.Core.ExcelSheetVisibility) alongside the sheet name, written to whatever the format uses for it — XLSX's `state` attribute, XLSB's `BrtBundleSh.hsState`, XLS's `BoundSheet8.hsState` — so it reads back through [`IExcelSheet.Visibility`](reading.md#open-by-auto-detecting-the-format):
 
+<!-- snippet: writing-hidden-sheets -->
 ```csharp
 using ExcelReader.Core; // ExcelSheetVisibility, shared by the readers and writers
 
-await using var data = workbook.AddSheet("Data");                                 // visible
-await using var lookups = workbook.AddSheet("Lookups", ExcelSheetVisibility.Hidden);
-await using var audit = workbook.AddSheet("Audit", ExcelSheetVisibility.VeryHidden); // not in Excel's unhide dialog
+await using (var data = workbook.AddSheet("Data")) { /* rows */ } // visible
+await using (var lookups = workbook.AddSheet("Lookups", ExcelSheetVisibility.Hidden)) { /* rows */ }
+await using (var audit = workbook.AddSheet("Audit", ExcelSheetVisibility.VeryHidden)) { /* rows */ } // not in Excel's unhide dialog
 ```
 
 A workbook whose sheets are *all* hidden is rejected when it is ended (`InvalidOperationException`): the formats allow it, but Excel reports such a file as damaged, so it is caught at write time rather than shipped to a user. CSV accepts the argument and ignores it — delimited text has no tab bar to hide from.
@@ -57,6 +60,7 @@ A workbook whose sheets are *all* hidden is rejected when it is ended (`InvalidO
 
 Every `IWorkbookWriter<TSheet>` supports column- and row-level styling: a number format (currency, date, percentage), bold, and italic. Register a [`CellStyle`](xref:ExcelReader.Core.Writer.CellStyle) once with `AddStyle` and apply its returned index to a column (before the first row) or to a whole row (when starting it):
 
+<!-- snippet: writing-styles -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Xlsx;
@@ -92,6 +96,7 @@ Cell-level styling (one specific cell rather than a whole column or row) is out
 
 Use [`Excel.FromXlsbFile`](xref:ExcelReader.Core.Reader.Excel.FromXlsbFile*), [`Excel.FromXlsb`](xref:ExcelReader.Core.Reader.Excel.FromXlsb*), [`Excel.FromXlsbFileAsync`](xref:ExcelReader.Core.Reader.Excel.FromXlsbFileAsync*), or [`Excel.FromXlsbAsync`](xref:ExcelReader.Core.Reader.Excel.FromXlsbAsync*) to open XLSB directly. For writing, use [`XlsbWorkbookWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbWorkbookWriter), [`XlsbSheetWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbSheetWriter), and [`XlsbRowWriter`](xref:ExcelReader.Core.Writer.Xlsb.XlsbRowWriter).
 
+<!-- snippet: writing-xlsb -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Xlsb;
@@ -118,6 +123,7 @@ The XLSB writer also defaults to inline string cells. Set [`XlsbWriterOptions.Us
 
 [`XlsWorkbookWriter`](xref:ExcelReader.Core.Writer.Xls.XlsWorkbookWriter) emits a binary BIFF8 `.xls` file. The sheet and row APIs are synchronous; only the final `EndAsync` (which assembles and flushes the OLE container) is async. BIFF8 is capped at 65,536 rows × 256 columns per sheet.
 
+<!-- snippet: writing-xls -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Xls;
@@ -149,6 +155,7 @@ await workbook.EndAsync();
 
 The low-level writers above give you cell-by-cell control. When you just want to dump a collection of objects to a sheet, `sheet.WriteRecordsAsync(records, layout)` writes a header row followed by one row per record, with the columns coming from an [`ExcelRecordLayout<T>`](xref:ExcelReader.Core.Writer.ExcelRecordLayout%601). `ExcelRecordLayout.FromAttributes<T>()` maps each public readable property to a column by reflection. It is an extension on [`ISheetWriter<TRow>`](xref:ExcelReader.Core.Writer.ISheetWriter%601), so the same call works on a sheet from any of the writers above — XLSX, XLSB, XLS, and CSV.
 
+<!-- snippet: writing-records -->
 ```csharp
 using ExcelReader.Core.Writer;
 using ExcelReader.Core.Writer.Xlsx;
@@ -194,22 +201,24 @@ and opens a table there; every row written until `EndTable` (or the end of the s
 file opens in Excel already formatted as a table, with filter buttons and the chosen built-in style, and
 reads back through [`IExcelWorkbook.Tables`](xref:ExcelReader.Core.Reader.IExcelWorkbook.Tables).
 
+<!-- snippet: writing-table -->
 ```csharp
 using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("report.xlsx"));
 XlsxSheetWriter sheet = workbook.AddSheet("Report");
-sheet.BeginTable("Sales", ["Product", "Qty", "Price"]);
+sheet.BeginTable("Sales", ["Region", "Units", "Revenue"]);
 foreach (Sale s in sales)
 {
     using XlsxRowWriter row = sheet.StartRow();
-    row.Write(s.Product);
-    row.Write(s.Qty);
-    row.Write(s.Price);
+    row.Write(s.Region);
+    row.Write(s.Units);
+    row.Write(s.Revenue);
 }
 sheet.EndTable();
 ```
 
 For records, `WriteTableAsync` does all three steps with the same layouts as `WriteRecordsAsync`:
 
+<!-- snippet: writing-table-records -->
 ```csharp
 await sheet.WriteTableAsync(sales, "Sales", ExcelRecordLayout.FromAttributes<Sale>());
 ```
@@ -232,6 +241,7 @@ and by default that happens on the calling thread. Set `PrefetchWrite` on the wr
 onto a background thread, so the caller keeps building the next batch of rows while the previous one
 compresses:
 
+<!-- snippet: writing-prefetch -->
 ```csharp
 await using var wb = XlsxWorkbookWriter.Create(stream, leaveOpen: true, options: new XlsxWriterOptions { PrefetchWrite = true });
 XlsxSheetWriter sheet = wb.AddSheet("S1");
diff --git a/docs/snippets/Csv.cs b/docs/snippets/Csv.cs
new file mode 100644
index 00000000..73013dc5
--- /dev/null
+++ b/docs/snippets/Csv.cs
@@ -0,0 +1,158 @@
+namespace Snippets.Csv
+{
+    internal sealed class ChangeRow
+    {
+        [ExcelColumn("file")]
+        public string File { get; set; } = "";
+
+        [ExcelColumn("lines_added")]
+        public int LinesAdded { get; set; }
+    }
+}
+
+namespace Snippets.Csv.Read
+{
+    #region csv-read
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region csv-read
+            using var csv = Excel.FromCsvFile("report.csv");
+
+            foreach (var row in csv.FirstSheet)
+            {
+                Console.WriteLine(row[0].GetString());
+            }
+
+            // Typed parsing works exactly like the Excel workbooks:
+            foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(csv.FirstSheet))
+            {
+                Console.WriteLine($"{item.File}: +{item.LinesAdded}");
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.ReadOptions
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region csv-read-options
+            var options = new ExcelReaderOptions { Csv = new CsvReaderOptions { Delimiter = (byte)';' } };
+            using var csv = Excel.FromCsvFile("relatorio.csv", options);
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.OpenByFormat
+{
+    internal static class Snippet
+    {
+        internal static void Run(string path, string secret)
+        {
+            #region csv-open-by-format
+            ExcelFileFormat format = Path.GetExtension(path) is ".csv" ? ExcelFileFormat.Csv : ExcelFileFormat.Unknown;
+
+            using IExcelWorkbook workbook = Excel.Open(path, format, new ExcelReaderOptions
+            {
+                Password = secret,                                                  // used by the Excel formats
+                Csv = CsvReaderOptions.Default with { SniffDialect = true },        // used by the CSV format
+            });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.Sniff
+{
+    #region csv-sniff
+    using ExcelReader.Core.Reader;
+    using ExcelReader.Core.Reader.Csv;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region csv-sniff
+            CsvDialect dialect = CsvSniffer.DetectFile("export.csv");
+            using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default.WithDialect(dialect) });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.SniffOnOpen
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region csv-sniff-on-open
+            using var csv = Excel.FromCsvFile("export.csv", new ExcelReaderOptions { Csv = CsvReaderOptions.Default with { SniffDialect = true } });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.Write
+{
+    #region csv-write
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Csv;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region csv-write
+            using var stream = File.Create("out.csv");
+            using var workbook = CsvWorkbookWriter.Create(stream);
+            using var writer = workbook.AddSheet("Sheet1");
+
+            using (CsvRowWriter row = writer.StartRow())
+            {
+                row.Write("Name");
+                row.Write("Total");
+                row.Write("Created");
+            }
+
+            using (CsvRowWriter row = writer.StartRow())
+            {
+                row.Write("Q1");
+                row.Write(42);
+                row.Write(DateTime.UtcNow);
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Csv.WriteOptions
+{
+    internal static class Snippet
+    {
+        internal static void Run(Stream stream)
+        {
+            #region csv-write-options
+            using var workbook = CsvWorkbookWriter.Create(stream, leaveOpen: false, new CsvWriterOptions
+            {
+                Delimiter = (byte)';',
+                Encoding = Encoding.Latin1,          // fields are formatted as UTF-8, then transcoded on the way out
+                WriteByteOrderMark = true,           // what makes Excel open a UTF-8 file as UTF-8
+                NewLine = CsvNewLine.LineFeed,       // default is CRLF, as RFC 4180 specifies
+            });
+            #endregion
+        }
+    }
+}
diff --git a/docs/snippets/Encryption.cs b/docs/snippets/Encryption.cs
new file mode 100644
index 00000000..8d7c2fb8
--- /dev/null
+++ b/docs/snippets/Encryption.cs
@@ -0,0 +1,78 @@
+namespace Snippets.Encryption.Open
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region encryption-open
+            var options = new ExcelReaderOptions { Password = "hunter2" };
+            using IExcelWorkbook workbook = Excel.Open("protected.xlsx", options);
+            foreach (Row row in workbook.FirstSheet) { /* ... */ }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Encryption.Reason
+{
+    internal static class Snippet
+    {
+        internal static void Run(string path, ExcelReaderOptions options)
+        {
+            #region encryption-reason
+            try
+            {
+                using IExcelWorkbook workbook = Excel.Open(path, options);
+            }
+            catch (ExcelEncryptionException ex) when (ex.Reason is ExcelEncryptionReason.PasswordIncorrect)
+            {
+                // Ask again. UnsupportedScheme and IntegrityFailure are terminal.
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Encryption.VerifyIntegrity
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region encryption-verify-integrity
+            var options = new ExcelReaderOptions
+            {
+                Password = "hunter2",
+                VerifyEncryptedIntegrity = true, // pay one full pass; reject tampered packages
+            };
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Encryption.Write
+{
+    #region encryption-write
+    using ExcelReader.Core.Reader;
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region encryption-write
+            using var plain = new MemoryStream();
+            await using (var workbook = XlsxWorkbookWriter.Create(plain, leaveOpen: true))
+            {
+                // write sheets and rows as usual
+            }
+            plain.Position = 0;
+
+            using var destination = File.Create("secret.xlsx");
+            await Excel.EncryptPackageAsync(plain, destination, "hunter2");
+            #endregion
+        }
+    }
+}
diff --git a/docs/snippets/ExcelReader.Snippets.csproj b/docs/snippets/ExcelReader.Snippets.csproj
new file mode 100644
index 00000000..306075ec
--- /dev/null
+++ b/docs/snippets/ExcelReader.Snippets.csproj
@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <!-- The C# blocks in docs/guide are copied from the #regions here by sync.py, so a guide example
+       that stops compiling against the current API fails the build instead of going stale. -->
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+    <!-- The examples read like caller code, not like this repo's library code: no ConfigureAwait,
+         literal strings, Console output. The compiler's own warnings still fail the build. -->
+    <RunAnalyzers>false</RunAnalyzers>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\ExcelReader.Core\ExcelReader.Core.csproj" />
+    <ProjectReference Include="..\..\src\ExcelReader.Arrow\ExcelReader.Arrow.csproj" />
+    <ProjectReference Include="..\..\src\ExcelReader.Generator\ExcelReader.Generator.csproj"
+                      OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+  </ItemGroup>
+
+</Project>
diff --git a/docs/snippets/GlobalUsings.cs b/docs/snippets/GlobalUsings.cs
new file mode 100644
index 00000000..2b80db1b
--- /dev/null
+++ b/docs/snippets/GlobalUsings.cs
@@ -0,0 +1,17 @@
+// Most guide blocks are fragments that leave their using directives out; the ones that show them
+// still compile against these, so a missing directive in a block is not caught here.
+global using ExcelReader.Arrow;
+global using ExcelReader.Core;
+global using ExcelReader.Core.Parser;
+global using ExcelReader.Core.Reader;
+global using ExcelReader.Core.Reader.Csv;
+global using ExcelReader.Core.Reader.Schema;
+global using ExcelReader.Core.Reader.Xls;
+global using ExcelReader.Core.Reader.Xlsb;
+global using ExcelReader.Core.Reader.Xlsx;
+global using ExcelReader.Core.Writer;
+global using ExcelReader.Core.Writer.Csv;
+global using ExcelReader.Core.Writer.Xls;
+global using ExcelReader.Core.Writer.Xlsb;
+global using ExcelReader.Core.Writer.Xlsx;
+global using System.Text;
diff --git a/docs/snippets/Parsing.cs b/docs/snippets/Parsing.cs
new file mode 100644
index 00000000..72dc9112
--- /dev/null
+++ b/docs/snippets/Parsing.cs
@@ -0,0 +1,291 @@
+namespace Snippets.Parsing
+{
+    internal sealed class ChangeRow
+    {
+        [ExcelColumn("file")]
+        public string File { get; set; } = "";
+
+        [ExcelColumn("lines_added")]
+        public int LinesAdded { get; set; }
+    }
+
+    internal readonly ref struct ChangeRowRef
+    {
+        public ReadOnlySpan<byte> File { get; init; }
+        public int LinesAdded { get; init; }
+    }
+}
+
+namespace Snippets.Parsing.Attributes
+{
+    #region parsing-attributes
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    #region parsing-attributes
+    public sealed class ChangeRow
+    {
+        [ExcelColumn("file")]
+        public string File { get; set; } = "";
+
+        [ExcelColumn("lines_added")]
+        public int LinesAdded { get; set; }
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-attributes
+            using var workbook = Excel.FromXlsxFile("changes.xlsx");
+            var parser = ExcelParser.FromAttributes<ChangeRow>();
+
+            foreach (var item in parser.Parse(workbook.FirstSheet))
+            {
+                Console.WriteLine($"{item.File}: +{item.LinesAdded}");
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.AttributesOpen
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-attributes-open
+            using IExcelWorkbook workbook = Excel.Open("changes.xlsx"); // or .xlsb / .xls
+            foreach (var item in ExcelParser.FromAttributes<ChangeRow>().Parse(workbook.FirstSheet)) { /* ... */ }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.Generated
+{
+    #region parsing-generated
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    #region parsing-generated
+    [ExcelSerializable]                       // the model must be declared partial
+    public partial class ChangeRow
+    {
+        [ExcelColumn("file")]
+        public string File { get; set; } = "";
+
+        [ExcelColumn("lines_added")]
+        public int LinesAdded { get; set; }
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region parsing-generated
+            using var workbook = Excel.FromXlsxFile("changes.xlsx");
+            foreach (var item in ExcelParser.Generated<ChangeRow>().Parse(workbook.FirstSheet))
+            {
+                Console.WriteLine($"{item.File}: +{item.LinesAdded}");
+            }
+
+            var changes = new[] { new ChangeRow { File = "README.md", LinesAdded = 12 } };
+            await using var stream = File.Create("changes.xlsx");
+            await using var writer = XlsxWorkbookWriter.Create(stream);   // or XlsbWorkbookWriter / XlsWorkbookWriter / CsvWorkbookWriter
+            await using (var sheet = writer.AddSheet("Changes"))
+            {
+                await sheet.WriteRecordsAsync(changes, ExcelRecordLayout.Generated<ChangeRow>());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.Fluent
+{
+    #region parsing-fluent
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    #region parsing-fluent
+    public sealed class ChangeRow
+    {
+        public string File { get; set; } = "";
+        public int LinesAdded { get; set; }
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-fluent
+            var parser = ExcelParser.Build<ChangeRow>(builder => builder
+                .Factory(() => new ChangeRow())
+                .Property(["file"], ExcelCellReaders.String, (ref ChangeRow r, string v) => r.File = v)
+                .Property(["lines_added"], ExcelCellReaders.Parsable, (ref ChangeRow r, int v) => r.LinesAdded = v));
+
+            using var workbook = Excel.FromXlsxFile("changes.xlsx");
+            foreach (var item in parser.Parse(workbook.FirstSheet))
+            {
+                Console.WriteLine($"{item.File}: +{item.LinesAdded}");
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.FluentIndex
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-fluent-index
+            var parser = ExcelParser.Build<ChangeRow>(builder => builder
+                .Factory(() => new ChangeRow())
+                .PropertyAt(0, ExcelCellReaders.String, (ref ChangeRow r, string v) => r.File = v)
+                .PropertyAt(1, ExcelCellReaders.Parsable, (ref ChangeRow r, int v) => r.LinesAdded = v));
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.FluentFallback
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-fluent-fallback
+            var parser = ExcelParser.BuildWithAttributeFallback<ChangeRow>(builder => builder
+                .Property(["file"], ExcelCellReaders.String, (ref ChangeRow r, string v) => r.File = v.ToUpperInvariant()));
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.Options
+{
+    #region parsing-options
+    using System.Globalization;
+    using ExcelReader.Core.Parser;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-options
+            var options = new ExcelParserOptions
+            {
+                HeaderRow = 1,                                   // 1-based row holding the headers
+                ColumnNameComparer = StringComparer.OrdinalIgnoreCase,
+                HeaderNormalization = HeaderNormalization.Trim | HeaderNormalization.CollapseSpaces,
+                Culture = CultureInfo.GetCultureInfo("pt-BR"),   // parse "1.234,56" as 1234.56m
+            };
+
+            var parser = ExcelParser.FromAttributes<ChangeRow>(options);
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.Required
+{
+    #region parsing-required
+    public sealed class Order
+    {
+        [ExcelRequired]
+        public int Id { get; set; }
+
+        [ExcelRequired(AllowEmpty = true)]   // column must exist; blank cells allowed
+        public string? Note { get; set; }
+    }
+    #endregion
+}
+
+namespace Snippets.Parsing.Converter
+{
+    #region parsing-converter
+    using System.Globalization;
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    #region parsing-converter
+    public sealed class BrlMoneyConverter : IExcelCellConverter<decimal>
+    {
+        public bool TryConvert(in Cell cell, in ExcelRowContext context, out decimal value)
+        {
+            string text = cell.GetString().Replace("R$", "", StringComparison.Ordinal).Trim();
+            return decimal.TryParse(text, NumberStyles.Currency, CultureInfo.GetCultureInfo("pt-BR"), out value);
+        }
+    }
+
+    public sealed class Invoice
+    {
+        [ExcelConverter(typeof(BrlMoneyConverter))]
+        public decimal Total { get; set; }
+    }
+    #endregion
+}
+
+namespace Snippets.Parsing.RefStruct
+{
+    #region parsing-ref-struct
+    using System.Text;
+    using ExcelReader.Core.Parser;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    #region parsing-ref-struct
+    public readonly ref struct ChangeRowRef
+    {
+        public ReadOnlySpan<byte> File { get; init; }   // zero-copy — aliases the reader's row buffer
+        public int LinesAdded { get; init; }
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region parsing-ref-struct
+            using var workbook = Excel.FromXlsxFile("changes.xlsx");
+
+            foreach (ChangeRowRef item in ExcelParser.FromAttributes<ChangeRowRef>().Parse(workbook.FirstSheet))
+            {
+                Console.WriteLine($"{Encoding.UTF8.GetString(item.File)}: +{item.LinesAdded}");
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Parsing.RefStructAsync
+{
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region parsing-ref-struct-async
+            await using var workbook = await Excel.FromXlsxFileAsync("changes.xlsx");
+
+            await foreach (ChangeRowRef item in ExcelParser.FromAttributes<ChangeRowRef>().Parse(workbook.FirstSheet))
+            {
+                Console.WriteLine($"{Encoding.UTF8.GetString(item.File)}: +{item.LinesAdded}");
+            }
+            #endregion
+        }
+    }
+}
diff --git a/docs/snippets/Reading.cs b/docs/snippets/Reading.cs
new file mode 100644
index 00000000..fd91e128
--- /dev/null
+++ b/docs/snippets/Reading.cs
@@ -0,0 +1,384 @@
+namespace Snippets.Reading.ReadRows
+{
+    #region reading-read-rows
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-read-rows
+            using var workbook = Excel.FromXlsxFile("report.xlsx");
+
+            foreach (var row in workbook.FirstSheet)
+            {
+                string name = row[0].GetString();
+
+                if (row[1].TryParse(null, out int quantity))
+                {
+                    Console.WriteLine($"{name}: {quantity}");
+                }
+
+                if (row[2].Type == CellType.Date && row[2].TryGetDateTime(workbook.IsDate1904, out var date))
+                {
+                    Console.WriteLine(date);
+                }
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.ParallelParse
+{
+    internal sealed class SalesRow
+    {
+        public decimal Revenue { get; set; }
+    }
+
+    internal static class Snippet
+    {
+        private static decimal Total;
+
+        internal static async Task Run()
+        {
+            #region reading-parallel-parse
+            using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
+            await foreach (var row in SheetParallel.ParseAsync(workbook.FirstSheet, ExcelParser.FromAttributes<SalesRow>(), new SheetParallelOptions { DegreeOfParallelism = 8 }))
+            {
+                Total += row.Revenue;
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.ParallelAggregate
+{
+    #region reading-parallel-aggregate
+    public ref struct SaleRow
+    {
+        [ExcelColumn("Region")] public ReadOnlySpan<byte> Region { get; set; }
+        [ExcelColumn("Units")] public int Units { get; set; }
+    }
+
+    public sealed class UnitTotal : IRowAccumulator<UnitTotal, SaleRow>
+    {
+        public long Units;
+
+        public void Add(SaleRow model) => Units += model.Units;
+
+        public void Merge(UnitTotal following) => Units += following.Units;
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region reading-parallel-aggregate
+            using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
+            UnitTotal total = await SheetParallel.AggregateAsync<UnitTotal, SaleRow>(
+                workbook.FirstSheet,
+                ExcelParser.FromAttributes<SaleRow>(),
+                new SheetParallelOptions { HeaderRow = 1 });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.ParallelForeach
+{
+    using Snippets.Reading.ParallelAggregate;
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region reading-parallel-foreach
+            using XlsxWorkbook workbook = Excel.FromXlsxFile("big.xlsx");
+
+            long total = 0;
+            await SheetParallel.ForEachAsync(
+                workbook.FirstSheet,
+                ExcelParser.FromAttributes<SaleRow>(),
+                row => Interlocked.Add(ref total, row.Units),
+                new SheetParallelOptions { DegreeOfParallelism = 8, HeaderRow = 1 });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.ArrowRead
+{
+    #region reading-arrow-read
+    using ExcelReader.Arrow;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-arrow-read
+            using var workbook = Excel.FromXlsxFile("report.xlsx");
+            Apache.Arrow.RecordBatch batch = workbook.FirstSheet.ToArrowRecordBatch();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.ArrowWrite
+{
+    #region reading-arrow-write
+    using ExcelReader.Arrow;
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run(Apache.Arrow.RecordBatch batch)
+        {
+            #region reading-arrow-write
+            using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("report.xlsx"));
+            workbook.WriteRecordBatch(batch); // adds the sheet, writes the header + every row, ends the workbook
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.Open
+{
+    #region reading-open
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-open
+            using IExcelWorkbook workbook = Excel.Open("report.xlsx"); // or report.xlsb / report.xls
+
+            foreach (var row in workbook.FirstSheet)
+            {
+                Console.WriteLine(row[0].GetString());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.OpenEverySheet
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-open-every-sheet
+            using IExcelWorkbook workbook = Excel.Open("report.xlsx");
+
+            for (int i = 0; i < workbook.SheetCount; i++)
+            {
+                IExcelSheet sheet = workbook.SheetAt(i);
+                Console.WriteLine(sheet.Name);
+                foreach (var row in sheet)
+                {
+                    Console.WriteLine(row[0].GetString());
+                }
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.OpenTryGetSheet
+{
+    internal static class Snippet
+    {
+        internal static void Run(IExcelWorkbook workbook)
+        {
+            #region reading-open-try-get-sheet
+            if (workbook.TryGetSheet("Totals", out var totals))
+            {
+                foreach (var row in totals)
+                {
+                    Console.WriteLine(row[0].GetString());
+                }
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.OpenVisibility
+{
+    #region reading-open-visibility
+    using ExcelReader.Core; // ExcelSheetVisibility, shared by the readers and writers
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run(IExcelWorkbook workbook)
+        {
+            #region reading-open-visibility
+            for (int i = 0; i < workbook.SheetCount; i++)
+            {
+                IExcelSheet sheet = workbook.SheetAt(i);
+                if (sheet.Visibility != ExcelSheetVisibility.Visible)
+                {
+                    continue; // skip hidden and veryHidden sheets
+                }
+                Console.WriteLine(sheet.Name);
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.OpenCsv
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-open-csv
+            using IExcelWorkbook workbook = Excel.Open("report.csv", ExcelFileFormat.Csv);
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.Table
+{
+    internal sealed class ProductRow
+    {
+        public string Product { get; set; } = "";
+        public int Qty { get; set; }
+    }
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-table
+            using IExcelWorkbook workbook = Excel.Open("sales.xlsx");
+            if (workbook.TryGetTable("Sales", out ExcelTable? sales))
+            {
+                foreach (ProductRow row in ExcelParser.FromAttributes<ProductRow>().Parse(sales.AsSheet()))
+                {
+                    Console.WriteLine($"{row.Product}: {row.Qty}");
+                }
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.SheetsInParallel
+{
+    internal static class Snippet
+    {
+        internal static void Run(string path)
+        {
+            #region reading-sheets-in-parallel
+            using XlsxWorkbook workbook = Excel.FromXlsxFile(path);
+
+            Parallel.For(0, workbook.Sheets.Count, i =>
+            {
+                foreach (Row row in workbook.Sheets[i])
+                {
+                    // consume
+                }
+            });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.Async
+{
+    #region reading-async
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run(CancellationToken cancellationToken)
+        {
+            #region reading-async
+            await using var workbook = await Excel.FromXlsxFileAsync("report.xlsx", ct: cancellationToken);
+
+            await foreach (var row in workbook.FirstSheet)
+            {
+                Console.WriteLine(row[0].GetString());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.AsyncEnumerator
+{
+    internal static class Snippet
+    {
+        internal static async Task Run(CancellationToken cancellationToken)
+        {
+            #region reading-async-enumerator
+            await using var workbook = await Excel.FromXlsxFileAsync("report.xlsx", ct: cancellationToken);
+            await using var rows = workbook.FirstSheet.GetAsyncEnumerator(cancellationToken);
+
+            while (await rows.MoveNextAsync())
+            {
+                var row = rows.Current;
+                Console.WriteLine(row[0].GetString());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.Prefetch
+{
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-prefetch
+            var options = new ExcelReaderOptions { PrefetchDecompression = true };
+            using var workbook = Excel.FromXlsxFile("report.xlsx", options);
+
+            foreach (var row in workbook.FirstSheet)
+            {
+                Console.WriteLine(row[0].GetString());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Reading.DataReader
+{
+    #region reading-data-reader
+    using System.Data;
+    using ExcelReader.Core.Reader;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static void Run()
+        {
+            #region reading-data-reader
+            using IExcelWorkbook workbook = Excel.Open("report.xlsx");
+            using IDataReader data = new SheetDataReader(workbook.FirstSheet); // header on row 1 by default
+
+            var table = new DataTable();
+            table.Load(data);
+            #endregion
+        }
+    }
+}
diff --git a/docs/snippets/Writing.cs b/docs/snippets/Writing.cs
new file mode 100644
index 00000000..c69772fe
--- /dev/null
+++ b/docs/snippets/Writing.cs
@@ -0,0 +1,280 @@
+namespace Snippets.Writing.Xlsx
+{
+    #region writing-xlsx
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region writing-xlsx
+            await using var stream = File.Create("out.xlsx");
+            await using var workbook = XlsxWorkbookWriter.Create(stream);
+
+            await using (var sheet = workbook.AddSheet("Summary"))
+            {
+                await using (var row = await sheet.StartRowAsync())
+                {
+                    row.Write("Name");
+                    row.Write("Total");
+                    row.Write("Created");
+                }
+
+                await using (var row = await sheet.StartRowAsync())
+                {
+                    row.Write("Q1");
+                    row.Write(42);
+                    row.Write(DateTime.UtcNow);
+                }
+            }
+
+            await workbook.EndAsync();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.XlsxSharedStrings
+{
+    internal static class Snippet
+    {
+        internal static async Task Run(Stream stream)
+        {
+            #region writing-xlsx-shared-strings
+            await using var workbook = XlsxWorkbookWriter.Create(stream, options: new XlsxWriterOptions { UseSharedStrings = true });
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.HiddenSheets
+{
+    #region writing-hidden-sheets
+    using ExcelReader.Core; // ExcelSheetVisibility, shared by the readers and writers
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run(XlsxWorkbookWriter workbook)
+        {
+            #region writing-hidden-sheets
+            await using (var data = workbook.AddSheet("Data")) { /* rows */ } // visible
+            await using (var lookups = workbook.AddSheet("Lookups", ExcelSheetVisibility.Hidden)) { /* rows */ }
+            await using (var audit = workbook.AddSheet("Audit", ExcelSheetVisibility.VeryHidden)) { /* rows */ } // not in Excel's unhide dialog
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Styles
+{
+    #region writing-styles
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run(Stream stream)
+        {
+            #region writing-styles
+            await using var workbook = XlsxWorkbookWriter.Create(stream);
+
+            int currency = workbook.AddStyle(new CellStyle { NumberFormat = "R$ #,##0.00" });
+            int header = workbook.AddStyle(new CellStyle { Bold = true });
+
+            await using var sheet = workbook.AddSheet("Summary");
+            sheet.SetColumnStyle(columnIndex: 1, currency); // before the first row
+            sheet.SetColumnWidth(columnIndex: 0, width: 20);
+
+            await using (var row = await sheet.StartRowAsync(header))
+            {
+                row.Write("Product");
+                row.Write("Total");
+            }
+            await using (var row = await sheet.StartRowAsync())
+            {
+                row.Write("Widget");
+                row.Write(1234.5);
+            }
+
+            await workbook.EndAsync();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Xlsb
+{
+    #region writing-xlsb
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsb;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region writing-xlsb
+            await using var stream = File.Create("out.xlsb");
+            await using var workbook = XlsbWorkbookWriter.Create(stream);
+
+            await using (XlsbSheetWriter sheet = workbook.AddSheet("Summary"))
+            {
+                await using (XlsbRowWriter row = await sheet.StartRowAsync())
+                {
+                    row.Write("Name");
+                    row.Write("Total");
+                    row.Write("Created");
+                }
+            }
+
+            await workbook.EndAsync();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Xls
+{
+    #region writing-xls
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xls;
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region writing-xls
+            await using var stream = File.Create("out.xls");
+            await using var workbook = XlsWorkbookWriter.Create(stream);
+
+            using (var sheet = workbook.AddSheet("Summary"))
+            {
+                using (var row = sheet.StartRow())
+                {
+                    row.Write("Name");
+                    row.Write("Total");
+                    row.Write("Created");
+                }
+
+                using (var row = sheet.StartRow())
+                {
+                    row.Write("Q1");
+                    row.Write(42);
+                    row.Write(DateTime.UtcNow);
+                }
+            }
+
+            await workbook.EndAsync();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Records
+{
+    #region writing-records
+    using ExcelReader.Core.Writer;
+    using ExcelReader.Core.Writer.Xlsx;
+    #endregion
+
+    #region writing-records
+    public sealed class Sale
+    {
+        public string? Region { get; set; }
+        public int Units { get; set; }
+        public decimal Revenue { get; set; }
+        public DateOnly Date { get; set; }
+    }
+    #endregion
+
+    internal static class Snippet
+    {
+        internal static async Task Run()
+        {
+            #region writing-records
+            var sales = new[]
+            {
+                new Sale { Region = "North", Units = 42, Revenue = 1234.50m, Date = new DateOnly(2026, 1, 2) },
+                new Sale { Region = "South", Units = 17, Revenue = 512.00m,  Date = new DateOnly(2026, 1, 3) },
+            };
+
+            await using var stream = File.Create("sales.xlsx");
+            await using var workbook = XlsxWorkbookWriter.Create(stream);   // or XlsbWorkbookWriter / XlsWorkbookWriter / CsvWorkbookWriter
+            await using (var sheet = workbook.AddSheet("Sales"))
+            {
+                await sheet.WriteRecordsAsync(sales, ExcelRecordLayout.FromAttributes<Sale>());
+            }
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Table
+{
+    using Snippets.Writing.Records;
+
+    internal static class Snippet
+    {
+        internal static void Run(Sale[] sales)
+        {
+            #region writing-table
+            using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(File.Create("report.xlsx"));
+            XlsxSheetWriter sheet = workbook.AddSheet("Report");
+            sheet.BeginTable("Sales", ["Region", "Units", "Revenue"]);
+            foreach (Sale s in sales)
+            {
+                using XlsxRowWriter row = sheet.StartRow();
+                row.Write(s.Region);
+                row.Write(s.Units);
+                row.Write(s.Revenue);
+            }
+            sheet.EndTable();
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.TableRecords
+{
+    using Snippets.Writing.Records;
+
+    internal static class Snippet
+    {
+        internal static async Task Run(XlsxSheetWriter sheet, Sale[] sales)
+        {
+            #region writing-table-records
+            await sheet.WriteTableAsync(sales, "Sales", ExcelRecordLayout.FromAttributes<Sale>());
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.Writing.Prefetch
+{
+    internal sealed record Metric(string Name, double Value);
+
+    internal static class Snippet
+    {
+        internal static async Task Run(Stream stream, Metric[] records)
+        {
+            #region writing-prefetch
+            await using var wb = XlsxWorkbookWriter.Create(stream, leaveOpen: true, options: new XlsxWriterOptions { PrefetchWrite = true });
+            XlsxSheetWriter sheet = wb.AddSheet("S1");
+
+            foreach (var record in records)
+            {
+                using XlsxRowWriter row = sheet.StartRow();
+                row.Write(record.Name);
+                row.Write(record.Value);
+            }
+
+            await sheet.EndAsync();
+            #endregion
+        }
+    }
+}
diff --git a/docs/snippets/sync.py b/docs/snippets/sync.py
new file mode 100644
index 00000000..e333a3b8
--- /dev/null
+++ b/docs/snippets/sync.py
@@ -0,0 +1,64 @@
+"""Copies the #regions of docs/snippets/*.cs into the guide code blocks that name them.
+
+A block opts in with `<!-- snippet: name -->` on the line before its fence. Every region of that
+name, in file order, is dedented and joined with a blank line, so a snippet can show its using
+directives and type declarations above statements that have to live inside a method here.
+
+    python docs/snippets/sync.py           rewrite the guides
+    python docs/snippets/sync.py --check   fail if a guide differs from its snippets
+"""
+
+import pathlib
+import re
+import sys
+import textwrap
+
+ROOT = pathlib.Path(__file__).resolve().parent
+GUIDES = ROOT.parent / "guide"
+BLOCK = re.compile(r"^<!-- snippet: (\S+) -->\n```csharp\n.*?^```$", re.MULTILINE | re.DOTALL)
+
+
+def regions():
+    found = {}
+    for path in sorted(ROOT.glob("*.cs")):
+        name, lines = None, []
+        for line in path.read_text(encoding="utf-8").splitlines():
+            directive = line.strip()
+            if directive.startswith("#region "):
+                name, lines = directive.removeprefix("#region ").strip(), []
+            elif directive.startswith("#endregion") and name:
+                found.setdefault(name, []).append(textwrap.dedent("\n".join(lines)).strip("\n"))
+                name = None
+            elif name:
+                lines.append(line)
+    return {name: "\n\n".join(parts) for name, parts in found.items()}
+
+
+def main():
+    check = "--check" in sys.argv[1:]
+    snippets = regions()
+    used, stale = set(), []
+    for guide in sorted(GUIDES.glob("*.md")):
+        text = guide.read_text(encoding="utf-8")
+
+        def fill(match):
+            name = match.group(1)
+            if name not in snippets:
+                sys.exit(f"{guide.name}: no #region {name} in docs/snippets")
+            used.add(name)
+            return f"<!-- snippet: {name} -->\n```csharp\n{snippets[name]}\n```"
+
+        updated = BLOCK.sub(fill, text)
+        if updated != text:
+            stale.append(guide.name)
+            if not check:
+                guide.write_text(updated, encoding="utf-8", newline="\n")
+
+    unused = sorted(snippets.keys() - used)
+    if unused:
+        sys.exit("regions no guide shows: " + ", ".join(unused))
+    if check and stale:
+        sys.exit("out of date with docs/snippets (run python docs/snippets/sync.py): " + ", ".join(stale))
+
+
+main()

From 0fde7132759a834d5e2f60f5e3773549e6971170 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:06:00 -0300
Subject: [PATCH 111/115] ci(docs): build generator project before site
 generation to resolve analyzer issues

---
 .github/workflows/docs.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index d03d0e1d..8aeea115 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -53,9 +53,12 @@ jobs:
           sudo apt-get install --yes --no-install-recommends doxygen
           python3 cpp/scripts/api_markdown.py
 
-      # Fails on a broken page link or an xref naming a member that no longer exists.
+      # Fails on a broken page link or an xref naming a member that no longer exists. Core loads the
+      # generator as an analyzer from its bin/Release output, so it is built first, or docfx warns
+      # FailedToResolveAnalyzer.
       - name: Build site
         run: |
+          dotnet build src/ExcelReader.Generator/ExcelReader.Generator.csproj --configuration Release
           dotnet tool install --global docfx --version 2.81.0
           docfx docfx.json --warningsAsErrors
 

From 53e31e85803e2374ba3d269a3284a11a7aa4a4cd Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:18:56 -0300
Subject: [PATCH 112/115] docs: add guidance for reading untrusted files and
 implement related snippets

---
 README.md                       |   1 +
 docfx.json                      |   7 +-
 docs/404.html                   |  23 ++++++
 docs/README.md                  |   3 +-
 docs/guide/untrusted-input.md   | 138 ++++++++++++++++++++++++++++++++
 docs/snippets/UntrustedInput.cs |  69 ++++++++++++++++
 docs/toc.yml                    |  14 +++-
 7 files changed, 249 insertions(+), 6 deletions(-)
 create mode 100644 docs/404.html
 create mode 100644 docs/guide/untrusted-input.md
 create mode 100644 docs/snippets/UntrustedInput.cs

diff --git a/README.md b/README.md
index 026534bc..1d410915 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,7 @@ foreach (Row row in workbook.FirstSheet)
 - [Writing workbooks](docs/guide/writing.md) — XLSX, XLSB (BIFF12) and XLS (BIFF8) writers, cell styles, typed records, and prefetch compression.
 - [CSV](docs/guide/csv.md) — reading, dialect sniffing, parallel parsing, and writing delimited text.
 - [Encrypted workbooks](docs/guide/encryption.md) — opening password-protected packages and encrypting written ones.
+- [Reading untrusted files](docs/guide/untrusted-input.md) — the resource limits that bound what one hostile file can cost, and how to reject one cleanly.
 - [Migrating to v7](docs/guide/migrating-to-v7.md) — porting `CsvParallel` code to `SheetParallel`, which now reads XLSX and XLSB on several threads too.
 - [Migrating to v6](docs/guide/migrating-to-v6.md) — porting v5 reader code to workbooks and sheets, and reading sheets in parallel.
 - [Benchmarks](docs/performance/benchmarks.md) — throughput and allocation against Sep, Sylvan, OfficeIMO and SpreadCheetah. [Live results](https://gabrielmarquezmatte.github.io/ExcelReader/dev/bench/).
diff --git a/docfx.json b/docfx.json
index df62eea3..5589a580 100644
--- a/docfx.json
+++ b/docfx.json
@@ -34,8 +34,13 @@
       }
     ],
     "resource": [
-      { "files": [ "assets/icon.png", "LICENSE", "src/ExcelReader.Native/include/excelreader.h" ] }
+      { "files": [ "assets/icon.png", "LICENSE", "src/ExcelReader.Native/include/excelreader.h" ] },
+      { "files": [ "404.html" ], "src": "docs" }
     ],
+    "sitemap": {
+      "baseUrl": "https://gabrielmarquezmatte.github.io/ExcelReader/",
+      "changefreq": "weekly"
+    },
     "output": "docs/_site",
     "template": [ "default", "modern", "docs/template" ],
     "globalMetadata": {
diff --git a/docs/404.html b/docs/404.html
new file mode 100644
index 00000000..85ed8539
--- /dev/null
+++ b/docs/404.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<!-- Plain HTML rather than a docfx page: GitHub Pages serves this at whatever path was missing, where
+     the template's relative links to its scripts and styles would not resolve. -->
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Page not found | ExcelReader</title>
+  <style>
+    :root { color-scheme: light dark; }
+    body { font-family: system-ui, sans-serif; max-width: 40rem; margin: 4rem auto; padding: 0 1rem; line-height: 1.5; }
+  </style>
+</head>
+<body>
+  <h1>Page not found</h1>
+  <p>This page does not exist, or it moved when the documentation was reorganized.</p>
+  <ul>
+    <li><a href="/ExcelReader/">Documentation home</a></li>
+    <li><a href="/ExcelReader/api/ExcelReader.Core.Reader.html">API reference</a></li>
+    <li><a href="https://github.com/GabrielMarquezMatte/ExcelReader/issues">Report a broken link</a></li>
+  </ul>
+</body>
+</html>
diff --git a/docs/README.md b/docs/README.md
index dfb01feb..ce2642d9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -44,4 +44,5 @@ invariant) without restating the evidence for it.
   Sep, Sylvan, OfficeIMO and SpreadCheetah.
 - `guide/` — usage documentation: [reading](./guide/reading.md),
   [parsing](./guide/parsing.md), [writing](./guide/writing.md), [csv](./guide/csv.md),
-  [encryption](./guide/encryption.md), [errors](./guide/errors.md).
+  [encryption](./guide/encryption.md), [errors](./guide/errors.md),
+  [untrusted input](./guide/untrusted-input.md).
diff --git a/docs/guide/untrusted-input.md b/docs/guide/untrusted-input.md
new file mode 100644
index 00000000..83a94565
--- /dev/null
+++ b/docs/guide/untrusted-input.md
@@ -0,0 +1,138 @@
+# Reading untrusted files
+
+What one hostile workbook can cost you, which options bound it, and how to reject a file cleanly.
+Read this before you accept spreadsheets from uploads, APIs or mail.
+
+A spreadsheet is a container whose sizes, counts and offsets are written by whoever made the file.
+The readers check every one of those values before it drives an allocation, and the options below
+turn what is left — a file that is well-formed but simply enormous — into an
+[`ExcelLimitExceededException`](xref:ExcelReader.Core.Reader.ExcelLimitExceededException) instead of an out-of-memory crash. The defaults suit
+a desktop tool or a batch job reading files you trust. A server should set its own.
+
+## The limits
+
+All of them live on [`ExcelReaderOptions`](xref:ExcelReader.Core.Reader.ExcelReaderOptions):
+
+| Option | Default | Bounds | Formats |
+|---|---:|---|---|
+| `MaxTotalDecompressedBytes` | 512 MiB | Every byte the workbook inflates or loads from its container: sheets, shared strings, styles, and the decrypted package | XLSX, XLSB, XLS, encrypted |
+| `MaxSharedStringBytes` | 128 MiB | The shared-string table, which is held in memory for the whole read | XLSX, XLSB, XLS |
+| `MaxCellBytes` | 32 MiB | Each buffer that grows to hold one cell value, or one CSV record | all |
+| `MaxZipEntries` | 65,536 | Entries in the ZIP directory | XLSX, XLSB |
+| `MaxPasswordSpinCount` | 100,000 | Key-derivation iterations an agile-encrypted file may ask for | encrypted XLSX, XLSB |
+
+Two limits are fixed by Excel's grid rather than configured: a cell past column XFD (16,384) throws
+with `LimitName == "Columns"`, and no single buffer may exceed .NET's array size
+(`LimitName == "ArrayMaxLength"`).
+
+How they count:
+
+- **`MaxTotalDecompressedBytes` belongs to the opened workbook, not to one read.** Every sheet you
+  read, and every re-read of the same sheet, draws from the same budget. A workbook kept open and
+  read repeatedly will eventually hit it, so open one per job, or size the budget for all the
+  reads you make.
+- **XLS has nothing to inflate, but it is not streamed:** the whole Workbook stream is read into
+  memory, up to `MaxTotalDecompressedBytes`.
+- **CSV has no total limit.** It streams, so the size of what you hand it is the bound; only
+  `MaxCellBytes` applies.
+- **Zero or a negative value turns a byte or entry limit off.** `MaxPasswordSpinCount` has no off
+  switch. In the Python, Rust and C++ bindings and the C ABI, `0` means the default instead, and a
+  limit cannot be turned off.
+- **The limits are per workbook.** Ten uploads read at once can hold ten times the budget.
+
+## A profile for uploads
+
+Size each limit for the largest file you legitimately expect, measured rather than guessed. For a
+service taking spreadsheets of a few MB, something like:
+
+<!-- snippet: untrusted-input-options -->
+```csharp
+var uploadOptions = new ExcelReaderOptions
+{
+    MaxTotalDecompressedBytes = 64L * 1024 * 1024, // everything one workbook may inflate
+    MaxSharedStringBytes = 16L * 1024 * 1024,
+    MaxCellBytes = 1024 * 1024,
+    MaxZipEntries = 1_000,
+};
+```
+
+Cap the upload itself as well, before it reaches the reader: the options bound what the file
+expands to, not how many bytes you accept. [`Excel.Open`](xref:ExcelReader.Core.Reader.Excel.Open*) needs a seekable stream, so
+buffer a request body to a file or to memory first.
+
+Leave [`PrefetchDecompression`](xref:ExcelReader.Core.Reader.ExcelReaderOptions.PrefetchDecompression) off: it adds a thread per read, which a busy server
+cannot spare. For encrypted uploads, set `VerifyEncryptedIntegrity` so a tampered package is
+rejected; see [Encrypted workbooks](encryption.md).
+
+No option bounds wall-clock time. The work a read does grows with the bytes it inflates, which the
+limits bound; for a deadline, use the async entry points and enumerators, which take a
+`CancellationToken`.
+
+## Rejecting a file
+
+A limit can trip when the workbook opens, when you start reading a sheet (XLSX loads its shared
+strings then), or halfway down it. Wrap the whole read, not just the open, and do not commit rows until the read
+has finished:
+
+<!-- snippet: untrusted-input-reject -->
+```csharp
+try
+{
+    using IExcelWorkbook workbook = Excel.Open(upload, options: uploadOptions);
+    foreach (Row row in workbook.FirstSheet)
+    {
+        // stage the row; commit only once the loop has finished
+    }
+}
+catch (ExcelLimitExceededException ex)
+{
+    Console.WriteLine($"Rejected: {ex.LimitName} reached {ex.Actual}, limit {ex.Limit}");
+}
+catch (Exception ex) when (IsRejectedFile(ex))
+{
+    Console.WriteLine($"Rejected: {ex.Message}");
+}
+
+static bool IsRejectedFile(Exception ex) =>
+    ex is InvalidDataException or EndOfStreamException or NotSupportedException
+        or ExcelEncryptionException or ExcelParseException
+    || ex.GetType() == typeof(ArgumentException)
+    || ex.GetType() == typeof(InvalidOperationException);
+```
+
+`LimitName` is the option's name (or `Columns`, `ArrayMaxLength`); `Limit` and `Actual` are in that
+limit's unit — bytes, entries or iterations.
+
+That exception list is exactly what the fuzz suite accepts as a correct rejection of arbitrary
+bytes. Anything else escaping a read of a file — an `IndexOutOfRangeException`, an
+`OutOfMemoryException`, a hang — is a bug; please report it privately as described in
+[SECURITY.md](../../SECURITY.md). See [Errors across languages](errors.md) for how these map onto the
+bindings.
+
+## What the reader does not do
+
+- **It evaluates nothing.** A formula cell reports the result Excel cached when it saved the file,
+  so the value is whatever the file claims; recompute anything you rely on. Macros are never run
+  and external links never followed.
+- **It resolves no XML entities beyond the predefined ones.** Sheet XML goes through the library's
+  own scanner, which decodes `&amp;`-style and numeric references and copies anything else through
+  as text, so there is no entity expansion and no external fetch. The one `XmlReader`, for the
+  encryption descriptor, prohibits DTDs.
+
+## Writing untrusted text to CSV
+
+The writers store text as text: in XLSX, XLSB and XLS a string that starts with `=` is still a
+string. CSV has no cell types, and Excel opening a `.csv` treats a field starting with `=`, `+`,
+`-` or `@` as a formula. [`CsvWorkbookWriter`](xref:ExcelReader.Core.Writer.Csv.CsvWorkbookWriter) writes your text unchanged, so if a person may open the
+file in a spreadsheet program, neutralize those fields yourself:
+
+<!-- snippet: untrusted-input-csv-injection -->
+```csharp
+static string Neutralize(string text) =>
+    text.Length > 0 && "=+-@\t\r".Contains(text[0]) ? "'" + text : text;
+
+row.Write(Neutralize(comment));
+```
+
+The leading `'` changes the data, so do this only for files meant for people, not for files another
+program parses back.
diff --git a/docs/snippets/UntrustedInput.cs b/docs/snippets/UntrustedInput.cs
new file mode 100644
index 00000000..c894b537
--- /dev/null
+++ b/docs/snippets/UntrustedInput.cs
@@ -0,0 +1,69 @@
+namespace Snippets.UntrustedInput.Options
+{
+    internal static class Snippet
+    {
+        internal static ExcelReaderOptions Run()
+        {
+            #region untrusted-input-options
+            var uploadOptions = new ExcelReaderOptions
+            {
+                MaxTotalDecompressedBytes = 64L * 1024 * 1024, // everything one workbook may inflate
+                MaxSharedStringBytes = 16L * 1024 * 1024,
+                MaxCellBytes = 1024 * 1024,
+                MaxZipEntries = 1_000,
+            };
+            #endregion
+            return uploadOptions;
+        }
+    }
+}
+
+namespace Snippets.UntrustedInput.Reject
+{
+    internal static class Snippet
+    {
+        internal static void Run(Stream upload, ExcelReaderOptions uploadOptions)
+        {
+            #region untrusted-input-reject
+            try
+            {
+                using IExcelWorkbook workbook = Excel.Open(upload, options: uploadOptions);
+                foreach (Row row in workbook.FirstSheet)
+                {
+                    // stage the row; commit only once the loop has finished
+                }
+            }
+            catch (ExcelLimitExceededException ex)
+            {
+                Console.WriteLine($"Rejected: {ex.LimitName} reached {ex.Actual}, limit {ex.Limit}");
+            }
+            catch (Exception ex) when (IsRejectedFile(ex))
+            {
+                Console.WriteLine($"Rejected: {ex.Message}");
+            }
+
+            static bool IsRejectedFile(Exception ex) =>
+                ex is InvalidDataException or EndOfStreamException or NotSupportedException
+                    or ExcelEncryptionException or ExcelParseException
+                || ex.GetType() == typeof(ArgumentException)
+                || ex.GetType() == typeof(InvalidOperationException);
+            #endregion
+        }
+    }
+}
+
+namespace Snippets.UntrustedInput.CsvInjection
+{
+    internal static class Snippet
+    {
+        internal static void Run(CsvRowWriter row, string comment)
+        {
+            #region untrusted-input-csv-injection
+            static string Neutralize(string text) =>
+                text.Length > 0 && "=+-@\t\r".Contains(text[0]) ? "'" + text : text;
+
+            row.Write(Neutralize(comment));
+            #endregion
+        }
+    }
+}
diff --git a/docs/toc.yml b/docs/toc.yml
index b504ac27..d3707a7d 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -12,10 +12,8 @@
       href: guide/encryption.md
     - name: Errors across languages
       href: guide/errors.md
-    - name: Migrating to v7
-      href: guide/migrating-to-v7.md
-    - name: Migrating to v6
-      href: guide/migrating-to-v6.md
+    - name: Reading untrusted files
+      href: guide/untrusted-input.md
 - name: API
   href: api/
 - name: Bindings
@@ -40,3 +38,11 @@
       href: performance/reader-performance.md
     - name: Live results
       href: https://gabrielmarquezmatte.github.io/ExcelReader/dev/bench/
+- name: Releases
+  items:
+    - name: Release notes
+      href: https://github.com/GabrielMarquezMatte/ExcelReader/releases
+    - name: Migrating to v7
+      href: guide/migrating-to-v7.md
+    - name: Migrating to v6
+      href: guide/migrating-to-v6.md

From 405e1956cef288d86447591d31c3f33a4a6143b3 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:26:42 -0300
Subject: [PATCH 113/115] docs: clarify limits for decompressed bytes in
 untrusted file handling and update related code comments

---
 docs/guide/untrusted-input.md                 | 13 +--
 .../Reader/ExcelReaderOptions.cs              | 12 +--
 .../Reader/Xlsb/XlsbWorkbook.Enumerator.cs    |  4 +-
 .../Reader/Xlsb/XlsbWorkbook.cs               |  6 +-
 .../Reader/Xlsx/XlsxWorkbook.Enumerator.cs    |  4 +-
 .../Reader/Xlsx/XlsxWorkbook.cs               |  6 +-
 .../Reader/Zip/LimitedReadStream.cs           |  7 ++
 .../Reader/ReaderLimitTests.cs                | 90 +++++++++++++++++++
 8 files changed, 121 insertions(+), 21 deletions(-)

diff --git a/docs/guide/untrusted-input.md b/docs/guide/untrusted-input.md
index 83a94565..ce61e4fa 100644
--- a/docs/guide/untrusted-input.md
+++ b/docs/guide/untrusted-input.md
@@ -15,7 +15,7 @@ All of them live on [`ExcelReaderOptions`](xref:ExcelReader.Core.Reader.ExcelRea
 
 | Option | Default | Bounds | Formats |
 |---|---:|---|---|
-| `MaxTotalDecompressedBytes` | 512 MiB | Every byte the workbook inflates or loads from its container: sheets, shared strings, styles, and the decrypted package | XLSX, XLSB, XLS, encrypted |
+| `MaxTotalDecompressedBytes` | 512 MiB | What one read of a sheet inflates or loads from its container, counting the workbook's metadata, styles, shared strings and decrypted package | XLSX, XLSB, XLS, encrypted |
 | `MaxSharedStringBytes` | 128 MiB | The shared-string table, which is held in memory for the whole read | XLSX, XLSB, XLS |
 | `MaxCellBytes` | 32 MiB | Each buffer that grows to hold one cell value, or one CSV record | all |
 | `MaxZipEntries` | 65,536 | Entries in the ZIP directory | XLSX, XLSB |
@@ -27,10 +27,10 @@ with `LimitName == "Columns"`, and no single buffer may exceed .NET's array size
 
 How they count:
 
-- **`MaxTotalDecompressedBytes` belongs to the opened workbook, not to one read.** Every sheet you
-  read, and every re-read of the same sheet, draws from the same budget. A workbook kept open and
-  read repeatedly will eventually hit it, so open one per job, or size the budget for all the
-  reads you make.
+- **`MaxTotalDecompressedBytes` is per read of a sheet.** The workbook's one-time loads (its
+  metadata, styles and shared strings) count toward every read, and each read adds the sheet it
+  inflates. Reading a sheet again starts from the one-time loads, so a workbook kept open and read
+  repeatedly never runs out.
 - **XLS has nothing to inflate, but it is not streamed:** the whole Workbook stream is read into
   memory, up to `MaxTotalDecompressedBytes`.
 - **CSV has no total limit.** It streams, so the size of what you hand it is the bound; only
@@ -38,7 +38,8 @@ How they count:
 - **Zero or a negative value turns a byte or entry limit off.** `MaxPasswordSpinCount` has no off
   switch. In the Python, Rust and C++ bindings and the C ABI, `0` means the default instead, and a
   limit cannot be turned off.
-- **The limits are per workbook.** Ten uploads read at once can hold ten times the budget.
+- **Reads running at once each have their own budget.** Ten uploads read together, or several sheets
+  of one workbook read on different threads, can inflate ten times the budget between them.
 
 ## A profile for uploads
 
diff --git a/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs b/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
index 4f2d0285..3e4f5470 100644
--- a/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
+++ b/src/ExcelReader.Core/Reader/ExcelReaderOptions.cs
@@ -8,11 +8,13 @@ namespace ExcelReader.Core.Reader
     /// </summary>
     public sealed record ExcelReaderOptions
     {
-        /// <summary>Gets the maximum total decompressed bytes allowed across the whole workbook. Defaults to 512 MiB.</summary>
-        /// <remarks>Applies to ZIP-backed formats (XLSX/XLSB) as their decompressed byte budget, and to
-        /// the legacy CFB container (.xls) as the cap on its declared Workbook stream size — the CFB path
-        /// has nothing to decompress, but this is still the caller's budget for what that phase may
-        /// materialize.</remarks>
+        /// <summary>Gets the maximum total decompressed bytes allowed for one read of a sheet. Defaults to 512 MiB.</summary>
+        /// <remarks>Applies to ZIP-backed formats (XLSX/XLSB) as their decompressed byte budget: what the
+        /// workbook inflated when it opened and loaded its shared strings, plus the sheet being read. Each
+        /// read of a sheet starts from that one-time total again, so reading a sheet twice does not count
+        /// it twice. For the legacy CFB container (.xls) it caps the declared Workbook stream size — the
+        /// CFB path has nothing to decompress, but this is still the caller's budget for what that phase
+        /// may materialize.</remarks>
         public long MaxTotalDecompressedBytes { get; init; } = 512L * 1024 * 1024;
 
         /// <summary>Gets the maximum byte length allowed for a single cell's value, or a single buffered CSV record. Defaults to 32 MiB.</summary>
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
index cd1fb5fc..4884a29b 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.Enumerator.cs
@@ -64,12 +64,12 @@ internal Enumerator(XlsbWorkbook reader, ReadOnlyMemory<byte> chunk, bool rowOpe
 
             private protected override Stream OpenSource()
             {
-                return _reader._zip!.OpenEntryStream(_entry, _reader._decompressedBytes, _reader._options);
+                return _reader._zip!.OpenEntryStream(_entry, _reader._decompressedBytes.ForRead(), _reader._options);
             }
 
             private protected override async ValueTask<Stream> OpenSourceAsync()
             {
-                return await _reader._zip!.OpenEntryStreamAsync(_entry, _reader._decompressedBytes, _reader._options, _ct).ConfigureAwait(false);
+                return await _reader._zip!.OpenEntryStreamAsync(_entry, _reader._decompressedBytes.ForRead(), _reader._options, _ct).ConfigureAwait(false);
             }
 
             /// <inheritdoc/>
diff --git a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
index a51ef242..f2ce0b53 100644
--- a/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsb/XlsbWorkbook.cs
@@ -278,7 +278,7 @@ internal Enumerator OpenSheet(int index)
             try
             {
                 ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path);
-                return new Enumerator(this, _zip!.OpenEntryStream(entry, _decompressedBytes, _options), entry.UncompressedSize);
+                return new Enumerator(this, _zip!.OpenEntryStream(entry, _decompressedBytes.ForRead(), _options), entry.UncompressedSize);
             }
             catch
             {
@@ -303,7 +303,7 @@ internal Enumerator OpenSheetWithoutPrefetch(int index)
             try
             {
                 ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path);
-                return new Enumerator(this, _zip!.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch), entry.UncompressedSize);
+                return new Enumerator(this, _zip!.OpenEntryStream(entry, _decompressedBytes.ForRead(), WithoutPrefetch), entry.UncompressedSize);
             }
             catch
             {
@@ -315,7 +315,7 @@ internal Enumerator OpenSheetWithoutPrefetch(int index)
         internal Stream OpenSheetStream(int index)
         {
             ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip!, _sheets![index].Path);
-            return _zip!.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch);
+            return _zip!.OpenEntryStream(entry, _decompressedBytes.ForRead(), WithoutPrefetch);
         }
 
         internal Enumerator OpenSheetAsync(int index, CancellationToken ct)
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
index 61db4709..23b97aea 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.Enumerator.cs
@@ -71,14 +71,14 @@ private protected override Stream OpenSource()
             {
                 _reader.EnsureSharedLoaded();
                 _sharedOffsets = _reader._sharedOffsets;
-                return _reader._zip.OpenEntryStream(_entry, _reader._decompressedBytes, _reader._options);
+                return _reader._zip.OpenEntryStream(_entry, _reader._decompressedBytes.ForRead(), _reader._options);
             }
 
             private protected override async ValueTask<Stream> OpenSourceAsync()
             {
                 await _reader.EnsureSharedLoadedAsync(_ct).ConfigureAwait(false);
                 _sharedOffsets = _reader._sharedOffsets;
-                return await _reader._zip.OpenEntryStreamAsync(_entry, _reader._decompressedBytes, _reader._options, _ct).ConfigureAwait(false);
+                return await _reader._zip.OpenEntryStreamAsync(_entry, _reader._decompressedBytes.ForRead(), _reader._options, _ct).ConfigureAwait(false);
             }
 
             /// <inheritdoc/>
diff --git a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
index c684f478..2151f557 100644
--- a/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
+++ b/src/ExcelReader.Core/Reader/Xlsx/XlsxWorkbook.cs
@@ -209,7 +209,7 @@ internal Enumerator OpenSheet(int index)
             {
                 EnsureSharedLoaded();
                 ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path);
-                return new Enumerator(this, _zip.OpenEntryStream(entry, _decompressedBytes, _options), entry.UncompressedSize);
+                return new Enumerator(this, _zip.OpenEntryStream(entry, _decompressedBytes.ForRead(), _options), entry.UncompressedSize);
             }
             catch
             {
@@ -235,7 +235,7 @@ internal Enumerator OpenSheetWithoutPrefetch(int index)
             {
                 EnsureSharedLoaded();
                 ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path);
-                return new Enumerator(this, _zip.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch), entry.UncompressedSize);
+                return new Enumerator(this, _zip.OpenEntryStream(entry, _decompressedBytes.ForRead(), WithoutPrefetch), entry.UncompressedSize);
             }
             catch
             {
@@ -247,7 +247,7 @@ internal Enumerator OpenSheetWithoutPrefetch(int index)
         internal Stream OpenSheetStream(int index)
         {
             ZipEntryRef entry = WorkbookLookups.GetWorksheetEntry(_zip, _sheets[index].Path);
-            return _zip.OpenEntryStream(entry, _decompressedBytes, WithoutPrefetch);
+            return _zip.OpenEntryStream(entry, _decompressedBytes.ForRead(), WithoutPrefetch);
         }
 
         internal Enumerator OpenSheetAsync(int index, CancellationToken ct)
diff --git a/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs b/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
index a1863f9a..b805477c 100644
--- a/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
+++ b/src/ExcelReader.Core/Reader/Zip/LimitedReadStream.cs
@@ -12,6 +12,13 @@ internal DecompressedByteCounter(long limit, string limitName = nameof(ExcelRead
             _limitName = limitName;
         }
 
+        // A sheet read counts from what the workbook's one-time loads (metadata, styles, shared strings)
+        // inflated, so a single read stays within the limit while a re-read does not pay for earlier ones.
+        internal DecompressedByteCounter ForRead()
+        {
+            return new DecompressedByteCounter(_limit, _limitName) { _total = Interlocked.Read(ref _total) };
+        }
+
         internal void Add(long bytes)
         {
             if (bytes <= 0 || _limit <= 0)
diff --git a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
index 4469dbaa..babf22dd 100644
--- a/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
+++ b/tests/ExcelReader.Tests/Reader/ReaderLimitTests.cs
@@ -9,6 +9,8 @@
 using ExcelReader.Core.Reader.Xlsb;
 using ExcelReader.Core.Reader.Xlsx;
 using ExcelReader.Core.Reader.Zip;
+using ExcelReader.Core.Writer.Xlsb;
+using ExcelReader.Core.Writer.Xlsx;
 using ExcelReader.Tests.Crypto;
 using ExcelReader.Tests.Reader.Tables;
 using ExcelReader.Tests.Reader.Xls;
@@ -391,6 +393,94 @@ public void ZeroTotalDecompressedLimitRestoresUnlimitedTotalRead()
             Assert.Equal(value.Length, e.Current[0].GetString().Length);
         }
 
+        private const int BudgetRows = 5_000;
+
+        [Theory]
+        [InlineData(false, false)]
+        [InlineData(false, true)]
+        [InlineData(true, false)]
+        [InlineData(true, true)]
+        public void RereadingASheetStartsAFreshTotalDecompressedBudget(bool xlsb, bool fromStream)
+        {
+            byte[] package = WriteTextRows(xlsb, sharedStrings: false);
+            (long total, long sheet) = EntrySizes(package, xlsb);
+            var options = new ExcelReaderOptions { MaxTotalDecompressedBytes = total + (sheet / 2) };
+
+            using MemoryStream stream = new(package);
+            using IExcelWorkbook workbook = fromStream
+                ? Excel.Open(stream, options: options)
+                : Excel.Open(package, options);
+            for (int pass = 0; pass < 3; pass++)
+            {
+                Assert.Equal(BudgetRows, CountRows(workbook.FirstSheet));
+            }
+        }
+
+        [Theory]
+        [InlineData(false)]
+        [InlineData(true)]
+        public void OneSheetReadStillCountsTheSharedStringsTowardTheTotalBudget(bool xlsb)
+        {
+            byte[] package = WriteTextRows(xlsb, sharedStrings: true);
+            (long total, long sheet) = EntrySizes(package, xlsb);
+            var options = new ExcelReaderOptions { MaxTotalDecompressedBytes = total - (sheet / 2) };
+
+            using IExcelWorkbook workbook = Excel.Open(package, options);
+            ExcelLimitExceededException ex = Assert.Throws<ExcelLimitExceededException>(() => CountRows(workbook.FirstSheet));
+            Assert.Equal(nameof(ExcelReaderOptions.MaxTotalDecompressedBytes), ex.LimitName);
+        }
+
+        private static byte[] WriteTextRows(bool xlsb, bool sharedStrings)
+        {
+            using MemoryStream ms = new();
+            if (xlsb)
+            {
+                using XlsbWorkbookWriter workbook = XlsbWorkbookWriter.Create(ms, leaveOpen: true, new XlsbWriterOptions { UseSharedStrings = sharedStrings });
+                using (XlsbSheetWriter sheet = workbook.AddSheet("S"))
+                {
+                    for (int i = 0; i < BudgetRows; i++)
+                    {
+                        using XlsbRowWriter row = sheet.StartRow();
+                        row.Write(string.Create(CultureInfo.InvariantCulture, $"value {i:D6} padding padding padding"));
+                    }
+                }
+                workbook.End();
+            }
+            else
+            {
+                using XlsxWorkbookWriter workbook = XlsxWorkbookWriter.Create(ms, leaveOpen: true, new XlsxWriterOptions { UseSharedStrings = sharedStrings });
+                using (XlsxSheetWriter sheet = workbook.AddSheet("S"))
+                {
+                    for (int i = 0; i < BudgetRows; i++)
+                    {
+                        using XlsxRowWriter row = sheet.StartRow();
+                        row.Write(string.Create(CultureInfo.InvariantCulture, $"value {i:D6} padding padding padding"));
+                    }
+                }
+                workbook.End();
+            }
+            return ms.ToArray();
+        }
+
+        private static (long Total, long Sheet) EntrySizes(byte[] package, bool xlsb)
+        {
+            using MemoryStream ms = new(package);
+            using ZipArchive zip = new(ms, ZipArchiveMode.Read);
+            long total = zip.Entries.Sum(entry => entry.Length);
+            long sheet = zip.GetEntry(xlsb ? "xl/worksheets/sheet1.bin" : "xl/worksheets/sheet1.xml")!.Length;
+            return (total, sheet);
+        }
+
+        private static int CountRows(IExcelSheet sheet)
+        {
+            int rows = 0;
+            foreach (Row row in sheet)
+            {
+                rows++;
+            }
+            return rows;
+        }
+
         [Fact]
         public async Task LimitedReadStreamCoversUnsupportedOperationsAndByteArrayAsyncRead()
         {

From 518c2d78c9e753519e0df99f9b6f0e82a0d5c2f5 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:31:49 -0300
Subject: [PATCH 114/115] ci: optimize workflow triggers by limiting branches
 for benchmarks and native bindings

---
 .github/workflows/benchmark-pr.yml    |  3 ++-
 .github/workflows/ci.yml              |  7 +++++--
 .github/workflows/codeql.yml          | 10 ++++++++--
 .github/workflows/native-bindings.yml |  7 ++++++-
 4 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/benchmark-pr.yml b/.github/workflows/benchmark-pr.yml
index 059d97da..ab3cd3f5 100644
--- a/.github/workflows/benchmark-pr.yml
+++ b/.github/workflows/benchmark-pr.yml
@@ -22,7 +22,8 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       benchmarks: ${{ steps.filter.outputs.benchmarks }}
-      run: ${{ steps.filter.outputs.benchmarks == 'true' && (github.base_ref == 'master' || contains(github.event.pull_request.labels.*.name, 'run-benchmarks')) }}
+      # Opt-in on every base branch: the suite is ~40 runner-minutes, too much to repeat on each push.
+      run: ${{ steps.filter.outputs.benchmarks == 'true' && contains(github.event.pull_request.labels.*.name, 'run-benchmarks') }}
     steps:
       - name: Checkout
         uses: actions/checkout@v7
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7953c3bf..3a5f5eba 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -65,6 +65,9 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
     env:
       RUN: ${{ needs.changes.outputs.dotnet }}
+      # The whole solution compiles the same on every OS, so Linux builds all of it and the others
+      # build only what the tests need.
+      BUILD_TARGET: ${{ matrix.os == 'ubuntu-latest' && 'ExcelReader.slnx' || 'tests/ExcelReader.Tests/ExcelReader.Tests.csproj' }}
 
     steps:
       - name: Nothing to build
@@ -85,11 +88,11 @@ jobs:
 
       - name: Restore
         if: env.RUN == 'true'
-        run: dotnet restore ExcelReader.slnx
+        run: dotnet restore ${{ env.BUILD_TARGET }}
 
       - name: Build (Release)
         if: env.RUN == 'true'
-        run: dotnet build ExcelReader.slnx --configuration Release --no-restore -p:DeterministicSourcePaths=false
+        run: dotnet build ${{ env.BUILD_TARGET }} --configuration Release --no-restore -p:DeterministicSourcePaths=false
 
       - name: Verify formatting (whitespace)
         if: env.RUN == 'true' && matrix.os == 'ubuntu-latest'
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index b93ef95d..2012de50 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -1,8 +1,9 @@
 name: CodeQL
 
 on:
+  # develop is covered by its pull request into master; a push trigger there would run everything twice.
   push:
-    branches: [ master, develop ]
+    branches: [ master ]
   pull_request:
     branches: [ master, develop ]
     types: [ opened, synchronize, reopened, ready_for_review ]
@@ -89,9 +90,14 @@ jobs:
           languages: ${{ matrix.language }}
           queries: security-extended
 
+      # Only the shipped projects: tests, benchmarks and the fuzz harness double the build for code
+      # no one runs against untrusted input.
       - name: Build (Release)
         if: matrix.language == 'csharp'
-        run: dotnet build ExcelReader.slnx --configuration Release
+        run: |
+          for project in src/*/*.csproj; do
+            dotnet build "$project" --configuration Release
+          done
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v4
diff --git a/.github/workflows/native-bindings.yml b/.github/workflows/native-bindings.yml
index 754d53c1..7d4afc11 100644
--- a/.github/workflows/native-bindings.yml
+++ b/.github/workflows/native-bindings.yml
@@ -1,8 +1,9 @@
 name: Native bindings
 
 on:
+  # develop is covered by its pull request into master; a push trigger there would run everything twice.
   push:
-    branches: [master, develop]
+    branches: [master]
   pull_request:
     branches: [master, develop]
     types: [opened, synchronize, reopened, ready_for_review]
@@ -145,13 +146,17 @@ jobs:
           EXCELREADER_NATIVE_LIB_DIR: ${{ github.workspace }}/${{ steps.lib.outputs.dir }}
         run: cargo test --workspace --all-features --verbose
 
+      # The next two compile the crate again (default features, then the bench profile); that
+      # catches nothing platform-specific the test build above missed, so one OS is enough.
       - name: cargo build (default features)
+        if: runner.os == 'Linux'
         working-directory: rust
         env:
           EXCELREADER_NATIVE_LIB_DIR: ${{ github.workspace }}/${{ steps.lib.outputs.dir }}
         run: cargo build --workspace --verbose
 
       - name: cargo bench (smoke)
+        if: runner.os == 'Linux'
         working-directory: rust
         env:
           EXCELREADER_NATIVE_LIB_DIR: ${{ github.workspace }}/${{ steps.lib.outputs.dir }}

From b796cfcbfb21959bb9149faa0cdf732840e700c9 Mon Sep 17 00:00:00 2001
From: GabrielMarquezMatte <gabriel.matte@peakinvest.com.br>
Date: Mon, 12 Oct 2026 20:42:42 -0300
Subject: [PATCH 115/115] ci: disable analyzers during builds to improve
 performance across workflows

---
 .github/workflows/benchmark-pr.yml    | 4 ++--
 .github/workflows/ci.yml              | 9 ++++++---
 .github/workflows/codeql.yml          | 2 +-
 .github/workflows/docs.yml            | 2 +-
 .github/workflows/fuzz.yml            | 4 ++--
 .github/workflows/native-bindings.yml | 2 ++
 6 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/benchmark-pr.yml b/.github/workflows/benchmark-pr.yml
index ab3cd3f5..ecbbcad9 100644
--- a/.github/workflows/benchmark-pr.yml
+++ b/.github/workflows/benchmark-pr.yml
@@ -67,7 +67,7 @@ jobs:
           cache-dependency-path: '**/*.csproj'
 
       - name: Build (Release)
-        run: dotnet build tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj --configuration Release
+        run: dotnet build tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj --configuration Release -p:RunAnalyzers=false
 
       - name: Check group coverage
         run: bash tests/ExcelReader.Benchmarks/check-benchmark-groups.sh
@@ -95,7 +95,7 @@ jobs:
         run: dotnet restore tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj
 
       - name: Build (Release)
-        run: dotnet build tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj --configuration Release --no-restore
+        run: dotnet build tests/ExcelReader.Benchmarks/ExcelReader.Benchmarks.csproj --configuration Release --no-restore -p:RunAnalyzers=false
 
       - name: Run benchmarks
         run: |
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3a5f5eba..23f980d8 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -68,6 +68,9 @@ jobs:
       # The whole solution compiles the same on every OS, so Linux builds all of it and the others
       # build only what the tests need.
       BUILD_TARGET: ${{ matrix.os == 'ubuntu-latest' && 'ExcelReader.slnx' || 'tests/ExcelReader.Tests/ExcelReader.Tests.csproj' }}
+      # Analyzers are about two thirds of the compile and report the same on every OS, so only the
+      # Linux build runs them; every other build in CI skips them. Source generators still run.
+      BUILD_ARGS: ${{ matrix.os != 'ubuntu-latest' && '-p:RunAnalyzers=false' || '' }}
 
     steps:
       - name: Nothing to build
@@ -92,7 +95,7 @@ jobs:
 
       - name: Build (Release)
         if: env.RUN == 'true'
-        run: dotnet build ${{ env.BUILD_TARGET }} --configuration Release --no-restore -p:DeterministicSourcePaths=false
+        run: dotnet build ${{ env.BUILD_TARGET }} --configuration Release --no-restore -p:DeterministicSourcePaths=false ${{ env.BUILD_ARGS }}
 
       - name: Verify formatting (whitespace)
         if: env.RUN == 'true' && matrix.os == 'ubuntu-latest'
@@ -159,7 +162,7 @@ jobs:
           cache-dependency-path: '**/*.csproj'
 
       - name: Build (Release)
-        run: dotnet build tests/ExcelReader.Tests/ExcelReader.Tests.csproj --configuration Release
+        run: dotnet build tests/ExcelReader.Tests/ExcelReader.Tests.csproj --configuration Release -p:RunAnalyzers=false
 
       - name: Test (Release)
         run: dotnet test --project tests/ExcelReader.Tests/ExcelReader.Tests.csproj --configuration Release --no-build
@@ -192,7 +195,7 @@ jobs:
       - name: Pack and verify the generator ships inside the nupkg
         shell: pwsh
         run: |
-          dotnet pack src/ExcelReader.Core/ExcelReader.Core.csproj -c Release -o ./artifacts
+          dotnet pack src/ExcelReader.Core/ExcelReader.Core.csproj -c Release -o ./artifacts -p:RunAnalyzers=false
           $pkg = Get-ChildItem ./artifacts/*.nupkg | Select-Object -First 1
           Add-Type -AssemblyName System.IO.Compression.FileSystem
           $zip = [System.IO.Compression.ZipFile]::OpenRead($pkg.FullName)
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index 2012de50..a0b08d88 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -96,7 +96,7 @@ jobs:
         if: matrix.language == 'csharp'
         run: |
           for project in src/*/*.csproj; do
-            dotnet build "$project" --configuration Release
+            dotnet build "$project" --configuration Release -p:RunAnalyzers=false
           done
 
       - name: Perform CodeQL Analysis
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 8aeea115..14b6e992 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -58,7 +58,7 @@ jobs:
       # FailedToResolveAnalyzer.
       - name: Build site
         run: |
-          dotnet build src/ExcelReader.Generator/ExcelReader.Generator.csproj --configuration Release
+          dotnet build src/ExcelReader.Generator/ExcelReader.Generator.csproj --configuration Release -p:RunAnalyzers=false
           dotnet tool install --global docfx --version 2.81.0
           docfx docfx.json --warningsAsErrors
 
diff --git a/.github/workflows/fuzz.yml b/.github/workflows/fuzz.yml
index d633c942..d0dd6254 100644
--- a/.github/workflows/fuzz.yml
+++ b/.github/workflows/fuzz.yml
@@ -76,7 +76,7 @@ jobs:
 
       - name: Publish harness
         run: |
-          dotnet publish tests/ExcelReader.Fuzz/ExcelReader.Fuzz.csproj -c Release -o fuzz-out
+          dotnet publish tests/ExcelReader.Fuzz/ExcelReader.Fuzz.csproj -c Release -o fuzz-out -p:RunAnalyzers=false
           chmod +x fuzz-out/ExcelReader.Fuzz
 
       - name: Generate seed corpus
@@ -159,7 +159,7 @@ jobs:
 
       - name: Build
         if: env.RUN == 'true'
-        run: dotnet build tests/ExcelReader.Fuzz/ExcelReader.Fuzz.csproj -c Release
+        run: dotnet build tests/ExcelReader.Fuzz/ExcelReader.Fuzz.csproj -c Release -p:RunAnalyzers=false
 
       - name: Generate corpus
         if: env.RUN == 'true'
diff --git a/.github/workflows/native-bindings.yml b/.github/workflows/native-bindings.yml
index 7d4afc11..06d6862d 100644
--- a/.github/workflows/native-bindings.yml
+++ b/.github/workflows/native-bindings.yml
@@ -77,6 +77,8 @@ jobs:
 
       - name: Build the native library
         shell: bash
+        env:
+          RunAnalyzers: 'false'
         run: python python/scripts/build_native.py
 
       - name: Upload native library