@intlayer/docs 5.8.1 → 6.0.0-canary.0

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

@@ -0,0 +1,165 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: getEnumeration Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketinde getEnumeration fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getEnumeration
+  - çeviri
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getEnumeration
+---
+
+# Dokümantasyon: `intlayer` Paketinde `getEnumeration` Fonksiyonu
+
+## Açıklama
+
+`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.
+
+## Parametreler
+
+- `enumerationContent: QuantityContent<Content>`
+  - **Açıklama**: Anahtarların koşullar (örneğin, `<=`, `<`, `>=`, `=`) temsil ettiği ve değerlerin karşılık gelen içeriği temsil ettiği bir nesne. Anahtarların sırası, eşleşme önceliklerini tanımlar.
+  - **Tür**: `QuantityContent<Content>`
+    - `Content` herhangi bir tür olabilir.
+
+- `quantity: number`
+  - **Açıklama**: `enumerationContent`'teki koşullara karşı eşleştirmek için kullanılan sayısal değer.
+  - **Tür**: `number`
+
+## Döndürür
+
+- **Tür**: `Content`
+- **Açıklama**: `enumerationContent`'teki ilk eşleşen koşula karşılık gelen içerik. Eşleşme bulunamazsa, varsayılan olarak uygulama tabanlı işleme yapılır (örneğin, hata veya yedek içerik).
+
+## Kullanım Örneği
+
+### Temel Kullanım
+
+```typescript codeFormat="typescript"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<=-2.3": "Şundan azınız var: -2.3",
+    "<1": "Şundan azınız var: bir",
+    "2": "İkiniz var",
+    ">=3": "Üç veya daha fazlasınız var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "İkiniz var"
+```
+
+```javascript codeFormat="esm"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<1": "Şundan azınız var: bir",
+    "2": "İkiniz var",
+    ">=3": "Üç veya daha fazlasınız var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "İkiniz var"
+```
+
+```javascript codeFormat="commonjs"
+const { getEnumeration } = require("intlayer");
+
+const content = getEnumeration(
+  {
+    "<1": "Şundan azınız var: bir",
+    "2": "İkiniz var",
+    ">=3": "Üç veya daha fazlasınız var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "İkiniz var"
+```
+
+### Koşulların Önceliği
+
+```typescript codeFormat="typescript"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<4": "Dörtten azınız var",
+    "2": "İkiniz var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "Dörtten azınız var"
+```
+
+```javascript codeFormat="esm"
+import { getEnumeration } from "intlayer";
+
+const content = getEnumeration(
+  {
+    "<4": "Dörtten azınız var",
+    "2": "İkiniz var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "Dörtten azınız var"
+```
+
+```javascript codeFormat="commonjs"
+const { getEnumeration } = require("intlayer");
+
+const content = getEnumeration(
+  {
+    "<4": "Dörtten azınız var",
+    "2": "İkiniz var",
+  },
+  2
+);
+
+console.log(content); // Çıktı: "Dörtten azınız var"
+```
+
+## Kenar Durumları
+
+- **Eşleşen Koşul Yok:**
+  - Sağlanan miktarla eşleşen koşul yoksa, fonksiyon `undefined` döndürür veya varsayılan/yedek senaryoyu açıkça işler.
+
+- **Belirsiz Koşullar:**
+  - Koşullar çakışırsa, ilk eşleşen koşul (nesne sırasına göre) öncelik kazanır.
+
+- **Geçersiz Anahtarlar:**
+  - Fonksiyon, `enumerationContent`'teki tüm anahtarların geçerli ve koşullar olarak ayrıştırılabilir olduğunu varsayar. Geçersiz veya yanlış biçimlendirilmiş anahtarlar beklenmedik davranışlara yol açabilir.
+
+- **TypeScript Zorlaması:**
+  - Fonksiyon, `Content` türünün tüm anahtarlar arasında tutarlı olmasını sağlar, böylece alınan içerikte tür güvenliği sağlar.
+
+## Notlar
+
+- Uygun koşulu verilen miktara göre belirlemek için `findMatchingCondition` yardımcı programı kullanılır.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```

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

@@ -0,0 +1,127 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: getHTMLTextDir Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketinde getHTMLTextDir fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getHTMLTextDir
+  - çeviri
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getHTMLTextDir
+---
+
+# Dokümantasyon: `intlayer` Paketinde `getHTMLTextDir` Fonksiyonu
+
+## Açıklama
+
+`getHTMLTextDir` fonksiyonu, sağlanan yerel ayara göre metin yönünü (`ltr`, `rtl` veya `auto`) belirler. Geliştiricilerin HTML'de `dir` özelliğini doğru metin işleme için ayarlamasına yardımcı olmak için tasarlanmıştır.
+
+## Parametreler
+
+- `locale?: Locales`
+  - **Açıklama**: Metin yönünü belirlemek için kullanılan yerel ayar dizesi (örneğin, `Locales.ENGLISH`, `Locales.ARABIC`).
+  - **Tür**: `Locales` (isteğe bağlı)
+
+## Döndürür
+
+- **Tür**: `Dir` (`'ltr' | 'rtl' | 'auto'`)
+- **Açıklama**: Yerel ayara karşılık gelen metin yönü:
+  - `'ltr'` soldan sağa diller için.
+  - `'rtl'` sağdan sola diller için.
+  - `'auto'` yerel ayar tanınmazsa.
+
+## Kullanım Örneği
+
+### Metin Yönünü Belirleme
+
+```typescript codeFormat="typescript"
+import { getHTMLTextDir } from "intlayer";
+
+getHTMLTextDir(Locales.ENGLISH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Çıktı: "rtl"
+```
+
+```javascript codeFormat="esm"
+import { getHTMLTextDir } from "intlayer";
+
+getHTMLTextDir(Locales.ENGLISH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Çıktı: "rtl"
+```
+
+```javascript codeFormat="commonjs"
+const { getHTMLTextDir } = require("intlayer");
+
+getHTMLTextDir(Locales.ENGLISH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.FRENCH); // Çıktı: "ltr"
+getHTMLTextDir(Locales.ARABIC); // Çıktı: "rtl"
+```
+
+## Kenar Durumları
+
+- **Yerel Ayar Sağlanmadı:**
+  - `locale` `undefined` olduğunda fonksiyon `'auto'` döndürür.
+
+- **Tanınmayan Yerel Ayar:**
+  - Tanınmayan yerel ayarlar için fonksiyon varsayılan olarak `'auto'` döndürür.
+
+## Bileşenlerde Kullanım:
+
+`getHTMLTextDir` fonksiyonu, yerel ayara göre HTML belgesinde `dir` özelliğini dinamik olarak ayarlamak için kullanılabilir.
+
+```tsx codeFormat="typescript"
+import type { FC } from "react";
+import { getHTMLTextDir, type Locales } from "intlayer";
+
+export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({
+  children,
+  locale,
+}) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+```jsx codeFormat="esm"
+import { getHTMLTextDir } from "intlayer";
+
+const HTMLLayout = ({ children, locale }) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+```jsx codeFormat="commonjs"
+const { getHTMLTextDir } = require("intlayer");
+
+const HTMLLayout = ({ children, locale }) => (
+  <html dir={getHTMLTextDir(locale)} locale={locale}>
+    <body>{children}</body>
+  </html>
+);
+```
+
+Yukarıdaki örnekte, `dir` özelliği yerel ayara göre dinamik olarak ayarlanır.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```

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

@@ -0,0 +1,87 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: getLocaleLang Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketinde getLocaleLang fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getLocaleLang
+  - çeviri
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getLocaleLang
+---
+
+# Dokümantasyon: `intlayer` Paketinde `getLocaleLang` Fonksiyonu
+
+## Açıklama
+
+`getLocaleLang` fonksiyonu, bir yerel ayar dizesinden dil kodunu çıkarır. Ülke kodları ile veya olmadan yerel ayarları destekler. Yerel ayar sağlanmazsa, varsayılan olarak boş bir dize döndürür.
+
+## Parametreler
+
+- `locale?: Locales`
+  - **Açıklama**: Dil kodunun çıkarıldığı yerel ayar dizesi (örneğin, `Locales.ENGLISH_UNITED_STATES`, `Locales.FRENCH_CANADA`).
+  - **Tür**: `Locales` (isteğe bağlı)
+
+## Döndürür
+
+- **Tür**: `string`
+- **Açıklama**: Yerel ayardan çıkarılan dil kodu. Yerel ayar sağlanmazsa, boş bir dize (`''`) döndürür.
+
+## Kullanım Örneği
+
+### Dil Kodlarını Çıkarma:
+
+```typescript codeFormat="typescript"
+import { getLocaleLang, Locales } from "intlayer";
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Çıktı: "en"
+getLocaleLang(Locales.ENGLISH); // Çıktı: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Çıktı: "fr"
+getLocaleLang(Locales.FRENCH); // Çıktı: "fr"
+```
+
+```javascript codeFormat="esm"
+import { getLocaleLang } from "intlayer";
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Çıktı: "en"
+getLocaleLang(Locales.ENGLISH); // Çıktı: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Çıktı: "fr"
+getLocaleLang(Locales.FRENCH); // Çıktı: "fr"
+```
+
+```javascript codeFormat="commonjs"
+const { getLocaleLang } = require("intlayer");
+
+getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Çıktı: "en"
+getLocaleLang(Locales.ENGLISH); // Çıktı: "en"
+getLocaleLang(Locales.FRENCH_CANADA); // Çıktı: "fr"
+getLocaleLang(Locales.FRENCH); // Çıktı: "fr"
+```
+
+## Kenar Durumları
+
+- **Yerel Ayar Sağlanmadı:**
+  - `locale` `undefined` olduğunda fonksiyon boş bir dize döndürür.
+
+- **Hatalı Biçimlendirilmiş Yerel Ayar Dizeleri:**
+  - `locale` `language-country` formatını takip etmezse (örneğin, `Locales.ENGLISH-US`), fonksiyon `'-'` öncesindeki kısmı güvenli bir şekilde döndürür veya `'-'` yoksa tüm dizeyi döndürür.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```

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

@@ -0,0 +1,124 @@
+---
+createdAt: 2025-09-07
+updatedAt: 2025-09-07
+title: getLocaleName Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketinde getLocaleName fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - getLocaleName
+  - çeviri
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getLocaleName
+---
+
+# Dokümantasyon: `intlayer` Paketinde `getLocaleName` Fonksiyonu
+
+## Açıklama
+
+`getLocaleName` fonksiyonu, verilen bir yerel ayar (`targetLocale`) adını görüntü yerel ayarında (`displayLocale`) döndürür. `targetLocale` sağlanmazsa, `displayLocale`'un kendi dilindeki adını döndürür.
+
+## Parametreler
+
+- `displayLocale: Locales`
+  - **Açıklama**: Hedef yerel ayar adının görüntüleneceği yerel ayar.
+  - **Tür**: Geçerli yerel ayarları temsil eden enum veya dize.
+
+- `targetLocale?: Locales`
+  - **Açıklama**: Adının yerelleştirileceği yerel ayar.
+  - **Tür**: İsteğe bağlı. Geçerli yerel ayarları temsil eden enum veya dize.
+
+## Döndürür
+
+- **Tür**: `string`
+- **Açıklama**: `targetLocale`'un `displayLocale`'daki yerelleştirilmiş adı veya `targetLocale` sağlanmazsa `displayLocale`'un kendi adı. Çeviri bulunamazsa, `"Unknown locale"` döndürür.
+
+## Kullanım Örneği
+
+```typescript codeFormat="typescript"
+import { Locales, getLocaleName } from "intlayer";
+
+getLocaleName(Locales.ENGLISH); // Çıktı: "English"
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Çıktı: "Anglais"
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Çıktı: "Inglés"
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Çıktı: "English"
+
+getLocaleName(Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Çıktı: "Francés"
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Çıktı: "French"
+
+getLocaleName(Locales.CHINESE); // Çıktı: "中文"
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Çıktı: "Chinois"
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Çıktı: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Çıktı: "Chinese"
+
+getLocaleName("unknown-locale"); // Çıktı: "Unknown locale"
+```
+
+```javascript codeFormat="esm"
+import { Locales, getLocaleName } from "intlayer";
+
+getLocaleName(Locales.ENGLISH); // Çıktı: "English"
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Çıktı: "Anglais"
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Çıktı: "Inglés"
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Çıktı: "English"
+
+getLocaleName(Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Çıktı: "Francés"
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Çıktı: "French"
+
+getLocaleName(Locales.CHINESE); // Çıktı: "中文"
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Çıktı: "Chinois"
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Çıktı: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Çıktı: "Chinese"
+
+getLocaleName("unknown-locale"); // Çıktı: "Unknown locale"
+```
+
+```javascript codeFormat="commonjs"
+const { Locales, getLocaleName } = require("intlayer");
+
+getLocaleName(Locales.ENGLISH); // Çıktı: "English"
+getLocaleName(Locales.ENGLISH, Locales.FRENCH); // Çıktı: "Anglais"
+getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // Çıktı: "Inglés"
+getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // Çıktı: "English"
+
+getLocaleName(Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.FRENCH); // Çıktı: "Français"
+getLocaleName(Locales.FRENCH, Locales.ESPANOL); // Çıktı: "Francés"
+getLocaleName(Locales.FRENCH, Locales.ENGLISH); // Çıktı: "French"
+
+getLocaleName(Locales.CHINESE); // Çıktı: "中文"
+getLocaleName(Locales.CHINESE, Locales.FRENCH); // Çıktı: "Chinois"
+getLocaleName(Locales.CHINESE, Locales.ESPANOL); // Çıktı: "Chino"
+getLocaleName(Locales.CHINESE, Locales.ENGLISH); // Çıktı: "Chinese"
+
+getLocaleName("unknown-locale"); // Çıktı: "Unknown locale"
+```
+
+## Kenar Durumları
+
+- **`targetLocale` sağlanmadı:**
+  - Fonksiyon varsayılan olarak `displayLocale`'un kendi adını döndürür.
+- **Eksik çeviriler:**
+  - `localeNameTranslations` `targetLocale` veya belirli `displayLocale` için bir giriş içermezse, fonksiyon `ownLocalesName`'e geri döner veya `"Unknown locale"` döndürür.
+
+## Dokümantasyon Geçmişi
+
+| Sürüm  | Tarih      | Değişiklikler     |
+| ------ | ---------- | ----------------- |
+| 5.5.10 | 2025-06-29 | Geçmiş başlatıldı |
+
+```
+
+```