feat(core): B1.2 — sectioned-output hook (one file, many sections)

[thiagoluga]

The OSS/MIT enabling piece for the Pro workbook. A single output can now carry several sections — one file with many sections (e.g. an XLSX workbook with a worksheet per section) — each with its own filters/columns, all projected in one source pass. The commercial ClosedXML writer + XlsxWorkbook(...) API land in B1.3 on top of this.

This complements B1.1 (many outputs → many files) with the other axis (one output → many sections in one file).

API

new ReportBuilder<Sale>("workbook")
    .From(source)
    .Column(v => v.Id, "Id")
    .ToSections(new SectionedOutputSpec(xlsxWorkbookFactory), s => s
        .Section("Approved", v => v.Where(x => x.Amount > 0))
        .Section("Rejected", v => v
            .Where(x => x.Amount <= 0)
            .Column(x => x.Id, "Id").Column(x => x.Customer, "Customer")));

Changes (additive — default path byte-identical)

• New Core contracts (in Core, not the frozen Abstractions, like the artifact store): IReportSectionedWriter, ISectionedWriterFactory, SectionedWriterContext, ReportSection.
• Builder: ToSections(...) via a SectionBuilder<T> reusing B1.1's OutputView<T>. CompiledReport gains SectionedOutputs (spec + per-section name/schema).
• Pipeline: TypedBatchReader also projects each section in the single pass; ProjectedBatch carries per-sectioned-output → per-section rows; WrittenCount counts a source row once across outputs and sections. The runner creates one IReportSectionedWriter per sectioned output, writes each section per batch, finalizes one file, and uploads/retains it (unified with regular outputs via a small IFinishedFile).

Tests

55 green Core (+1): a fake sectioned writer proves single read, per-section projection with different columns into one file, plus correct RecordsWritten. Jobs (16) and AspNetCore (10) unaffected — reports without sectioned outputs are byte-identical.

Next

B1.3 — NeoReports.Xlsx.Pro (commercial): a ClosedXML IReportSectionedWriter (one worksheet per section) + fluent XlsxWorkbook(...) + the PolyForm Small Business LICENSE (I'll fetch the canonical text) + metadata, excluded from the OSS NuGet release.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
95.1% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud