varna 1.0.0

Varna — multilingual language engine: phoneme inventories, G2P rules, scripts, grammar, and lexicon for 50+ languages
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# Varna

> **Varna** (Sanskrit: वर्ण — letter, character, sound) — multilingual language engine for AGNOS

Structured, queryable corpus of human language data. Phoneme inventories, writing system metadata, grammar profiles, and lexicon access for 50+ languages.

Used by [shabda](https://github.com/MacCracken/shabda) (G2P conversion), [shabdakosh](https://github.com/MacCracken/shabdakosh) (pronunciation dictionary), [svara](https://github.com/MacCracken/svara) (vocal synthesis), [jnana](https://github.com/MacCracken/jnana) (knowledge system), and [vidya](https://github.com/MacCracken/vidya) (programming reference).

## Modules

| Module | Description |
|--------|-------------|
| `phoneme` | IPA phoneme inventories per language, articulatory features (manner, place, voicing), stress/tone patterns |
| `script` | Writing system metadata: alphabet, syllabary, logographic, abjad, abugida. Unicode ranges, directionality |
| `grammar` | Morphological typology (isolating, agglutinative, fusional, polysynthetic), word order, case systems |
| `lexicon` | Core vocabulary per language (Swadesh lists, frequency-ranked word lists), cognate detection |

## Features

| Feature | Default | Description |
|---------|---------|-------------|
| `std` | yes | Standard library support |
| `logging` | no | Structured logging via `LIPI_LOG` env var |
| `full` | -- | Enables all features |

## Quick Start

```toml
[dependencies]
varna = "0.1"
```

```rust
use varna::phoneme::{self, StressPattern};

// Get the English phoneme inventory
let en = phoneme::english();
assert!(en.has("θ"));           // voiceless dental fricative (think)
assert!(en.has("ð"));           // voiced dental fricative (this)
assert!(!en.has("ʀ"));          // no uvular trill in English
assert_eq!(en.stress, StressPattern::Free);
println!("{} consonants, {} vowels", en.consonant_count(), en.vowel_count());

// Look up a specific phoneme
let sh = en.find("ʃ").unwrap(); // postalveolar fricative (ship)
```

## Architecture

```text
varna (this) — language structure & phoneme inventories
  | provides phoneme sets per language
shabda — G2P conversion (currently English-only, varna makes it multilingual)
  | produces phoneme sequences
shabdakosh — pronunciation dictionary (currently CMUdict, varna adds IPA dicts)
  | lookup fallback
svara — vocal synthesis (consumes phonemes, produces audio)
  | voice output
dhvani — audio engine (mixing, DSP, output)
```

Also feeds:
- **jnana** — multilingual knowledge access
- **vidya** — programming concepts explained in native languages
- **vansh** (planned) — voice assistant with multilingual TTS/STT
- **sahifa** (planned) — OCR language detection, multilingual document processing

## Development

```bash
make check     # fmt + clippy + test + audit
make bench     # Run benchmarks with history tracking
make coverage  # Generate coverage report
make doc       # Build documentation
```

## License

GPL-3.0-only. See [LICENSE](LICENSE).