# simonebortolin/sharpequations architecture

> Architecture diagram of the GitHub repository simonebortolin/sharpequations, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/simonebortolin/sharpequations
- Repository: https://github.com/simonebortolin/sharpequations

## Overview

SharpEquations is a .NET equation-conversion library with shared MathML representation, plus a real-time equation editor and read-only view across Avalonia, Uno/WinUI, WPF, and Windows Forms. The converter workflow parses a selected format into normalized MathML and writes supported target formats; MTEF is read-only. The editor workflow accepts linear input, builds and edits a math tree, then lays it out for a toolkit canvas. The README documents format coverage and editor features; unsampled serializers and some toolkit wiring are shown only where documented, not inferred as specific calls.

Main entry points: [`src/SharpEquations.Editing/MathEditor.cs`](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathEditor.cs) (Math editor), [`src/SharpEquations.Rendering/MathEditorView.cs`](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathEditorView.cs) (Editor view), [`src/SharpEquations/Internal/EquationPipeline.cs`](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/EquationPipeline.cs) (Format pipeline), [`src/SharpEquations/Public/Equation.cs`](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Public/Equation.cs) (Equation API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversion["Conversion core"]
  node_equation["Equation API<br/>[Equation.cs]"]
  node_pipeline["Format pipeline"]
end

subgraph group_formats["Format readers"]
  node_mathml["MathML parser<br/>[MathMLParser.cs]"]
  node_latex["LaTeX reader<br/>[LaTeXParser.cs]"]
  node_unicode["UnicodeMath reader"]
  node_omml["OMML reader<br/>[OmmlParser.cs]"]
  node_mtef["MTEF reader<br/>[MtefParser.cs]"]
  node_serializers["Format writers"]
end

subgraph group_editing["Editing model"]
  node_editor["Math editor<br/>[MathEditor.cs]"]
  node_tree["Math tree<br/>[MathTree.cs]"]
  node_buildup["Linear build-up<br/>[BuildUp.cs]"]
  node_autocorrect["Auto-correction<br/>[MathAutoCorrect.cs]"]
end

subgraph group_rendering["Layout and drawing"]
  node_layoutapi["Layout engine API"]
  node_layouter["Structure layout<br/>[Engine.cs]"]
  node_layout["Layout geometry<br/>[MathLayout.cs]"]
  node_font["OpenType math font"]
  node_view["Editor view<br/>[MathEditorView.cs]"]
  node_canvas["Canvas contract<br/>[IMathCanvas.cs]"]
end

subgraph group_toolkits["UI toolkits"]
  node_avalonia["Avalonia controls<br/>[MathEditBox.cs]"]
  node_uno["Uno controls<br/>[MathEditBox.cs]"]
  node_wpf["WPF controls<br/>[MathEditBox.cs]"]
  node_winforms["WinForms controls<br/>[MathEditBox.cs]"]
end

node_caller(("Application"))

node_caller -->|"uses API"| node_equation
node_equation -->|"reads through"| node_pipeline
node_pipeline -->|"normalizes"| node_mathml
node_pipeline -->|"dispatches read"| node_latex
node_pipeline -->|"dispatches read"| node_unicode
node_pipeline -->|"dispatches read"| node_omml
node_pipeline -->|"dispatches read"| node_mtef
node_equation -.->|"writes formats"| node_serializers
node_editor -->|"edits structure"| node_tree
node_editor -->|"builds input"| node_buildup
node_editor -->|"applies corrections"| node_autocorrect
node_layoutapi -->|"delegates layout"| node_layouter
node_layouter -->|"queries glyphs"| node_font
node_layoutapi -->|"produces geometry"| node_layout
node_view -->|"presents edits"| node_editor
node_view -.->|"measures equation"| node_layoutapi
node_view -->|"draws on"| node_canvas
node_avalonia -->|"uses editing"| node_editor
node_avalonia -->|"uses view"| node_view
node_uno -->|"uses editing"| node_editor
node_uno -->|"uses view"| node_view
node_wpf -->|"uses editing"| node_editor
node_wpf -->|"uses view"| node_view
node_winforms -->|"uses editing"| node_editor
node_winforms -->|"uses view"| node_view

click node_equation "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Public/Equation.cs"
click node_pipeline "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/EquationPipeline.cs"
click node_mathml "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/MathML/MathMLParser.cs"
click node_latex "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/LaTeX/LaTeXParser.cs"
click node_unicode "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/UnicodeMath/UnicodeMathParser.cs"
click node_omml "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/Omml/OmmlParser.cs"
click node_mtef "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/Mtef/MtefParser.cs"
click node_serializers "https://github.com/simonebortolin/sharpequations/tree/main/src/SharpEquations/Internal"
click node_editor "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathEditor.cs"
click node_tree "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathTree.cs"
click node_buildup "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/BuildUp.cs"
click node_autocorrect "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathAutoCorrect.cs"
click node_layoutapi "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathLayoutEngine.cs"
click node_layouter "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/Layout/Engine.cs"
click node_layout "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathLayout.cs"
click node_font "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/OpenTypeMathFont.cs"
click node_view "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathEditorView.cs"
click node_canvas "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/IMathCanvas.cs"
click node_avalonia "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Avalonia/MathEditBox.cs"
click node_uno "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Uno/MathEditBox.cs"
click node_wpf "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Wpf/MathEditBox.cs"
click node_winforms "https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.WinForms/MathEditBox.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_equation,node_pipeline toneBlue
class node_mathml,node_latex,node_unicode,node_omml,node_mtef,node_serializers toneAmber
class node_editor,node_tree,node_buildup,node_autocorrect toneMint
class node_layoutapi,node_layouter,node_layout,node_font,node_view,node_canvas toneRose
class node_avalonia,node_uno,node_wpf,node_winforms,node_caller toneIndigo
```

## Components

### Conversion core

- [Equation API](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Public/Equation.cs): `src/SharpEquations/Public/Equation.cs`
- [Format pipeline](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/EquationPipeline.cs): `src/SharpEquations/Internal/EquationPipeline.cs`

### Format readers

- [MathML parser](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/MathML/MathMLParser.cs): `src/SharpEquations/Internal/MathML/MathMLParser.cs`
- [LaTeX reader](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/LaTeX/LaTeXParser.cs): `src/SharpEquations/Internal/LaTeX/LaTeXParser.cs`
- [UnicodeMath reader](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/UnicodeMath/UnicodeMathParser.cs): `src/SharpEquations/Internal/UnicodeMath/UnicodeMathParser.cs`
- [OMML reader](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/Omml/OmmlParser.cs): `src/SharpEquations/Internal/Omml/OmmlParser.cs`
- [MTEF reader](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations/Internal/Mtef/MtefParser.cs): `src/SharpEquations/Internal/Mtef/MtefParser.cs`
- [Format writers](https://github.com/simonebortolin/sharpequations/tree/main/src/SharpEquations/Internal): `src/SharpEquations/Internal`

### Editing model

- [Math editor](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathEditor.cs): `src/SharpEquations.Editing/MathEditor.cs`
- [Math tree](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathTree.cs): `src/SharpEquations.Editing/MathTree.cs`
- [Linear build-up](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/BuildUp.cs): `src/SharpEquations.Editing/BuildUp.cs`
- [Auto-correction](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Editing/MathAutoCorrect.cs): `src/SharpEquations.Editing/MathAutoCorrect.cs`

### Layout and drawing

- [Layout engine API](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathLayoutEngine.cs): `src/SharpEquations.Rendering/MathLayoutEngine.cs`
- [Structure layout](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/Layout/Engine.cs): `src/SharpEquations.Rendering/Layout/Engine.cs`
- [Layout geometry](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathLayout.cs): `src/SharpEquations.Rendering/MathLayout.cs`
- [OpenType math font](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/OpenTypeMathFont.cs): `src/SharpEquations.Rendering/OpenTypeMathFont.cs`
- [Editor view](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/MathEditorView.cs): `src/SharpEquations.Rendering/MathEditorView.cs`
- [Canvas contract](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Rendering/IMathCanvas.cs): `src/SharpEquations.Rendering/IMathCanvas.cs`

### UI toolkits

- [Avalonia controls](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Avalonia/MathEditBox.cs): `src/SharpEquations.Avalonia/MathEditBox.cs`
- [Uno controls](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Uno/MathEditBox.cs): `src/SharpEquations.Uno/MathEditBox.cs`
- [WPF controls](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.Wpf/MathEditBox.cs): `src/SharpEquations.Wpf/MathEditBox.cs`
- [WinForms controls](https://github.com/simonebortolin/sharpequations/blob/main/src/SharpEquations.WinForms/MathEditBox.cs): `src/SharpEquations.WinForms/MathEditBox.cs`

### Other components

- **Application**

## Connections

- Application → Equation API: uses API (evidence: `README.md`)
- Equation API → Format pipeline: reads through (evidence: `src/SharpEquations/Public/Equation.cs`)
- Format pipeline → MathML parser: normalizes (evidence: `src/SharpEquations/Internal/EquationPipeline.cs`)
- Format pipeline → LaTeX reader: dispatches read (evidence: `src/SharpEquations/Internal/EquationPipeline.cs`)
- Format pipeline → UnicodeMath reader: dispatches read (evidence: `src/SharpEquations/Internal/EquationPipeline.cs`)
- Format pipeline → OMML reader: dispatches read (evidence: `src/SharpEquations/Internal/EquationPipeline.cs`)
- Format pipeline → MTEF reader: dispatches read (evidence: `src/SharpEquations/Internal/EquationPipeline.cs`)
- Equation API → Format writers: writes formats (evidence: `README.md`)
- Math editor → Math tree: edits structure (evidence: `src/SharpEquations.Editing/MathEditor.cs`)
- Math editor → Linear build-up: builds input (evidence: `src/SharpEquations.Editing/MathEditor.cs`)
- Math editor → Auto-correction: applies corrections (evidence: `src/SharpEquations.Editing/MathEditor.cs`)
- Layout engine API → Structure layout: delegates layout (evidence: `src/SharpEquations.Rendering/MathLayoutEngine.cs`)
- Structure layout → OpenType math font: queries glyphs (evidence: `src/SharpEquations.Rendering/Layout/Engine.cs`)
- Layout engine API → Layout geometry: produces geometry (evidence: `src/SharpEquations.Rendering/MathLayoutEngine.cs`)
- Editor view → Math editor: presents edits (evidence: `src/SharpEquations.Rendering/MathEditorView.cs`)
- Editor view → Layout engine API: measures equation (evidence: `src/SharpEquations.Rendering/MathEditorView.cs`)
- Editor view → Canvas contract: draws on (evidence: `src/SharpEquations.Rendering/MathEditorView.cs`)
- Avalonia controls → Math editor: uses editing (evidence: `src/SharpEquations.Avalonia/MathEditBox.cs`)
- Avalonia controls → Editor view: uses view (evidence: `src/SharpEquations.Avalonia/MathEditBox.cs`)
- Uno controls → Math editor: uses editing (evidence: `src/SharpEquations.Uno/MathEditBox.cs`)
- Uno controls → Editor view: uses view (evidence: `src/SharpEquations.Uno/MathEditBox.cs`)
- WPF controls → Math editor: uses editing (evidence: `src/SharpEquations.Wpf/MathEditBox.cs`)
- WPF controls → Editor view: uses view (evidence: `src/SharpEquations.Wpf/MathEditBox.cs`)
- WinForms controls → Math editor: uses editing (evidence: `src/SharpEquations.WinForms/MathEditBox.cs`)
- WinForms controls → Editor view: uses view (evidence: `src/SharpEquations.WinForms/MathEditBox.cs`)
