ekler

Turkish grammatical case suffix library. Automatically applies vowel harmony, consonant assimilation, and buffer letter rules.

Installation

npm install ekler

Usage

import { belirtme, yonelme, bulunma, ayrilma } from "ekler";

belirtme("araba");  // "arabayı"  (accusative)
yonelme("kedi");    // "kediye"   (dative)
bulunma("sokak");   // "sokakta"  (locative)
ayrilma("ev");      // "evden"    (ablative)

Functions

belirtme(kelime, secenekler?)

Accusative case (i-hali). Variants: -ı, -i, -u, -ü. Adds y buffer when the word ends with a vowel.

belirtme("araba");  // "arabayı"
belirtme("ev");     // "evi"
belirtme("okul");   // "okulu"
belirtme("göz");    // "gözü"

yonelme(kelime, secenekler?)

Dative case (e-hali). Variants: -a, -e. Adds y buffer when the word ends with a vowel.

yonelme("okul");   // "okula"
yonelme("kedi");   // "kediye"
yonelme("araba");  // "arabaya"

bulunma(kelime, secenekler?)

Locative case (de-hali). Variants: -da, -de, -ta, -te. Uses t after voiceless consonants (f, s, t, k, ç, ş, h, p).

bulunma("deniz");   // "denizde"
bulunma("sokak");   // "sokakta"
bulunma("ağaç");   // "ağaçta"

ayrilma(kelime, secenekler?)

Ablative case (den-hali). Variants: -dan, -den, -tan, -ten. Uses t after voiceless consonants (f, s, t, k, ç, ş, h, p).

ayrilma("ev");      // "evden"
ayrilma("sokak");   // "sokaktan"
ayrilma("ağaç");   // "ağaçtan"

Options

Every function accepts an optional second parameter:

interface Secenekler {
  iyelik?: boolean;
  ozelIsim?: boolean;
}

iyelik

Set to true when the word already carries a 3rd-person possessive suffix. Inserts the pronominal n buffer automatically.

belirtme("arabası", { iyelik: true }); // "arabasını"
yonelme("arabası", { iyelik: true });  // "arabasına"
bulunma("arabası", { iyelik: true });  // "arabasında"
ayrilma("arabası", { iyelik: true });  // "arabasından"

ozelIsim

Set to true for proper nouns. Separates the suffix with an apostrophe (').

yonelme("Ankara", { ozelIsim: true });  // "Ankara'ya"
bulunma("Tokat", { ozelIsim: true });   // "Tokat'ta"
ayrilma("Ankara", { ozelIsim: true });  // "Ankara'dan"
belirtme("Ali", { ozelIsim: true });    // "Ali'yi"

License

MIT