tdk-api-wrapper 1.4.0 → 1.5.0

package/dist/cli.mjs

@@ -1,12 +1,21 @@
 #!/usr/bin/env node
 import {
   TDK
-} from "./chunk-5TYJDVHK.mjs";
+} from "./chunk-7KJHYRJZ.mjs";
 
 // src/cli.ts
 var rawArgs = process.argv.slice(2);
 var jsonMode = rawArgs.includes("--json");
 var args = rawArgs.filter((a) => a !== "--json");
+var isColor = !jsonMode && Boolean(process.stdout.isTTY);
+var c = {
+  bold: (s) => isColor ? `\x1B[1m${s}\x1B[0m` : s,
+  dim: (s) => isColor ? `\x1B[2m${s}\x1B[0m` : s,
+  green: (s) => isColor ? `\x1B[32m${s}\x1B[0m` : s,
+  yellow: (s) => isColor ? `\x1B[33m${s}\x1B[0m` : s,
+  cyan: (s) => isColor ? `\x1B[36m${s}\x1B[0m` : s,
+  red: (s) => isColor ? `\x1B[31m${s}\x1B[0m` : s
+};
 var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "ara",
   "anlam",
@@ -14,6 +23,7 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "ornek",
   "hece",
   "uyum",
+  "kucukuyum",
   "yazim",
   "kok",
   "stem",
@@ -28,6 +38,14 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "karsilastir",
   "analiz",
   "oneri",
+  "bulmaca",
+  "pattern",
+  "anagram",
+  "kafiye",
+  "rhyme",
+  "denetle",
+  "proofread",
+  "repl",
   "kubbealti",
   "nisanyan",
   "viki"
@@ -49,17 +67,93 @@ function printError(message) {
   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("readline");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: c.cyan("tdk> ")
+  });
+  console.log(c.bold("TDK \u0130nteraktif S\xF6zl\xFCk Kabu\u011Fu (\xC7\u0131kmak i\xE7in 'exit' veya Ctrl+C)"));
+  console.log(c.dim("Komutlar: ara <kelime>, hece <kelime>, bulmaca <desen>, denetle <metin> veya do\u011Frudan 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\xE7 bulunamad\u0131."));
+        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\xF6ken: ${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\xFCy\xFCk \xDCnl\xFC Uyumu: ${h ? c.green("Uyar") : c.red("Uymaz")}`);
+      } else if (subCmd === "kucukuyum") {
+        const h = TDK.checkLabialHarmony(subArg);
+        console.log(`K\xFC\xE7\xFCk \xDCnl\xFC 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("\u2713 Sorun bulunamad\u0131."));
+        else
+          res.issues.forEach((iss) => console.log(`- ${c.yellow(iss.word)}: ${iss.message}${iss.suggestion ? " -> " + c.green(iss.suggestion) : ""}`));
+      } else {
+        console.log(c.dim("\xD6rnek komutlar: 'ara kalem', 'hece elektrik', 'bulmaca k_l_m', 'denetle Bug\xFCn evdeyim'"));
+      }
+    } catch (e) {
+      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\u0131m: 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\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
+    process.exit(1);
+  }
+  if (command === "--help" || command === "-h") {
     console.log("Kullan\u0131m: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, kok, deyim, 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\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
-    process.exit(command ? 0 : 1);
+    process.exit(0);
   }
   TDK.enableCache(false);
   try {
@@ -118,6 +212,17 @@ 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\xFC\xE7\xFCk \xDCnl\xFC Uyumu: ${isHarmony ? "Uyar" : "Uymaz"}`)
+        );
+        break;
+      }
       case "yazim": {
         if (!word)
           throw new Error("Kelime belirtmelisiniz.");
@@ -293,6 +398,76 @@ async function run() {
         });
         break;
       }
+      case "bulmaca":
+      case "pattern": {
+        if (!word)
+          throw new Error("Desen belirtmelisiniz (\xF6rn: k_l_m).");
+        const matches = await TDK.patternSearch(word);
+        printResult(matches, () => {
+          if (matches.length === 0) {
+            console.log("E\u015Fle\u015Fen kelime bulunamad\u0131.");
+          } 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\xFCretilebilecek kelime bulunamad\u0131.");
+          } 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\u0131. Bu harflerle t\xFCretilen 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\u0131.");
+          } 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("\u2713 Metinde imla veya ba\u011Fla\xE7 hatas\u0131 tespit edilmedi."));
+          } else {
+            console.log(c.bold(c.red(`Metinde ${result.issues.length} olas\u0131 sorun tespit edildi:`)));
+            result.issues.forEach((issue, i) => {
+              const label = c.yellow(`[${issue.type}]`);
+              const sug = issue.suggestion ? c.green(` -> \xD6neri: ${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.");

package/dist/index.d.mts

@@ -123,6 +123,7 @@ interface WordComparisonSide {
     origin: string | null;
     syllables: string[];
     harmony: boolean;
+    labialHarmony?: boolean;
 }
 interface WordComparison {
     a: WordComparisonSide;
@@ -136,6 +137,36 @@ interface WordAnalysis {
     root?: string;
     isInflected?: boolean;
 }
+interface ProofreadIssue {
+    type: "spelling" | "conjunction_da" | "conjunction_ki" | "question_particle";
+    word: string;
+    startIndex: number;
+    endIndex: number;
+    suggestion?: string;
+    message: string;
+}
+interface ProofreadResult {
+    text: string;
+    issues: ProofreadIssue[];
+    isCorrect: boolean;
+}
+interface PatternSearchOptions {
+    maxResults?: number;
+}
+interface AnagramOptions {
+    exactLength?: boolean;
+    maxResults?: number;
+}
+interface RhymeOptions {
+    minLetters?: number;
+    maxResults?: number;
+}
+interface TDKConfig {
+    timeoutMs?: number;
+    retries?: number;
+    cache?: boolean;
+    maxCacheSize?: number;
+}
 interface KubbealtiEntry {
     kelime: string;
     anlam: string;
@@ -168,12 +199,19 @@ declare class TDK {
      * fail-closed contract as the rest of this file's fragile integrations.
      */
     private static readonly KUBBEALTI_EXTRA_CA;
+    private static defaultTimeoutMs;
+    private static defaultRetries;
+    private static maxCacheSize;
     private static isCacheEnabled;
     private static wordCache;
     private static dailyContentCache;
     private static autocompleteCache;
     private static autocompleteSet;
     private static stemCache;
+    /**
+     * Configures global client options such as network timeout, retries, and cache size.
+     */
+    static configure(config: TDKConfig): void;
     /**
      * Enables or disables in-memory caching for API requests.
      */
@@ -182,7 +220,12 @@ declare class TDK {
      * Clears the internal cache.
      */
     static clearCache(): void;
+    private static setBoundedCache;
     private static delay;
+    /**
+     * Internal helper that performs HTTP fetch with timeout and automatic retry on network/5xx errors.
+     */
+    private static fetchWithRetry;
     /**
      * Fetches detailed information for a given word from the TDK Dictionary.
      */
@@ -471,6 +514,8 @@ declare class TDK {
     static getWordsBatch(words: string[]): Promise<WordInfo[][]>;
     /**
      * Syllabicates a Turkish word based on general grammar rules.
+     * Handles syllable separation for vowels, single consonants, double consonants,
+     * and western loanword three-consonant clusters (e.g. e-lek-trik, kon-trol, or-kes-tra).
      */
     static syllabicate(word: string): string[];
     /**
@@ -480,6 +525,65 @@ declare class TDK {
      * (dotless) as the front vowel "i" (dotted).
      */
     static checkVowelHarmony(word: string): boolean;
+    /**
+     * Checks if a word follows Turkish Minor Vowel Harmony (Küçük Ünlü Uyumu / Labial Harmony).
+     * Rules:
+     * 1. After an unrounded vowel (a, e, ı, i), only unrounded vowels (a, e, ı, i) can follow.
+     * 2. After a rounded vowel (o, ö, u, ü), either an unrounded wide (a, e) or rounded narrow (u, ü) vowel can follow.
+     * Single-syllable words and words with <=1 vowel are considered compliant by convention.
+     */
+    static checkLabialHarmony(word: string): boolean;
+    /**
+     * Searches TDK headwords using a wildcard / pattern string.
+     * Wildcards:
+     *   '_' or '?' matches any single character
+     *   '*' matches zero or more characters
+     * Example: "k_l_m" matches "kalem", "kelam", "kilim".
+     * Runs in-memory against TDK's 81k headword list.
+     */
+    static patternSearch(pattern: string, options?: PatternSearchOptions): Promise<string[]>;
+    /**
+     * Finds headwords in TDK that can be formed from the given letters (anagrams).
+     * If exact-length anagrams exist, they are returned.
+     * If none exist (or exactLength is false), valid sub-anagrams (words using a subset of the letters,
+     * minimum 3 letters) are returned, sorted by length descending.
+     */
+    static findAnagrams(letters: string, options?: AnagramOptions): Promise<string[]>;
+    /**
+     * Finds words in TDK that rhyme with the given word (sharing the same ending suffix/letters).
+     * @param word The target word
+     * @param options.minLetters Minimum number of ending characters that must match (default: 3)
+     * @param options.maxResults Maximum number of rhyme results to return (default: 50)
+     */
+    static findRhymes(word: string, options?: RhymeOptions): Promise<string[]>;
+    /**
+     * Performs comprehensive spelling, grammar, and syntax proofreading on a Turkish text.
+     * Detects:
+     * 1. Conjunction 'da/de' erroneously joined to verbs or words (e.g. "gitsende" -> "gitsen de")
+     * 2. Conjunction 'ki' erroneously joined to verbs (e.g. "gördümki" -> "gördüm ki"), respecting SOMBAHÇEMİ exceptions
+     * 3. Question particle 'mi/mı/mu/mü' erroneously joined to words (e.g. "geldimi" -> "geldi mi")
+     * 4. Misspelled words with dictionary suggestions (via edit-distance & morphology)
+     */
+    static proofread(text: string): Promise<ProofreadResult>;
+}
+/**
+ * Configurable instance-based client for TDK API.
+ * Useful for multi-tenant applications or backend services requiring isolated configurations.
+ */
+declare class TDKClient {
+    constructor(config?: TDKConfig);
+    getWord(word: string): Promise<WordInfo[]>;
+    getMeanings(word: string): Promise<string[]>;
+    checkSpelling(word: string): Promise<SpellCheckResult>;
+    findRoot(word: string): Promise<string | null>;
+    stem(word: string): Promise<StemResult | null>;
+    proofread(text: string): Promise<ProofreadResult>;
+    patternSearch(pattern: string, options?: PatternSearchOptions): Promise<string[]>;
+    findAnagrams(letters: string, options?: AnagramOptions): Promise<string[]>;
+    findRhymes(word: string, options?: RhymeOptions): Promise<string[]>;
+    syllabicate(word: string): string[];
+    checkVowelHarmony(word: string): boolean;
+    checkLabialHarmony(word: string): boolean;
 }
 
 /**
@@ -537,6 +641,20 @@ declare function restoreConsonantSoftening(stem: string): string[];
  * This restores the harmonic dropped vowel between the final consonant cluster.
  */
 declare function restoreVowelDrop(stem: string): string[];
+/**
+ * Reverses Turkish consonant gemination (ünsüz türemesi / ikizleşmesi):
+ * In words of Arabic/foreign origin, when receiving a vowel-initial suffix, the final consonant doubles:
+ * e.g. hak->hakkı, his->hissi, sır->sırrı, af->affı, ret->reddi, tıp->tıbbı, zam->zammı, hat->hattı.
+ * Restores the single consonant form and checks consonant softening on the result (e.g. redd -> red -> ret).
+ */
+declare function restoreGemination(stem: string): string[];
+/**
+ * Reverses Turkish vowel narrowing (ünlü daralması):
+ * Verbs ending in wide vowels 'a' or 'e' narrow to 'ı', 'i', 'u', 'ü' before the continuous tense suffix -yor:
+ * e.g. başla-yor -> başlıyor, bekle-yor -> bekliyor, özle-yor -> özlüyor, anla-yor -> anlıyor.
+ * Also handles irregular monosyllabic verbs: de-yor -> diyor, ye-yor -> yiyor.
+ */
+declare function restoreVowelNarrowing(stem: string): string[];
 /**
  * Restores verb infinitive headword form (-mek / -mak):
  * Since TDK registers verbs in their infinitive form (e.g. okumak, gelmek, yazmak),
@@ -557,4 +675,4 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-export { type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type Proverb, type SpellCheckResult, type StemResult, TDK, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreInfinitive, restoreVowelDrop };
+export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing };

package/dist/index.d.ts

@@ -123,6 +123,7 @@ interface WordComparisonSide {
     origin: string | null;
     syllables: string[];
     harmony: boolean;
+    labialHarmony?: boolean;
 }
 interface WordComparison {
     a: WordComparisonSide;
@@ -136,6 +137,36 @@ interface WordAnalysis {
     root?: string;
     isInflected?: boolean;
 }
+interface ProofreadIssue {
+    type: "spelling" | "conjunction_da" | "conjunction_ki" | "question_particle";
+    word: string;
+    startIndex: number;
+    endIndex: number;
+    suggestion?: string;
+    message: string;
+}
+interface ProofreadResult {
+    text: string;
+    issues: ProofreadIssue[];
+    isCorrect: boolean;
+}
+interface PatternSearchOptions {
+    maxResults?: number;
+}
+interface AnagramOptions {
+    exactLength?: boolean;
+    maxResults?: number;
+}
+interface RhymeOptions {
+    minLetters?: number;
+    maxResults?: number;
+}
+interface TDKConfig {
+    timeoutMs?: number;
+    retries?: number;
+    cache?: boolean;
+    maxCacheSize?: number;
+}
 interface KubbealtiEntry {
     kelime: string;
     anlam: string;
@@ -168,12 +199,19 @@ declare class TDK {
      * fail-closed contract as the rest of this file's fragile integrations.
      */
     private static readonly KUBBEALTI_EXTRA_CA;
+    private static defaultTimeoutMs;
+    private static defaultRetries;
+    private static maxCacheSize;
     private static isCacheEnabled;
     private static wordCache;
     private static dailyContentCache;
     private static autocompleteCache;
     private static autocompleteSet;
     private static stemCache;
+    /**
+     * Configures global client options such as network timeout, retries, and cache size.
+     */
+    static configure(config: TDKConfig): void;
     /**
      * Enables or disables in-memory caching for API requests.
      */
@@ -182,7 +220,12 @@ declare class TDK {
      * Clears the internal cache.
      */
     static clearCache(): void;
+    private static setBoundedCache;
     private static delay;
+    /**
+     * Internal helper that performs HTTP fetch with timeout and automatic retry on network/5xx errors.
+     */
+    private static fetchWithRetry;
     /**
      * Fetches detailed information for a given word from the TDK Dictionary.
      */
@@ -471,6 +514,8 @@ declare class TDK {
     static getWordsBatch(words: string[]): Promise<WordInfo[][]>;
     /**
      * Syllabicates a Turkish word based on general grammar rules.
+     * Handles syllable separation for vowels, single consonants, double consonants,
+     * and western loanword three-consonant clusters (e.g. e-lek-trik, kon-trol, or-kes-tra).
      */
     static syllabicate(word: string): string[];
     /**
@@ -480,6 +525,65 @@ declare class TDK {
      * (dotless) as the front vowel "i" (dotted).
      */
     static checkVowelHarmony(word: string): boolean;
+    /**
+     * Checks if a word follows Turkish Minor Vowel Harmony (Küçük Ünlü Uyumu / Labial Harmony).
+     * Rules:
+     * 1. After an unrounded vowel (a, e, ı, i), only unrounded vowels (a, e, ı, i) can follow.
+     * 2. After a rounded vowel (o, ö, u, ü), either an unrounded wide (a, e) or rounded narrow (u, ü) vowel can follow.
+     * Single-syllable words and words with <=1 vowel are considered compliant by convention.
+     */
+    static checkLabialHarmony(word: string): boolean;
+    /**
+     * Searches TDK headwords using a wildcard / pattern string.
+     * Wildcards:
+     *   '_' or '?' matches any single character
+     *   '*' matches zero or more characters
+     * Example: "k_l_m" matches "kalem", "kelam", "kilim".
+     * Runs in-memory against TDK's 81k headword list.
+     */
+    static patternSearch(pattern: string, options?: PatternSearchOptions): Promise<string[]>;
+    /**
+     * Finds headwords in TDK that can be formed from the given letters (anagrams).
+     * If exact-length anagrams exist, they are returned.
+     * If none exist (or exactLength is false), valid sub-anagrams (words using a subset of the letters,
+     * minimum 3 letters) are returned, sorted by length descending.
+     */
+    static findAnagrams(letters: string, options?: AnagramOptions): Promise<string[]>;
+    /**
+     * Finds words in TDK that rhyme with the given word (sharing the same ending suffix/letters).
+     * @param word The target word
+     * @param options.minLetters Minimum number of ending characters that must match (default: 3)
+     * @param options.maxResults Maximum number of rhyme results to return (default: 50)
+     */
+    static findRhymes(word: string, options?: RhymeOptions): Promise<string[]>;
+    /**
+     * Performs comprehensive spelling, grammar, and syntax proofreading on a Turkish text.
+     * Detects:
+     * 1. Conjunction 'da/de' erroneously joined to verbs or words (e.g. "gitsende" -> "gitsen de")
+     * 2. Conjunction 'ki' erroneously joined to verbs (e.g. "gördümki" -> "gördüm ki"), respecting SOMBAHÇEMİ exceptions
+     * 3. Question particle 'mi/mı/mu/mü' erroneously joined to words (e.g. "geldimi" -> "geldi mi")
+     * 4. Misspelled words with dictionary suggestions (via edit-distance & morphology)
+     */
+    static proofread(text: string): Promise<ProofreadResult>;
+}
+/**
+ * Configurable instance-based client for TDK API.
+ * Useful for multi-tenant applications or backend services requiring isolated configurations.
+ */
+declare class TDKClient {
+    constructor(config?: TDKConfig);
+    getWord(word: string): Promise<WordInfo[]>;
+    getMeanings(word: string): Promise<string[]>;
+    checkSpelling(word: string): Promise<SpellCheckResult>;
+    findRoot(word: string): Promise<string | null>;
+    stem(word: string): Promise<StemResult | null>;
+    proofread(text: string): Promise<ProofreadResult>;
+    patternSearch(pattern: string, options?: PatternSearchOptions): Promise<string[]>;
+    findAnagrams(letters: string, options?: AnagramOptions): Promise<string[]>;
+    findRhymes(word: string, options?: RhymeOptions): Promise<string[]>;
+    syllabicate(word: string): string[];
+    checkVowelHarmony(word: string): boolean;
+    checkLabialHarmony(word: string): boolean;
 }
 
 /**
@@ -537,6 +641,20 @@ declare function restoreConsonantSoftening(stem: string): string[];
  * This restores the harmonic dropped vowel between the final consonant cluster.
  */
 declare function restoreVowelDrop(stem: string): string[];
+/**
+ * Reverses Turkish consonant gemination (ünsüz türemesi / ikizleşmesi):
+ * In words of Arabic/foreign origin, when receiving a vowel-initial suffix, the final consonant doubles:
+ * e.g. hak->hakkı, his->hissi, sır->sırrı, af->affı, ret->reddi, tıp->tıbbı, zam->zammı, hat->hattı.
+ * Restores the single consonant form and checks consonant softening on the result (e.g. redd -> red -> ret).
+ */
+declare function restoreGemination(stem: string): string[];
+/**
+ * Reverses Turkish vowel narrowing (ünlü daralması):
+ * Verbs ending in wide vowels 'a' or 'e' narrow to 'ı', 'i', 'u', 'ü' before the continuous tense suffix -yor:
+ * e.g. başla-yor -> başlıyor, bekle-yor -> bekliyor, özle-yor -> özlüyor, anla-yor -> anlıyor.
+ * Also handles irregular monosyllabic verbs: de-yor -> diyor, ye-yor -> yiyor.
+ */
+declare function restoreVowelNarrowing(stem: string): string[];
 /**
  * Restores verb infinitive headword form (-mek / -mak):
  * Since TDK registers verbs in their infinitive form (e.g. okumak, gelmek, yazmak),
@@ -557,4 +675,4 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-export { type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type Proverb, type SpellCheckResult, type StemResult, TDK, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreInfinitive, restoreVowelDrop };
+export { type AnagramOptions, type Author, type DailyContent, type DailyPick, type Example, type Feature, type KubbealtiEntry, type Meaning, type PatternSearchOptions, type ProofreadIssue, type ProofreadResult, type Proverb, type RhymeOptions, type SpellCheckResult, type StemResult, TDK, TDKClient, type TDKConfig, TDKError, TDKNetworkError, type TDKResponse, type TDKRule, TDKValidationError, TURKISH_SUFFIXES, TURKISH_VOWELS, type WiktionaryEntry, type WordAnalysis, type WordComparison, type WordComparisonSide, type WordInfo, type WordOfTheDay, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing };