.

Author: SimonCropp

claude.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Morph is a .NET library that converts Microsoft Word DOCX documents into PNG images. The public API lives in the `WordRender` namespace. The main entry point is `DocumentConverter`, which exposes `ConvertToImages` (file/stream → PNG files) and `ConvertToImageData` (file/stream → byte arrays).
+Morph is a .NET library that converts Microsoft Word DOCX documents or HTML content into PNG images. The DOCX public API lives in the `WordRender` namespace (entry point: `DocumentConverter`). The HTML public API lives in the `HtmlRender` namespace (entry point: `HtmlConverter`). Both expose `ConvertToImages` and `ConvertToImageData`.
 
 ## Build & Test Commands
 
@@ -26,16 +26,25 @@ dotnet run --project src/Tests -- --filter "Name=Scenario"
 
 ## Architecture
 
-The conversion pipeline is **Parse → Render**:
+The conversion pipeline is **Parse → Render**, split across multiple assemblies:
 
-1. **Parsing** (`src/Morph/Parsing/`): `DocumentParser` reads OOXML via DocumentFormat.OpenXml and builds a `ParsedDocument` containing a tree of `DocumentElement` types (defined in `DocumentElements.cs`). Sub-parsers handle shapes, ink, themes, and HTML (AltChunk).
+**Core model** (`src/Morph/`): `ParsedDocument`, `DocumentElement` types (defined in `DocumentElements.cs`), shared rendering base (`RenderContextBase`, `FontCacheLoader`, `FontHelpers`, `TableLayout`), `ConversionOptions`, `ConversionResult`. No heavy dependencies.
 
-2. **Rendering** — two interchangeable backends behind an abstract `DocumentConverter` base class:
-   - **SkiaSharp** (`src/Morph.Skia/`): `WordRender.Skia.DocumentConverter` — uses SkiaSharp + Svg.Skia
-   - **ImageSharp** (`src/Morph.ImageSharp/`): `WordRender.ImageSharp.DocumentConverter` — uses SixLabors.ImageSharp / ImageSharp.Drawing / Fonts
-   - **Shared rendering logic** (`src/Morph/Rendering/`): `RenderContextBase`, `FontCacheLoader`, `FontHelpers`, `TableLayout`
+**Parsers:**
+- **DOCX** (`src/Morph.OpenXml/`): `DocumentParser` reads OOXML via DocumentFormat.OpenXml and builds a `ParsedDocument`. Sub-parsers handle shapes, ink, themes, and HTML (AltChunk).
+- **HTML** (`src/Morph.Html/`): `HtmlParser` converts HTML to `DocumentElement` trees via AngleSharp. `HtmlConverter` abstract base class.
 
-   Each backend has its own `PageRenderer`, `TextRenderer`, and `RenderContext`.
+**Rendering backends** — each has its own `PageRenderer`, `TextRenderer`, and `RenderContext`:
+- **SkiaSharp** (`src/Morph.Skia/`): rendering engine using SkiaSharp + Svg.Skia
+- **ImageSharp** (`src/Morph.ImageSharp/`): rendering engine using SixLabors.ImageSharp / ImageSharp.Drawing / Fonts
+
+**Entry points** (thin wrappers combining a parser with a rendering backend):
+- `src/Morph.OpenXml.Skia/` — `WordRender.Skia.DocumentConverter` (DOCX → PNG via SkiaSharp)
+- `src/Morph.OpenXml.ImageSharp/` — `WordRender.ImageSharp.DocumentConverter` (DOCX → PNG via ImageSharp)
+- `src/Morph.Html.Skia/` — `HtmlRender.Skia.HtmlConverter` (HTML → PNG via SkiaSharp)
+- `src/Morph.Html.ImageSharp/` — `HtmlRender.ImageSharp.HtmlConverter` (HTML → PNG via ImageSharp)
+
+The HTML packages have no transitive dependency on `DocumentFormat.OpenXml`.
 
 ## Code Style
 

readme.md

@@ -1,10 +1,12 @@
 # <img src='/src/icon.png' height='30px'> Morph
 
 [![Build status](https://img.shields.io/appveyor/build/SimonCropp/morph)](https://ci.appveyor.com/project/SimonCropp/morph)
-[![NuGet Status](https://img.shields.io/nuget/v/Morph.Skia.svg?label=Morph.Skia)](https://www.nuget.org/packages/Morph.Skia/)
-[![NuGet Status](https://img.shields.io/nuget/v/Morph.ImageSharp.svg?label=Morph.ImageSharp)](https://www.nuget.org/packages/Morph.ImageSharp/)
+[![NuGet Status](https://img.shields.io/nuget/v/Morph.OpenXml.Skia.svg?label=Morph.OpenXml.Skia)](https://www.nuget.org/packages/Morph.OpenXml.Skia/)
+[![NuGet Status](https://img.shields.io/nuget/v/Morph.OpenXml.ImageSharp.svg?label=Morph.OpenXml.ImageSharp)](https://www.nuget.org/packages/Morph.OpenXml.ImageSharp/)
+[![NuGet Status](https://img.shields.io/nuget/v/Morph.Html.Skia.svg?label=Morph.Html.Skia)](https://www.nuget.org/packages/Morph.Html.Skia/)
+[![NuGet Status](https://img.shields.io/nuget/v/Morph.Html.ImageSharp.svg?label=Morph.Html.ImageSharp)](https://www.nuget.org/packages/Morph.Html.ImageSharp/)
 
-A .NET library that converts Microsoft Word DOCX documents into PNG images.
+A .NET library that converts Microsoft Word DOCX documents or HTML content into PNG images.
 
 
 ## Requirements
@@ -13,27 +15,23 @@ A .NET library that converts Microsoft Word DOCX documents into PNG images.
 - Cross-platform support: Windows, macOS, Linux
 
 
-## Dependencies
+## NuGet packages
 
-**Core:**
-- **[DocumentFormat.OpenXml](https://www.nuget.org/packages/DocumentFormat.OpenXml)** - DOCX file parsing
-- **[AngleSharp](https://www.nuget.org/packages/AngleSharp)** - HTML content parsing (for AltChunk support)
+### DOCX to PNG
 
-**Morph.Skia backend:**
-- **[SkiaSharp](https://www.nuget.org/packages/SkiaSharp)** - Cross-platform graphics rendering
-- **[Svg.Skia](https://www.nuget.org/packages/Svg.Skia)** - SVG rendering support
+For converting Word documents to images:
 
-**Morph.ImageSharp backend:**
-- **[SixLabors.ImageSharp](https://www.nuget.org/packages/SixLabors.ImageSharp)** - Cross-platform graphics rendering
-- **[SixLabors.ImageSharp.Drawing](https://www.nuget.org/packages/SixLabors.ImageSharp.Drawing)** - Drawing primitives
-- **[SixLabors.Fonts](https://www.nuget.org/packages/SixLabors.Fonts)** - Font handling
+https://nuget.org/packages/Morph.OpenXml.Skia/
 
+https://nuget.org/packages/Morph.OpenXml.ImageSharp/
 
-## NuGet packages
+### HTML to PNG
+
+For converting HTML content to images (no Microsoft Word / OpenXml dependency):
 
-https://nuget.org/packages/Morph.Skia/
+https://nuget.org/packages/Morph.Html.Skia/
 
-https://nuget.org/packages/Morph.ImageSharp/
+https://nuget.org/packages/Morph.Html.ImageSharp/
 
 
 ## Features
@@ -108,16 +106,17 @@ https://nuget.org/packages/Morph.ImageSharp/
 
 Morph supports two rendering backends:
 
-| Backend | Package | Pros |
-|---------|---------|------|
-| **SkiaSharp** | `Morph.Skia` | Mature, includes SVG support |
-| **ImageSharp** | `Morph.ImageSharp` | Fully managed (no native dependencies) |
-
-Both backends expose the same API via `WordRender.Skia.DocumentConverter` and `WordRender.ImageSharp.DocumentConverter`.
+| Backend | DOCX Package | HTML Package | Pros |
+|---------|-------------|-------------|------|
+| **SkiaSharp** | `Morph.OpenXml.Skia` | `Morph.Html.Skia` | Mature, includes SVG support |
+| **ImageSharp** | `Morph.OpenXml.ImageSharp` | `Morph.Html.ImageSharp` | Fully managed (no native dependencies) |
 
 
 ## Usage
 
+
+### DOCX to PNG
+
 The examples below use the SkiaSharp backend. To use ImageSharp instead, replace `WordRender.Skia.DocumentConverter` with `WordRender.ImageSharp.DocumentConverter`.
 
 
@@ -201,6 +200,42 @@ var result = converter.ConvertToImages(
 <!-- endSnippet -->
 
 
+### HTML to PNG
+
+To use ImageSharp instead, replace `HtmlRender.Skia.HtmlConverter` with `HtmlRender.ImageSharp.HtmlConverter`.
+
+
+#### Basic Usage - Save to Files
+
+```cs
+var converter = new HtmlRender.Skia.HtmlConverter();
+
+var result = converter.ConvertToImages(
+    "<h1>Hello</h1><p>World</p>",
+    "output-folder");
+
+Console.WriteLine($"Generated {result.PageCount} pages");
+foreach (var path in result.ImagePaths)
+{
+    Console.WriteLine($"Created: {path}");
+}
+```
+
+
+#### In-Memory Conversion
+
+```cs
+var converter = new HtmlRender.Skia.HtmlConverter();
+
+var imageData = converter.ConvertToImageData("<h1>Hello</h1><p>World</p>");
+
+foreach (var pngBytes in imageData)
+{
+    // Use the PNG byte array as needed
+}
+```
+
+
 ## Configuration Options
 
 | Option | Type | Default | Description |