@intlayer/docs 9.3.3 → 9.4.0

package/docs/tr/migration_from_i18next_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

package/docs/tr/migration_from_next-i18next_to_intlayer.md

@@ -48,7 +48,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

package/docs/tr/migration_from_next-intl_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

package/docs/tr/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

package/docs/tr/migration_from_react-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

package/docs/tr/migration_from_vue-i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer aynı zamanda i18n ekosisteminde **en aktif şekilde geliştirilen** ç
 
 <Accordion header="Yapay Zeka (AI) Ajanları">
 
-İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Ajan Yetenekleri (Agent Skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
+İçeriğin (kod ile) bir arada bulunması (colocation), Büyük Dil Modelleri (LLM'ler) için **gerekli bağlamı azaltır**. Intlayer ayrıca eksik çevirileri test etmek için bir **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/mcp_server.md)** ve yapay zeka ajanları için Geliştirici Deneyimini (DX) çok daha pürüzsüz hale getiren **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/agent_skills.md)** gibi bir dizi araç sunar.
 
 </Accordion>
 

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: elysia-intlayer Paket Dokümantasyonu
+description: Intlayer için Elysia eklentisi; çeviri fonksiyonları ve locale algılama sağlar.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Tüm dışa aktarımlar için birleştirilmiş dokümantasyon"
+author: aymericzip
+---
+
+# elysia-intlayer Paketi
+
+`elysia-intlayer` paketi, Elysia uygulamaları için uluslararasılaştırmayı (internationalization / i18n) yönetmek üzere bir plugin sağlar. Kullanıcının locale'ini algılar ve route context'ine bir `intlayer` nesnesi enjekte eder.
+
+## Kurulum
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` bir peer dependency'dir (`>=1.0.0`). Elysia **Bun** runtime'ını hedefler.
+
+## Dışa Aktarımlar
+
+### Eklenti
+
+İçe aktarma:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| Fonksiyon  | Açıklama                                                                                                                                                                                                                                                                                                               | İlgili Doküman                                                                                                 |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Intlayer'ı Elysia uygulamanıza entegre eden Elysia eklentisi. Locale algılamayı storage'dan (çerezler, başlıklar) ve ardından `Accept-Language`'den yönetir, route context'ine `locale`, `t`, `getIntlayer` ve `getDictionary` sunan bir `intlayer` nesnesi enjekte eder ve `AsyncLocalStorage` istek bağlamını kurar. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/elysia-intlayer/intlayer.md) |
+
+### Fonksiyonlar
+
+İçe aktarma:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| Fonksiyon       | Açıklama                                                                                                                                                                                                                                                    | İlgili Doküman                                                                                         |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Elysia'da mevcut locale için içeriği getiren global çeviri fonksiyonu. `intlayer` eklentisinin kurduğu istek bağlamına erişmek için `AsyncLocalStorage` kullanır ve bunun dışında varsayılan locale'e geri döner. `intlayer.t` üzerinden de erişilebilir.   | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dictionary/translation.md) |
+| `getIntlayer`   | Üretilen bildirimden anahtarına göre bir sözlük getirir ve içeriğini mevcut locale için döndürür. `getDictionary`'nin optimize edilmiş sürümü. İstek bağlamına erişmek için `AsyncLocalStorage` kullanır. `intlayer.getIntlayer` üzerinden de erişilebilir. | -                                                                                                      |
+| `getDictionary` | Sözlük nesnelerini işler ve mevcut locale için içeriği döndürür. `t()` çevirilerini, enumeration'ları, markdown'ı, HTML'i vb. işler. İstek bağlamına erişmek için `AsyncLocalStorage` kullanır. `intlayer.getDictionary` üzerinden de erişilebilir.         | -                                                                                                      |
+
+### Tipler
+
+İçe aktarma:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| Tip                 | Açıklama                                                                                                                                                                |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | Her route context'ine enjekte edilen `intlayer` nesnesinin yapısı: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | Bir locale map'ini mevcut istek locale'ine karşılık gelen içeriğe çeviren çeviri fonksiyonunun imzası.                                                                  |
+
+## Kullanım
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // Uluslararasılaştırma eklentisini yükle
+  .use(intlayer())
+  // Locale ve helper'ları route context'ten oku
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      tr: "Merhaba",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // Ya da mevcut isteğe bağlı standalone helper'ları kullan
+  .get("/t_example", () =>
+    t({
+      tr: "İngilizce'de döndürülen içerik örneği",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> 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!.locale`) veya optional chaining kullanın.
+
+## İlgili Dokümantasyon
+
+- [Elysia i18n - Uygulamanızı çevirmek için eksiksiz kılavuz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_with_elysia.md)
+- [Yapılandırma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)

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