Pennington.Pipeline.ContentPipeline

namespace Pennington.Pipeline;

/// Orchestrates the content processing pipeline.
public class ContentPipeline
{
    /// Creates the pipeline from the registered content services, parser, and renderer.
    
public ContentPipeline(
    IEnumerable<IContentService> services,
    IContentParser parser,
    IContentRenderer renderer);

    /// Entry: content services produce discovered items.
    
public async IAsyncEnumerable<ContentItem> DiscoverAsync();

    /// Exit: generate output files.
    
public async Task<BuildReport> GenerateAsync(IAsyncEnumerable<ContentItem> items, OutputOptions options);

    /// Transform: parse items (read files, extract YAML + body).
    
public async IAsyncEnumerable<ContentItem> ParseAsync(IAsyncEnumerable<ContentItem> items);

    /// Transform: render items (Markdig pipeline to HTML).
    
public async IAsyncEnumerable<ContentItem> RenderAsync(IAsyncEnumerable<ContentItem> items);

    /// Convenience: run the full pipeline end-to-end.
    
public async Task<BuildReport> RunAsync(OutputOptions options);
}