tdk-api-wrapper 1.6.1 → 1.7.1

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TDK
-} from "./chunk-ZFWZXNGY.mjs";
+} from "./chunk-YY4WA2AO.mjs";
 
 // src/cli.ts
 var rawArgs = process.argv.slice(2);
@@ -48,7 +48,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "repl",
   "kubbealti",
   "nisanyan",
-  "viki"
+  "viki",
+  "mcp"
 ]);
 var command = args[0];
 var word = args.slice(1).join(" ");
@@ -135,6 +136,12 @@ async function startRepl() {
   });
 }
 async function run() {
+  const binaryName = (process.argv[1] || "").toLowerCase();
+  if (command === "mcp" || rawArgs.includes("--mcp") || binaryName.includes("tdk-mcp")) {
+    const { runMcpServer } = await import("./mcp-GBTXQJLW.mjs");
+    await runMcpServer();
+    return;
+  }
   if (!command) {
     if (process.stdin.isTTY) {
       await startRepl();
@@ -142,19 +149,19 @@ async function run() {
     }
     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"
+      "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, mcp"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(1);
   }
   if (command === "--version" || command === "-v") {
-    console.log("tdk-api-wrapper v1.5.1");
+    console.log("tdk-api-wrapper v1.7.0");
     process.exit(0);
   }
   if (command === "--help" || command === "-h") {
     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"
+      "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, mcp"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(0);

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
 interface Author {
     yazar_id: string;
     tam_adi: string;
@@ -186,19 +188,6 @@ declare class TDK {
     private static readonly BASE_URL;
     private static readonly AUDIO_API_HOST;
     private static readonly KUBBEALTI_HOST;
-    /**
-     * `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.
-     */
-    private static readonly KUBBEALTI_EXTRA_CA;
     private static defaultTimeoutMs;
     private static defaultRetries;
     private static maxCacheSize;
@@ -397,7 +386,6 @@ declare class TDK {
      * spans) — cutting there avoids that trailing cruft.
      */
     private static fetchRuleText;
-    private static htmlToPlainText;
     /**
      * GETs a JSON path from Kubbealtı Lugatı's data API (`eski.lugatim.com`),
      * supplying `KUBBEALTI_EXTRA_CA` to work around that host's incomplete
@@ -500,24 +488,6 @@ declare class TDK {
      * headword. This is an inherent limitation of the data source, not a bug.
      */
     static analyzeText(text: string): Promise<WordAnalysis[]>;
-    /**
-     * 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.
-     */
-    private static damerauLevenshtein;
-    /**
-     * 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.
-     */
-    private static keyboardAwareDistance;
     /**
      * Fetches multiple words concurrently with a small delay to avoid rate limiting.
      */
@@ -621,6 +591,13 @@ declare class TDKNetworkError extends TDKError {
     });
 }
 
+/**
+ * Turkish suffix catalogue used by the morphology engine's BFS stem-stripper
+ * (see `morphology.ts`). Ordered strictly by descending length so that
+ * longer composite suffixes match before their individual subcomponents.
+ */
+declare const TURKISH_SUFFIXES: readonly string[];
+
 /**
  * Turkish Morphology Engine & Stem Candidate Generator.
  *
@@ -631,13 +608,9 @@ declare class TDKNetworkError extends TDKError {
  * 4. Infinitive restoration (-mek / -mak for verbal stems)
  * 5. Apostrophe stripping for proper nouns (İstanbul'da -> İstanbul)
  */
+
 declare const TURKISH_VOWELS = "ae\u0131io\u00F6u\u00FC";
 declare function isVowel(ch: string): boolean;
-/**
- * Turkish suffixes ordered strictly by descending length so that longer
- * composite suffixes match before their individual subcomponents.
- */
-declare const TURKISH_SUFFIXES: readonly string[];
 /**
  * Reverses Turkish consonant softening (ünsüz yumuşaması):
  * When a root ends with p, ç, t, k, it softens to b, c, d, ğ, g before a vowel.
@@ -685,4 +658,16 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-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 };
+/**
+ * Builds the TDK MCP server: every meaningful `TDK` static method is surfaced
+ * as a Model Context Protocol tool so an LLM client (Claude Desktop, Cursor,
+ * Antigravity, …) can query Turkish dictionary, morphology, spelling and
+ * etymology data directly. All tools return JSON text; network/scraping
+ * failures come back as `{ "error": ... }` with `isError: true` rather than
+ * throwing.
+ */
+declare function createMcpServer(): McpServer;
+/** Starts the TDK MCP server over stdio (used by the `tdk mcp` CLI command). */
+declare function runMcpServer(): Promise<void>;
+
+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, createMcpServer, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing, runMcpServer };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
 interface Author {
     yazar_id: string;
     tam_adi: string;
@@ -186,19 +188,6 @@ declare class TDK {
     private static readonly BASE_URL;
     private static readonly AUDIO_API_HOST;
     private static readonly KUBBEALTI_HOST;
-    /**
-     * `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.
-     */
-    private static readonly KUBBEALTI_EXTRA_CA;
     private static defaultTimeoutMs;
     private static defaultRetries;
     private static maxCacheSize;
@@ -397,7 +386,6 @@ declare class TDK {
      * spans) — cutting there avoids that trailing cruft.
      */
     private static fetchRuleText;
-    private static htmlToPlainText;
     /**
      * GETs a JSON path from Kubbealtı Lugatı's data API (`eski.lugatim.com`),
      * supplying `KUBBEALTI_EXTRA_CA` to work around that host's incomplete
@@ -500,24 +488,6 @@ declare class TDK {
      * headword. This is an inherent limitation of the data source, not a bug.
      */
     static analyzeText(text: string): Promise<WordAnalysis[]>;
-    /**
-     * 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.
-     */
-    private static damerauLevenshtein;
-    /**
-     * 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.
-     */
-    private static keyboardAwareDistance;
     /**
      * Fetches multiple words concurrently with a small delay to avoid rate limiting.
      */
@@ -621,6 +591,13 @@ declare class TDKNetworkError extends TDKError {
     });
 }
 
+/**
+ * Turkish suffix catalogue used by the morphology engine's BFS stem-stripper
+ * (see `morphology.ts`). Ordered strictly by descending length so that
+ * longer composite suffixes match before their individual subcomponents.
+ */
+declare const TURKISH_SUFFIXES: readonly string[];
+
 /**
  * Turkish Morphology Engine & Stem Candidate Generator.
  *
@@ -631,13 +608,9 @@ declare class TDKNetworkError extends TDKError {
  * 4. Infinitive restoration (-mek / -mak for verbal stems)
  * 5. Apostrophe stripping for proper nouns (İstanbul'da -> İstanbul)
  */
+
 declare const TURKISH_VOWELS = "ae\u0131io\u00F6u\u00FC";
 declare function isVowel(ch: string): boolean;
-/**
- * Turkish suffixes ordered strictly by descending length so that longer
- * composite suffixes match before their individual subcomponents.
- */
-declare const TURKISH_SUFFIXES: readonly string[];
 /**
  * Reverses Turkish consonant softening (ünsüz yumuşaması):
  * When a root ends with p, ç, t, k, it softens to b, c, d, ğ, g before a vowel.
@@ -685,4 +658,16 @@ declare function restoreInfinitive(stem: string): string[];
  */
 declare function getStemCandidates(word: string, minStemLength?: number, maxDepth?: number): string[];
 
-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 };
+/**
+ * Builds the TDK MCP server: every meaningful `TDK` static method is surfaced
+ * as a Model Context Protocol tool so an LLM client (Claude Desktop, Cursor,
+ * Antigravity, …) can query Turkish dictionary, morphology, spelling and
+ * etymology data directly. All tools return JSON text; network/scraping
+ * failures come back as `{ "error": ... }` with `isError: true` rather than
+ * throwing.
+ */
+declare function createMcpServer(): McpServer;
+/** Starts the TDK MCP server over stdio (used by the `tdk mcp` CLI command). */
+declare function runMcpServer(): Promise<void>;
+
+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, createMcpServer, getStemCandidates, isVowel, restoreConsonantSoftening, restoreGemination, restoreInfinitive, restoreVowelDrop, restoreVowelNarrowing, runMcpServer };