@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.4

package/docs/tr/migration_from_react-i18next_to_intlayer.md

@@ -101,24 +101,40 @@ Aşağıdaki adımlar, mevcut `react-i18next` uygulamanızı hiçbir bileşen ko
 
 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 react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > `react-i18next` ve `i18next`'i güvenle yüklü bırakabilirsiniz; uyumluluk adaptörü bunları TypeScript türleri için `devDependency` / `peerDependency` olarak kullanır. `package.json` dosyanızdaki herhangi bir eş bağımlılığı (peer dependency) değiştirmeniz gerekmez.

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/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)             |

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook Dokümantasyonu | next-intlayer
+description: next-intlayer paketi için usePathname hook'unun nasıl kullanılacağını öğrenin
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - next-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname aracı eklendi"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Geçmişin başlatılması"
+author: aymericzip
+---
+
+# Next.js Entegrasyonu: `usePathname` Hook Dokümantasyonu
+
+`usePathname` hook'u, yerel ayar (locale) segmenti kaldırılmış olan geçerli Next.js yolunu (pathname) döndürür. Bu, yerel ayar ön ekini manuel olarak kaldırmak zorunda kalmadan, yerel ayar duyarlı gezinme oluşturmak (örneğin, hangi gezinme öğesinin aktif olduğunu belirlemek) için kullanışlıdır.
+
+## `usePathname`'i Next.js'te İçe Aktarma
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## Genel Bakış
+
+`usePathname`, `next/navigation`'dan gelen Next.js'in yerleşik `usePathname()` fonksiyonunu sarar, herhangi bir arama parametresini (search params) ekler ve yerel ayar önekini `getPathWithoutLocale` aracılığıyla kaldırır. Her istemci tarafı gezinmesinde (client-side navigation) yeniden render (re-render) tetikler. Hook yalnızca Client Component'lerde kullanılabilir (`"use client"` gerektirir).
+
+## Kullanım
+
+```tsx fileName="src/components/NavItem.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FC<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Dönüş Değeri
+
+| Tip      | Açıklama                                                                                                              |
+| -------- | --------------------------------------------------------------------------------------------------------------------- |
+| `string` | Yerel ayar öneki ve yerel ayarla ilgili sorgu parametreleri (query parameters) kaldırılmış mevcut yol adı (pathname). |
+
+## Davranış
+
+- **Yerel ayar kırpma**: Başlangıçtaki yerel ayar segmentini kaldırır (örneğin `/tr/dashboard` → `/dashboard`).
+- **Arama parametresi kırpma**: Arama parametresi (search param) tabanlı yönlendirme modu kullanıldığında `?locale=...` sorgu parametresini de kaldırır.
+- **Reaktif**: Next.js App Router üzerinden yapılan her istemci tarafı gezinmede otomatik olarak güncellenir.
+- **SSR Güvenli**: İlk render sırasında sunucu tarafı yolu döndürür, ardından istemcideki arama parametrelerini eşitler (sync).
+
+## `useLocale` ile Karşılaştırma
+
+`next-intlayer`'dan alınan `useLocale`, dönüş değerinin bir parçası olarak zaten `pathWithoutLocale`'i sunar. Yerel ayar değiştirme işlevine ihtiyaç duymadan sadece yola (path) ihtiyacınız olduğunda `usePathname`'i kullanın.
+
+```tsx codeFormat={["typescript", "esm"]}
+// Hem yerel ayar durumuna hem de yola ihtiyacınız olduğunda:
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// Sadece yola ihtiyacınız olduğunda:
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## Örnek
+
+```tsx fileName="src/components/Sidebar.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Kontrol Paneli" },
+  { href: "/settings", label: "Ayarlar" },
+];
+
+const Sidebar: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      {links.map(({ href, label }) => (
+        <a
+          key={href}
+          href={href}
+          style={{ fontWeight: pathname === href ? "bold" : "normal" }}
+        >
+          {label}
+        </a>
+      ))}
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## İlgili Dokümanlar
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/next-intlayer/useLocale.md) — mevcut yerel ayar + yerel ayar değiştirici (ayrıca `pathWithoutLocale`'i de sunar)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/packages/intlayer/getPathWithoutLocale.md) — bu hook tarafından kullanılan temel yardımcı araç