> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myspellchecker.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> Multi-layer validation architecture with a 12-strategy pipeline, from deterministic syllable rules to ONNX-powered AI inference.
The core design principle is **fail fast, go deeper only when needed**. Cheap deterministic checks (syllable structure, dictionary lookups) run first and reject \~90% of errors before expensive operations (N-gram context, grammar rules, AI inference) are ever invoked. Each layer receives only the output that passed the layer below.
## Design Philosophy
Myanmar text has no spaces between words, so splitting on whitespace doesn't work. Instead, the pipeline starts from syllables and builds up:
1. **Break into syllables** (deterministic, fast)
2. **Validate syllables** (catches \~90% of errors)
3. **Assemble into words** (only with valid syllables)
4. **Check grammar and context** (only with valid words)
This "fail-fast" approach catches obvious typos immediately without wasting resources on deeper analysis.
## High-Level Architecture
```text theme={null}
+------------------+
| User Input |
+--------+---------+
|
v
+------------------+
| Segmenter |
| (Syllable/Word) |
+--------+---------+
|
+----------+----------+----------+
| | | |
v v v v
+--------+ +------+--+ +---+----+ +--+-------+
| Layer 1 | | Layer 2 | | L 2.5 | | Layer 3 |
|Syllable | | Word | |Grammar | | Context |
|Validator| |Validator | |Rules | |Validator |
+---------+ +---------+ +--------+ +----------+
| | | |
+----------+----------+----------+
|
v
+------------------+ +------------------+
| Dictionary | | Response |
| Provider | ----> | (errors, |
| (SQLite/Memory) | | suggestions, |
+------------------+ | corrected_text) |
+------------------+
```
## Core Components
| Component | Purpose |
| ----------------------- | -------------------------------------------------------- |
| **SpellChecker** | Main coordinator that orchestrates all validation layers |
| **SpellCheckerBuilder** | Fluent interface for constructing SpellChecker instances |
| **DictionaryProvider** | Pluggable storage backend (SQLite, Memory, JSON) |
| **Segmenter** | Text segmentation (syllable + word) |
| **SyllableValidator** | Layer 1: syllable structure validation |
| **WordValidator** | Layer 2: word lookup + SymSpell suggestions |
| **ContextValidator** | Layer 3: N-gram + validation strategies |
## Validation Strategies
The context validation layer uses a Strategy pattern for modular, priority-ordered validation:
Each strategy can be enabled/disabled via configuration. See [Validation Strategies](/features/validation-strategies).
## Offline Systems
### Data Pipeline
Transforms raw corpus into optimized dictionary database:
### Training Pipeline
Creates AI models for semantic checking (BYOM):
## Design Principles
1. **Fail Fast**: Catch errors at the earliest possible layer
2. **Layered Validation**: Each layer adds accuracy at a cost
3. **Pluggable Components**: Swap providers, segmenters, taggers
4. **Graceful Degradation**: Continue working even if optional components fail
5. **Performance First**: Optimize hot paths with Cython/OpenMP
## Architecture Documents
Detailed component architecture and class responsibilities
Pipeline deep-dive with execution flow
Visual component relationships
Data flow through the system
How to extend the system
DI container system