@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/tr/packages/solid-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - solid-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programını ekle"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Tüm dışa aktarılanlar için birleştirilmiş dokümantasyon"
@@ -59,6 +62,7 @@ import "solid-intlayer";
 | `useDictionaryAsync`   | `useDictionary` ile aynı, ancak asenkron sözlükleri işler.                                                                                     | -                                                                                                                       |
 | `useDictionaryDynamic` | `useDictionary` ile aynı, ancak dinamik sözlükleri işler.                                                                                      | -                                                                                                                       |
 | `useLocale`            | Geçerli locale'i ve bunu ayarlamak için bir fonksiyon döndürür.                                                                                | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | Geçerli yol adını (pathname), locale segmenti kaldırılmış olarak bir `Accessor<string>` şeklinde döndürür. `popstate` olaylarına duyarlıdır.   | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | URL yeniden yazımlarını yönetmek için istemci tarafı hook'u. Lokalize edilmiş bir yeniden yazma kuralı varsa URL'yi otomatik olarak günceller. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | Geçerli locale için Intl nesnesini döndürür.                                                                                                   | -                                                                                                                       |
 | `useLoadDynamic`       | Dinamik sözlükleri yüklemek için hook.                                                                                                         | -                                                                                                                       |

package/docs/tr/packages/solid-intlayer/usePathname.md

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook Dokümantasyonu | solid-intlayer
+description: solid-intlayer paketindeki usePathname hook'unun nasıl kullanılacağını öğrenin
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programını ekle"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Geçmişi başlat"
+author: aymericzip
+---
+
+# Solid Entegrasyonu: `usePathname` Hook Dokümantasyonu
+
+`usePathname` hook'u, geçerli tarayıcı yol adını (pathname) locale segmenti çıkarılmış olarak bir Solid `Accessor<string>` biçiminde döndürür. Locale duyarlı navigasyon oluşturmak — örneğin hangi navigasyon öğesinin aktif olduğunu belirlemek — için locale ön ekini manuel olarak kaldırmanıza gerek kalmadan kullanışlıdır.
+
+## Solid'de `usePathname` İçe Aktarımı
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## Genel Bakış
+
+`usePathname`, `window.location.pathname`'den başlatılan reaktif bir sinyal (reactive signal) oluşturur, `getPathWithoutLocale` aracılığıyla locale ön ekini kaldırır ve tarayıcı ne zaman bir `popstate` olayı (geri/ileri navigasyon) tetiklerse sinyali günceller. Olay dinleyicisi (event listener) `onCleanup` aracılığıyla otomatik olarak temizlenir.
+
+## Kullanım
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Dönüş Değeri
+
+| Tür                | Açıklama                                                                                    |
+| ------------------ | ------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | Locale ön eki olmayan mevcut yol adını (pathname) döndüren Solid Accessor (reaktif getter). |
+
+## Davranış
+
+- **Locale çıkarma**: Baştaki locale segmentini kaldırır (örn. `/tr/dashboard` → `/dashboard`).
+- **Reaktif**: `popstate` olaylarında (tarayıcıda geri / ileri gitme) otomatik olarak güncellenir.
+- **SSR-güvenli**: `window` kullanılamadığında `""` döndürür.
+- **Temizleme (Cleanup)**: `popstate` dinleyicisi, Solid'in `onCleanup`'ı aracılığıyla otomatik olarak kaldırılır.
+
+## Örnek
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Panel" },
+  { href: "/settings", label: "Ayarlar" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## İlgili
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/solid-intlayer/useLocale.md) — mevcut locale + locale değiştirici
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) — bu hook tarafından kullanılan temel yardımcı program

package/docs/tr/packages/svelte-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programını ekle"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
@@ -64,15 +67,16 @@ import "svelte-intlayer";
 import "svelte-intlayer";
 ```
 
-| Fonksiyon              | Açıklama                                                                                                                                          | İlgili Doküman                                                                                                           |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `useIntlayer`          | `useDictionary` tabanlıdır, ancak üretilen deklarasyondan optimize edilmiş bir sözlük sürümünü enjekte eder.                                      | -                                                                                                                        |
-| `useDictionary`        | Anahtar, içerik (key, content) şeklinde görünen sözlük benzeri nesneleri işler. `t()` çevirilerini, enumerasyonları vb. işler.                    | -                                                                                                                        |
-| `useDictionaryAsync`   | `useDictionary` ile aynı, ancak asenkron (asynchronous) sözlükleri işler.                                                                         | -                                                                                                                        |
-| `useDictionaryDynamic` | `useDictionary` ile aynı, ancak dinamik sözlükleri işler.                                                                                         | -                                                                                                                        |
-| `useLocale`            | Mevcut locale'i (yerel ayarı) ve bunu ayarlamak için bir fonksiyon döndürür.                                                                      | -                                                                                                                        |
-| `useRewriteURL`        | URL yeniden yazımlarını yönetmek için istemci tarafı fonksiyon. Yerelleştirilmiş bir yeniden yazma kuralı varsa URL'yi otomatik olarak günceller. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/svelte-intlayer/useRewriteURL.md) |
-| `useIntl`              | Mevcut locale için Intl nesnesini döndürür.                                                                                                       | -                                                                                                                        |
+| Fonksiyon              | Açıklama                                                                                                                                           | İlgili Doküman                                                                                                           |
+| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `useIntlayer`          | `useDictionary` tabanlıdır, ancak üretilen deklarasyondan optimize edilmiş bir sözlük sürümünü enjekte eder.                                       | -                                                                                                                        |
+| `useDictionary`        | Anahtar, içerik (key, content) şeklinde görünen sözlük benzeri nesneleri işler. `t()` çevirilerini, enumerasyonları vb. işler.                     | -                                                                                                                        |
+| `useDictionaryAsync`   | `useDictionary` ile aynı, ancak asenkron (asynchronous) sözlükleri işler.                                                                          | -                                                                                                                        |
+| `useDictionaryDynamic` | `useDictionary` ile aynı, ancak dinamik sözlükleri işler.                                                                                          | -                                                                                                                        |
+| `useLocale`            | Mevcut locale'i (yerel ayarı) ve bunu ayarlamak için bir fonksiyon döndürür.                                                                       | -                                                                                                                        |
+| `usePathname`          | Geçerli yol adını (pathname), locale segmenti kaldırılmış olarak bir `Readable<string>` store şeklinde döndürür. `popstate` olaylarına duyarlıdır. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/svelte-intlayer/usePathname.md)     |
+| `useRewriteURL`        | URL yeniden yazımlarını yönetmek için istemci tarafı fonksiyon. Yerelleştirilmiş bir yeniden yazma kuralı varsa URL'yi otomatik olarak günceller.  | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/svelte-intlayer/useRewriteURL.md) |
+| `useIntl`              | Mevcut locale için Intl nesnesini döndürür.                                                                                                        | -                                                                                                                        |
 
 ### Markdown
 

package/docs/tr/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Fonksiyonu Dokümantasyonu | svelte-intlayer
+description: svelte-intlayer paketindeki usePathname fonksiyonunun nasıl kullanılacağını öğrenin
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Uluslararasılaştırma (Internationalization)
+  - Dokümantasyon
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programını ekle"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Geçmişi başlat"
+author: aymericzip
+---
+
+# Svelte Entegrasyonu: `usePathname` Dokümantasyonu
+
+`usePathname` fonksiyonu, locale segmenti kaldırılmış geçerli tarayıcı yol adını (pathname) bir Svelte `Readable<string>` store'u olarak döndürür. Locale önekini manuel olarak kaldırmanıza gerek kalmadan, locale farkındalığına sahip navigasyonlar oluşturmak (örneğin hangi navigasyon öğesinin aktif olduğunu belirlemek) için yararlıdır.
+
+## Svelte'de `usePathname` Kullanımı
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Genel Bakış
+
+`usePathname`, `window.location.pathname` üzerinden okuma yapan ve locale önekini `getPathWithoutLocale` aracılığıyla kaldıran bir Svelte okuma (readable) store'u oluşturur ve tarayıcı her `popstate` olayı tetiklediğinde (geri/ileri gezinme) yeni bir değer yayar. Bileşenlerde `$` store sözdizimi ile abone olunur.
+
+## Kullanım
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Döndürülen Değer
+
+| Tür                | Açıklama                                                                          |
+| ------------------ | --------------------------------------------------------------------------------- |
+| `Readable<string>` | Locale öneki olmadan geçerli yol adını (pathname) içeren Svelte readable store'u. |
+
+## Davranış
+
+- **Locale kaldırma**: Başta bulunan locale segmentini kaldırır (ör. `/tr/dashboard` → `/dashboard`).
+- **Reaktif**: Her `popstate` olayında (tarayıcıda geri / ileri navigasyonu) yeni bir değer yayar.
+- **SSR-güvenli**: `window` mevcut olmadığında `""` döndürür.
+- **Temizleme (Cleanup)**: Son abone abonelikten çıktığında `popstate` dinleyicisi otomatik olarak kaldırılır.
+
+## Örnek
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Gösterge Paneli" },
+    { href: "/settings", label: "Ayarlar" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## İlgili
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/svelte-intlayer/useLocale.md) — mevcut locale + locale değiştirici
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) — bu hook tarafından kullanılan temel yardımcı program

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` |