tdk-api-wrapper 1.6.1 → 1.7.1

package/README.md

@@ -1,6 +1,6 @@
 # TDK API Node.js Wrapper
 
-Bu proje, Türk Dil Kurumu (TDK) sözlük verilerine Node.js ortamından doğrudan, hızlı ve güvenilir bir şekilde erişim sağlamak amacıyla geliştirilmiş, TypeScript tabanlı resmî olmayan bir sarmalayıcı (wrapper) kütüphanedir. Herhangi bir dış bağımlılığa veya ikili (binary) dosyaya ihtiyaç duymadan HTTP üzerinden güncel verileri çeker.
+Bu proje, Türk Dil Kurumu (TDK) sözlük verilerine Node.js ortamından doğrudan, hızlı ve güvenilir bir şekilde erişim sağlamak amacıyla geliştirilmiş, TypeScript tabanlı resmî olmayan bir sarmalayıcı (wrapper) kütüphanedir. Herhangi bir dış bağımlılığa veya ikili (binary) dosyaya ihtiyaç duymadan HTTP üzerinden güncel verileri çeker. Kütüphanenin yanı sıra bir terminal CLI'si (`tdk`) ve dahili bir **Model Context Protocol (MCP)** sunucusu da paketle birlikte gelir.
 
 ## Kurulum
 
@@ -46,6 +46,7 @@ tdk repl
 tdk kubbealti merhaba
 tdk nisanyan merhaba
 tdk viki merhaba
+tdk mcp                    # MCP (Model Context Protocol) stdio sunucusunu başlatır
 ```
 
 Herhangi bir komuta `--json` bayrağı eklendiğinde çıktı, insan-okunur metin yerine tek satırlık JSON olarak basılır (script/otomasyon kullanımı için):
@@ -90,7 +91,7 @@ Aşağıdaki metotlar `TDK` sınıfı üzerinden statik olarak veya `TDKClient`
 - **`TDK.checkVowelHarmony(word)`**: Kelimenin büyük ünlü uyumuna uyup uymadığını (boolean) kontrol eder.
 - **`TDK.checkLabialHarmony(word)`**: Kelimenin küçük ünlü uyumuna (düzlük-yuvarlaklık uyumu) uyup uymadığını (boolean) kontrol eder.
 - **`TDK.getPartOfSpeech(word)`**: Kelimenin sözcük türünü (isim, sıfat, zarf vb.) döndürür.
-- **`TDK.checkSpelling(word)`**: Kelimenin doğru yazılıp yazılmadığını kontrol eder. Önce TDK'de doğrudan arar; bulamazsa TDK'nin "sık yapılan yanlışlar" listesini kontrol eder. Ardından **morfolojik ek sıyırma (stemming) motoru** devreye girer; kelime çekimli bir biçimse (`halılarımızın`, `kitabımız`, `çocuğa`, `okuyoruz`, `hakkımızda`, `başlıyor`) kökünü tespit edip `{ isCorrect: true, isInflected: true, root: "..." }` döner. Son aşamada ise TDK'nin ~81 bin kelimelik tam madde listesi üzerinde **klavye ve düzeltme işareti farkındalıklı** bir Damerau-Levenshtein edit-distance ile en yakın kelimeyi önerir: Türkçe Q klavyede yan yana duran tuşlar (`arabs` → `araba`, `swlam` → `selam`) ve ASCII/Türkçe harf ikilileri (`ı/i`, `ş/s`, `ö/o` …) tam bir düzeltme yerine bir düzeltmenin küçük bir kesri kadar sayılır; böylece hem en yakın hem de en olası madde kazanır (`yanlız` → `yalnız`).
+- **`TDK.checkSpelling(word)`**: Kelimenin doğru yazılıp yazılmadığını kontrol eder. Önce TDK'de doğrudan arar; bulamazsa kütüphanenin dahili sık yapılan yanlışlar listesini (`COMMON_MISSPELLINGS` — [referans liste](https://gist.github.com/cemyilmazzzz122/e4bdd509fe9b03a3070a685ab603aaa8)) kontrol eder. Ardından **morfolojik ek sıyırma (stemming) motoru** devreye girer; kelime çekimli bir biçimse (`halılarımızın`, `kitabımız`, `çocuğa`, `okuyoruz`, `hakkımızda`, `başlıyor`) kökünü tespit edip `{ isCorrect: true, isInflected: true, root: "..." }` döner. Son aşamada ise TDK'nin ~81 bin kelimelik tam madde listesi üzerinde **klavye ve düzeltme işareti farkındalıklı** bir Damerau-Levenshtein edit-distance ile en yakın kelimeyi önerir: Türkçe Q klavyede yan yana duran tuşlar (`arabs` → `araba`, `swlam` → `selam`) ve ASCII/Türkçe harf ikilileri (`ı/i`, `ş/s`, `ö/o` …) tam bir düzeltme yerine bir düzeltmenin küçük bir kesri kadar sayılır; böylece hem en yakın hem de en olası madde kazanır (`yanlız` → `yalnız`).
 - **`TDK.getCompoundWords(word)`**: Aranan kelime ile oluşturulmuş birleşik kelimeleri (Örn: dolma kalem) listeler.
 
 ### 3. Morfoloji ve Kök Bulma (Morphology Engine)
@@ -138,6 +139,25 @@ TDK dışındaki bu üç kaynak da her zaman kullanılabilir/dokümante edilmiş
 - **`TDK.getNisanyan(word)`**: Nişanyan Sözlük'ten kelimenin etimoloji paragrafını düz metin olarak döner; kelime bulunamazsa `null`.
 - **`TDK.getWiktionary(word)`**: Türkçe Vikisözlük'ten (`tr.wiktionary.org`) resmî MediaWiki API'si (`action=query&prop=extracts`) üzerinden veri çeker — bu üçü arasında scraping olmayan, resmî ve en kararlı olanı. `{ raw, sections }` döner; `sections` metni `== Köken ==`, `=== Söyleniş ===` gibi başlıklara göre bir sözlüğe ayırır. `getWiktionarySection(word, sectionName)` tek bir bölümü (örn. `"Köken"`) büyük/küçük harf duyarsız süzer. Bu wiki'de başlık büyütme kapalı (`$wgCapitalLinks=false` — "Türkiye" ile bir küçük harfli kelime ayrı sayfalardır), o yüzden `TDK.getWiktionary("türkiye")` gibi tam eşleşmeyen aramalar otomatik olarak ilk harfi (Türkçe kurallarına göre, örn. `istanbul` → `İstanbul`) büyütülmüş hâliyle tekrar denenir.
 
+## Model Context Protocol (MCP) Sunucusu
+
+Paket, bir MCP stdio sunucusu içerir; böylece TDK sözlük, morfoloji, yazım denetimi ve etimoloji araçlarını Claude Desktop, Cursor, Antigravity veya herhangi bir MCP istemcisine yalnızca Node.js ile bağlayabilirsiniz — Python ya da ek bir çalışma zamanı gerekmez.
+
+```json
+{
+  "mcpServers": {
+    "tdk": {
+      "command": "npx",
+      "args": ["-y", "tdk-api-wrapper", "mcp"]
+    }
+  }
+}
+```
+
+Global kuruluysa `tdk mcp` (veya `tdk-mcp`) komutu da aynı sunucuyu başlatır. Sunucu programatik olarak dışa aktarılan `createMcpServer()` / `runMcpServer()` ile de gömülebilir.
+
+Sunulan araçlar: `tdk_lookup`, `tdk_meanings`, `tdk_examples`, `tdk_proverbs`, `tdk_compound_words`, `tdk_part_of_speech`, `tdk_synonyms`, `tdk_antonyms`, `tdk_origin`, `tdk_nisanyan`, `tdk_kubbealti`, `tdk_wiktionary`, `tdk_spell_check`, `tdk_proofread`, `tdk_stem`, `tdk_analyze_text`, `tdk_syllables`, `tdk_vowel_harmony`, `tdk_autocomplete`, `tdk_pattern_search`, `tdk_anagram`, `tdk_rhymes`, `tdk_compare`, `tdk_audio_url`, `tdk_word_of_the_day`, `tdk_random_word`, `tdk_rules`. Her araç JSON metin döndürür; ağ/scraping hataları fırlatmak yerine `isError: true` ile `{ "error": ... }` olarak döner.
+
 ## Hata Yönetimi
 
 Kütüphane, ayırt edilebilir hata sınıfları fırlatır (hepsi `Error`'dan türer):
@@ -161,4 +181,4 @@ try {
 
 ## Lisans
 
-Bu proje MIT Lisansı ile lisanslanmıştır. Kullanım hakları ve kısıtlamalar için kaynak kod içerisindeki lisans metnini inceleyebilirsiniz.
+Bu proje GNU General Public License v3.0 (or later) ile lisanslanmıştır. Kullanım hakları ve kısıtlamalar için kaynak kod içerisindeki [LICENSE](./LICENSE) dosyasını inceleyebilirsiniz.

package/dist/{chunk-ZFWZXNGY.mjs → chunk-YY4WA2AO.mjs}

@@ -25,11 +25,7 @@ var TDKNetworkError = class extends TDKError {
   }
 };
 
-// src/morphology.ts
-var TURKISH_VOWELS = "ae\u0131io\xF6u\xFC";
-function isVowel(ch) {
-  return TURKISH_VOWELS.includes(ch);
-}
+// src/data/suffixes.ts
 var TURKISH_SUFFIXES = [
   // 9-letter composite suffixes
   "lerimizden",
@@ -432,6 +428,12 @@ var TURKISH_SUFFIXES = [
   "u",
   "\xFC"
 ];
+
+// src/morphology.ts
+var TURKISH_VOWELS = "ae\u0131io\xF6u\xFC";
+function isVowel(ch) {
+  return TURKISH_VOWELS.includes(ch);
+}
 function restoreConsonantSoftening(stem) {
   if (stem.length < 2)
     return [];
@@ -585,12 +587,7 @@ function getStemCandidates(word, minStemLength = 2, maxDepth = 4) {
   return [...new Set(candidatesWithWeight.map((c) => c.candidate))];
 }
 
-// src/tdk.ts
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import * as https from "https";
-import * as tls from "tls";
+// src/data/misspellings.ts
 var COMMON_MISSPELLINGS = {
   // -şey ile biten ve ayrı yazılması zorunlu söz öbekleri
   her\u015Fey: "her \u015Fey",
@@ -744,75 +741,10 @@ var COMMON_MISSPELLINGS = {
   babaanne: "babaanne"
 };
 var SEY_EXCEPTIONS = /* @__PURE__ */ new Set(["d\xFC\u015Fey", "e\u015Fey", "konsey", "jersey", "\u015Fey"]);
-var KEYBOARD_ROWS = [
-  ["qwertyu\u0131op\u011F\xFC", 0],
-  ["asdfghjkl\u015Fi", 0.5],
-  ["zxcvbnm\xF6\xE7", 1]
-];
-var KEYBOARD_COORDS = (() => {
-  const coords = {};
-  KEYBOARD_ROWS.forEach(([keys, offset], row) => {
-    [...keys].forEach((key, col) => {
-      coords[key] = [col + offset, row];
-    });
-  });
-  return coords;
-})();
-var DIACRITIC_SIBLINGS = {
-  \u0131: "i",
-  i: "\u0131",
-  \u00F6: "o",
-  o: "\xF6",
-  \u00FC: "u",
-  u: "\xFC",
-  \u015F: "s",
-  s: "\u015F",
-  \u00E7: "c",
-  c: "\xE7",
-  \u011F: "g",
-  g: "\u011F",
-  \u00E2: "a",
-  a: "\xE2"
-};
-var KEYBOARD_ROW_SUB_COST = 0.4;
-var KEYBOARD_DIAGONAL_SUB_COST = 0.55;
-var DIACRITIC_SUB_COST = 0.3;
-var TRANSPOSITION_COST = 0.8;
-function keyboardSubCost(a, b) {
-  if (a === b)
-    return 0;
-  if (DIACRITIC_SIBLINGS[a] === b)
-    return DIACRITIC_SUB_COST;
-  const pa = KEYBOARD_COORDS[a];
-  const pb = KEYBOARD_COORDS[b];
-  if (!pa || !pb)
-    return 1;
-  const dx = Math.abs(pa[0] - pb[0]);
-  const dy = Math.abs(pa[1] - pb[1]);
-  if (dy === 0 && dx <= 1 + 1e-9)
-    return KEYBOARD_ROW_SUB_COST;
-  if (dy === 1 && dx <= 1 + 1e-9)
-    return KEYBOARD_DIAGONAL_SUB_COST;
-  return 1;
-}
-var TDK = class {
-  static BASE_URL = "https://sozluk.gov.tr";
-  static AUDIO_API_HOST = "api.sozluk.gov.tr";
-  static KUBBEALTI_HOST = "eski.lugatim.com";
-  /**
-   * `eski.lugatim.com` (Kubbealtı Lugatı's data API) sends only its leaf
-   * certificate during the TLS handshake, omitting the intermediates a
-   * correctly configured server would include — a server-side misconfiguration,
-   * not something we should paper over by disabling verification. These are
-   * the two certificates the server *should* be sending (fetched from the
-   * leaf's own Authority Information Access URLs), supplied here so Node can
-   * still build a full, properly verified chain up to a root it already
-   * trusts (ISRG Root X1). If Let's Encrypt rotates this intermediate, this
-   * stops working and every Kubbealtı call fails closed to `null` — same
-   * fail-closed contract as the rest of this file's fragile integrations.
-   */
-  static KUBBEALTI_EXTRA_CA = [
-    `-----BEGIN CERTIFICATE-----
+
+// src/data/kubbealti-ca.ts
+var KUBBEALTI_EXTRA_CA = [
+  `-----BEGIN CERTIFICATE-----
 MIIE2jCCAsKgAwIBAgIQTr0klH4k05SALYSlL9WzGTANBgkqhkiG9w0BAQsFADAu
 MQswCQYDVQQGEwJVUzENMAsGA1UEChMESVNSRzEQMA4GA1UEAxMHUm9vdCBZUjAe
 Fw0yNTA5MDMwMDAwMDBaFw0yODA5MDIyMzU5NTlaMDMxCzAJBgNVBAYTAlVTMRYw
@@ -840,7 +772,7 @@ NA3wJdl4DDUuQSV8hBgx6zoI1ZSGORprDFux7c6rhc77QZMSRrEgomBeklervEve
 86ylWmZ3WWHV6RLMi8xNvjd71r4EPIGgY7BZU/VPBkq+uA7Gb6mbJnFgV43uh3xy
 LRFgxIAphIukwTGSMZZR+AI+Qnp0BYTWovHXozOf3H8r6hozEoT02JHn0AeTfA==
 -----END CERTIFICATE-----`,
-    `-----BEGIN CERTIFICATE-----
+  `-----BEGIN CERTIFICATE-----
 MIIF9DCCA9ygAwIBAgIRAPJLbRf52a18scn+p4eCaZ8wDQYJKoZIhvcNAQELBQAw
 TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
 cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMjYwNTEzMDAwMDAw
@@ -874,7 +806,112 @@ RGMuHGnzS3hFIrRTfKxrzUZ9RzQWzEG3K6fJ3r2nqSltkeytis9DIBoFY9VmVyjL
 M71DMi+y1+TRSJVClEMwvA4yL++7q9XZx5r5wBRWB4kQTKH5qyoZnDw7iiuh1lID
 yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
 -----END CERTIFICATE-----`
-  ];
+];
+
+// src/data/keyboard-layout.ts
+var KEYBOARD_ROWS = [
+  ["qwertyu\u0131op\u011F\xFC", 0],
+  ["asdfghjkl\u015Fi", 0.5],
+  ["zxcvbnm\xF6\xE7", 1]
+];
+var KEYBOARD_COORDS = (() => {
+  const coords = {};
+  KEYBOARD_ROWS.forEach(([keys, offset], row) => {
+    [...keys].forEach((key, col) => {
+      coords[key] = [col + offset, row];
+    });
+  });
+  return coords;
+})();
+var DIACRITIC_SIBLINGS = {
+  \u0131: "i",
+  i: "\u0131",
+  \u00F6: "o",
+  o: "\xF6",
+  \u00FC: "u",
+  u: "\xFC",
+  \u015F: "s",
+  s: "\u015F",
+  \u00E7: "c",
+  c: "\xE7",
+  \u011F: "g",
+  g: "\u011F",
+  \u00E2: "a",
+  a: "\xE2"
+};
+var KEYBOARD_ROW_SUB_COST = 0.4;
+var KEYBOARD_DIAGONAL_SUB_COST = 0.55;
+var DIACRITIC_SUB_COST = 0.3;
+var TRANSPOSITION_COST = 0.8;
+function keyboardSubCost(a, b) {
+  if (a === b)
+    return 0;
+  if (DIACRITIC_SIBLINGS[a] === b)
+    return DIACRITIC_SUB_COST;
+  const pa = KEYBOARD_COORDS[a];
+  const pb = KEYBOARD_COORDS[b];
+  if (!pa || !pb)
+    return 1;
+  const dx = Math.abs(pa[0] - pb[0]);
+  const dy = Math.abs(pa[1] - pb[1]);
+  if (dy === 0 && dx <= 1 + 1e-9)
+    return KEYBOARD_ROW_SUB_COST;
+  if (dy === 1 && dx <= 1 + 1e-9)
+    return KEYBOARD_DIAGONAL_SUB_COST;
+  return 1;
+}
+
+// src/lib/edit-distance.ts
+function damerauLevenshtein(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++)
+    dp[i][0] = i;
+  for (let j = 0; j <= b.length; j++)
+    dp[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+        dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + cost);
+      }
+    }
+  }
+  return dp[a.length][b.length];
+}
+function keyboardAwareDistance(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++)
+    dp[i][0] = i;
+  for (let j = 0; j <= b.length; j++)
+    dp[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      const cost = keyboardSubCost(a[i - 1], b[j - 1]);
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+        dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + TRANSPOSITION_COST);
+      }
+    }
+  }
+  return dp[a.length][b.length];
+}
+
+// src/lib/html.ts
+function htmlToPlainText(html) {
+  return html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|div)>/gi, "\n\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/gi, " ").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;|&rsquo;/gi, "'").replace(/&amp;/gi, "&").replace(/[ \t]+/g, " ").replace(/[ \t]*\n[ \t]*/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+
+// src/tdk.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as https from "https";
+import * as tls from "tls";
+var TDK = class {
+  static BASE_URL = "https://sozluk.gov.tr";
+  static AUDIO_API_HOST = "api.sozluk.gov.tr";
+  static KUBBEALTI_HOST = "eski.lugatim.com";
   // Configuration
   static defaultTimeoutMs = 8e3;
   static defaultRetries = 1;
@@ -1421,12 +1458,12 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
         continue;
       if (Math.abs(candidate.length - cleanWord.length) > 2)
         continue;
-      const rawDist = this.damerauLevenshtein(cleanWord, candidate);
+      const rawDist = damerauLevenshtein(cleanWord, candidate);
       if (rawDist === 0 || rawDist > 2)
         continue;
       const firstMismatch = candidate[0] === cleanWord[0] ? 0 : 1;
       const lengthMismatch = candidate.length === cleanWord.length ? 0 : 1;
-      const score = this.keyboardAwareDistance(cleanWord, candidate) + (firstMismatch > 0 ? 1.2 : 0);
+      const score = keyboardAwareDistance(cleanWord, candidate) + (firstMismatch > 0 ? 1.2 : 0);
       const better = !best || score < best.score - 1e-9 || Math.abs(score - best.score) < 1e-9 && firstMismatch < best.firstMismatch || Math.abs(score - best.score) < 1e-9 && firstMismatch === best.firstMismatch && lengthMismatch < best.lengthMismatch;
       if (better) {
         best = { candidate, score, rawDist, firstMismatch, lengthMismatch };
@@ -1557,14 +1594,11 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
       const contentEnd = html.indexOf("<footer", contentStart);
       if (contentEnd === -1)
         return null;
-      return this.htmlToPlainText(html.slice(contentStart, contentEnd));
+      return htmlToPlainText(html.slice(contentStart, contentEnd));
     } catch {
       return null;
     }
   }
-  static htmlToPlainText(html) {
-    return html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/(p|div)>/gi, "\n\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/gi, " ").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;|&rsquo;/gi, "'").replace(/&amp;/gi, "&").replace(/[ \t]+/g, " ").replace(/[ \t]*\n[ \t]*/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
-  }
   /**
    * GETs a JSON path from Kubbealtı Lugatı's data API (`eski.lugatim.com`),
    * supplying `KUBBEALTI_EXTRA_CA` to work around that host's incomplete
@@ -1578,7 +1612,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
           hostname: this.KUBBEALTI_HOST,
           path: path2,
           method: "GET",
-          ca: [...tls.rootCertificates, ...this.KUBBEALTI_EXTRA_CA],
+          ca: [...tls.rootCertificates, ...KUBBEALTI_EXTRA_CA],
           headers: {
             "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
           }
@@ -1670,7 +1704,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
     const entries = await this.getKubbealti(word);
     if (!entries)
       return null;
-    return entries.map((e) => this.htmlToPlainText(e.anlam));
+    return entries.map((e) => htmlToPlainText(e.anlam));
   }
   /**
    * Autocomplete suggestions from Kubbealtı Lugatı's own typeahead endpoint
@@ -1706,7 +1740,7 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
       const match = html.match(/<meta name="description" content="([^"]*)"/);
       if (!match)
         return null;
-      const description = this.htmlToPlainText(match[1]);
+      const description = htmlToPlainText(match[1]);
       if (description === "\xC7a\u011Fda\u015F T\xFCrk\xE7enin Etimolojisi")
         return null;
       return description;
@@ -1937,56 +1971,6 @@ yDFx8r7i9vIJU5HS3moZLkYWAOilMaV9N56A9Bgb6dNcHkvg3NoaYA==
     }
     return analyses;
   }
-  /**
-   * Damerau-Levenshtein edit-distance (optimal string alignment variant):
-   * like classic Levenshtein but also counts an adjacent-character
-   * transposition (e.g. "yanlız" -> "yalnız") as a single edit instead of
-   * two substitutions — a very common class of typo that plain Levenshtein
-   * otherwise misses.
-   */
-  static damerauLevenshtein(a, b) {
-    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
-    for (let i = 0; i <= a.length; i++)
-      dp[i][0] = i;
-    for (let j = 0; j <= b.length; j++)
-      dp[0][j] = j;
-    for (let i = 1; i <= a.length; i++) {
-      for (let j = 1; j <= b.length; j++) {
-        const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-        dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
-        if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-          dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + cost);
-        }
-      }
-    }
-    return dp[a.length][b.length];
-  }
-  /**
-   * Keyboard- and diacritic-aware edit distance: same optimal-string-alignment
-   * recurrence as {@link damerauLevenshtein}, but a substitution is charged by
-   * {@link keyboardSubCost} (a fraction of an edit when the two letters are
-   * adjacent on a Turkish Q keyboard or are ASCII/diacritic siblings) and a
-   * transposition costs {@link TRANSPOSITION_COST}. Insertions and deletions
-   * still cost a full 1. Used only to *rank* spelling candidates; the plain
-   * integer distance still gates whether a suggestion is offered at all.
-   */
-  static keyboardAwareDistance(a, b) {
-    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
-    for (let i = 0; i <= a.length; i++)
-      dp[i][0] = i;
-    for (let j = 0; j <= b.length; j++)
-      dp[0][j] = j;
-    for (let i = 1; i <= a.length; i++) {
-      for (let j = 1; j <= b.length; j++) {
-        const cost = keyboardSubCost(a[i - 1], b[j - 1]);
-        dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
-        if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-          dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + TRANSPOSITION_COST);
-        }
-      }
-    }
-    return dp[a.length][b.length];
-  }
   /**
    * Fetches multiple words concurrently with a small delay to avoid rate limiting.
    */
@@ -2460,9 +2444,9 @@ export {
   TDKError,
   TDKValidationError,
   TDKNetworkError,
+  TURKISH_SUFFIXES,
   TURKISH_VOWELS,
   isVowel,
-  TURKISH_SUFFIXES,
   restoreConsonantSoftening,
   restoreVowelDrop,
   restoreGemination,