@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/tr/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: intlayer Elysia Eklenti Dokümantasyonu | elysia-intlayer
+description: elysia-intlayer paketindeki intlayer eklentisinin nasıl kullanılacağını görün
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Dokümantasyonun başlatılması"
+author: aymericzip
+---
+
+# intlayer Elysia Eklenti Dokümantasyonu
+
+Elysia için `intlayer` eklentisi kullanıcının locale'ini tespit eder ve route context'ine bir `intlayer` nesnesi enjekte eder. Ayrıca, istek bağlamı içerisinde global çeviri fonksiyonlarının kullanılmasını sağlar.
+
+## Kullanım
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    tr: "Merhaba",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> Plugin, context'ini **global** bir `derive` üzerinden kaydeder ve Elysia bunu `Partial<{ intlayer: IntlayerContext }>` olarak tipler. `.use(intlayer())` sonrasında kaydedilen route'larda değer çalışma zamanında her zaman mevcuttur; bu yüzden `strict` modda TypeScript'i memnun etmek için non-null assertion (`intlayer!.t`) veya optional chaining kullanın.
+
+Aynı helper'lar bağımsız export'lar olarak da mevcuttur; böylece route context'ini destructure etmeden çağırabilirsiniz:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    tr: "Merhaba",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## Açıklama
+
+Eklenti aşağıdaki görevleri yerine getirir:
+
+1. **Locale Algılama**: İstemcinin açıkça belirlediği locale'i storage'dan (çerez, başlık) okur, ardından `Accept-Language` başlığından müzakere edilen locale'e geri döner.
+2. **Bağlama Enjeksiyon**: Elysia route context'ine bir `intlayer` özelliği ekler (aşağıdaki Route Context tablosuna bakın).
+3. **Bağlam Yönetimi**: Asenkron bir bağlamı yönetmek için `AsyncLocalStorage` kullanır; böylece global Intlayer fonksiyonları (`t`, `getIntlayer`, `getDictionary`) bağlam nesnesini taşımaya gerek kalmadan isteğe özel locale'e erişebilir.
+4. **Sözlük Hazırlığı**: Plugin oluşturulduğunda `prepareIntlayer` çağrılır, böylece sözlükler uygulama açılırken derlenir.
+
+### Route Context
+
+| Özellik           | Tip                    | Açıklama                                                                                    |
+| ----------------- | ---------------------- | ------------------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | Bu istek için kullanılacak locale; `locale_storage`, `locale_detected`'a göre önceliklidir. |
+| `locale_storage`  | `Locale` (opsiyonel)   | İstemcinin bir çerez veya başlık aracılığıyla açıkça talep ettiği locale.                   |
+| `locale_detected` | `Locale`               | İstek başlıklarından müzakere edilen locale.                                                |
+| `defaultLocale`   | `Locale`               | `intlayer.config.ts` içinde fallback olarak yapılandırılan locale.                          |
+| `t`               | `TranslateFunction`    | Bir çeviri fonksiyonu.                                                                      |
+| `getIntlayer`     | `typeof getIntlayer`   | Sözlükleri anahtarına göre almak için bir fonksiyon.                                        |
+| `getDictionary`   | `typeof getDictionary` | Sözlük nesnelerini işlemek için bir fonksiyon.                                              |
+
+> Node tabanlı Intlayer eklentilerinin aksine, `elysia-intlayer` `cls-hooked` yerine `AsyncLocalStorage`'a dayanır; çünkü `cls-hooked`, Bun'un uygulamadığı `async_hooks.createHook`'a bağımlıdır.
+
+İstek bağlamı, yanıt map'lendiği anda serbest bırakılır; böylece bağımsız helper'lar hiçbir zaman sonlanmış bir isteğe karşı çözümlenmez. Eklentinin işlediği bir isteğin dışında çağrıldıklarında, yapılandırılmış varsayılan locale'e geri dönerler.
+
+## Locale Çözümleme Sırası
+
+Varsayılan olarak plugin, locale'i şu sırayla çözer:
+
+1. `INTLAYER_LOCALE` çerezi.
+2. `x-intlayer-locale` header'ı.
+3. `Accept-Language` header müzakeresi.
+4. Yapılandırılan `defaultLocale`.
+
+```bash
+# `Accept-Language` üzerinden müzakere edildi
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# Çerez `Accept-Language`'e göre önceliklidir
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# Header `Accept-Language`'e göre önceliklidir
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## Yapılandırma
+
+Eklenti `intlayer.config.ts` dosyanızı okur. Locale algılama için kullanılan çerezi ve başlığı özelleştirebilirsiniz:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> Yapılandırma hakkında daha fazla bilgi için [yapılandırma dokümantasyonunu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) ziyaret edin.
+
+## İlgili Dokümantasyon
+
+- [elysia-intlayer Paket Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - Uygulamanızı çevirmek için eksiksiz kılavuz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_with_elysia.md)

package/docs/tr/packages/intlayer/getDictionary.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionary Function Documentation | intlayer
+description: intlayer paketi için getDictionary fonksiyonunun nasıl kullanılacağını öğrenin
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: `getDictionary` Function in `intlayer`
+
+## Açıklama
+
+`getDictionary` fonksiyonu, **kendiniz geçtiğiniz bir sözlük nesnesini** yorumlar ve belirli bir locale için çözülmüş içeriğini döndürür. İçeriği tek bir geçişte yürür ve her bir yorumlayıcı eklentisini gerektiği şekilde uygulayarak `t()` çevirileri, numaralandırmaları, koşulları, eklemeleri, iç içe geçişi, markdown'ı, HTML'yi ve dosya düğümlerini çözer.
+
+Oluşturulan kayıt defterinde bir sözlüğü anahtara göre arayan [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayer.md)'dan farklı olarak, `getDictionary` sözlüğün kendisini alır. Bu, çalışma zamanında oluşturulan, bir API veya CMS'den getirilen ya da bir teste satır içinde bildirilen içerik için doğru araç haline getirir.
+
+**Temel Özellikler:**
+
+- Sözlük yapısını izleyen herhangi bir nesneyle çalışır (`{ key, content }`)
+- Nitelikli bir sözlük grubu (koleksiyonlar, varyantlar) ile birlikte bir seçiciyi kabul eder
+- Tam olarak tipli: döndürülen nesne, geçtiğiniz `content`'i yansıtır
+- Özel yorumlayıcı eklentilerini kabul eder
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // Gerekli
+  localeOrSelector?: LocalesValues | DictionarySelector, // İsteğe Bağlı
+  plugins?: Plugins[]                                // İsteğe Bağlı
+): DeepTransformContent<...>
+```
+
+---
+
+## Parametreler
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **Açıklama**: Yorumlanacak sözlük (veya nitelikli sözlük grubu).
+  - **Tür**: `Dictionary | QualifiedDictionaryGroup`
+  - **Gerekli**: Evet
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Açıklama**: İçeriği yorumlamak için kullanılacak yerel ayar veya bir seçici nesnesi (`{ item }`, `{ variant }`, isteğe bağlı olarak `locale`). Bkz. [dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md).
+  - **Tür**: `LocalesValues | DictionarySelector`
+  - **Gerekli**: Hayır (İsteğe bağlı) — yapılandırılmış `defaultLocale` ayarına varsayılan olarak atar.
+
+- `plugins: Plugins[]`
+  - **Açıklama**: Tanınan düğümlerin nasıl yorumlandığını tanımlayan bir dizi düğüm dönüştürücüsü. Atlanırsa, varsayılan yorumlayıcı eklentileri seti kullanılır.
+  - **Tür**: `Plugins[]`
+  - **Gerekli**: Hayır (İsteğe bağlı)
+
+### Dönüşler
+
+- **Tür**: Sözlüğün yorumlanan içeriği.
+- **Açıklama**: Geçirdiğiniz `content`, istenen yerel ayar için çözümlenen her Intlayer düğümü ile. `item` seçici olmayan bir koleksiyon grubu için, yorumlanan girdilerin sıralı bir dizisi döndürülür; seçici hiçbir şeyi hedeflediğinde `null` döndürülür.
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        tr: "Merhaba",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "tr"
+);
+
+console.log(content.greeting); // "Merhaba"
+```
+
+### Çalışma zamanında getirilen içeriği yorumlama
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### Bir seçici ile
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// Nitelikli bir sözlük grubu tek bir girişe çözülür…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …veya `item` verilmediğinde sıralı bir diziye çözülür
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayer.md): Aynı yorum, ancak sözlük oluşturulan kayıt defterinde anahtar tarafından aranır.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionaryAsync.md): Her locale yükleyici haritaları için karşılık gelen fonksiyon.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/react-intlayer/useDictionary.md): React hook eşdeğeri, sağlayıcıdan locale'i okur.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/tr/packages/intlayer/getDictionaryAsync.md

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionaryAsync Function Documentation | intlayer
+description: getDictionaryAsync fonksiyonunun intlayer paketi için nasıl kullanılacağını görün
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: `getDictionaryAsync` Function in `intlayer`
+
+## Açıklama
+
+`getDictionaryAsync` işlevi, bir sözlüğün **tek bir yerel ayar parçasını** yükler ve yorumlanmış içeriğini döndürür.
+
+`.intlayer/dynamic_dictionaries/` içinde yayınlanan yerel ayara özgü loader haritaları için [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionary.md) işlevinin karşılığıdır: her yerel ayarı içeren bir sözlük almak yerine, loader haritasını alır ve istenen yerel ayarın ihtiyaç duyduğu parçayı bekler.
+
+> Uygulama kodunda normalde bu işlevi değil, [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md) işlevini çağırırsınız. [Build eklentileri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/bundle_optimization.md), her `getIntlayerAsync('key', locale)` çağrısını `getDictionaryAsync(loaderMap, 'key', locale)` çağrısına dönüştürür. `getDictionaryAsync` özel loaderlar ve kendi loader haritalarını oluşturan tooling için dışa aktarılır.
+
+**Temel Özellikler:**
+
+- Yalnızca istenen yerel ayar parçasını yükler
+- Düz (`locale → loader`) ve nitelikli (`locale → qualifierId → loader`) loader haritalarını destekler
+- Aynı parçanın eşzamanlı yüklemelerini çoğaltmadan çıkarır ve çözülen içeriği önbelleğe alır
+- Başarısız yüklemeler önbellekten çıkarılır, böylece daha sonraki bir çağrı parçayı yeniden dener
+
+---
+
+## İşlev İmzası
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // Gerekli
+  key: string,                                           // Gerekli
+  localeOrSelector?: LocalesValues | DictionarySelector, // İsteğe bağlı
+  plugins?: Plugins[]                                    // İsteğe bağlı
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## Parametreler
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **Description**: Locale başına loader haritası. Basit haritalar bir locale'i bir loader ile ilişkilendirirken; nitelikli haritalar (koleksiyonlar ve varyantlar tarafından kullanılır) bir locale'i bir niteleyici id ile, ardından bir loader ile ilişkilendirir. Nitelikli bir harita için, yalnızca seçicinin hedeflediği chunk(lar) yüklenir.
+  - **Type**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **Required**: Yes
+
+- `key: string`
+  - **Description**: Sözlük anahtarı, chunk önbelleğini namespace'lemek için kullanılır.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: İçeriği yorumlamak için kullanılacak locale, veya bir seçici nesnesi (`{ item }`, `{ variant }`, isteğe bağlı olarak `locale` ile). Bkz. [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md).
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — yapılandırılan `defaultLocale` değerine varsayılan olarak ayarlanır.
+
+- `plugins: Plugins[]`
+  - **Description**: Node transformers. Temel interpreter setine varsayılan olarak ayarlanır.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Döndürülen Değerler
+
+- **Type**: `Promise<Content>` — yüklenen chunk'ın yorumlanmış içeriğine çözümlenen bir promise.
+- **Description**: İstenen locale için ne harita ne de herhangi bir fallback'i çıkardığında `null` değerine çözümlenir, eksik nitelendirilmiş koordinatın nasıl çözümlendiğini yansıtır.
+
+---
+
+## Örnek Kullanım
+
+### Oluşturulan bir yükleyici haritası ile
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### Özel bir loader haritası ile
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### Nitelikli harita üzerinde bir seçici ile
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## Davranış Notları
+
+### Önbelleğe alma ve yinelenenleri kaldırma
+
+Önbellek, her `key + locale + selector` üçlüsünün **promise**'ini depolar, bu nedenle aynı chunk için eşzamanlı çağrılar tek bir yüklemesi bekler. Reddedilen bir yükleme önbellekten kaldırılır, bu nedenle başarısız bir chunk, aynı hatayı sonsuza dek tekrarlamak yerine sonraki çağrıda yeniden denenir.
+
+### Locale fallback
+
+Düz bir loader haritası, senkron mod ile aynı fallback zinciri boyunca yürütülür: istenen locale ilk olarak, sonra fallback'leri, sonra hiçbiri chunk yayınlamadıysa `null`.
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md): Uygulamaların çağırdığı fonksiyon; build eklentileri bunu `getDictionaryAsync` olarak yeniden yazar.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionary.md): Tam bir sözlük alan senkron karşılığı.
+- [Dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md): Koleksiyonlar ve varyantlar, ve oluşturdukları loader haritaları.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/tr/packages/intlayer/getEnumeration.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getEnumeration` fonksiyonu, bir numaralandırma nesnesindeki önceden tanımlanmış koşullara göre belirli bir miktara karşılık gelen içeriği alır. Koşullar anahtarlar olarak tanımlanır ve öncelik, nesnedeki sıralarına göre belirlenir.
 
+Enumerations bildirimi hakkında daha fazla bilgi için [Enumeration documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/enumeration.md) bölümüne bakınız.
+
 ## Parametreler
 
 - `enumerationContent: QuantityContent<Content>`

package/docs/tr/packages/intlayer/getIntlayer.md

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayer Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketi için getIntlayer fonksiyonunun nasıl kullanılacağını öğrenin
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Belgelendirme: `intlayer`'de `getIntlayer` Fonksiyonu
+
+## Açıklama
+
+`getIntlayer` işlevi bir anahtar (key) ile bir sözlüğü seçer ve içeriğini belirli bir yerel ayar için yorumlanmış şekilde döndürür. `useIntlayer` hook'unun framework-agnostik karşılığıdır: aynı içerik, aynı seçiciler, ancak React context'in kullanılamadığı her yerde kullanılabilir — Node scriptleri, server işlevleri, route loaders, metadata builders, Express/Fastify handlers, testler.
+
+Intlayer tarafından `.intlayer/` içinde oluşturulan sözlükleri okur, bu nedenle `key` argümanı sizin kendi içerik bildirimlerinizden türü belirlenmiş ve otomatik tamamlanmıştır, ve döndürülen nesne her yaprakta tam olarak türü belirlenmiştir.
+
+**Ana Özellikler:**
+
+- Türü belirlenmiş sözlük anahtarları ve türü belirlenmiş döndürülen içerik
+- Her içerik düğümünü yorumlar (`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- Yerel ayarı veya seçici nesnesini kabul eder (koleksiyonlar, varyantlar)
+- Sonuçlar `key + locale + selector` başına bellekte tutulur
+- Geliştirme sırasında sözlük eksik olduğunda, kilitlenmek yerine güvenli bir proxy'ye geri döner
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // Gerekli
+  localeOrSelector?: LocalesValues | DictionarySelector, // İsteğe bağlı
+  plugins?: Plugins[]                         // İsteğe bağlı
+): DeepTransformContent<...>
+```
+
+---
+
+## Parametreler
+
+- `key: DictionaryKeys`
+  - **Açıklama**: İçerik dosyalarınızda bildirilen sözlüğün anahtarı.
+  - **Tür**: `DictionaryKeys` — bildirilen her sözlük anahtarının birleşimi.
+  - **Gerekli**: Evet
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Açıklama**: İçeriği yorumlamak için kullanılacak yerel ayar veya [dinamik sözlükler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md) için bir seçici nesnesi.
+    - `'fr'` — bir yerel ayar
+    - `{ item: 2 }` — bir [koleksiyon](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/collections.md) öğesi (`item` öğesini atlayarak tüm öğeleri dizi olarak alabilirsiniz)
+    - `{ variant: 'black-friday' }` — adlandırılmış bir [varyant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md) (varsayılan olanı almak için atlayın)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — yapılandırılmış bir varyant
+    - Herhangi bir seçici yerel ayar taşıyabilir: `{ item: 2, locale: 'fr' }`
+  - **Tür**: `LocalesValues | DictionarySelector`
+  - **Gerekli**: Hayır (İsteğe bağlı) — yapılandırılan `defaultLocale` değerini kullanır.
+
+- `plugins: Plugins[]`
+  - **Açıklama**: Temel yorumlayıcı eklentilerinin yerini alan özel düğüm dönüştürücüleri. Yalnızca ileri kullanım için; varsayılan davranışı korumak için atlayın.
+  - **Tür**: `Plugins[]`
+  - **Gerekli**: Hayır (İsteğe bağlı)
+
+### Döndürülen Değerler
+
+- **Type**: Sözlüğünüzün deklarasyonundan yazılan, yorumlanan içerik.
+- **Description**: Sözlüğünüzün `content` alanını yansıtan düz bir nesne; burada her Intlayer düğümü, istenen locale için nihai değerine çözülmüştür.
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      tr: "Merhaba",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### Locale olmadan
+
+Locale'i atlarsanız, içerik [yapılandırmanızda](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md) belirtilen `defaultLocale` ile yorumlanır.
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // Varsayılan locale ile yorumlanır
+```
+
+### Bir sunucu işleyicisinin içinde
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### Seçici ile (collections ve variants)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// Bir collection öğesi
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// Collection'ın tüm öğeleri, sıralı bir dizi olarak
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// Adlandırılmış bir variant
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## Davranış Notları
+
+### Önbellekleme
+
+Sonuçlar, `key + locale + selector` ile anahtarlanan bir modül seviyesi önbelleğinde memoize edilir. `getIntlayer("app", "fr")` işlemini tekrar tekrar çağırmak sözlüğü bir kez yorumlar ve daha sonra aynı nesneyi döndürür.
+
+### Eksik sözlükler
+
+Geliştirme sırasında, oluşturulmuş bir sözlüğü olmayan bir anahtarı istediğinizde, bir uyarı bir kez kaydedilir ve güvenli bir fallback proxy döndürülür: `content.title` öğesini okuduğunuzda hata atmak yerine `"app.title"` dizesini verir. Bu, eksik bildirim düzeltilirken bir sayfanın kullanılabilir kalmasını sağlar. Sözlüğün oluşturulması için Intlayer build'ini (veya geliştirme sunucusunu) çalıştırın.
+
+### Bundle boyutu
+
+`getIntlayer` birleştirilmiş sözlüğü okur; bu sözlük **her** locale'i içerir. İstemci bundle'larında, [build eklentileri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/bundle_optimization.md) çağrıyı yeniden yazarak yalnızca gerekli içeriğin gönderilmesini sağlar. Rendering dışında içerik okuyorsanız (metadata, loaders, server functions) ve talep üzerine tek bir locale yüklenmesini istiyorsanız, bunun yerine [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md) kullanın.
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getIntlayerAsync.md): Tek bir locale chunk yükleyen async eşdeğeri.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getDictionary.md): Anahtarla arama yapılan bir sözlük yerine, kendiniz geçtiğiniz bir sözlük nesnesini yorumlar.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/react-intlayer/useIntlayer.md): React hook eşdeğeri, provider'dan locale'i okur.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```