# focusring/horn architecture

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

- Interactive diagram: https://gitdiagram.com/focusring/horn
- Repository: https://github.com/focusring/horn

## Overview

Horn is a PDF/UA-1 and PDF/UA-2 accessibility validator. Its main workflow accepts PDF bytes or a file, parses the document and detects its standard, runs registered automated and manual-review checks, then presents findings in supported report formats. The check suite spans Matterhorn checkpoints, font-program analysis, and PDF/UA-2-specific rules. The README documents CLI use and output capabilities; source excerpts show the library validation path and check registration, but not CLI dispatch or report-writer invocation.

Main entry points: [`src/checks/mod.rs`](https://github.com/focusring/horn/blob/main/src/checks/mod.rs) (Check registry), [`src/lib.rs`](https://github.com/focusring/horn/blob/main/src/lib.rs) (Validation API), [`src/checks/font_program.rs`](https://github.com/focusring/horn/blob/main/src/checks/font_program.rs) (Font checks), [`src/output/mod.rs`](https://github.com/focusring/horn/blob/main/src/output/mod.rs) (Report writers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Validation core"]
  node_api["Validation API<br/>[lib.rs]"]
  node_document["PDF document<br/>[document.rs]"]
  node_registry["Check registry<br/>[mod.rs]"]
end

subgraph group_checks["Accessibility checks"]
  node_matterhorn["Matterhorn coverage<br/>[matterhorn.rs]"]
  node_ua2rules["PDF/UA-2 rules<br/>[pdfua2.rs]"]
  node_generalchecks["General checks"]
  node_structurechecks["Structure checks<br/>[annot_struct.rs]"]
  node_fontchecks["Font checks<br/>[font_program.rs]"]
  node_languagechecks["Language checks<br/>[language.rs]"]
  node_tablechecks["Table checks<br/>[tables.rs]"]
  node_reviewchecks["Manual review<br/>[human_review.rs]"]
  node_ua2checks["UA-2 checks<br/>[annotations.rs]"]
end

subgraph group_analysis["PDF analysis"]
  node_fontprogram["Font parsers<br/>[mod.rs]"]
  node_cmap["CMap analysis<br/>[cmap.rs]"]
end

subgraph group_reporting["Findings and reports"]
  node_reportmodel["Report model<br/>[model.rs]"]
  node_output["Report writers<br/>[mod.rs]"]
end

node_user(("PDF user"))

node_user -->|"requests validation"| node_api
node_api -->|"parses PDF"| node_document
node_api -->|"runs checks"| node_registry
node_registry -->|"registers checks"| node_generalchecks
node_registry -->|"registers checks"| node_ua2checks
node_registry -->|"collects results"| node_reportmodel
node_fontchecks -.->|"uses font analysis"| node_fontprogram
node_fontchecks -.->|"uses CMaps"| node_cmap
node_output -->|"formats reports"| node_reportmodel
node_user -->|"selects format"| node_output

click node_api "https://github.com/focusring/horn/blob/main/src/lib.rs"
click node_document "https://github.com/focusring/horn/blob/main/src/document.rs"
click node_registry "https://github.com/focusring/horn/blob/main/src/checks/mod.rs"
click node_reportmodel "https://github.com/focusring/horn/blob/main/src/model.rs"
click node_matterhorn "https://github.com/focusring/horn/blob/main/src/matterhorn.rs"
click node_ua2rules "https://github.com/focusring/horn/blob/main/src/pdfua2.rs"
click node_generalchecks "https://github.com/focusring/horn/tree/main/src/checks"
click node_structurechecks "https://github.com/focusring/horn/blob/main/src/checks/annot_struct.rs"
click node_fontchecks "https://github.com/focusring/horn/blob/main/src/checks/font_program.rs"
click node_languagechecks "https://github.com/focusring/horn/blob/main/src/checks/language.rs"
click node_tablechecks "https://github.com/focusring/horn/blob/main/src/checks/tables.rs"
click node_reviewchecks "https://github.com/focusring/horn/blob/main/src/checks/human_review.rs"
click node_ua2checks "https://github.com/focusring/horn/blob/main/src/checks/ua2/annotations.rs"
click node_fontprogram "https://github.com/focusring/horn/blob/main/src/fontprog/mod.rs"
click node_cmap "https://github.com/focusring/horn/blob/main/src/content/cmap.rs"
click node_output "https://github.com/focusring/horn/blob/main/src/output/mod.rs"

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_api,node_document,node_registry,node_user toneBlue
class node_matterhorn,node_ua2rules,node_generalchecks,node_structurechecks,node_fontchecks,node_languagechecks,node_tablechecks,node_reviewchecks,node_ua2checks toneAmber
class node_fontprogram,node_cmap toneMint
class node_reportmodel,node_output toneRose
```

## Components

### Validation core

- [Validation API](https://github.com/focusring/horn/blob/main/src/lib.rs): `src/lib.rs`
- [PDF document](https://github.com/focusring/horn/blob/main/src/document.rs): `src/document.rs`
- [Check registry](https://github.com/focusring/horn/blob/main/src/checks/mod.rs): `src/checks/mod.rs`

### Accessibility checks

- [Matterhorn coverage](https://github.com/focusring/horn/blob/main/src/matterhorn.rs): `src/matterhorn.rs`
- [PDF/UA-2 rules](https://github.com/focusring/horn/blob/main/src/pdfua2.rs): `src/pdfua2.rs`
- [General checks](https://github.com/focusring/horn/tree/main/src/checks): `src/checks`
- [Structure checks](https://github.com/focusring/horn/blob/main/src/checks/annot_struct.rs): `src/checks/annot_struct.rs`
- [Font checks](https://github.com/focusring/horn/blob/main/src/checks/font_program.rs): `src/checks/font_program.rs`
- [Language checks](https://github.com/focusring/horn/blob/main/src/checks/language.rs): `src/checks/language.rs`
- [Table checks](https://github.com/focusring/horn/blob/main/src/checks/tables.rs): `src/checks/tables.rs`
- [Manual review](https://github.com/focusring/horn/blob/main/src/checks/human_review.rs): `src/checks/human_review.rs`
- [UA-2 checks](https://github.com/focusring/horn/blob/main/src/checks/ua2/annotations.rs): `src/checks/ua2/annotations.rs`

### PDF analysis

- [Font parsers](https://github.com/focusring/horn/blob/main/src/fontprog/mod.rs): `src/fontprog/mod.rs`
- [CMap analysis](https://github.com/focusring/horn/blob/main/src/content/cmap.rs): `src/content/cmap.rs`

### Findings and reports

- [Report model](https://github.com/focusring/horn/blob/main/src/model.rs): `src/model.rs`
- [Report writers](https://github.com/focusring/horn/blob/main/src/output/mod.rs): `src/output/mod.rs`

### Other components

- **PDF user**

## Connections

- PDF user → Validation API: requests validation (evidence: `README.md`)
- Validation API → PDF document: parses PDF (evidence: `src/lib.rs`)
- Validation API → Check registry: runs checks (evidence: `src/lib.rs`)
- Check registry → General checks: registers checks (evidence: `src/checks/mod.rs`)
- Check registry → UA-2 checks: registers checks (evidence: `src/checks/mod.rs`)
- Check registry → Report model: collects results (evidence: `src/checks/mod.rs`)
- Font checks → Font parsers: uses font analysis (evidence: `src/checks/font_program.rs`)
- Font checks → CMap analysis: uses CMaps (evidence: `src/checks/font_program.rs`)
- Report writers → Report model: formats reports (evidence: `src/output/mod.rs`)
- PDF user → Report writers: selects format (evidence: `README.md`)
