Wordle TR Dictionary

Bu repo, Türkçe Wordle benzeri oyunlar için 5 harfli temizlenmiş kelime havuzunu içerir. Geliştirici dostu bir Node.js / NPM paketi yapısına dönüştürülmüş, şapkalı harfler ve özel kurallar için otomatikleştirilmiş bir yapıya kavuşturulmuştur.

Özellikler

• Hedef Kelimeler (TARGET_WORDS): Oyunda cevap olarak çıkabilecek (~1.900) kelimeler.
• Kabul Edilen Kelimeler (ACCEPTED_WORDS): Tahmin olarak girilebilecek (~5.600) kelimeler. Şapkalı (Â, Î, Û vb.) kelimelerin şapkasız versiyonlarını (A, İ, U) otomatik olarak içerir.
• Otomatik Testler: Vitest ile tüm kelime uzunlukları, karakter geçerliliği ve küme ilişkileri test edilir.
• Build Pipeline: TDK tabanlı kaynak veriden (data/sources) optimize edilmiş sözlük (data/generated) üretimi.

Kurulum

Projeyi klonlayıp kendi projelerinize yerel modül (local dependency) olarak ekleyebilirsiniz:

npm install /path/to/wordle-tr-dictionary

Kullanım

import { TARGET_WORDS, ACCEPTED_WORDS } from 'wordle-tr-dictionary';
import { isValidWord, isTargetWord } from 'wordle-tr-dictionary/src/validation';

console.log(isValidWord('KABUS')); // true (KÂBUS üzerinden otomatik üretilir)
console.log(isTargetWord('BEYİN')); // true

Geliştirme (Scripts)

• npm run build: data/sources/tdk.json üzerinden şapka temizliği ve sıralama yaparak data/generated/words.json oluşturur.
• npm run test: Vitest kullanarak sözlük kurallarını ve kelime bütünlüğünü test eder.