@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

package/docs/tr/migration_from_vue-i18n_to_intlayer.md

@@ -100,24 +100,40 @@ Aşağıdaki adımlar, mevcut `vue-i18n` uygulamanızı hiçbir bileşen kodunu
 
 Temel Intlayer paketlerini ve uyumluluk adaptörünü kurun:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.
+
+> Bu komut ortamınızı algılayacak ve gerekli paketleri yükleyecektir. Örneğin:
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > `vue-i18n`'i güvenle yüklü bırakabilirsiniz; uyumluluk adaptörü onu TypeScript türleri için `devDependency` / `peerDependency` olarak kullanır.

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

@@ -14,6 +14,9 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programı eklendi"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Tüm dışa aktarımlar için birleştirilmiş belgeler"
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### Hook'lar
 
-| Hook                   | Açıklama                                                                                                      | İlgili Doküman |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------- | -------------- |
-| `useIntlayer`          | `useDictionary`'e dayanır, ancak oluşturulan bildirimden sözlüğün optimize edilmiş bir sürümünü enjekte eder. | -              |
-| `useDictionary`        | Sözlük gibi görünen (key, content) nesneleri işler. `t()` çevirilerini, enumerations vb. işler.               | -              |
-| `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.                                               | -              |
-| `useIntl`              | Geçerli locale için Intl nesnesini döndürür.                                                                  | -              |
-| `useLoadDynamic`       | Dinamik sözlükleri yüklemek için hook.                                                                        | -              |
+| Hook                   | Açıklama                                                                                                                                            | İlgili Doküman                                                                                                        |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | `useDictionary`'e dayanır, ancak oluşturulan bildirimden sözlüğün optimize edilmiş bir sürümünü enjekte eder.                                       | -                                                                                                                     |
+| `useDictionary`        | Sözlük gibi görünen (key, content) nesneleri işler. `t()` çevirilerini, enumerations vb. işler.                                                     | -                                                                                                                     |
+| `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.                                                                                     | -                                                                                                                     |
+| `usePathname`          | Geçerli yol adını yerel ayar segmenti kaldırılmış olarak bir `Signal<string>` şeklinde döndürür. `DestroyRef` aracılığıyla `popstate`'e duyarlıdır. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | Geçerli locale için Intl nesnesini döndürür.                                                                                                        | -                                                                                                                     |
+| `useLoadDynamic`       | Dinamik sözlükleri yüklemek için hook.                                                                                                              | -                                                                                                                     |
 
 ### Bileşenler
 

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook Belgeleri | angular-intlayer
+description: angular-intlayer paketinde usePathname hook'unun nasıl kullanılacağını öğrenin
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname yardımcı programı eklendi"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Geçmişi başlat"
+author: aymericzip
+---
+
+# Angular Entegrasyonu: `usePathname` Hook Belgeleri
+
+`usePathname` hook'u, yerel ayar segmenti kaldırılmış geçerli tarayıcı yol adını bir Angular `Signal<string>` olarak döndürür. Bu, yerel ayar ön ekini manuel olarak kaldırmak zorunda kalmadan yerel ayara duyarlı gezinme oluşturmak (örneğin hangi gezinme öğesinin etkin olduğunu belirlemek) için yararlıdır.
+
+## Angular'da `usePathname` İçe Aktarımı
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## Genel Bakış
+
+`usePathname` `window.location.pathname` değerini okur, `getPathWithoutLocale` aracılığıyla yerel ayar ön ekini kaldırır ve tarayıcı her `popstate` olayı (geri/ileri gezinme) tetiklediğinde sinyali günceller. Bileşen yok edildiğinde olay dinleyicisini otomatik olarak temizlemek için Angular'ın `DestroyRef` sınıfını kullanır.
+
+## Kullanım
+
+```typescript fileName="src/app/nav-item.component.ts"
+import { Component, input } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-nav-item",
+  template: `
+    <a
+      [href]="href()"
+      [attr.aria-current]="pathname() === href() ? 'page' : null"
+    >
+      {{ label() }}
+    </a>
+  `,
+})
+export class NavItemComponent {
+  readonly href = input.required<string>();
+  readonly label = input.required<string>();
+
+  readonly pathname = usePathname();
+}
+```
+
+## Dönüş Değeri
+
+| Tür              | Açıklama                                                            |
+| ---------------- | ------------------------------------------------------------------- |
+| `Signal<string>` | Yerel ayar ön eki olmayan geçerli yol adını içeren Angular sinyali. |
+
+## Davranış
+
+- **Yerel ayar kaldırma**: Öndeki yerel ayar segmentini kaldırır (örn. `/tr/dashboard` → `/dashboard`).
+- **Reaktif**: `popstate` olaylarında (tarayıcı geri / ileri gezinme) otomatik olarak güncellenir.
+- **SSR güvenli**: `window` mevcut olmadığında `""` döndürür.
+- **Temizlik**: Barındıran bileşen yok edildiğinde `DestroyRef.onDestroy` aracılığıyla `popstate` dinleyicisi kaldırılır.
+
+## Örnek
+
+```typescript fileName="src/app/sidebar.component.ts"
+import { Component } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-sidebar",
+  template: `
+    <nav>
+      @for (link of links; track link.href) {
+        <a
+          [href]="link.href"
+          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"
+        >
+          {{ link.label }}
+        </a>
+      }
+    </nav>
+  `,
+})
+export class SidebarComponent {
+  readonly links = [
+    { href: "/dashboard", label: "Kontrol Paneli" },
+    { href: "/settings", label: "Ayarlar" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## İlgili
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/angular-intlayer/exports.md) — mevcut yerel ayar + yerel ayar 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/intlayer/comparePaths.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: comparePaths Fonksiyonu Dokümantasyonu | intlayer
+description: intlayer paketi için comparePaths fonksiyonunun nasıl kullanılacağını görün
+keywords:
+  - comparePaths
+  - normalizePath
+  - aktif bağlantı
+  - navigasyon
+  - Intlayer
+  - intlayer
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "İlk dokümantasyon"
+author: aymericzip
+---
+
+# Dokümantasyon: `intlayer` İçinde `comparePaths` Fonksiyonu
+
+## Açıklama
+
+`comparePaths` fonksiyonu, locale (dil) segmentini, protokolü/sunucuyu, sorgu dizesini, karma değerini (hash) ve sondaki eğik çizgileri göz ardı ederek iki URL'nin veya yolun eşitliğini karşılaştırır. Bir gezinme bağlantısının mevcut sayfayı işaret edip etmediğini belirlemenin —örneğin aktif bağlantıyı vurgulamak için— kendi (hataya açık) normalleştirme mantığınızı yazmanıza gerek kalmadan önerilen yoludur.
+
+İçeride locale segmentini kaldırmak için [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md)'i yeniden kullanır, böylece yapılandırılmış yönlendirme modunuza ve dillerinize saygı duyar.
+
+Paket ayrıca, karşılaştırma için kullanılan standartlaştırılmış, dilden bağımsız yolu döndüren temel [`normalizePath`](#normalizepath) yardımcısını da dışa aktarır.
+
+**Anahtar Özellikler:**
+
+- Dilden bağımsız karşılaştırma (`/tr/about`, `/about` ile eşleşir)
+- Hem mutlak URL'lerle hem de göreceli yollarla çalışır
+- Sorgu dizesini, karmayı ve sondaki eğik çizgileri yoksayar
+- Eksik baştaki eğik çizgileri ve boş değerleri tolere eder (`/` olarak normalleştirilir)
+- Hafif — `getPathWithoutLocale` üzerine inşa edilmiştir
+
+---
+
+## Fonksiyon İmzası
+
+```typescript
+comparePaths(
+  pathname: string,  // Gerekli
+  href: string,      // Gerekli
+  locales?: Locales[] // İsteğe Bağlı
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Gerekli
+  locales?: Locales[] // İsteğe Bağlı
+): string
+```
+
+---
+
+## Parametreler
+
+- `pathname: string`
+  - **Açıklama**: Karşılaştırılacak ilk URL dizesi veya yolu (genellikle mevcut yol).
+  - **Tip**: `string`
+  - **Gerekli**: Evet
+
+- `href: string`
+  - **Açıklama**: Karşılaştırılacak ikinci URL dizesi veya yolu (genellikle bir gezinme bağlantısının `href`'i).
+  - **Tip**: `string`
+  - **Gerekli**: Evet
+
+- `locales: Locales[]`
+  - **Açıklama**: Desteklenen dillerin isteğe bağlı dizisi. Varsayılan olarak projede yapılandırılan dillere eşittir.
+  - **Tip**: `Locales[]`
+  - **Gerekli**: Hayır (İsteğe Bağlı)
+
+### Döndürür
+
+- **Tip**: `boolean`
+- **Açıklama**: Her iki giriş de aynı dilden bağımsız yola çözümlenirse `true`, aksi takdirde `false` döner.
+
+---
+
+## Örnek Kullanım
+
+### Temel Kullanım
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### Mutlak ve Göreceli URL'ler
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Aktif gezinme bağlantısını vurgulama
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath`, `comparePaths` tarafından kullanılan standartlaştırılmış, dilden bağımsız yolu döndürür. Locale segmentini, protokolü/sunucuyu, sorgu dizesini ve karmayı kaldırır, tek bir baştaki eğik çizgi sağlar, herhangi bir sondaki eğik çizgiyi kaldırır (kök dizin hariç) ve boş değerler için `/`'a geri döner.
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## İlgili Fonksiyonlar
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md): Bir URL'den veya yoldan locale segmentini kaldırır.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPrefix.md): Verilen bir locale için URL önekini belirler.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md): Belirli bir locale için yerelleştirilmiş bir URL oluşturur.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "comparePaths yardımcı programı eklendi"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Tüm dışa aktarımlar için birleştirilmiş dokümantasyon"
@@ -108,19 +111,21 @@ import "intlayer";
 import "intlayer";
 ```
 
-| Fonksiyon              | Tür         | Açıklama                                           | İlgili Doküman                                                                                                                  |
-| ---------------------- | ----------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Fonksiyon` | Bir dizeden veya yoldan locale'i algılar.          | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function`  | Bir locale'in dil kısmını alır.                    | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function`  | Bir locale'in görüntü adını alır.                  | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function`  | Kanonik bir yolu yerelleştirilmiş bir yola çözer.  | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function`  | Yerelleştirilmiş bir yolu kanonik hale çözer.      | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function`  | Yerelleştirilmiş bir URL oluşturur.                | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function`  | Desteklenen tüm locale'lar için URL'ler oluşturur. | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function`  | Yoldan locale önekini kaldırır.                    | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function`  | Yoldan locale önekini alır.                        | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function`  | Metin yönünü (LTR/RTL) döndürür.                   | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function`  | Yerel önekini doğrular.                            | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/validatePrefix.md)             |
+| Fonksiyon              | Tür         | Açıklama                                              | İlgili Doküman                                                                                                                  |
+| ---------------------- | ----------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Fonksiyon` | Bir dizeden veya yoldan locale'i algılar.             | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function`  | Bir locale'in dil kısmını alır.                       | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function`  | Bir locale'in görüntü adını alır.                     | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function`  | Kanonik bir yolu yerelleştirilmiş bir yola çözer.     | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function`  | Yerelleştirilmiş bir yolu kanonik hale çözer.         | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function`  | Yerelleştirilmiş bir URL oluşturur.                   | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function`  | Desteklenen tüm locale'lar için URL'ler oluşturur.    | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function`  | Yoldan locale önekini kaldırır.                       | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function`  | Yoldan locale önekini alır.                           | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function`  | Locale'i göz ardı ederek iki yolu karşılaştırır.      | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function`  | Bir yolu locale'den bağımsız bir yola normalleştirir. | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function`  | Metin yönünü (LTR/RTL) döndürür.                      | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function`  | Yerel önekini doğrular.                               | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/validatePrefix.md)             |
 
 ### Tarayıcı Yardımcıları
 

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

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Açıklama
 
+`getMultilingualUrls` fonksiyonu, verilen URL'yi desteklenen her yerel dilde bir önek ekleyerek çok dilli URL'lerin bir haritasını oluşturur. Hem mutlak hem de göreceli URL'leri işleyebilir ve sağlanan yapılandırmaya veya varsayılanlara göre uygun yerel dil önekini uygular.
+
+**Temel Özellikler:**
+
+- Yalnızca 1 parametre gereklidir: `url`
+- `locales`, `defaultLocale` ve `mode` ile isteğe bağlı `options` nesnesi
+- Varsayılan olarak projenizin uluslararasılaştırma yapılandırmasını kullanır
+- Birden fazla yönlendirme modunu destekler: `prefix-no-default`, `prefix-all`, `no-prefix` ve `search-params`
+- Tüm yerel dilleri anahtar olarak ve karşılık gelen URL'leri değer olarak içeren bir harita nesnesi döndürür
+
+---
+
+## Açıklama
+
 `getMultilingualUrls` fonksiyonu, verilen URL'yi her desteklenen yerel ayar ile öneklendirerek çok dilli URL'lerin bir eşlemesini oluşturur. Hem mutlak hem de göreli URL'leri işleyebilir ve sağlanan yapılandırma veya varsayılanlara göre uygun yerel ayar önekini uygular.
 
 ---
 
 ## Parametreler
 
+## Parametreler
+
 - `url: string`
   - **Açıklama**: Yerel ayarlarla öneklendirilecek orijinal URL dizesi.
   - **Tür**: `string`
@@ -54,6 +70,33 @@ author: aymericzip
   - **Tür**: `boolean`
   - **Varsayılan**: `prefixDefaultDefault`
 
+### İsteğe Bağlı Parametreler
+
+- `options?: object`
+  - **Description**: URL yerelleştirme davranışı için yapılandırma nesnesi.
+  - **Type**: `object`
+  - **Required**: No (İsteğe Bağlı)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Desteklenen locale'lerin dizisi. Sağlanmazsa, proje yapılandırmanızdan yapılandırılmış locale'leri kullanır.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: Uygulama için varsayılan locale. Sağlanmazsa, proje yapılandırmanızdan yapılandırılmış varsayılan locale'yi kullanır.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Locale işleme için URL yönlendirme modu. Sağlanmazsa, proje yapılandırmanızdan yapılandırılmış modu kullanır.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Varsayılan locale için ön ek yok, diğerleri için ön ek
+      - `prefix-all`: Varsayılan dahil tüm locale'ler için ön ek
+      - `no-prefix`: URL'de locale ön eki yok
+      - `search-params`: Locale için sorgu parametreleri kullan (örn. `?locale=fr`)
+
 ### Döndürür
 
 - **Tür**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ author: aymericzip
 
 ## Kullanım Örneği
 
+### Temel Kullanım (Proje Yapılandırmasını Kullanır)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Projenizin locales, defaultLocale ve mode yapılandırmasını kullanır
+getMultilingualUrls("/dashboard");
+// Çıktı (proje yapılandırması en, fr'ye sahip olduğunu ve mode 'prefix-no-default' olduğunu varsayıyorsa):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### Göreli URL'ler
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### Farklı Yönlendirme Modları
+
+```typescript
+// prefix-no-default: Varsayılan locale için önek yok
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Çıktı: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Tüm locales için önek
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Çıktı: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: URL'lerde locale öneki yok
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Çıktı: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Locale sorgu parametresi olarak
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Çıktı: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Kenar Durumları
 
 - **Yerel Ayar Segmenti Yok:**

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname aracı eklendi"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Tüm dışa aktarımlar için birleştirilmiş dokümantasyon"
@@ -95,6 +98,7 @@ Re-exports most hooks from `react-intlayer`.
 | `useDictionaryAsync`   | Asenkron sözlükleri yöneten hook. Promise tabanlı bir sözlük haritası kabul eder ve mevcut locale için çözer.                                           | -                                                                                                                       |
 | `useDictionaryDynamic` | Anahtara göre yüklenen dinamik sözlükleri yöneten hook. Yükleme durumları için dahili olarak React Suspense kullanır.                                   | -                                                                                                                       |
 | `useLocale`            | İstemci tarafı hook; geçerli locale'i alır ve bunu ayarlamak için bir fonksiyon sağlar. Next.js App Router için navigasyon desteğiyle geliştirilmiştir. | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | Yerel ayar öneki kaldırılmış ve yerel ayar parametrelerinden arındırılmış sorgu parametreleri ile mevcut yol adını döndürür.                            | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | URL yeniden yazmalarını yönetmek için istemci tarafı hook. Daha uygun bir yerelleştirilmiş yeniden yazma kuralı varsa URL'yi otomatik olarak günceller. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Next.js Page Router'a özgü yerelleştirme yönetimi için hook. Dil değişikliklerinde yönlendirmeleri ve sayfa yeniden yüklemelerini işler.                | -                                                                                                                       |
 | `useI18n`              | Anahtar kullanarak iç içe geçmiş içeriğe erişen `t()` çeviri fonksiyonunu sağlayan hook. i18next/next-intl desenini taklit eder.                        | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/react-intlayer/useI18n.md)             |