name-variants 0.1.0

Multilingual name romanization lookup tables: Chinese, Japanese, Korean, Arabic, Vietnamese, Indian, Persian, Hebrew, Thai, Greek, Turkish, Russian, Indonesian/Malay
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

# name-variants

Multilingual name romanization lookup tables for Rust — Chinese, Japanese, Korean,
Arabic, Vietnamese, Indian, Persian, Hebrew, Thai, Greek, Turkish, Russian, Indonesian/Malay.

Maps romanization variants to their canonical native-script key so that
`Chen`, `Chan`, and `Tan` all resolve to `陈`.

## Usage

```rust
use name_variants::lookup_key;

assert_eq!(lookup_key("Chan"),      Some("陈"));
assert_eq!(lookup_key("chen"),      Some("陈"));   // case-insensitive
assert_eq!(lookup_key("park"),      Some("박"));
assert_eq!(lookup_key("Muhammad"),  Some("محمد"));
assert_eq!(lookup_key("Smith"),     None);

// Multi-word: first matching token wins
assert_eq!(lookup_key("Chan Wai Ming"), Some("陈"));
```

## Install

```toml
[dependencies]
name-variants = "0.1"
```

## Design

- **Canonical key is always the native script form** — `陈`, `박`, `محمد`
- **Zero runtime dependencies** — all data in a compile-time perfect hash map (`phf`)
- **Case-insensitive** — input is lowercased before lookup
- **`None` for unknowns** — explicit signal to fall back to fuzzy matching