tdk-api-wrapper 1.7.0 → 1.7.1

package/README.md

@@ -91,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)
@@ -181,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,

package/dist/{chunk-MELLECWT.mjs → chunk-ZG7YRT7V.mjs}

@@ -1,6 +1,6 @@
 import {
   TDK
-} from "./chunk-ZFWZXNGY.mjs";
+} from "./chunk-YY4WA2AO.mjs";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";