update

Author: mmanela

AGENT.md

@@ -0,0 +1,30 @@
+# DiffPlex Development Guide
+
+## Build/Test Commands
+- Build: `dotnet build`
+- Test all: `dotnet test`
+- Test single project: `dotnet test Facts.DiffPlex`
+- Test specific class: `dotnet test Facts.DiffPlex --filter "FullyQualifiedName~InlineDiffBuilderFacts"`
+- Test specific method: `dotnet test --filter "FullyQualifiedName~ClassName.MethodName"`
+- Restore packages: `dotnet restore`
+
+## Code Style Guidelines
+- **Classes/Interfaces**: PascalCase (interfaces with "I" prefix)
+- **Methods/Properties**: PascalCase
+- **Fields/Parameters/Variables**: camelCase
+- **Constants**: PascalCase
+- Use expression-bodied members for simple getters
+- Modern C# collection initialization: `data.Pieces = [];`
+- Null checks with `ArgumentNullException` for public APIs
+- Singleton pattern with static `Instance` properties
+
+## Test Conventions
+- Test classes: `*Facts` suffix (e.g., `DifferFacts`)
+- Use xUnit with `[Fact]` attributes
+- Nested classes to organize related tests
+- Descriptive test names: `Will_throw_if_parameter_is_null`
+- Use Moq for mocking dependencies
+
+## Error Handling
+- Throw `ArgumentNullException` for null parameters in public APIs
+- Use descriptive parameter names in exceptions

DiffPlex.Blazor/Components/Pages/Home.razor

@@ -76,10 +76,13 @@ This is a sample text
 for demonstrating diff functionality.
 Line 5
 Line 6
-Line 7";
+Line 7
+Line 9
+Deleted Line";
 
     private string newText = @"The quick red fox
 jumps over the lazy cat.
+New Line
 This is a sample text
 for demonstrating diff functionality.
 Line 5 modified

README.md

@@ -198,6 +198,31 @@ DiffPlex also contains a sample website that shows how to create a basic side by
 
 ![Web page sample](./images/website.png)
 
+## Sample Blazor App
+
+DiffPlex includes a Blazor component library and sample application demonstrating how to render textual diffs in modern Blazor applications. The sample showcases both server-side and client-side rendering capabilities with interactive diff visualization.
+
+[Screenshot placeholder - Blazor app overview]
+
+The Blazor components provide:
+- Interactive side-by-side diff rendering
+- Inline diff view mode
+- Responsive design for various screen sizes
+- Customizable styling and themes
+- Real-time diff updates
+
+[Screenshot placeholder - Side-by-side diff view]
+
+[Screenshot placeholder - Inline diff view]
+
+To run the sample Blazor application:
+```bash
+cd DiffPlex.Blazor
+dotnet run
+```
+
+The Blazor library is available as a NuGet package for integration into your own Blazor applications.
+
 # Windows app
 
 There are 2 libraries for Windows app development.