tdk-api-wrapper 1.3.1 → 1.5.0

package/dist/index.mjs

@@ -1,12 +1,32 @@
 import {
   TDK,
+  TDKClient,
   TDKError,
   TDKNetworkError,
-  TDKValidationError
-} from "./chunk-ACMGCL7T.mjs";
+  TDKValidationError,
+  TURKISH_SUFFIXES,
+  TURKISH_VOWELS,
+  getStemCandidates,
+  isVowel,
+  restoreConsonantSoftening,
+  restoreGemination,
+  restoreInfinitive,
+  restoreVowelDrop,
+  restoreVowelNarrowing
+} from "./chunk-7KJHYRJZ.mjs";
 export {
   TDK,
+  TDKClient,
   TDKError,
   TDKNetworkError,
-  TDKValidationError
+  TDKValidationError,
+  TURKISH_SUFFIXES,
+  TURKISH_VOWELS,
+  getStemCandidates,
+  isVowel,
+  restoreConsonantSoftening,
+  restoreGemination,
+  restoreInfinitive,
+  restoreVowelDrop,
+  restoreVowelNarrowing
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tdk-api-wrapper",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "TDK (Türk Dil Kurumu) unofficial live data API wrapper for Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -16,7 +16,8 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean --shims"
+    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean --shims",
+    "test": "node test/morphology.test.js && node test/grammar.test.js && node test/proofread.test.js && node test/tools.test.js"
   },
   "keywords": [
     "tdk",

package/src/cli.ts

@@ -4,6 +4,17 @@ import { TDK } from "./tdk";
 const rawArgs = process.argv.slice(2);
 const jsonMode = rawArgs.includes("--json");
 const args = rawArgs.filter((a) => a !== "--json");
+
+const isColor = !jsonMode && Boolean(process.stdout.isTTY);
+const c = {
+  bold: (s: string) => (isColor ? `\x1b[1m${s}\x1b[0m` : s),
+  dim: (s: string) => (isColor ? `\x1b[2m${s}\x1b[0m` : s),
+  green: (s: string) => (isColor ? `\x1b[32m${s}\x1b[0m` : s),
+  yellow: (s: string) => (isColor ? `\x1b[33m${s}\x1b[0m` : s),
+  cyan: (s: string) => (isColor ? `\x1b[36m${s}\x1b[0m` : s),
+  red: (s: string) => (isColor ? `\x1b[31m${s}\x1b[0m` : s),
+};
+
 const KNOWN_COMMANDS = new Set([
   "ara",
   "anlam",
@@ -11,7 +22,11 @@ const KNOWN_COMMANDS = new Set([
   "ornek",
   "hece",
   "uyum",
+  "kucukuyum",
   "yazim",
+  "kok",
+  "stem",
+  "deyim",
   "gunun",
   "rastgele",
   "esanlam",
@@ -22,6 +37,14 @@ const KNOWN_COMMANDS = new Set([
   "karsilastir",
   "analiz",
   "oneri",
+  "bulmaca",
+  "pattern",
+  "anagram",
+  "kafiye",
+  "rhyme",
+  "denetle",
+  "proofread",
+  "repl",
   "kubbealti",
   "nisanyan",
   "viki",
@@ -47,18 +70,96 @@ function printError(message: string) {
   if (jsonMode) {
     console.log(JSON.stringify({ error: message }));
   } else {
-    console.log(`Hata: ${message}`);
+    console.log(c.red(`Hata: ${message}`));
   }
 }
 
+async function startRepl() {
+  const readline = await import("node:readline");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: c.cyan("tdk> "),
+  });
+
+  console.log(c.bold("TDK İnteraktif Sözlük Kabuğu (Çıkmak için 'exit' veya Ctrl+C)"));
+  console.log(c.dim("Komutlar: ara <kelime>, hece <kelime>, bulmaca <desen>, denetle <metin> veya doğrudan kelime"));
+  rl.prompt();
+
+  rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      rl.prompt();
+      return;
+    }
+    if (trimmed === "exit" || trimmed === "quit" || trimmed === ".exit") {
+      rl.close();
+      return;
+    }
+
+    const parts = trimmed.split(/\s+/);
+    let subCmd = parts[0].toLowerCase();
+    let subArg = parts.slice(1).join(" ");
+    if (!KNOWN_COMMANDS.has(subCmd)) {
+      subArg = trimmed;
+      subCmd = "anlam";
+    }
+
+    try {
+      if (subCmd === "ara" || subCmd === "anlam") {
+        const meanings = await TDK.getMeanings(subArg);
+        if (meanings.length === 0) console.log(c.dim("Sonuç bulunamadı."));
+        else meanings.forEach((m, i) => console.log(`${i + 1}. ${c.green(m)}`));
+      } else if (subCmd === "koken") {
+        const origin = await TDK.getOrigin(subArg);
+        console.log(`Köken: ${c.cyan(origin || "Bilinmiyor")}`);
+      } else if (subCmd === "hece") {
+        const s = TDK.syllabicate(subArg);
+        console.log(`Heceler: ${c.yellow(s.join("-"))}`);
+      } else if (subCmd === "uyum") {
+        const h = TDK.checkVowelHarmony(subArg);
+        console.log(`Büyük Ünlü Uyumu: ${h ? c.green("Uyar") : c.red("Uymaz")}`);
+      } else if (subCmd === "kucukuyum") {
+        const h = TDK.checkLabialHarmony(subArg);
+        console.log(`Küçük Ünlü Uyumu: ${h ? c.green("Uyar") : c.red("Uymaz")}`);
+      } else if (subCmd === "bulmaca" || subCmd === "pattern") {
+        const matches = await TDK.patternSearch(subArg);
+        console.log(matches.slice(0, 15).join(", "));
+      } else if (subCmd === "denetle" || subCmd === "proofread") {
+        const res = await TDK.proofread(subArg);
+        if (res.isCorrect) console.log(c.green("✓ Sorun bulunamadı."));
+        else res.issues.forEach((iss) => console.log(`- ${c.yellow(iss.word)}: ${iss.message}${iss.suggestion ? " -> " + c.green(iss.suggestion) : ""}`));
+      } else {
+        console.log(c.dim("Örnek komutlar: 'ara kalem', 'hece elektrik', 'bulmaca k_l_m', 'denetle Bugün evdeyim'"));
+      }
+    } catch (e: any) {
+      console.log(c.red(`Hata: ${e?.message || e}`));
+    }
+    rl.prompt();
+  });
+}
+
 async function run() {
-  if (!command || command === "--help" || command === "-h") {
+  if (!command) {
+    if (process.stdin.isTTY) {
+      await startRepl();
+      return;
+    }
     console.log("Kullanım: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, kubbealti, nisanyan, viki"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki"
     );
     console.log("Not: Komut belirtilmezse doğrudan kelime anlamı aranır (örn: tdk selam)");
-    process.exit(command ? 0 : 1);
+    process.exit(1);
+  }
+
+  if (command === "--help" || command === "-h") {
+    console.log("Kullanım: tdk [komut] <kelime> [--json]");
+    console.log(
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, kucukuyum, yazim, kok, deyim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri, bulmaca, anagram, kafiye, denetle, repl, kubbealti, nisanyan, viki"
+    );
+    console.log("Not: Komut belirtilmezse doğrudan kelime anlamı aranır (örn: tdk selam)");
+    process.exit(0);
   }
 
   TDK.enableCache(false);
@@ -118,12 +219,26 @@ async function run() {
         break;
       }
 
+      case "kucukuyum":
+      case "labial": {
+        if (!word) throw new Error("Kelime belirtmelisiniz.");
+        const isHarmony = TDK.checkLabialHarmony(word);
+        printResult({ word, labialHarmony: isHarmony }, () =>
+          console.log(`Küçük Ünlü Uyumu: ${isHarmony ? "Uyar" : "Uymaz"}`)
+        );
+        break;
+      }
+
       case "yazim": {
         if (!word) throw new Error("Kelime belirtmelisiniz.");
         const spellResult = await TDK.checkSpelling(word);
         printResult(spellResult, () => {
           if (spellResult.isCorrect) {
-            console.log("Doğru yazım.");
+            if (spellResult.isInflected && spellResult.root) {
+              console.log(`Doğru yazım (çekimli biçim, kök: ${spellResult.root}).`);
+            } else {
+              console.log("Doğru yazım.");
+            }
           } else {
             console.log(`Yanlış yazım.${spellResult.suggestion ? " Doğrusu: " + spellResult.suggestion : ""}`);
           }
@@ -131,6 +246,35 @@ async function run() {
         break;
       }
 
+      case "kok":
+      case "stem": {
+        if (!word) throw new Error("Kelime belirtmelisiniz.");
+        const stemResult = await TDK.stem(word);
+        printResult(stemResult, () => {
+          if (!stemResult) {
+            console.log("Kök bulunamadı.");
+          } else if (stemResult.isInflected) {
+            console.log(`Kök: ${stemResult.root} (çekimli biçim)`);
+          } else {
+            console.log(`Kök: ${stemResult.root} (yalın biçim)`);
+          }
+        });
+        break;
+      }
+
+      case "deyim": {
+        if (!word) throw new Error("Kelime belirtmelisiniz.");
+        const proverbs = await TDK.getProverbs(word);
+        printResult(proverbs, () => {
+          if (proverbs.length === 0) {
+            console.log("Atasözü/deyim bulunamadı.");
+          } else {
+            proverbs.forEach((p, i) => console.log(`${i + 1}. ${p}`));
+          }
+        });
+        break;
+      }
+
       case "gunun": {
         const wotd = await TDK.getWordOfTheDay();
         printResult(wotd, () => {
@@ -239,7 +383,8 @@ async function run() {
           } else {
             analysis.forEach((a) => {
               if (a.found) {
-                console.log(`${a.word}: ${a.meaning ?? "-"} (${a.origin})`);
+                const rootLabel = a.isInflected && a.root ? ` (kök: ${a.root})` : "";
+                console.log(`${a.word}${rootLabel}: ${a.meaning ?? "-"} (${a.origin})`);
               } else {
                 console.log(`${a.word}: bulunamadı`);
               }
@@ -262,6 +407,79 @@ async function run() {
         break;
       }
 
+      case "bulmaca":
+      case "pattern": {
+        if (!word) throw new Error("Desen belirtmelisiniz (örn: k_l_m).");
+        const matches = await TDK.patternSearch(word);
+        printResult(matches, () => {
+          if (matches.length === 0) {
+            console.log("Eşleşen kelime bulunamadı.");
+          } else {
+            console.log(c.bold(`Bulunan Kelimeler (${matches.length}):`));
+            matches.forEach((m, i) => console.log(`${i + 1}. ${c.cyan(m)}`));
+          }
+        });
+        break;
+      }
+
+      case "anagram": {
+        if (!word) throw new Error("Harfler belirtmelisiniz.");
+        const anagrams = await TDK.findAnagrams(word);
+        printResult(anagrams, () => {
+          if (anagrams.length === 0) {
+            console.log("Anagram veya bu harflerle türetilebilecek kelime bulunamadı.");
+          } else {
+            const clean = word.trim().toLocaleLowerCase("tr-TR").replace(/[^a-zçğıöşüâîû]/gi, "");
+            const hasExact = anagrams.some((a) => a.length === clean.length);
+            const title = hasExact
+              ? `Anagramlar (${anagrams.length}):`
+              : `Birebir anagram bulunamadı. Bu harflerle türetilen kelimeler (${anagrams.length}):`;
+            console.log(c.bold(title));
+            anagrams.forEach((a, i) => console.log(`${i + 1}. ${c.green(a)} ${c.dim(`(${a.length} harf)`)}`));
+          }
+        });
+        break;
+      }
+
+      case "kafiye":
+      case "rhyme": {
+        if (!word) throw new Error("Kelime belirtmelisiniz.");
+        const rhymes = await TDK.findRhymes(word);
+        printResult(rhymes, () => {
+          if (rhymes.length === 0) {
+            console.log("Kafiye bulunamadı.");
+          } else {
+            console.log(c.bold(`Kafiyeli Kelimeler (${rhymes.length}):`));
+            rhymes.forEach((r, i) => console.log(`${i + 1}. ${c.yellow(r)}`));
+          }
+        });
+        break;
+      }
+
+      case "denetle":
+      case "proofread": {
+        if (!word) throw new Error("Metin belirtmelisiniz.");
+        const result = await TDK.proofread(word);
+        printResult(result, () => {
+          if (result.isCorrect) {
+            console.log(c.green("✓ Metinde imla veya bağlaç hatası tespit edilmedi."));
+          } else {
+            console.log(c.bold(c.red(`Metinde ${result.issues.length} olası sorun tespit edildi:`)));
+            result.issues.forEach((issue, i) => {
+              const label = c.yellow(`[${issue.type}]`);
+              const sug = issue.suggestion ? c.green(` -> Öneri: ${issue.suggestion}`) : "";
+              console.log(`${i + 1}. ${label} "${c.bold(issue.word)}": ${issue.message}${sug}`);
+            });
+          }
+        });
+        break;
+      }
+
+      case "repl": {
+        await startRepl();
+        break;
+      }
+
       case "kubbealti": {
         if (!word) throw new Error("Kelime belirtmelisiniz.");
         const meanings = await TDK.getKubbealtiMeanings(word);

package/src/index.ts

@@ -1,3 +1,4 @@
-export { TDK } from "./tdk";
+export { TDK, TDKClient } from "./tdk";
 export * from "./types";
 export * from "./errors";
+export * from "./morphology";