@intlayer/docs 8.12.4 → 9.0.0-canary.10

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

@@ -22,18 +22,35 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # التوثيق: دالة `getMultilingualUrls` في `intlayer`
 
 ## الوصف
 
+تقوم دالة `getMultilingualUrls` بإنشاء خريطة من عناوين URL متعددة اللغات عن طريق إضافة بادئة للعنوان المحدد بكل لغة مدعومة. يمكنها التعامل مع عناوين URL المطلقة والنسبية، وتطبيق بادئة اللغة المناسبة بناءً على الإعدادات المقدمة أو الإعدادات الافتراضية.
+
+**الميزات الرئيسية:**
+
+- مطلوب معامل واحد فقط: `url`
+- كائن `options` اختياري يحتوي على `locales` و`defaultLocale` و`mode`
+- يستخدم إعدادات الدولية في مشروعك كإعدادات افتراضية
+- يدعم أوضاع التوجيه المتعددة: `prefix-no-default` و`prefix-all` و`no-prefix` و`search-params`
+- يعيد كائن خريطة مع جميع اللغات كمفاتيح وعناوين URL المقابلة لها كقيم
+
+---
+
+## الوصف
+
 تقوم دالة `getMultilingualUrls` بإنشاء خريطة لعناوين URL متعددة اللغات عن طريق إضافة بادئة لكل عنوان URL المعطى باستخدام كل لغة مدعومة. يمكنها التعامل مع عناوين URL المطلقة والنسبية، وتطبيق بادئة اللغة المناسبة بناءً على التكوين المقدم أو الإعدادات الافتراضية.
 
 ---
 
 ## المعاملات
 
+## المعاملات
+
 - `url: string`
   - **الوصف**: سلسلة عنوان URL الأصلية التي سيتم إضافة بادئات اللغات إليها.
   - **النوع**: `string`
@@ -53,6 +70,33 @@ history:
   - **النوع**: `boolean`
   - **الافتراضي**: `prefixDefaultDefault`
 
+### المعاملات الاختيارية
+
+- `options?: object`
+  - **الوصف**: كائن الإعدادات لسلوك تحديد موقع عنوان URL.
+  - **النوع**: `object`
+  - **مطلوب**: لا (اختياري)
+
+  - `options.locales?: Locales[]`
+    - **الوصف**: مصفوفة اللغات المدعومة. إذا لم يتم توفيرها، يتم استخدام اللغات المكونة من إعدادات المشروع الخاص بك.
+    - **النوع**: `Locales[]`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **الوصف**: اللغة الافتراضية للتطبيق. إذا لم يتم توفيرها، يتم استخدام اللغة الافتراضية المكونة من إعدادات المشروع الخاص بك.
+    - **النوع**: `Locales`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **الوصف**: وضع توجيه عنوان URL لمعالجة اللغة. إذا لم يتم توفيره، يتم استخدام الوضع المكون من إعدادات المشروع الخاص بك.
+    - **النوع**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+    - **الأوضاع**:
+      - `prefix-no-default`: لا توجد بادئة للغة الافتراضية، بادئة لجميع الأخرى
+      - `prefix-all`: بادئة لجميع اللغات بما فيها الافتراضية
+      - `no-prefix`: لا توجد بادئة لغة في عنوان URL
+      - `search-params`: استخدام معاملات الاستعلام للغة (على سبيل المثال، `?locale=fr`)
+
 ### القيم المرجعة
 
 - **النوع**: `IConfigLocales<string>`
@@ -62,6 +106,20 @@ history:
 
 ## مثال على الاستخدام
 
+### الاستخدام الأساسي (استخدام إعدادات المشروع)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// يستخدم إعدادات مشروعك للغات وdefaultLocale والوضع mode
+getMultilingualUrls("/dashboard");
+// الإخراج (بافتراض أن إعدادات المشروع تحتوي على en و fr مع وضع 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### عناوين URL النسبية
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -96,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### أنماط التوجيه المختلفة
+
+```typescript
+// prefix-no-default: بدون بادئة للغة الافتراضية
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// الإخراج: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: بادئة لجميع اللغات
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// الإخراج: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: بدون بادئة اللغة في العناوين
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// الإخراج: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: اللغة كمعامل استعلام
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// الإخراج: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## الحالات الخاصة
 
 - **عدم وجود جزء اللغة:**

package/docs/ar/packages/intlayer/getPathWithoutLocale.md

@@ -18,6 +18,7 @@ slugs:
   - packages
   - intlayer
   - getPathWithoutLocale
+author: aymericzip
 ---
 
 # التوثيق: دالة `getPathWithoutLocale` في `intlayer`
@@ -51,7 +52,3 @@ console.log(getPathWithoutLocale("/en/dashboard")); // الناتج: "/dashboard
 console.log(getPathWithoutLocale("/fr/dashboard")); // الناتج: "/dashboard"
 console.log(getPathWithoutLocale("https://example.com/en/dashboard")); // الناتج: "https://example.com/dashboard"
 ```
-
-## تاريخ التوثيق
-
-- 5.5.10 - 2025-06-29: بداية السجل

package/docs/ar/packages/intlayer/getPrefix.md

@@ -22,6 +22,7 @@ history:
   - version: 7.1.0
     date: 2025-11-16
     changes: "التوثيق الأولي"
+author: aymericzip
 ---
 
 # التوثيق: دالة `getPrefix` في `intlayer`

package/docs/ar/packages/intlayer/getTranslation.md

@@ -22,6 +22,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بدء التاريخ"
+author: aymericzip
 ---
 
 # التوثيق: دالة `getTranslationContent` في `intlayer`

package/docs/ar/packages/intlayer/getTranslationContent.md

@@ -21,6 +21,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # التوثيق: دالة `getTranslation` في `intlayer`

package/docs/ar/packages/intlayer/validatePrefix.md

@@ -19,6 +19,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Init doc"
+author: aymericzip
 ---
 
 # وثائق دالة validatePrefix

package/docs/ar/packages/intlayer-cli/exports.md

@@ -17,6 +17,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
+author: aymericzip
 ---
 
 # حزمة intlayer-cli

package/docs/ar/packages/lynx-intlayer/exports.md

@@ -17,6 +17,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد التوثيق لجميع الصادرات"
+author: aymericzip
 ---
 
 # حزمة lynx-intlayer

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

@@ -15,9 +15,13 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لجميع الصادرات"
+author: aymericzip
 ---
 
 # حزمة next-intlayer
@@ -98,6 +102,7 @@ import "next-intlayer";
 | `useDictionaryAsync`   | Hook يتعامل مع القواميس غير المتزامنة. يقبل خريطة قواميس مبنية على Promise ويقوم بحلّها وفقًا للـ locale الحالي.                 | -                                                                                                                       |
 | `useDictionaryDynamic` | Hook يتعامل مع القواميس الديناميكية المحمّلة حسب المفتاح. يستخدم React Suspense داخليًا لحالات التحميل.                          | -                                                                                                                       |
 | `useLocale`            | هوك على جانب العميل للحصول على اللغة الحالية ودالة لتعيينها. محسّن لـ Next.js App Router مع دعم التنقل.                          | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | يُرجع مسار URL الحالي مع إزالة بادئة اللغة ومعلمات استعلام اللغة.                                                                | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | هوك على جانب العميل لإدارة إعادة كتابة عناوين URL. يقوم تلقائيًا بتحديث عنوان URL إذا وُجدت قاعدة إعادة كتابة محلية أكثر ملاءمة. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Hook مخصص لـ Next.js Page Router لإدارة الـ locale. يتعامل مع إعادة التوجيه وإعادة تحميل الصفحة عند تغيّر الـ locale.            | -                                                                                                                       |
 | `useI18n`              | Hook يوفّر دالة ترجمة `t()` للوصول إلى محتوى متداخل بواسطة مفتاح. يُحاكي نمط i18next/next-intl.                                  | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useI18n.md)             |

package/docs/ar/packages/next-intlayer/intlayerMiddleware.md

@@ -23,6 +23,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "إنشاء المستند"
+author: aymericzip
 ---
 
 # توثيق intlayerProxy (intlayerMiddleware)

package/docs/ar/packages/next-intlayer/t.md

@@ -22,6 +22,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # التوثيق: دالة `t` في `next-intlayer`

package/docs/ar/packages/next-intlayer/useDictionary.md

@@ -22,6 +22,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # تكامل React: توثيق هوك `useDictionary`

package/docs/ar/packages/next-intlayer/useIntlayer.md

@@ -25,6 +25,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # تكامل Next.js: توثيق هوك `useIntlayer`

package/docs/ar/packages/next-intlayer/useLocale.md

@@ -25,6 +25,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بداية التاريخ"
+author: aymericzip
 ---
 
 # تكامل Next.js: توثيق هوك `useLocale` لحزمة `next-intlayer`

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: توثيق Hook usePathname | next-intlayer
+description: تعرف على كيفية استخدام Hook usePathname لحزمة next-intlayer
+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"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "تهيئة السجل"
+author: aymericzip
+---
+
+# تكامل Next.js: توثيق Hook `usePathname`
+
+يُرجع الخطاف `usePathname` مسار Next.js الحالي مع إزالة مقطع اللغة (locale). يعد هذا مفيدًا لبناء تنقل يراعي اللغة — على سبيل المثال، تحديد عنصر التنقل النشط — دون الحاجة إلى إزالة بادئة اللغة يدويًا.
+
+## استيراد `usePathname` في Next.js
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## نظرة عامة
+
+يقوم `usePathname` بتغليف `usePathname()` المدمج في Next.js والمستورد من `next/navigation`، ويقوم بإضافة أية معلمات بحث (search params)، ثم يزيل بادئة اللغة عبر `getPathWithoutLocale`. يعيد هذا الخطاف تصيير المكون (re-render) عند كل انتقال (navigation) يتم من جانب العميل. هذا الخطاف متاح فقط في مكونات العميل (يتطلب `"use client"`).
+
+## الاستخدام
+
+```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;
+```
+
+## القيمة المرجعة
+
+| النوع    | الوصف                                                     |
+| -------- | --------------------------------------------------------- |
+| `string` | المسار الحالي مع إزالة بادئة اللغة ومعلمات استعلام اللغة. |
+
+## السلوك
+
+- **إزالة اللغة**: يزيل مقطع اللغة الرائد (مثل `/ar/dashboard` ← `/dashboard`).
+- **إزالة معلمة البحث**: يزيل أيضًا معلمة استعلام `?locale=...` عندما يتم استخدام وضع توجيه معلمات البحث.
+- **تفاعلي**: يتم تحديثه في كل مرة يحدث فيها انتقال من جانب العميل عبر Next.js App Router.
+- **آمن مع العرض من جانب الخادم (SSR)**: يُرجع مسار الخادم أثناء العرض الأول (first render)، ثم يُزامن معلمات البحث على جانب العميل.
+
+## مقارنة مع `useLocale`
+
+يقوم `useLocale` من `next-intlayer` بالفعل بتوفير `pathWithoutLocale` كجزء من قيمته المرجعة. استخدم `usePathname` عندما تحتاج فقط إلى المسار ولا تحتاج إلى وظيفة تبديل اللغة.
+
+```tsx codeFormat={["typescript", "esm"]}
+// عندما تحتاج إلى حالة اللغة والمسار معًا:
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// عندما تحتاج إلى المسار فقط:
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## مثال
+
+```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: "لوحة التحكم" },
+  { href: "/settings", label: "الإعدادات" },
+];
+
+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;
+```
+
+## ذو صلة
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useLocale.md) — اللغة الحالية + مبدل اللغة (كما يوفر `pathWithoutLocale`)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) — الأداة الأساسية التي يعتمد عليها هذا الخطاف

package/docs/ar/packages/next-intlayer/useRewriteURL.md

@@ -14,6 +14,7 @@ slugs:
   - packages
   - next-intlayer
   - useRewriteURL
+author: aymericzip
 ---
 
 # هوك useRewriteURL

package/docs/ar/packages/nuxt-intlayer/exports.md

@@ -17,6 +17,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لكل الصادرات"
+author: aymericzip
 ---
 
 # حزمة nuxt-intlayer

package/docs/ar/packages/preact-intlayer/exports.md

@@ -14,9 +14,13 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد الوثائق لجميع الصادرات"
+author: aymericzip
 ---
 
 # حزمة preact-intlayer
@@ -39,12 +43,13 @@ npm install preact-intlayer
 
 ### الهوكس (Hooks)
 
-| الـ Hook        | الوصف                                                                                      | الوثيقة ذات الصلة                                                                                  |
-| --------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
-| `useIntlayer`   | مبني على `useDictionary`، لكنه يحقن نسخة مُحسّنة من القاموس المأخوذة من التصريح المُولَّد. | -                                                                                                  |
-| `useDictionary` | يعالج الكائنات التي تشبه القواميس (key, content). يعالج ترجمات `t()`، وenumerations، إلخ.  | -                                                                                                  |
-| `useLocale`     | يعيد اللغة الحالية ودالة لتعيينها.                                                         | -                                                                                                  |
-| `t`             | يختار المحتوى بناءً على اللغة الحالية.                                                     | [الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md) |
+| الـ Hook        | الوصف                                                                                                   | الوثيقة ذات الصلة                                                                                                    |
+| --------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | مبني على `useDictionary`، لكنه يحقن نسخة مُحسّنة من القاموس المأخوذة من التصريح المُولَّد.              | -                                                                                                                    |
+| `useDictionary` | يعالج الكائنات التي تشبه القواميس (key, content). يعالج ترجمات `t()`، وenumerations، إلخ.               | -                                                                                                                    |
+| `useLocale`     | يعيد اللغة الحالية ودالة لتعيينها.                                                                      | -                                                                                                                    |
+| `usePathname`   | هوك (Hook) يعيد المسار الحالي (pathname) بعد إزالة مقطع اللغة منه. يستجيب لتنقل المتصفح عبر `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/preact-intlayer/usePathname.md) |
+| `t`             | يختار المحتوى بناءً على اللغة الحالية.                                                                  | [الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)                   |
 
 ### المكونات
 

package/docs/ar/packages/preact-intlayer/usePathname.md

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: توثيق الهوك usePathname | preact-intlayer
+description: تعرف على كيفية استخدام الهوك usePathname مع حزمة preact-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - التدويل
+  - توثيق
+  - Preact
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - preact-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "تهيئة السجل التاريخي"
+author: aymericzip
+---
+
+# تكامل Preact: توثيق الهوك `usePathname`
+
+يُرجع الهوك `usePathname` المسار الحالي للمتصفح (pathname) مع إزالة مقطع اللغة (locale). يعد هذا مفيدًا لبناء تنقل (navigation) متوافق مع اللغة — على سبيل المثال، تحديد أي عنصر تنقل هو النشط — دون الحاجة إلى إزالة بادئة اللغة يدويًا.
+
+## استيراد `usePathname` في Preact
+
+```typescript
+import { usePathname } from "preact-intlayer";
+```
+
+## نظرة عامة
+
+يقرأ `usePathname` القيمة `window.location.pathname`، ويزيل بادئة اللغة عبر الدالة `getPathWithoutLocale`، ويعيد تصيير المكون (re-renders) كلما أطلق المتصفح حدث `popstate` (التنقل للخلف / للأمام). يُرجع سلسلة نصية فارغة أثناء التصيير من جانب الخادم (SSR).
+
+## الاستخدام
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FunctionComponent<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## القيمة المرجعة
+
+| النوع    | الوصف                                                                                |
+| -------- | ------------------------------------------------------------------------------------ |
+| `string` | المسار الحالي بدون بادئة اللغة. سلسلة نصية فارغة أثناء التصيير من جانب الخادم (SSR). |
+
+## السلوك
+
+- **إزالة اللغة (Locale stripping)**: يزيل مقطع اللغة الرائد (مثل `/ar/dashboard` ← `/dashboard`).
+- **تفاعلي (Reactive)**: يتحدث تلقائيًا عند أحداث `popstate` (تنقل المتصفح للخلف / للأمام).
+- **آمن لـ SSR**: يعود بـ `""` عندما لا يكون `window` متاحًا.
+- **التنظيف (Cleanup)**: يتم إزالة مستمع الـ `popstate` تلقائيًا عند إلغاء تحميل المكون (unmount).
+
+## مثال
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "لوحة التحكم" },
+  { href: "/settings", label: "الإعدادات" },
+];
+
+const Sidebar: FunctionComponent = () => {
+  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;
+```
+
+## مواضيع ذات صلة
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/preact-intlayer/exports.md) — اللغة الحالية + مبدّل اللغة
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) — الأداة الأساسية التي يستخدمها هذا الهوك

package/docs/ar/packages/react-intlayer/IntlayerProvider.md

@@ -19,6 +19,7 @@ history:
   - version: 7.5.14
     date: 2026-01-21
     changes: "بدء التوثيق"
+author: aymericzip
 ---
 
 # وثائق مكوّن IntlayerProvider

package/docs/ar/packages/react-intlayer/MarkdownRenderer.md

@@ -19,6 +19,7 @@ history:
   - version: 7.5.14
     date: 2026-01-21
     changes: "إنشاء المستند"
+author: aymericzip
 ---
 
 # توثيق المكوّن MarkdownRenderer

package/docs/ar/packages/react-intlayer/exports.md

@@ -14,9 +14,13 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "توثيق موحّد لجميع الصادرات"
+author: aymericzip
 ---
 
 # حزمة react-intlayer
@@ -63,6 +67,7 @@ import "react-intlayer";
 | `useDictionaryDynamic` | هوك يتعامل مع القواميس الديناميكية التي تُحمّل بواسطة المفتاح. يستخدم React Suspense داخليًا لحالات التحميل.                    | -                                                                                                                       |
 | `useLocale`            | هوك على جهة العميل للحصول على الـlocale الحالية، الـlocale الافتراضية، الـlocales المتاحة، ودالة لتحديث الـlocale.              | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useLocale.md)         |
 | `useLocaleBase`        | Hook للحصول على اللغة الحالية وجميع الحقول المتعلقة بها (locale, defaultLocale, availableLocales, setLocale) من السياق.         | -                                                                                                                       |
+| `usePathname`          | خطاف (Hook) يعيد مسار الرابط (pathname) الحالي مع إزالة جزء الإعداد المحلي. يتفاعل مع تنقل المتصفح عبر `popstate`.              | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Hook على جانب العميل لإدارة إعادة كتابة عناوين URL. إذا وُجدت قاعدة إعادة كتابة للمسار الحالي والlocale، فسيتم تحديث عنوان URL. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useRewriteURL.md) |
 | `useI18n`              | هوك يوفر دالة ترجمة `t()` للوصول إلى محتوى متداخل عبر المفتاح. يحاكي نمط i18next/next-intl.                                     | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useI18n.md)             |
 | `useIntl`              | هوك يوفر كائن `Intl` مربوط بالـ locale. يقوم بحقن الـ locale الحالي تلقائيًا ويستخدم تخزينًا مؤقتًا محسّنًا.                    | -                                                                                                                       |