@intlayer/docs 9.4.2 → 9.4.3

package/blog/tr/i18n_meaning.md

@@ -19,8 +19,6 @@ author: aymericzip
 
 # i18n Anlamı: Uluslararasılaştırma Nedir ve Neden Önemlidir?
 
-![i18n illüstrasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/assets/i18n.webp)
-
 ## "i18n Anlamı"nı Anlamak
 
 Yazılım geliştirme, web tasarımı veya dijital pazarlama ile ilgileniyorsanız, muhtemelen **i18n** terimiyle karşılaşmışsınızdır. Gerçek **i18n anlamı**, basitçe **internationalization** (uluslararasılaştırma) kelimesi için bir numeronimdir (sayı-ad).

package/blog/tr/i18n_testing_strategies.md

@@ -0,0 +1,179 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: "Kırılgan Testler Yazmadan Çevirileri Test Etme Yöntemleri"
+description: Çok dilli bir uygulamada nelerin test edilmeye değer olduğu ve nelerin olmadığı. Provider tabanlı render testleri, sahte yerelleştirme (pseudolocalization), RTL ve çoğul kapsamı ile anlık görüntü (snapshot) tuzağı.
+keywords:
+  - çeviri testi
+  - i18n testi
+  - testing library i18n
+  - sahte yerelleştirme
+  - dil sağlayıcı testi
+  - snapshot test i18n
+slugs:
+  - blog
+  - i18n-testing-strategies
+author: aymericzip
+---
+
+# Kırılgan Testler Yazmadan Çevirileri Test Etme Yöntemleri
+
+Çoğu i18n test paketi iki nedenden biriyle başarısız olur. Ya doğrudan metin içeriğini doğrularlar, böylece ufak bir kelime değişikliği elli testi bozar ve ekip testleri silmek zorunda kalır. Ya da her şeyi yalnızca varsayılan dilde render ederler, bu da diğer on yedi dil hakkında hiçbir şey kanıtlamaz. Her iki yaklaşım da aynı yere varır: kimsenin güvenmediği bir test paketi.
+
+## İçindekiler
+
+<TOC/>
+
+## Desenler kütüphaneden bağımsızdır
+
+Aşağıdaki her desen her türlü i18n yığınında çalışır. Sağlayıcıyı `I18nextProvider`, `NextIntlClientProvider` veya `IntlProvider` ile değiştirseniz bile testler tamamen aynı kalır; çünkü bir kütüphane API'sini değil, render edilen çıktıyı doğrularlar.
+
+Kapsam araçları da taşınabilir: Mevcut kataloglarınıza yönlendirilmiş [Sync JSON eklentisi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/plugins/sync-json.md) veya mevcut içe aktarmalarınızı takma adlandıran bir [uyumluluk adaptörü](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md) ile kapsam doğrulaması doğrudan mevcut JSON dosyalarınıza karşı çalışır.
+
+## Aslında neyi test ettiğinize karar verin
+
+Çeviri kalitesi kod testiyle doğrulanamaz. Hiçbir assertion Almanca metnin doğal olup olmadığını size söyleyemez ve aksini iddia etmek test paketinizi sabit kodlanmış dizelerle doldurur.
+
+Mekanik olarak test edilmeye değer olanlar şunlardır:
+
+| Test edilmeye değer                       | Test edilmeye değmez                 |
+| :---------------------------------------- | :----------------------------------- |
+| Gerekli her dilin bir değeri olması       | İfadenin ne kadar zarif olduğu       |
+| Doğru dilin bileşene ulaşması             | Her etiketin tam metin kopyası       |
+| Çoğulların her kategori için çözümlenmesi | Çevirmenin işini iyi yapıp yapmadığı |
+| RTL dillerinin yön ve aynalama ayarları   | Her dildeki her dize                 |
+| Biçimlendirilmiş tarih ve sayıların dili  | `Intl` motorunun iç doğruluğu        |
+
+Kapsam denetimi bileşen testlerinizde değil, tek bir veri odaklı testte yapılmalıdır. Bu konu [eksik çevirileri tespit etme](https://github.com/aymericzip/intlayer/blob/main/docs/blog/tr/detecting_missing_translations.md) yazısında ayrıntılı olarak ele alınmıştır; bu yazı diğer konulara odaklanır.
+
+## Sağlayıcı altında render edin ve role göre sorgulayın
+
+Temel desen, bileşeni bir dil sağlayıcısı içine yerleştirmek ve metin yerine rol veya test id üzerinden sorgulama yapmaktır.
+
+```tsx fileName="CartSummary.test.tsx"
+import { render, screen } from "@testing-library/react";
+import { IntlayerProvider } from "react-intlayer/client";
+import { CartSummary } from "./CartSummary";
+
+test("özet başlığını Fransızca render eder", () => {
+  render(
+    <IntlayerProvider locale="fr-FR">
+      <CartSummary />
+    </IntlayerProvider>
+  );
+
+  expect(screen.getByRole("heading")).toBeInTheDocument();
+});
+```
+
+`getByRole("heading")` ile sorgulamak metin değişikliklerine karşı dirençlidir. `getByText("Récapitulatif")` ise metin değiştiğinde bozulur. Birebir metin eşleşmesini yalnızca dizenin kendisi test konusu olduğunda kullanın, bu da oldukça nadirdir.
+
+`aria-label` gibi nitelikler için render edilebilir bir düğüm yerine ham dizeye ihtiyacınız vardır. React'ta `useIntlayer` girişleri bunun için bir `.value` alanı sunar.
+
+## Testleri diller arasında parametrelendirin
+
+Her dil için ayrı test yazmaktansa, tüm diller üzerinde çalışan tek bir test mantığı çok daha değerlidir.
+
+```tsx fileName="direction.test.tsx"
+import { getHTMLTextDir } from "intlayer";
+import { render } from "@testing-library/react";
+import { IntlayerProvider } from "react-intlayer/client";
+
+describe.each(["en", "fr", "ja", "ar"])("dil %s", (locale) => {
+  it("anahtar adına geri dönmeden render edilir", () => {
+    const { container } = render(
+      <IntlayerProvider locale={locale}>
+        <CartSummary />
+      </IntlayerProvider>
+    );
+
+    // Anahtarın render edilmesi aramanın başarısız olduğunu gösterir.
+    expect(container.textContent).not.toMatch(/^[a-z]+(\.[a-z]+)+$/);
+  });
+
+  it("doğru metin yönünü ayarlar", () => {
+    expect(getHTMLTextDir(locale)).toBe(locale === "ar" ? "rtl" : "ltr");
+  });
+});
+```
+
+İlk assertion zahmetsiz ve genel bir kazançtır: Arama başarısız olduğunda kütüphaneniz anahtarı yazdırırsa, DOM içinde `cart.summary.title` gibi bir kalıp yer alır. Bu, tek bir dizeyi belirtmeden bütün bir hata sınıfını yakalar.
+
+## Sahte yerelleştirme (Pseudolocalization) katalogların göremediğini bulur
+
+Her dizeyi dönüştüren sahte bir dil ekleyin; örneğin `Checkout` ifadesini `[!!! Çĥéçķöũţ !!!]` haline getirin. Ardından sayfayı bu dilde render edin.
+
+Halen standart İngilizce görünen her metin doğrudan koda gömülmüştür. Hiçbir katalog tabanlı denetim bunu göremez çünkü araçlar açısından o dize henüz mevcut değildir. Köşeli ayraçlar ikinci bir işe yarar: Metni yaklaşık yüzde 30 uzatarak, Almanca desteği gelmeden önce tasarımın taşacağı yerleri açığa çıkarır.
+
+Bu hata görsel olarak fark edildiğinden, bunu birim test yerine görsel veya uçtan uca (E2E) test olarak çalıştırmak en doğrusudur.
+
+## Çoğullar dil başına değil, kategori başına test gerektirir
+
+Çoğul hataları genellikle gizli kalır çünkü İngilizcede yalnızca iki biçim vardır ve çoğu geliştirici yalnızca bunları dener. Lehçede dört, Arapçada altı çoğul kategorisi bulunur.
+
+```ts fileName="plural.test.ts"
+// Arapça zero, one, two, few, many, other kategorilerini kapsar.
+describe.each([0, 1, 2, 3, 11, 100])("sayı %i", (count) => {
+  it("Arapçada boş olmayan bir dize üretir", () => {
+    expect(formatItems(count, "ar")).not.toBe("");
+  });
+});
+```
+
+Her yerde sadece 1 ve 2'yi test etmek yerine en karmaşık diliniz için her CLDR kategorisine denk gelen sayıları seçin. `Intl.PluralRules` bir sayının hangi kategoriye girdiğini söyler, böylece tahmin yürütmek zorunda kalmazsınız. Kategoriler hakkında daha fazla bilgi için [ICU mesaj formatı makalesine](https://github.com/aymericzip/intlayer/blob/main/docs/blog/tr/icu_message_format.md) göz atın.
+
+## Anlık görüntü (Snapshot) tuzağı
+
+Anlık görüntüler ve i18n iyi bir ikili değildir. Yerelleştirilmiş bir bileşenin anlık görüntüsü içerideki her dizeyi kaydeder: bir çevirmen Portekizcedeki bir yazım hatasını düzelttiğinde, hiçbir incelemecinin anlayamayacağı bir dosyada yeşil yanan test kırmızıya döner. Bir süre sonra geliştiriciler diff'i okumadan `-u` çalıştırmaya başlar ve snapshot testleri tüm anlamını yitirir.
+
+Snapshot kullanmak istiyorsanız, bunu yalnızca tek bir dilde alın ve içerik denetimi yerine yapısal bir kontrol olarak değerlendirin. Dile özgü her şey açık assertion ifadelerinde yer almalıdır.
+
+## Yalnızca render işlemini değil, dil anlaşmasını da test edin
+
+Canlı ortamdaki en yaygın i18n hatası çevirinin eksik olması değildir. Yanlış dilin seçilmesidir: URL `/fr/` derken istemci `navigator.language` okur ve uyuşmazlık yaşanır.
+
+Çözümleme sırasını bileşenlerden bağımsız, saf bir fonksiyon olarak doğrudan test edin:
+
+```ts fileName="locale-resolution.test.ts"
+it("kaydedilen tercihe göre URL'yi önceler", () => {
+  expect(resolveLocale({ url: "/fr/about", stored: "de", header: "ja" })).toBe(
+    "fr"
+  );
+});
+
+it("URL'de önek olmadığında başlığa (header) geri döner", () => {
+  expect(resolveLocale({ url: "/about", stored: null, header: "ja" })).toBe(
+    "ja"
+  );
+});
+```
+
+Bu, çoğu projede eksik olan en yüksek değerli i18n testidir ve herhangi bir DOM gerektirmez.
+
+## Neyi nerede çalıştırmalı
+
+- **Unit**: Dil seçimi mantığı, formatlayıcılar, çoğul kategorileri. Hızlıdır, DOM gerektirmez.
+- **Bileşen**: Her dil için bir kez sağlayıcı tabanlı render, roller ve ham anahtar olmaması denetimi.
+- **Kapsam**: Gerekli dillerde eksik olmadığını doğrulayan veri odaklı test.
+- **Görsel veya E2E**: Sahte yerelleştirme geçişi ve bir RTL sayfası; çünkü bu hatalar görseldir.
+
+İlk üçünü her commit'te CI hattında tutun. Sonuncusunu her push yerine gecelik derlemelerde çalıştırmak daha ekonomiktir.
+
+## Sık yapılan hatalar
+
+- **Her yerde birebir metni doğrulamak.** Test paketinin birkaç ay içinde silinmesini garantiler.
+- **Yerelleştirilmiş bileşenlerin anlık görüntüsünü almak.** Çevirmenler derlemeyi bozar, incelemeciler kontrol etmeden onaylar.
+- **Yalnızca varsayılan dili test etmek.** Asla eksik olamayacak tek dili test etmiş olursunuz.
+- **Çoğullar için yalnızca 1 ve 2'yi test etmek.** İngilizcede bulunmayan tüm kategorileri kaçırır.
+- **i18n kütüphanesini mock ile devre dışı bırakmak.** O zaman yalnızca mock nesnenizin dize döndürdüğünü test edersiniz.
+- **Dil anlaşma mantığını asla test etmemek.** Gerçek dünyadaki en yaygın sorun ve test etmesi en kolay olanıdır.
+
+## İleri okuma
+
+- [İçeriğinizi test etme: CLI denetimi, programatik API ve UI doğrulamaları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/testing.md)
+- [ESLint eklentisi: Sabit kodlanmış dizeleri ve kullanılmayan içerikleri yakalama](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/eslint.md)
+- [Formatlayıcılar ve dil yardımcıları (`getHTMLTextDir` dahil)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/formatters.md)
+- [Frameworkler arası benchmark raporları](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/benchmark/index.md)
+- [react-i18next uyumluluk adaptörü](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/react-i18next.md)
+- [Eksik çevirileri tespit etme](https://github.com/aymericzip/intlayer/blob/main/docs/blog/tr/detecting_missing_translations.md)
+- [ICU mesaj biçimi: Çoğullar, select ve iskeletler](https://github.com/aymericzip/intlayer/blob/main/docs/blog/tr/icu_message_format.md)

package/blog/tr/intlayer_with_i18next.md

@@ -74,15 +74,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_next-i18next.md

@@ -67,15 +67,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_next-intl.md

@@ -69,15 +69,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_react-i18next.md

@@ -68,15 +68,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_react-intl.md

@@ -69,15 +69,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_vue-i18n.md

@@ -68,15 +68,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/is_i18next_outdated.md

@@ -0,0 +1,315 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: i18next 2026'da Güncelliğini Yitirdi mi?
+description: i18next milyonlarca web sitesine güç veriyor, ancak 2011 yapımı çalışma zamanı mimarisi eskimeye başladı. Paket boyutu, tree-shaking sınırları ve duraksayan inovasyon üzerine bir inceleme.
+keywords:
+  - i18next
+  - react-i18next
+  - next-i18next
+  - Intlayer
+  - Uluslararasılaştırma
+  - i18n
+  - Paket boyutu
+  - Blog
+slugs:
+  - blog
+  - is-i18next-outdated
+author: aymericzip
+---
+
+# i18next 2026'da Güncelliğini Yitirdi mi?
+
+`i18next`, React bileşenleri, Webpack paketlemesi veya TypeScript standart hale gelmeden çok önce, 2011 yılında piyasaya sürüldü. Esnekliği ve yaygınlığı ile ekosistemi ele geçirdi, her teknoloji için eklentilere ve StackOverflow'da olası her hata için hazır yanıtlara sahip oldu.
+
+Terk edilmiş bir proje değil, düzenli olarak yamalar almaya devam ediyor. Ancak eskiyen bir motoru çalışır durumda tutmak ile modern frontend mimarisiyle birlikte aktif olarak gelişmek arasında belirgin bir fark vardır.
+
+Son birkaç yılda frontend dünyası derleme zamanı optimizasyonuna, React Server Components (RSC) yapısına, agresif tree-shaking yöntemlerine ve yapay zeka odaklı iş akışlarına yöneldi. i18next'in çekirdeği ise on yıl önceki halini koruyor: istemci tarafında dize anahtarlarını çözen bir çalışma zamanı tekili (runtime singleton).
+
+<TOC/>
+
+## Öne Çıkanlar
+
+**Bakım modu:**
+
+Geçtiğimiz yıl boyunca `next-i18next` ~63 commit (yaklaşık haftada bir) ve `react-i18next` ~157 commit kaydetti, bu değişiklikler çoğunlukla bağımlılık güncellemeleri ve küçük düzeltmelerden oluştu.
+
+**Ağır çalışma zamanı yükü:**
+
+`react-i18next` ve `next-i18next`, tek bir çevrilmiş kelime render etmeden önce istemciye ~17–18 KB gzipped (~60 KB minified) kod enjekte eder, bu da `next-intlayer`'a (~4.7 KB) kıyasla neredeyse 4 kat fazladır.
+
+**Ciddi veri sızıntısı:**
+
+Varsayılan statik kurulumlarda, bir sayfaya gönderilen yerelleştirme verisinin **%89.8'e** varan kısmı diğer rotalara veya okunmayan dillere aittir.
+
+**Tree-shaking imkansızlığı:**
+
+`t("home.hero.title")` gibi dinamik dize çağrıları paketleyiciler tarafından statik olarak çözümlenemez, bu da tüm JSON dosyalarının istemci koduna dahil edilmesine yol açar.
+
+**Ticari teşvikler:**
+
+Geliştiriciler Locize platformunu yönetmektedir. CLI içerisine sıfır maliyetli ve yerel bir yapay zeka çeviri akışı eklemek, onların ana gelir modeliyle doğrudan rekabet oluşturur.
+
+## Bakım vs. Aktif Gelişim
+
+GitHub yıldızları mevcut mimari ivmeyi değil, geçmişteki yaygınlığı yansıtır.
+
+| Depo                    | Yıldızlar                                                                                                                                                  | Toplam commit                                                                                                                                                           | Yıllık commit                                                                                                                                                          | Son commit                                                                                                                                       |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `i18next/i18next`       | [![stars](https://img.shields.io/github/stars/i18next/i18next?style=for-the-badge&label=stars)](https://github.com/i18next/i18next/stargazers)             | [![commits](https://img.shields.io/github/commit-activity/t/i18next/i18next?style=for-the-badge&label=commits)](https://github.com/i18next/i18next/commits)             | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/i18next/commits)             | [![last](https://img.shields.io/github/last-commit/i18next/i18next?style=for-the-badge)](https://github.com/i18next/i18next/commits)             |
+| `i18next/react-i18next` | [![stars](https://img.shields.io/github/stars/i18next/react-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/react-i18next/stargazers) | [![commits](https://img.shields.io/github/commit-activity/t/i18next/react-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/react-i18next/commits) | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/react-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/react-i18next/commits) | [![last](https://img.shields.io/github/last-commit/i18next/react-i18next?style=for-the-badge)](https://github.com/i18next/react-i18next/commits) |
+| `i18next/next-i18next`  | [![stars](https://img.shields.io/github/stars/i18next/next-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/next-i18next/stargazers)   | [![commits](https://img.shields.io/github/commit-activity/t/i18next/next-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/next-i18next/commits)   | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/next-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/next-i18next/commits)   | [![last](https://img.shields.io/github/last-commit/i18next/next-i18next?style=for-the-badge)](https://github.com/i18next/next-i18next/commits)   |
+| `aymericzip/intlayer`   | [![stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=stars)](https://github.com/aymericzip/intlayer/stargazers)     | [![commits](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits)     | [![yearly](https://img.shields.io/github/commit-activity/y/aymericzip/intlayer?style=for-the-badge&label=%2Fyear)](https://github.com/aymericzip/intlayer/commits)     | [![last](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits)     |
+
+Son on iki ayın geliştirme performansı:
+
+| Proje           | Toplam commit | Son 12 ay | Odak noktası                                 |
+| --------------- | ------------- | --------- | -------------------------------------------- |
+| `next-i18next`  | 1.311         | **63**    | Next.js uyumluluğu ve hata yamaları          |
+| `react-i18next` | 1.988         | **157**   | Tip tanımları ve bakım                       |
+| `i18next` core  | 2.626         | **259**   | Küçük güncellemeler                          |
+| Intlayer        | 7.156         | **4.343** | Derleyici, IDE araçları ve yapay zeka motoru |
+
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
+
+Küçük bir kütüphane kararlı olabilir. Ancak i18n araçları yerinde saymadı: modern paketleyiciler kullanılmayan çevirileri derleme anında temizliyor, LLM'ler doğrudan CI süreçlerinde çeviri yapıyor ve editörler özel Language Server (LSP) ile yapay zeka ajanlarına dayanıyor. i18next'in çalışma zamanı modeli bu ilerlemelere ayak uydurmakta zorlanıyor.
+
+## Paket Maliyetini Ölçmek
+
+<I18nBenchmark framework="tanstack" vertical/>
+
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
+
+> 10 rota ve 10 dil içeren bir üretim derlemesinde gzip sıkıştırmasıyla test edilmiştir. Tüm veriler [i18n benchmark raporunda](https://intlayer.org/tr/doc/benchmark).
+
+### Temel Kütüphane Yükü
+
+Çeviri metinleri eklenmeden önceki ilk ayak izi:
+
+| Kütüphane              | Gzipped    | Minified    |
+| ---------------------- | ---------- | ----------- |
+| `next-i18next@16.0.5`  | 17.8 KB    | 61.2 KB     |
+| `react-i18next@17.0.2` | 17.3 KB    | 59.8 KB     |
+| `intlayer@8.7.12`      | **4.7 KB** | **12.8 KB** |
+
+### Sayfa Ağırlığı ve Veri Sızıntısı
+
+React / TanStack Start ortamında test edilmiştir (statik strateji):
+
+| Kütüphane             | Ort. sayfa JS (gz) | Dil sızıntısı | Diğer sayfa sızıntısı | Ort. bileşen (gz) | Hidrasyon   |
+| --------------------- | ------------------ | ------------- | --------------------- | ----------------- | ----------- |
+| `react-i18next`       | 180.3 KB           | **50.0%**     | **89.8%**             | 24.3 KB           | 85.1 ms     |
+| Intlayer              | **127.8 KB**       | 50.0%         | **0.8%**              | **7.1 KB**        | **24.1 ms** |
+| Intlayer (scoped dyn) | **118.1 KB**       | **0.0%**      | **0.8%**              | **4.6 KB**        | 23.7 ms     |
+
+Next.js üzerinde:
+
+| Kütüphane        | Ort. sayfa JS (gz) | Diğer sayfa sızıntısı | Ort. bileşen (gz) |
+| ---------------- | ------------------ | --------------------- | ----------------- |
+| Temel (i18n yok) | 150.8 KB           | 0.0%                  | 0.7 KB            |
+| `next-i18next`   | **227.5 KB**       | **89.8%**             | 24.5 KB           |
+| `next-intlayer`  | **152.1 KB**       | **0.0%**              | **7.2 KB**        |
+
+### Temel Bulgular
+
+**Sayfa ağırlığı:**
+
+Next.js'te `next-i18next`, temel projeye kıyasla **76.7 KB gzipped** ek yük getirir (%50 artış). `next-intlayer` ise yalnızca 1.3 KB ekler.
+
+**Veri sızıntısı:**
+
+Varsayılan ayarlarda, bir rotaya iletilen **çevirilerin %90'a yakını** diğer sayfalara aittir. Manuel ad alanı bölme zahmetlidir ve gözden kaçan eksikliklere gebedir.
+
+**Hidrasyon gecikmesi:**
+
+`react-i18next` bileşenlerinin hidrasyonu **85 ms** sürerken, Intlayer'da bu süre **24 ms** olarak ölçülmüştür. İstemci bileşenlerine devasa JSON ağaçları göndermek ilk etkileşim süresini yavaşlatır.
+
+## i18next Neden Ağır?
+
+### Çalışma Zamanına Yığılan Özellikler
+
+Sadece tarayıcıda çalışmak, tüm yeteneklerin baştan yüklenmesini gerektirir: interpolasyon, çoğul kuralları, bağlam çözümleri, formatlayıcılar ve olay mekanizmaları. En basit metin bile koca bir motorun bedelini öder.
+
+### Dinamik Anahtarlar Tree-Shaking'i Engeller
+
+`"hero.title"` anahtarı çalışma anında çözümlendiğinden, paketleyiciler hangi metinlerin gerçekten kullanıldığını tespit edemez. Kullanılmayan dizeler de pakette kalır.
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```tsx fileName="Component.tsx"
+const { t } = useTranslation("home");
+
+return <h1>{t("hero.title")}</h1>;
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```tsx fileName="Hero.tsx"
+const { title } = useIntlayer("hero");
+
+return <h1>{title}</h1>;
+```
+
+  </Tab>
+</Tabs>
+
+[Intlayer derleyicisi](https://intlayer.org/tr/doc/compiler), `Hero.tsx` bileşeninin gerçekte neleri tükettiğini analiz eder ve kullanılmayan alanları temizler. İncelemek için [paket optimizasyonu](https://intlayer.org/tr/doc/concept/bundle-optimization) sayfasına bakın.
+
+## Geliştirici Deneyimi
+
+### Dağınık JSON vs. Birlikte Konumlandırma
+
+i18next'te metinler koddan ayrı JSON klasörlerinde bulunur. Intlayer ise içerik bildirimlerini doğrudan bileşenlerin yanına yerleştirir:
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```json fileName="locales/en/hero.json"
+{
+  "title": "Ship in every language"
+}
+```
+
+```json fileName="locales/tr/hero.json"
+{
+  "title": "Her dilde yayına alın"
+}
+```
+
+```tsx fileName="Hero.tsx"
+import { useTranslation } from "react-i18next";
+
+export const Hero = () => {
+  const { t } = useTranslation("hero");
+  return <h1>{t("title")}</h1>;
+};
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero",
+  content: {
+    title: t({
+      en: "Ship in every language",
+      tr: "Her dilde yayına alın",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+```tsx fileName="Hero.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const Hero = () => {
+  const { title } = useIntlayer("hero");
+  return <h1>{title}</h1>;
+};
+```
+
+  </Tab>
+</Tabs>
+
+`Hero.tsx` dosyasını taşıdığınızda veya sildiğinizde, içerik tanımları da onunla birlikte taşınır ya da silinir.
+
+### Otomatik Tamamlama vs. Kesin Tip Güvenliği
+
+`CustomTypeOptions` tanımlamak editörde otomatik tamamlama sağlar ancak içeriğin varlığını garanti etmez. `tr/home.json` dosyasından bir anahtarı silmek derlemeyi durdurmaz, sadece çalışma zamanında fallback tetikler.
+
+Intlayer, tipleri doğrudan içerik bildirimlerinden çıkarır ve [`strictMode`](https://intlayer.org/tr/doc/concept/configuration) modu eksik çevirileri derleme hatasına dönüştürür.
+
+### Araç Karşılaştırması
+
+| Özellik                      | i18next Ekosistemi    | Intlayer                                                                 |
+| ---------------------------- | --------------------- | ------------------------------------------------------------------------ |
+| **VS Code Eklentisi**        | Yalnızca üçüncü taraf | ✅ [Resmi eklenti](https://intlayer.org/tr/doc/vs-code-extension)        |
+| **Language Server (LSP)**    | ❌ Yok                | ✅ [Özel LSP](https://intlayer.org/tr/doc/lsp)                           |
+| **MCP Sunucusu (AI İçin)**   | ❌ Yok                | ✅ [Entegre MCP sunucusu](https://intlayer.org/tr/doc/mcp-server)        |
+| **Ajan Becerileri (Skills)** | ❌ Yok                | ✅ [Kullanıma hazır beceriler](https://intlayer.org/tr/doc/agent_skills) |
+| **Görsel CMS**               | Locize (Ücretli SaaS) | ✅ [Ücretsiz ve Açık Kaynak](https://intlayer.org/tr/doc/concept/editor) |
+
+## Çeviri ve Locize Modeli
+
+Locize, i18next yapımcılarının ticari servisidir. Açık kaynağın sürdürülebilirliği mühimdir, fakat bu yapı bir çıkar çatışması yaratır: gelirini ücretli bir SaaS çeviri platformundan sağlayan bir kütüphanenin, CLI içine yerel ve ücretsiz bir yapay zeka çeviri mekanizması ekleme motivasyonu düşüktür.
+
+Intlayer açık yaklaşımı benimser:
+
+- [`intlayer fill`](https://intlayer.org/tr/doc/concept/auto-fill), eksik çevirileri terminalinizde veya CI süreçlerinizde kendi OpenAI, Anthropic, Mistral ya da Gemini API anahtarlarınızla tamamlar.
+- [Intlayer CMS](https://intlayer.org/tr/doc/concept/cms) açık kaynaklıdır ve Docker Compose ile yerel olarak barındırılabilir.
+- Derleyici, CLI, editör ve CMS tamamen Apache 2.0 lisanslıdır.
+
+## i18next Hangi Durumlarda Halen Uygundur?
+
+<AccordionGroup>
+<Accordion header="Kararlı ve eski projeler">
+
+Uygulamanız sorunsuz çalışıyorsa ve paket boyutu sizin için bir engel teşkil etmiyorsa, yeniden yazmak acil değildir.
+
+</Accordion>
+<Accordion header="Özel platformlar">
+
+i18next'in geniş eklenti yelpazesi, modern derleyicilerin doğrudan hedeflemediği ortamları (Electron, eski jQuery uygulamaları, özel native köprüler) destekler.
+
+</Accordion>
+<Accordion header="Geniş topluluk arşivi">
+
+StackOverflow ve GitHub'da biriken çözümler sıra dışı senaryoların çözülmesine yardımcı olur.
+
+</Accordion>
+</AccordionGroup>
+
+## Mevcut i18next Yapılandırmamı Nasıl Geliştirebilirim?
+
+Intlayer, i18next kütüphanelerinin (`i18next`, `react-i18next` ve `next-i18next`) fonksiyon imzalarını birebir koruyan doğrudan uyumluluk paketleri sunar. Derleyici odaklı modern mimarinin avantajlarından faydalanmak için bileşenlerinizi yeniden yazmanız gerekmez.
+
+Kurulum tek bir komutla tamamlanır:
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer init --interactive
+```
+
+Bu etkileşimli CLI:
+
+1. `@intlayer/i18next` uyumluluk paketini yükler.
+2. Mevcut içe aktarmalarınızın (`useTranslation`, `Trans`, `t`) doğrudan Intlayer'a yönlendirilmesi için paketleyici alias'larını yapılandırır; böylece eski kütüphaneyi `package.json` dosyasından kaldırabilirsiniz.
+3. Editörde Dil Sunucusu (LSP) teşhislerini, derleme anında paket optimizasyonunu (tam tree-shaking) ve yerel yapay zeka çeviri iş akışlarını anında devreye alır.
+
+Ayrıntılı adımlar için özel kılavuzlarımızı inceleyin:
+
+- **Uyumluluk katmanları:** [i18next](https://intlayer.org/tr/doc/compatibility/i18next), [react-i18next](https://intlayer.org/tr/doc/compatibility/react-i18next) ve [next-i18next](https://intlayer.org/tr/doc/compatibility/next-i18next) uyumluluk katmanlarıyla mevcut sözdiziminizi koruyun.
+- **Katalog dönüştürme:** JSON dosyalarınızı tipli sözlüklere dönüştürün: [i18next üzerinden](https://intlayer.org/tr/doc/migration/i18next), [react-i18next üzerinden](https://intlayer.org/tr/doc/migration/react-i18next) veya [next-i18next üzerinden](https://intlayer.org/tr/doc/migration/next-i18next).
+- **Hibrit yapı:** i18next çalışma zamanını korurken, katalogları otomatik olarak tiplendirmek ve çevirmek için [Intlayer'ı i18next ile birlikte kullanın](https://intlayer.org/tr/blog/intlayer-with-i18next).
+
+Sitenizi ücretsiz [i18n SEO Tarayıcısı](https://intlayer.org/i18n-seo-scanner) ile analiz edin:
+
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## İlgili Yazılar
+
+- [Next.js i18n Benchmark: Kapsamlı Performans İncelemesi](https://intlayer.org/tr/doc/benchmark/nextjs)
+- [react-i18next vs react-intl vs Intlayer](https://intlayer.org/tr/blog/react-i18next-vs-react-intl-vs-intlayer)
+- [next-intl 2026'da Güncelliğini Yitirdi mi?](https://intlayer.org/tr/blog/is-next-intl-outdated)
+- [Derleyici Odaklı ve Bildirime Dayalı i18n Mimarisi](https://intlayer.org/tr/blog/compiler-vs-declarative-i18n)