# strangelion/latexsnipper-core architecture

> Architecture diagram of the GitHub repository strangelion/latexsnipper-core, 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/strangelion/latexsnipper-core
- Repository: https://github.com/strangelion/latexsnipper-core

## Overview

LaTeXSnipper Core is a Rust document-understanding platform centered on a shared editable Document AST. Its principal workflow accepts files or pixels, decodes/imports them, runs model-driven OCR and document-structure recognition, resolves regions and reading order, then converts or exports the AST. The repository also exposes native/WASM and application adapters, model/runtime management, plugins, and drawing contracts. Connections below follow README architecture/capability statements and shown source references; unsampled internals are represented at their exact crate paths, with no guessed implementation-level links.

Main entry points: [`crates/engine/src/engine.rs`](https://github.com/strangelion/latexsnipper-core/blob/main/crates/engine/src/engine.rs) (Engine service), [`crates/ast/src/document.rs`](https://github.com/strangelion/latexsnipper-core/blob/main/crates/ast/src/document.rs) (Document AST), [`crates/pipeline/src/graph.rs`](https://github.com/strangelion/latexsnipper-core/blob/main/crates/pipeline/src/graph.rs) (Recognition pipeline), [`crates/cli/src/main.rs`](https://github.com/strangelion/latexsnipper-core/blob/main/crates/cli/src/main.rs) (CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI<br/>[main.rs]"]
  node_sdk["Rust SDK<br/>[sdk.rs]"]
  node_ffi["Native adapters<br/>[application_c.rs]"]
  node_worker["Local worker<br/>[lib.rs]"]
  node_wasm["WASM API<br/>[api.rs]"]
  node_jsclient["Browser client<br/>[client.ts]"]
end

subgraph group_processing["Document processing"]
  node_engine["Engine service<br/>[engine.rs]"]
  node_image["Image and PDF input<br/>[decode.rs]"]
  node_import["Format import<br/>[importer.rs]"]
  node_pipeline["Recognition pipeline<br/>[graph.rs]"]
  node_inference["OCR inference"]
  node_ast["Document AST<br/>[document.rs]"]
end

subgraph group_models["Models and runtimes"]
  node_models[("Model registry<br/>[manager.rs]")]
  node_runtime["Runtime selection<br/>[factory.rs]"]
  node_nativebackends["Native backends<br/>[session.rs]"]
  node_tract["Tract WASM<br/>[session.rs]"]
end

subgraph group_formats["Conversion and output"]
  node_conversion["Format conversion<br/>[converter.rs]"]
  node_syntax["Syntax formats<br/>[parser.rs]"]
  node_export["Export service<br/>[service.rs]"]
  node_render["Render tree<br/>[render_tree.rs]"]
  node_generator["Output generators<br/>[generator.rs]"]
  node_drawing["Drawing contracts<br/>[adapter.rs]"]
end

subgraph group_extensions["Extensions"]
  node_plugins["Plugin host"]
  node_wasi["WASI host<br/>[host.rs]"]
  node_runtimeabi["Runtime plugin ABI<br/>[host.rs]"]
end

node_caller(("Applications"))

node_caller -->|"invokes"| node_cli
node_caller -->|"uses"| node_sdk
node_caller -->|"uses"| node_ffi
node_caller -->|"requests"| node_worker
node_caller -->|"uses"| node_jsclient
node_cli -->|"imports"| node_import
node_sdk -.->|"calls"| node_engine
node_ffi -->|"adapts"| node_engine
node_worker -->|"serves"| node_engine
node_wasm -.->|"exposes"| node_engine
node_jsclient -.->|"requests"| node_wasm
node_engine -->|"processes"| node_image
node_engine -->|"dispatches"| node_import
node_engine -->|"runs"| node_pipeline
node_image -->|"supplies pixels"| node_pipeline
node_import -->|"builds"| node_ast
node_pipeline -->|"dispatches"| node_inference
node_pipeline -->|"produces"| node_ast
node_engine -->|"resolves models"| node_models
node_engine -->|"selects runtime"| node_runtime
node_runtime -.->|"uses providers"| node_nativebackends
node_pipeline -->|"runs in browser"| node_tract
node_cli -->|"converts"| node_conversion
node_conversion -->|"reads and writes"| node_ast
node_syntax -.->|"parses formats"| node_ast
node_cli -->|"exports"| node_export
node_export -->|"builds"| node_render
node_export -->|"dispatches"| node_generator
node_render -->|"feeds"| node_generator
node_export -->|"reads"| node_ast
node_drawing -->|"adapts"| node_ast
node_engine -.->|"supports hooks"| node_plugins
node_plugins -->|"activates components"| node_wasi
node_runtime -->|"loads extensions"| node_runtimeabi

click node_cli "https://github.com/strangelion/latexsnipper-core/blob/main/crates/cli/src/main.rs"
click node_sdk "https://github.com/strangelion/latexsnipper-core/blob/main/crates/engine/src/sdk.rs"
click node_ffi "https://github.com/strangelion/latexsnipper-core/blob/main/crates/ffi/src/application_c.rs"
click node_worker "https://github.com/strangelion/latexsnipper-core/blob/main/crates/worker/src/lib.rs"
click node_wasm "https://github.com/strangelion/latexsnipper-core/blob/main/crates/wasm/src/api.rs"
click node_jsclient "https://github.com/strangelion/latexsnipper-core/blob/main/crates/wasm/js/src/client.ts"
click node_engine "https://github.com/strangelion/latexsnipper-core/blob/main/crates/engine/src/engine.rs"
click node_image "https://github.com/strangelion/latexsnipper-core/blob/main/crates/image/src/decode.rs"
click node_import "https://github.com/strangelion/latexsnipper-core/blob/main/crates/conversion/src/importer.rs"
click node_pipeline "https://github.com/strangelion/latexsnipper-core/blob/main/crates/pipeline/src/graph.rs"
click node_inference "https://github.com/strangelion/latexsnipper-core/blob/main/crates/inference/src/formula_recognizer.rs"
click node_ast "https://github.com/strangelion/latexsnipper-core/blob/main/crates/ast/src/document.rs"
click node_models "https://github.com/strangelion/latexsnipper-core/blob/main/crates/model/src/manager.rs"
click node_runtime "https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime/src/factory.rs"
click node_nativebackends "https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime-executorch/src/session.rs"
click node_tract "https://github.com/strangelion/latexsnipper-core/blob/main/crates/tract/src/session.rs"
click node_conversion "https://github.com/strangelion/latexsnipper-core/blob/main/crates/conversion/src/converter.rs"
click node_syntax "https://github.com/strangelion/latexsnipper-core/blob/main/crates/syntax/src/parser.rs"
click node_export "https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/service.rs"
click node_render "https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/render_tree.rs"
click node_generator "https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/generator.rs"
click node_drawing "https://github.com/strangelion/latexsnipper-core/blob/main/crates/drawing/src/adapter.rs"
click node_plugins "https://github.com/strangelion/latexsnipper-core/blob/main/crates/plugin/src/registry_manager.rs"
click node_wasi "https://github.com/strangelion/latexsnipper-core/blob/main/crates/plugin-wasi/src/host.rs"
click node_runtimeabi "https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime-plugin-api/src/host.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_cli,node_sdk,node_ffi,node_worker,node_wasm,node_jsclient toneBlue
class node_engine,node_image,node_import,node_pipeline,node_inference,node_ast toneAmber
class node_models,node_runtime,node_nativebackends,node_tract toneMint
class node_conversion,node_syntax,node_export,node_render,node_generator,node_drawing toneRose
class node_plugins,node_wasi,node_runtimeabi,node_caller toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/strangelion/latexsnipper-core/blob/main/crates/cli/src/main.rs): `crates/cli/src/main.rs`
- [Rust SDK](https://github.com/strangelion/latexsnipper-core/blob/main/crates/engine/src/sdk.rs): `crates/engine/src/sdk.rs`
- [Native adapters](https://github.com/strangelion/latexsnipper-core/blob/main/crates/ffi/src/application_c.rs): `crates/ffi/src/application_c.rs`
- [Local worker](https://github.com/strangelion/latexsnipper-core/blob/main/crates/worker/src/lib.rs): `crates/worker/src/lib.rs`
- [WASM API](https://github.com/strangelion/latexsnipper-core/blob/main/crates/wasm/src/api.rs): `crates/wasm/src/api.rs`
- [Browser client](https://github.com/strangelion/latexsnipper-core/blob/main/crates/wasm/js/src/client.ts): `crates/wasm/js/src/client.ts`

### Document processing

- [Engine service](https://github.com/strangelion/latexsnipper-core/blob/main/crates/engine/src/engine.rs): `crates/engine/src/engine.rs`
- [Image and PDF input](https://github.com/strangelion/latexsnipper-core/blob/main/crates/image/src/decode.rs): `crates/image/src/decode.rs`
- [Format import](https://github.com/strangelion/latexsnipper-core/blob/main/crates/conversion/src/importer.rs): `crates/conversion/src/importer.rs`
- [Recognition pipeline](https://github.com/strangelion/latexsnipper-core/blob/main/crates/pipeline/src/graph.rs): `crates/pipeline/src/graph.rs`
- [OCR inference](https://github.com/strangelion/latexsnipper-core/blob/main/crates/inference/src/formula_recognizer.rs): `crates/inference/src/formula_recognizer.rs`
- [Document AST](https://github.com/strangelion/latexsnipper-core/blob/main/crates/ast/src/document.rs): `crates/ast/src/document.rs`

### Models and runtimes

- [Model registry](https://github.com/strangelion/latexsnipper-core/blob/main/crates/model/src/manager.rs): `crates/model/src/manager.rs`
- [Runtime selection](https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime/src/factory.rs): `crates/runtime/src/factory.rs`
- [Native backends](https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime-executorch/src/session.rs): `crates/runtime-executorch/src/session.rs`
- [Tract WASM](https://github.com/strangelion/latexsnipper-core/blob/main/crates/tract/src/session.rs): `crates/tract/src/session.rs`

### Conversion and output

- [Format conversion](https://github.com/strangelion/latexsnipper-core/blob/main/crates/conversion/src/converter.rs): `crates/conversion/src/converter.rs`
- [Syntax formats](https://github.com/strangelion/latexsnipper-core/blob/main/crates/syntax/src/parser.rs): `crates/syntax/src/parser.rs`
- [Export service](https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/service.rs): `crates/export/src/service.rs`
- [Render tree](https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/render_tree.rs): `crates/export/src/render_tree.rs`
- [Output generators](https://github.com/strangelion/latexsnipper-core/blob/main/crates/export/src/generator.rs): `crates/export/src/generator.rs`
- [Drawing contracts](https://github.com/strangelion/latexsnipper-core/blob/main/crates/drawing/src/adapter.rs): `crates/drawing/src/adapter.rs`

### Extensions

- [Plugin host](https://github.com/strangelion/latexsnipper-core/blob/main/crates/plugin/src/registry_manager.rs): `crates/plugin/src/registry_manager.rs`
- [WASI host](https://github.com/strangelion/latexsnipper-core/blob/main/crates/plugin-wasi/src/host.rs): `crates/plugin-wasi/src/host.rs`
- [Runtime plugin ABI](https://github.com/strangelion/latexsnipper-core/blob/main/crates/runtime-plugin-api/src/host.rs): `crates/runtime-plugin-api/src/host.rs`

### Other components

- **Applications**

## Connections

- Applications → CLI: invokes (evidence: `README.md`)
- Applications → Rust SDK: uses (evidence: `README.md`)
- Applications → Native adapters: uses (evidence: `README.md`)
- Applications → Local worker: requests (evidence: `README.md`)
- Applications → Browser client: uses (evidence: `README.md`)
- CLI → Format import: imports (evidence: `crates/cli/src/main.rs`)
- Rust SDK → Engine service: calls
- Native adapters → Engine service: adapts (evidence: `README.md`)
- Local worker → Engine service: serves (evidence: `README.md`)
- WASM API → Engine service: exposes
- Browser client → WASM API: requests
- Engine service → Image and PDF input: processes (evidence: `README.md`)
- Engine service → Format import: dispatches (evidence: `README.md`)
- Engine service → Recognition pipeline: runs (evidence: `README.md`)
- Image and PDF input → Recognition pipeline: supplies pixels (evidence: `README.md`)
- Format import → Document AST: builds (evidence: `README.md`)
- Recognition pipeline → OCR inference: dispatches (evidence: `README.md`)
- Recognition pipeline → Document AST: produces (evidence: `README.md`)
- Engine service → Model registry: resolves models (evidence: `crates/engine/src/engine.rs`)
- Engine service → Runtime selection: selects runtime (evidence: `README.md`)
- Runtime selection → Native backends: uses providers
- Recognition pipeline → Tract WASM: runs in browser (evidence: `README.md`)
- CLI → Format conversion: converts (evidence: `crates/cli/src/main.rs`)
- Format conversion → Document AST: reads and writes (evidence: `README.md`)
- Syntax formats → Document AST: parses formats
- CLI → Export service: exports (evidence: `crates/cli/src/main.rs`)
- Export service → Render tree: builds (evidence: `crates/export/src/service.rs`)
- Export service → Output generators: dispatches (evidence: `crates/export/src/service.rs`)
- Render tree → Output generators: feeds (evidence: `crates/export/src/generator.rs`)
- Export service → Document AST: reads (evidence: `crates/export/src/service.rs`)
- Drawing contracts → Document AST: adapts (evidence: `README.md`)
- Engine service → Plugin host: supports hooks
- Plugin host → WASI host: activates components (evidence: `README.md`)
- Runtime selection → Runtime plugin ABI: loads extensions (evidence: `README.md`)
