Lyo.Web.WebRenderer 1.0.0

Lyo.Web.WebRenderer

Server-side rendering of Razor components and HTML→PDF conversion. Razor rendering uses Microsoft.AspNetCore.Components.Web.HtmlRenderer; PDF conversion is driven by PuppeteerSharp against a locally-installed Chromium/Chrome browser.

Examples

DI registration (Extensions.cs)

services.AddWebRendererServiceFromConfiguration(builder.Configuration);

Surface (IWebRendererService)

The service exposes three families of operations plus three observability events.

Surface (IWebRendererService) — Render Razor components

Surface (IWebRendererService) — HTML → PDF conversion

The current interface only exposes Razor render and HTML→PDF; there is no in-process screenshot API. For raw screenshots, use PuppeteerSharp directly through BrowserExePath.

Surface (IWebRendererService) — Events

ComponentRendered, ComponentRenderedToBytes, ComponentSavedToFile fire after the corresponding render operations and carry the resulting payload plus parameter and options snapshots — useful for downstream archival or diffing.

Options (WebRenderOptions)

Configuration section: WebRenderOptions.

When EnableMetrics is false (default) the service uses NullMetrics.Instance, so registering IMetrics is optional.

Metrics emitted (see Constants.cs) include webrenderer.render_to_html(.bytes|_to_file).{duration,success,failure,size_bytes} and webrenderer.convert_html_to_pdf.{duration,success,failure,size_bytes,input_size_bytes}, tagged with component_type / operation.

DI registration (Extensions.cs)

This binds WebRenderOptions from WebRenderOptions (default section name) and registers: - A scoped Microsoft.AspNetCore.Components.Web.HtmlRenderer (resolved with the host’s IServiceProvider and ILoggerFactory). - A scoped IWebRendererService → WebRendererService, optionally consuming registered ILogger<WebRendererService> and IMetrics. Pass configSectionName to the extension if you need a non-default section name. There is currently no inline-options overload — register WebRenderOptions yourself before calling the extension if you need to bypass configuration.

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Exceptions — (direct, lyo)
• Lyo.Metrics — (direct, lyo)
• Microsoft.AspNetCore.Components.Web 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.Configuration 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.Configuration.Binder 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 — (direct, microsoft)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 — (direct, microsoft)
• PuppeteerSharp 24.0.0 — (direct, third-party)
• Microsoft.Extensions.Options.ConfigurationExtensions 10.0.5 — (transitive, microsoft)