kiril-lotin/README.md

O'zbek tilida kiril va lotin o'rtasida konvertatsiya qilish uchun oddiy modul

# kiril-lotin

O'zbek tilidagi matnlarni **kiril**dan **lotin**ga va **lotin**dan **kiril**ga avtomatik o‘giruvchi oddiy JavaScript kutubxonasi.

---

## ✨ Xususiyatlar

- Kiril → Lotin transliteratsiyasi
- Lotin → Kiril transliteratsiyasi
- Toza, soddalashtirilgan funksiya chaqiriqlari
- Node.js va brauzer muhitida ishlaydi

---

## 📦 O‘rnatish

```bash
npm install kiril-lotin
```

Yoki `yarn` orqali:

```bash
yarn add kiril-lotin
```

---

## 🚀 Foydalanish

```js
const { kirilToLotin, lotinToKiril } = require("kiril-lotin");

// Kirildan lotinga
const lotinMatn = kirilToLotin("Салом дунё!");
console.log(lotinMatn); // Salom dunyo!

// Lotindan kirilga
const kirilMatn = lotinToKiril("Salom dunyo!");
console.log(kirilMatn); // Салом дунё!
```

---

## 🔧 Funksiyalar

### `kirilToLotin(text: string): string`

Berilgan kiril yozuvidagi matnni lotin yozuviga o‘giradi.

### `lotinToKiril(text: string): string`

Berilgan lotin yozuvidagi matnni kiril yozuviga o‘giradi.

---

## 📄 Litsenziya

MIT — bemalol foydalaning, o‘rganing, ulashing.

---

## 👨‍💻 Muallif

Yaratdi: Shoislom Shobaxromov
Ishonchli va yengil transliteratsiya uchun yaratilgan 🔁

---

## ❤️ Hissa qo‘shish

Takliflaringiz yoki `pull request`laringizni mamnuniyat bilan kutib qolamiz! Yordam berish yoki yaxshilashni istasangiz, `issues` oching yoki to‘g‘ridan-to‘g‘ri `PR` yuboring.