@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.7

package/docs/tr/intlayer_with_vite+vue.md

@@ -663,14 +663,17 @@ Paralel olarak, uygulamanıza sunucu tarafı yönlendirme eklemek için `intlaye
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -994,6 +997,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel derleyicisi'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `vite.config.ts` dosyanızı `intlayerCompiler` eklentisini içerecek şekilde güncelleyin:
 
 ```ts fileName="vite.config.ts"
@@ -1003,7 +1008,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Derleyici eklentisini ekler
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/tr/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "@intlayer/babel Paket Dokümantasyonu"
+description: Intlayer için derleme sırasında içerik ayıklama, import optimizasyonu, kullanılmayan alanları temizleme ve alan adlarını karartma işlemlerini gerçekleştiren Babel eklentileri.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - uluslararasılaştırma
+  - i18n
+  - derleyici
+  - optimize et
+  - temizle
+  - karart
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Tüm dışa aktarılan modüllerin dokümantasyonu birleştirildi"
+author: aymericzip
+---
+
+# @intlayer/babel Paketi
+
+`@intlayer/babel` paketi, Intlayer için özel Babel eklentilerinden oluşan bir set sağlar. Bu eklentiler tüm derleme döngüsünü kapsar: içerik bildirimlerini ayıklama, `useIntlayer` / `getIntlayer` çağrılarını optimize edilmiş sözlük importlarına yeniden yazma, kullanılmayan alanları temizleme ve alan adlarını karartma (minify).
+
+## Kurulum
+
+```bash
+npm install @intlayer/babel
+```
+
+## Dışa Aktarılanlar
+
+İçe aktarma (Import):
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Eklentiler (Plugins)
+
+| İşlev / Sınıf                  | Açıklama                                                                                                                                                                                                                                    |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Babel eklentisi, kaynak dosyalardan çevrilebilir içeriği ayıklayan ve `useIntlayer` / `getIntlayer` kancalarını (hooks) otomatik olarak ekleyen Babel eklentisi. Next.js ve Babel tabanlı derleme araçlarıyla kullanım için tasarlanmıştır. |
+| `intlayerOptimizeBabelPlugin`  | useIntlayer ve getIntlayer çağrılarını dönüştüren ve bunların importlarını optimize edilmiş JSON sözlük importlarına (statik, dinamik veya fetch aracılığıyla) yeniden yazan Babel eklentisi.                                               |
+| `intlayerPurgeBabelPlugin`     | Kaynak dosyaları analiz eden ve kullanılmayan alanları kaldırmak (`build.purge`) veya bunları kısa takma adlarla yeniden adlandırmak (`build.minify`) için derlenmiş sözlük JSON dosyalarını yeniden yazan Babel eklentisi.                 |
+| `intlayerMinifyBabelPlugin`    | Kaynak dosyaları, karartma aşamasında atanan kısa alan takma adlarını (örneğin `content.title` ← `content.a`) kullanacak şekilde yeniden yazan Babel eklentisi. `intlayerPurgeBabelPlugin` eklentisine dayanır.                             |
+| `makeFieldRenameBabelPlugin`   | `PruneContext` içinde doldurulan `dictionaryKeyToFieldRenameMap` eşlemesine göre kaynak dosyalardaki sözlük içeriği alan erişimlerini yeniden adlandırmak için bir Babel eklentisi üreten fabrika (factory) işlevi.                         |
+| `makeUsageAnalyzerBabelPlugin` | Kaynak koddaki `useIntlayer` / `getIntlayer` kullanımını analiz etmek ve paylaşılan `PruneContext` içindeki alan kullanım verilerini toplamak için bir Babel eklentisi üreten fabrika işlevi.                                               |
+| `getSharedPruneContext`        | Belirtilen temel dizin için paylaşılan `PruneContext` nesnesini döndüren veya henüz başlatılmamışsa `null` döndüren yardımcı işlev.                                                                                                         |
+
+---
+
+### Eklenti Yapılandırma Yardımcı Programları
+
+| İşlev                      | Açıklama                                                                                                                                        |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Intlayer yapılandırmasını yükler ve `intlayerExtractBabelPlugin` ile kullanıma hazır `ExtractPluginOptions` döndürür.                           |
+| `getOptimizePluginOptions` | Intlayer yapılandırmasını ve derlenmiş sözlükleri yükler ve `intlayerOptimizeBabelPlugin` ile kullanıma hazır `OptimizePluginOptions` döndürür. |
+| `getPurgePluginOptions`    | Intlayer yapılandırmasını yükler ve `intlayerPurgeBabelPlugin` ile kullanıma hazır `PurgePluginOptions` döndürür.                               |
+| `getMinifyPluginOptions`   | Intlayer yapılandırmasını yükler yardsımcı ve `intlayerMinifyBabelPlugin` ile kullanıma hazır `MinifyPluginOptions` döndürür.                   |
+
+---
+
+### Tipler
+
+| Tip                     | Açıklama                                                                                                                             |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `CompilerMode`          | Derleyici modu: `'dev'` HMR desteğiyle geliştirme için veya `'build'` üretim derlemeleri için.                                       |
+| `ExtractPluginOptions`  | `intlayerExtractBabelPlugin` için seçenekler: dosya listesi, yapılandırma, `onExtract` geri araması (callback) vb.                   |
+| `ExtractResult`         | Ayıklama sonucu: sözlük anahtarı, dosya yolu, içerik ve dil.                                                                         |
+| `OptimizePluginOptions` | `intlayerOptimizeBabelPlugin` için seçenekler: sözlük yolları, içe aktarma modu, sözlük başına mod eşlemesi vb.                      |
+| `PurgePluginOptions`    | `intlayerPurgeBabelPlugin` için seçenekler: temel dizin, temizleme/karartma/optimizasyon bayrakları, bileşen dosyaları listesi.      |
+| `MinifyPluginOptions`   | `intlayerMinifyBabelPlugin` için seçenekler: temel dizin, karartma/optimizasyon/editorEnabled bayrakları.                            |
+| `PruneContext`          | Analiz ve temizleme eklentileri arasında paylaşılan durum: alan kullanım eşlemeleri, yeniden adlandırma eşlemeleri vb.               |
+| `DictionaryFieldUsage`  | Tek bir sözlük için alan kullanımı sonucu: Statik analiz yetersiz olduğunda `Set<string>` veya `'all'`.                              |
+| `NestedRenameEntry`     | Yeniden adlandırma ağacındaki düğüm: `shortName` ve alt düğüm (children) eşlemesi.                                                   |
+| `NestedRenameMap`       | Yeniden adlandırma ağacındaki bir düzey: `Map<string, NestedRenameEntry>`.                                                           |
+| `CompatCallerConfig`    | Uyumlu bağdaştırıcı (compat-adapter) paketleri için uyumlu bir kullanım analizörü yapılandırması (çağıran adı ve işlem seçenekleri). |
+| `ScriptBlock`           | Bir SFC dosyasından (Vue veya Svelte) ayıklanan komut dosyası bloğu: içerik, başlangıç kayması ve bitiş kayması.                     |
+
+---
+
+### Yardımcı İşlevler
+
+| İşlev                             | Açıklama                                                                                                                                                                   |
+| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Bir tamsayıyı (sıfırdan başlayarak) kısa bir alfabetik tanımlayıcıya dönüştürür: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'` vb.                                              |
+| `buildNestedRenameMapFromContent` | Derlenmiş bir sözlüğün içerik değerinden, Intlayer düğüm yapılarına (translation, enumeration vb.) sadık kalarak özyinelemeli (recursive) bir `NestedRenameMap` oluşturur. |
+| `createPruneContext`              | Varsayılan değerlerle başlatılmış yeni bir boş `PruneContext` nesnesi oluşturur.                                                                                           |
+| `extractScriptBlocks`             | Sonraki Babel analizi için SFC dosyalarından (Vue / Svelte) `<script>` bloklarını ayıklar.                                                                                 |
+| `BABEL_PARSER_OPTIONS`            | Desteklenen framework'leri (React/Vue/Svelte/Angular/...) kapsayan Babel ayrıştırıcı seçeneklerini temsil eden sabit.                                                      |
+| `INTLAYER_CALLER_NAMES`           | Orijinal Intlayer çağıran adlarının sabit listesi: `['useIntlayer', 'getIntlayer']`.                                                                                       |
+
+---
+
+## Örnek Kullanım
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Not:** `intlayerPurgeBabelPlugin`, ilk eklenti tarafından oluşturulan yeniden adlandırma eşlemesini okuduğu için `intlayerMinifyBabelPlugin` eklentisinden **önce** bildirilmelidir. Ayrıca, `useIntlayer` çağrıları yeniden yazılmadan önce sözlük anahtarlarını görebilmesi için her ikisinden önce `intlayerOptimizeBabelPlugin` gelmelidir.

package/docs/tr/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Vite Eklenti Dokümantasyonu | vite-intlayer
+description: Bileşen dosyalarından satır içi Intlayer içerik bildirimlerini ayıklayan ve bunları derleme/dönüştürme zamanında sözlük JSON dosyalarına yazan Vite eklentisi.
+keywords:
+  - intlayerCompiler
+  - vite
+  - eklenti
+  - derleyici
+  - içerik
+  - sözlük
+  - uluslararasılaştırma
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "intlayer() içine dahil edildi; dokümantasyon başlatıldı"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler`, bileşen kaynak dosyalarını **satır içi Intlayer içerik bildirimleri** (ayrı bir `.content.ts` dosyası yerine doğrudan bir bileşen içinde tanımlanan içerikler) için tarayan ve bunları dönüştürme aşamasında sözlük JSON dosyalarına yazan bir Vite eklentisidir.
+
+> **Intlayer v9'dan beri** `intlayerCompiler`, Intlayer yapılandırmanızda hem `compiler.enabled` değeri `true` hem de `compiler.output` ayarlandığında ana [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/vite-intlayer/intlayer.md) eklentisine otomatik olarak dahil edilir. Yalnızca derleyiciye özel yapılandırma üzerinde tam kontrol sahibi olmak istediğinizde bunu ayrıca kaydetmeniz gerekir.
+
+## Kullanım
+
+### `intlayer()` Eklentisinin Parçası Olarak (Önerilen, v9+)
+
+Derleyiciyi Intlayer yapılandırmanız aracılığıyla etkinleştirin:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // ayıklanan sözlüklerin yazılacağı yer
+  },
+});
+```
+
+Ardından, ek bir kayıt yapmadan standart eklentiyi kullanın:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Bağımsız (Standalone - gerektiğinde)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Seçenekler
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Seçenek          | Tür                       | Açıklama                                                                                                |
+| ---------------- | ------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | `getConfiguration()` işlevine iletilen Intlayer yapılandırma geçersiz kılmaları.                        |
+| `compilerConfig` | `Partial<CompilerConfig>` | Derleyiciye özel yapılandırma bölümü için geçersiz kılmalar (örneğin `enabled`, `output`, `filesList`). |
+
+### Örnek
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Nasıl çalışır?
+
+### Dönüştürme Aşaması (Transform)
+
+`compiler.filesList` ile eşleşen her kaynak dosya için derleyici eklentisi:
+
+1. Dosya içeriğini `@intlayer/babel` paketindeki `extractContent` işlevine iletir.
+2. Bulunan her bildirim için `onExtract` işlevini çağırır ve bu işlev, ortaya çıkan sözlük JSON dosyasını `compiler.output` yoluna yazar.
+3. Satır içi bildirimlerin standart `useIntlayer('key')` / `getIntlayer('key')` çağrılarıyla değiştirildiği dönüştürülmüş kaynak kodu döndürür.
+
+Desteklenen dosya türleri: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement - Sıcak Modül Değişimi)
+
+Geliştirme modunda bir bileşen dosyası kaydedildiğinde derleyici:
+
+1. Vite'in `handleHotUpdate` kancası (hook) aracılığıyla dosya değişikliğini algılar.
+2. Güncellenen dosyadan içeriği yeniden ayıklar.
+3. Güncellenen sözlük JSON dosyasını yazar.
+4. Tam sayfa yenilemesini tetikler (`server.ws.send({ type: 'full-reload' })`).
+
+500 ms'lik bir debounce (gecikme), sözlük yazma işleminin kendisinin (bu da bir dosya değişikliği olayını tetikler) sonsuz bir yeniden ayıklama döngüsüne neden olmasını önler.
+
+### Tekilleştirme (Deduplication)
+
+`intlayerCompiler`, diğer paketlenmiş eklentilerle aynı `createPrimaryInstanceGuard` tekilleştirme mekanizmasını kullanır. Hem `intlayer()` (derleyiciyi içeren) hem de manuel bir `intlayerCompiler()` çağrısı mevcut olduğunda, yalnızca ilk kaydedilen örnek çalışır — hiçbir sözlük iki kez yazılmaz.

package/docs/tr/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerMinify Vite Eklenti Dokümantasyonu | vite-intlayer
+description: Derlenmiş Intlayer sözlük JSON dosyalarını sıkıştıran (minify) ve paket boyutunu küçültmek için isteğe bağlı olarak içerik alanı adlarını karartan Vite eklentisi.
+keywords:
+  - intlayerMinify
+  - vite
+  - eklenti
+  - minify
+  - paket boyutu
+  - sözlük
+  - uluslararasılaştırma
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Dokümantasyon başlatıldı"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify`, bir üretim derlemesi (production build) sırasında derlenmiş sözlük JSON dosyalarını sıkıştıran bir Vite eklentisidir. Gereksiz tüm boşlukları kaldırır ve `intlayerPrune` ile birleştirildiğinde, paket boyutunu daha da küçültmek için içerik alanı adlarını isteğe bağlı olarak kısa alfabetik takma adlarla (`a`, `b`, `c`, …) yeniden adlandırır.
+
+> Eklenti, [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/vite-intlayer/intlayer.md) kullandığınızda zaten otomatik olarak dahil edilir ve yapılandırılır. Yalnızca eklenti yığınını kendiniz oluşturuyorsanız bunu manuel olarak kaydetmeniz gerekir.
+
+## Kullanım
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Etkinleştirme Koşulları
+
+`intlayerMinify` **yalnızca** aşağıdaki üç koşulun tamamı doğru olduğunda etkindir:
+
+1. Vite komutu `build` (derleme) olduğunda ( `serve` / dev değil).
+2. `build.optimize` değeri `true` (veya derlemeler için varsayılan olarak `true` olan `undefined`) olduğunda.
+3. Intlayer yapılandırmanızda `build.minify` değeri `true` olduğunda.
+
+Editörün tam ve insan tarafından okunabilir sözlük içeriğine ihtiyacı olduğundan, `editor.enabled` değeri `true` olduğunda otomatik olarak **devre dışı bırakılır**.
+
+## Neler Sıkıştırılır?
+
+Eklenti, iki sözlük konumunu hedefler (`intlayer.system` üzerinden çözümlendiği şekliyle):
+
+- `dictionariesDir` — statik tüm dillerdeki sözlükler (örneğin `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — dil başına dinamik sözlükler
+
+> Getirme modundaki sözlükler (`fetchDictionariesDir`), çalışma zamanında orijinal alan adları kullanılarak uzak bir API'den sunuldukları için **asla** sıkıştırılmaz. Alan adlarını yeniden adlandırmak, sunucu yanıtı ile istemci tarafı özellik erişimleri arasında bir uyumsuzluk yaratacaktır.
+
+## Alan Adı Karartma (Özellik Sıkıştırma)
+
+`intlayerPrune` kod tabanını analiz edip `pruneContext.dictionaryKeyToFieldRenameMap` eşlemesini doldurduğunda, `intlayerMinify` içerik alanı adlarını da kısa takma adlarla yeniden adlandırır. Örneğin:
+
+```json
+// önce
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// sonra (karartma ile)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Karşılık gelen kaynak dosya özellik erişimleri `intlayerOptimize` içindeki Babel geçişiyle yeniden adlandırılır, böylece çalışma zamanı davranışı değişmez.
+
+Dahili Intlayer alanları (`nodeType`, `translation` vb.) asla yeniden adlandırılmaz.
+
+## İstisnai Sözlükler (Edge-cases)
+
+`pruneContext.dictionariesWithEdgeCases` içinde işaretlenen sözlükler (temizleme aşamasında algılanan yapısal anomaliler), bozuk veri gönderimini önlemek için tamamen atlanır — ne sıkıştırılır ne de karartılır.
+
+## Nitelikli Gruplar (Koleksiyonlar / Varyantlar / Meta Kayıtlar)
+
+Bir `qualifierTypes` dizisine sahip sözlükler (koleksiyonlar, varyantlar ve meta kayıtlar) için eklenti, `qualifierTypes` dizisini ve `meta` yan eşlemesini aynen korur. Yalnızca `content` girişlerinin alan adları karartılır. Çalışma zamanında seçici eşleştirme için kullanılan birleşik anahtarlara asla dokunulmaz.

package/docs/tr/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerProxy Vite Eklenti Dokümantasyonu | vite-intlayer
+description: Vite dev/preview sunucuları ve üretim SSR için dil yönlendirme ara yazılımı (middleware). Dil algılama, URL yönlendirmeleri ve dahili yeniden yazmaları yönetir.
+keywords:
+  - intlayerProxy
+  - vite
+  - eklenti
+  - middleware
+  - dil
+  - yönlendirme
+  - uluslararasılaştırma
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "configOptions tek bir seçenek nesnesinde birleştirildi; proxy intlayer() içine dahil edildi"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy`, **her ortam** için dil yönlendirme ara yazılımını (middleware) kaydeden bir Vite eklentisidir: geliştirme sunucusu (dev server), önizleme sunucusu (preview server) ve üretim SSR (Nitro / TanStack Start).
+
+> **Intlayer v9'dan beri** `intlayerProxy`, ana [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/vite-intlayer/intlayer.md) eklentisine otomatik olarak dahil edilir ve `routing.enableProxy: true` aracılığıyla varsayılan olarak etkinleştirilir. Yalnızca daha düşük seviyeli kontrole ihtiyacınız olduğunda veya bunu standart `intlayer()` kurulumunun dışında kullandığınızda ayrıca kaydetmeniz gerekir.
+
+## Kullanım
+
+### `intlayer()` Eklentisinin Parçası Olarak (Önerilen, v9+)
+
+`intlayerProxy`'yi ayrıca kaydetmek yerine ana eklentiye `proxy` seçeneklerini iletin:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Bağımsız (Standalone - gerektiğinde)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Seçenekler
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Tüm seçenekler isteğe bağlıdır ve tek bir nesne olarak iletilir:
+
+| Seçenek         | Tür                                 | Açıklama                                                                                                                                                                                          |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ignore`        | `(req: IncomingMessage) => boolean` | İstekleri dil yönlendirmesinden hariç tutan yüklem (predicate). Bir isteği atlamak için `true` döndürün (örneğin API yolları, sağlık kontrolleri).                                                |
+| `configOptions` | `GetConfigurationOptions`           | `getConfiguration()` işlevine iletilen Intlayer yapılandırma geçersiz kılmaları. Proxy'nin belirli bir yapılandırma dosyasını okumasını veya değerleri geçersiz kılmasını istediğinizde kullanın. |
+
+### Örnek
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler`, tüm dil yönlendirme mantığını içeren bağımsız, framework'ten bağımsız bir Node.js `(req, res, next)` ara yazılımı oluşturur. Vite eklenti API'sinin kullanılamadığı ortamlarda (örneğin düz bir Node.js sunucusu veya özel bir Nitro modülü) yararlıdır.
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### Üretim SSR (TanStack Start / h3 aracılığıyla Nitro)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Yönlendirme Davranışı
+
+Ara yazılım, `next-intlayer` ara yazılımının yönlendirme mantığını yansıtır ve tüm Intlayer yönlendirme modlarını destekler.
+
+### Yönlendirme Modları
+
+| Mod             | Tarayıcıda görünen URL   | Davranış                                                                                                                                                 |
+| --------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/tr/about`              | Varsayılan. URL'deki dil öneki. Varsayılan dil, `prefix-all` etkin olmadığı sürece öneksiz URL'ye yönlendirir.                                           |
+| `prefix-all`    | `/en/about`, `/tr/about` | Varsayılan dil dahil tüm diller her zaman öneklidir.                                                                                                     |
+| `no-prefix`     | `/about`                 | URL'de dil yok. Dil yalnızca çerezlerde saklanır; URL yeniden yazımları dahili olarak gerçekleşir.                                                       |
+| `search-params` | `/about?locale=tr`       | Dil, bir sorgu parametresi (query parameter) olarak iletilir. Eksik veya güncel olmadığında `locale` parametresini eklemek/güncellemek için yönlendirir. |
+
+### Algılama Önceliği
+
+1. URL yolu öneki (örneğin `/tr/about` → `tr`).
+2. Çerez / localStorage değeri (`intlayer-locale`).
+3. `Accept-Language` üstbilgisi (header).
+4. Yapılandırmadaki `defaultLocale`.
+
+### Otomatik Atlatma (Bypass)
+
+Ara yazılım, bu istekleri dil işlemi yapmadan her zaman doğrudan iletir:
+
+- `ignore` yüklemiyle eşleşen istekler.
+- `/node_modules/**`
+- `/@**` – Vite dahili bileşenleri (`@vite/`, `@fs/`, `@id/` vb.).
+- `/_**` – sunucu dahili bileşenleri (`__vite_ping`, `__manifest` vb.).
+- Yolu bir dosya uzantısıyla biten istekler (statische assets). Statik bir varlık yolunda bir dil öneki varsa (örneğin `/tr/logo.png`), dosyanın doğru şekilde sunulabilmesi için bu önek kaldırılır.
+
+### Alan Adı Yönlendirmesi (Domain Routing)
+
+Intlayer yapılandırmanızda `routing.domains` yapılandırıldığında, ara yazılım alan adları arası dil yönlendirmesini yönetir:
+
+- `domains.zh = "intlayer.zh"` olduğunda, `intlayer.org` üzerindeki `/zh/about` isteği `https://intlayer.zh/about` adresine yönlendirilir.
+- `intlayer.zh/about` isteği, `[locale]` rota parametresinin doldurulması için dahili olarak `/zh/about` şeklinde yeniden yazılır.
+
+### Yönlendirme Döngüsü Koruması (Redirect Loop Protection)
+
+Ara yazılım, 2 saniyelik kayan bir pencere içinde `originalUrl → newUrl` çifti başına yönlendirme sayılarını izler. Bu pencere içinde 10'dan fazla yönlendirme, sonsuza kadar döngüye girmek yerine açıklayıcı bir hata ile birlikte `500` yanıtı döndürür.
+
+## Nitro / Üretim SSR (Otomatik Enjeksiyon, v9+)
+
+`intlayerProxy` bir Vite eklentisi olarak kullanıldığında, bir `.nitro` özelliği taşır. `nitro/vite` derleme eklentisi bu özelliği okur ve `nitroConfig.modules` içine ekler, böylece `intlayerNitroHandler` otomatik olarak bir Nitro sunucu ara yazılımı olarak kaydedilir — üretim SSR için manuel yapılandırma gerekmez.
+
+Nitro işleyicisi (handler), h3 v2'nin Web Fetch API olay modelini kullanır (`fromNodeMiddleware` değil), bu nedenle tüm Nitro şablonlarıyla (Node, Bun, Deno, edge runtimes) uyumludur.
+
+## Kullanımdan Kaldırılan Takma Adlar (Deprecated)
+
+| Kullanımdan kaldırılan dışa aktarım | Değişiklik      |
+| ----------------------------------- | --------------- |
+| `intlayerMiddleware`                | `intlayerProxy` |
+| `intLayerMiddlewarePlugin`          | `intlayerProxy` |

package/docs/tr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-23
+updatedAt: 2026-06-25
 title: Yeni Intlayer v9 - Yenilikler Neler?
 description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar, Varyantlar ve Dinamik Kayıtlar desteği sunuluyor.
 keywords:
@@ -252,6 +252,28 @@ Bağımsız `intlayerCompiler()` ve `intlayerProxy()` eklentileri gelişmiş kur
 
 ---
 
+## React Native: tek paket içe aktarmaları
+
+Bir React Native veya Expo uygulamasında, artık `react-intlayer` ve `react-native-intlayer` arasında gidip gelmenize gerek yok. `react-native-intlayer` paketi artık **tüm `react-intlayer` API'sini yeniden dışa aktarıyor** (hook'lar, yardımcı programlar ve `/format`, `/html` ve `/markdown` alt yolları) ve `IntlayerProvider`'ı React Native polyfill'lerini otomatik olarak uyguluyor.
+
+Her şeyi tek `react-native-intlayer` paketinden içe aktarın:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer`'dan içe aktarmak çalışmaya devam eder, ancak `react-native-intlayer` artık React Native için önerilen tek giriş noktasıdır — sağlayıcısı, web odaklı `react-intlayer` sağlayıcısının sahip olmadığı polyfill'leri içerir.
+
+---
+
 ## v8'den Geçiş Notları
 
 v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking changes) içermediğini unutmayın. Ancak işte temel değişiklikler:

package/docs/uk/compiler.md

@@ -81,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Додає плагін компілятора
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/uk/custom_domains.md

@@ -172,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/uk/custom_url_rewrites.md

@@ -342,10 +342,16 @@ export function middleware(request: NextRequest) {
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/uk/intlayer_with_analog.md

@@ -207,7 +207,11 @@ import analog from "@analogjs/platform";
 export default defineConfig(() => ({
   plugins: [
     analog(),
-    intlayer(), // Додайте плагін Intlayer
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 }));
 ```