Pennington.Pipeline.IContentPipeline

namespace Pennington.Pipeline;

/// The content processing pipeline.
public interface IContentPipeline
{
    /// Entry: content services produce discovered items.
    
IAsyncEnumerable<ContentItem> DiscoverAsync();

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

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

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