kalpak-js 1.0.0

package/README.md

@@ -0,0 +1,50 @@
+# Kalpak.js 🧢
+
+A lightweight, accurate JavaScript library for transliterating **Karakalpak** text between Latin and Cyrillic scripts.
+Built by [**Ishipiskenler**](https://github.com/ishipiskenler) (The Doers).
+
+> **Note:** This library follows the official Karakalpak alphabet tables (Yellow Table standards).
+
+## ✨ Features
+
+- **Latin ➡️ Cyrillic**: Handles complex digraphs (Sh, Ch, etc.) correctly.
+- **Cyrillic ➡️ Latin**: Supports official mappings (e.g., И→I, Ы→Í).
+- **Zero Dependencies**: Pure JavaScript. Fast and simple.
+
+## 📦 Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/ishipiskenler/karakalpak-translit-js.git
+```
+
+_(NPM package coming soon!)_
+
+## 🚀 Usage
+
+```javascript
+const { latinToCyrillic, cyrillicToLatin } = require("./index");
+
+// 1. Latin to Cyrillic
+const cyrillic = latinToCyrillic("Sálem, Qaraqalpaqstan!");
+console.log(cyrillic);
+// Output: "Сәлем, Қарақалпақстан!"
+
+// 2. Cyrillic to Latin
+const latin = cyrillicToLatin("Мен сeни жақсы көремен ❤️");
+console.log(latin);
+// Output: "Men seni jaqsı kóremen"
+```
+
+## 🤝 Contributing
+
+We welcome contributions!
+
+1. Fork the repo
+2. Create your feature branch
+3. Commit your changes
+4. Open a Pull Request
+
+---
+
+© 2026 **Ishipiskenler**. Open Source.

package/index.js

@@ -0,0 +1,218 @@
+const latinToCyrillicMap = {
+  // Basic letters
+  A: "А",
+  a: "а",
+  B: "Б",
+  b: "б",
+  D: "Д",
+  d: "д",
+  E: "Е",
+  e: "е",
+  F: "Ф",
+  f: "ф",
+  G: "Г",
+  g: "г",
+  H: "Ҳ",
+  h: "ҳ",
+  X: "Х",
+  x: "х",
+  J: "Ж",
+  j: "ж",
+  K: "К",
+  k: "к",
+  Q: "Қ",
+  q: "қ",
+  L: "Л",
+  l: "л",
+  M: "М",
+  m: "м",
+  N: "Н",
+  n: "н",
+  O: "О",
+  o: "о",
+  P: "П",
+  p: "п",
+  R: "Р",
+  r: "р",
+  S: "С",
+  s: "с",
+  T: "Т",
+  t: "т",
+  U: "У",
+  u: "у",
+  V: "В",
+  v: "в",
+  Z: "З",
+  z: "з",
+
+  // Special Karakalpak letters
+  Á: "Ә",
+  á: "ә",
+  Ó: "Ө",
+  ó: "ө",
+  Ú: "Ү",
+  ú: "ү",
+  I: "И",
+  i: "и",
+  Í: "Ы",
+  ı: "ы",
+  Ǵ: "Ғ",
+  ǵ: "ғ",
+  Ń: "Ң",
+  ń: "ң",
+
+  // Extra letters
+  Y: "Й",
+  y: "й",
+  W: "Ў",
+  w: "ў",
+
+  // Digraphs
+  Sh: "Ш",
+  sh: "ш",
+  SH: "Ш",
+  Yu: "Ю",
+  yu: "ю",
+  Ya: "Я",
+  ya: "я",
+  Yo: "Ё",
+  yo: "ё",
+
+  Ch: "Ч",
+  ch: "ч",
+  CH: "Ч",
+
+  // Optional / borrowed letters
+  C: "Ц",
+  c: "ц",
+};
+
+const cyrillicToLatinMap = {
+  А: "A",
+  а: "a",
+  Ә: "Á",
+  ә: "á",
+  Б: "B",
+  б: "b",
+  В: "V",
+  в: "v",
+  Г: "G",
+  г: "g",
+  Ғ: "Ǵ",
+  ғ: "ǵ",
+  Д: "D",
+  д: "d",
+  Е: "E",
+  е: "e",
+  Ё: "Yo",
+  ё: "yo",
+  Ж: "J",
+  ж: "j",
+  З: "Z",
+  з: "z",
+  И: "I",
+  и: "i",
+  Й: "Y",
+  й: "y",
+  К: "K",
+  к: "k",
+  Қ: "Q",
+  қ: "q",
+  Л: "L",
+  л: "l",
+  М: "M",
+  м: "m",
+  Н: "N",
+  н: "n",
+  Ң: "Ń",
+  ң: "ń",
+  О: "O",
+  о: "o",
+  Ө: "Ó",
+  ө: "ó",
+  П: "P",
+  п: "p",
+  Р: "R",
+  р: "r",
+  С: "S",
+  с: "s",
+  Т: "T",
+  т: "t",
+  У: "U",
+  у: "u",
+  Ү: "Ú",
+  ү: "ú",
+  Ў: "W",
+  ў: "w",
+  Ф: "F",
+  ф: "f",
+  Х: "X",
+  х: "x",
+  Ҳ: "H",
+  ҳ: "h",
+  Ш: "Sh",
+  ш: "sh",
+  Ч: "Ch",
+  ч: "ch",
+  Щ: "Sh",
+  щ: "sh", // optional
+  Ы: "Í",
+  ы: "ı",
+
+  // Borrowed/Russian letters
+  Ц: "C",
+  ц: "c",
+  Э: "E",
+  э: "e",
+  Ю: "Yu",
+  ю: "yu",
+  Я: "Ya",
+  я: "ya",
+  Ъ: "",
+  ъ: "",
+  Ь: "",
+  ь: "",
+};
+
+function latinToCyrillic(text) {
+  let result = "";
+
+  for (let i = 0; i < text.length; i++) {
+    let twoChars = text[i] + (text[i + 1] || "");
+    if (latinToCyrillicMap[twoChars]) {
+      result += latinToCyrillicMap[twoChars];
+      i++;
+      continue;
+    }
+
+    let oneChar = text[i];
+    if (latinToCyrillicMap[oneChar]) {
+      result += latinToCyrillicMap[oneChar];
+    } else {
+      result += oneChar;
+    }
+  }
+
+  return result;
+}
+
+function cyrillicToLatin(text) {
+  let result = "";
+
+  for (let i = 0; i < text.length; i++) {
+    const char = text[i];
+
+    if (cyrillicToLatinMap[char] !== undefined) {
+      result += cyrillicToLatinMap[char];
+    } else {
+      result += char;
+    }
+  }
+
+  return result;
+}
+
+module.exports = {
+  latinToCyrillic,
+  cyrillicToLatin,
+};

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "kalpak-js",
+  "version": "1.0.0",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "description": "A lightweight JavaScript library for Karakalpak Cyrillic-Latin transliteration.",
+  "keywords": [
+    "karakalpak",
+    "transliteration",
+    "cyrillic",
+    "latin",
+    "qaraqalpaq",
+    "language"
+  ],
+  "author": "Ishipiskenler",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ishipiskenler/kalpak-js.git"
+  }
+}