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

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

@@ -14,9 +14,12 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة الأداة المساعدة usePathname"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Unified documentation for all exports"
+    changes: "توحيد التوثيق لجميع الصادرات"
 author: aymericzip
 ---
 
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### الـ Hooks
 
-| الـ Hook               | الوصف                                                                                                 | المستند ذو الصلة |
-| ---------------------- | ----------------------------------------------------------------------------------------------------- | ---------------- |
-| `useIntlayer`          | مبنية على `useDictionary`، لكنها تحقن نسخة مُحسّنة من القاموس مأخوذة من التصريح المُولد.              | -                |
-| `useDictionary`        | يعالج الكائنات التي تشبه القواميس (مفتاح، محتوى). يعالج ترجمات `t()`، والتعدادات (enumerations)، إلخ. | -                |
-| `useDictionaryAsync`   | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس غير المتزامنة (asynchronous).                        | -                |
-| `useDictionaryDynamic` | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس الديناميكية (dynamic).                               | -                |
-| `useLocale`            | يعيد الـ locale الحالي ودالة لتعيينه.                                                                 | -                |
-| `useIntl`              | يعيد كائن Intl للـ locale الحالي.                                                                     | -                |
-| `useLoadDynamic`       | Hook لتحميل القواميس الديناميكية.                                                                     | -                |
+| الـ Hook               | الوصف                                                                                                 | المستند ذو الصلة                                                                                                      |
+| ---------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | مبنية على `useDictionary`، لكنها تحقن نسخة مُحسّنة من القاموس مأخوذة من التصريح المُولد.              | -                                                                                                                     |
+| `useDictionary`        | يعالج الكائنات التي تشبه القواميس (مفتاح، محتوى). يعالج ترجمات `t()`، والتعدادات (enumerations)، إلخ. | -                                                                                                                     |
+| `useDictionaryAsync`   | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس غير المتزامنة (asynchronous).                        | -                                                                                                                     |
+| `useDictionaryDynamic` | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس الديناميكية (dynamic).                               | -                                                                                                                     |
+| `useLocale`            | إرجاع اللغة الحالية ووظيفة لتعيينها.                                                                  | -                                                                                                                     |
+| `usePathname`          | يُرجع المسار الحالي كـ `Signal<string>` مع إزالة جزء اللغة. يتفاعل مع `popstate` عبر `DestroyRef`.    | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | إرجاع كائن Intl للغة الحالية.                                                                         | -                                                                                                                     |
+| `useLoadDynamic`       | Hook لتحميل القواميس الديناميكية.                                                                     | -                                                                                                                     |
 
 ### المكوّنات
 

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: توثيق Hook usePathname | angular-intlayer
+description: تعرف على كيفية استخدام hook usePathname في حزمة angular-intlayer
+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"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "تهيئة السجل"
+author: aymericzip
+---
+
+# تكامل Angular: توثيق Hook `usePathname`
+
+يُرجع الـ hook `usePathname` مسار المتصفح الحالي مع إزالة جزء اللغة، كإشارة (Signal) من نوع `Signal<string>` في Angular. يُعد هذا مفيدًا لبناء تنقل (navigation) يعتمد على اللغة — على سبيل المثال، لتحديد عنصر التنقل النشط — دون الحاجة إلى إزالة بادئة اللغة يدويًا.
+
+## استيراد `usePathname` في Angular
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## نظرة عامة
+
+يقوم `usePathname` بقراءة `window.location.pathname`، ويزيل بادئة اللغة عبر `getPathWithoutLocale`، ويُحدّث الإشارة (signal) كلما أطلق المتصفح حدث `popstate` (التنقل للخلف/للأمام). يستخدم `DestroyRef` الخاص بـ Angular لتنظيف مستمع الحدث تلقائيًا عند تدمير المكون.
+
+## الاستخدام
+
+```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();
+}
+```
+
+## القيمة المُرجعة
+
+| النوع            | الوصف                                                   |
+| ---------------- | ------------------------------------------------------- |
+| `Signal<string>` | إشارة Angular تحتوي على المسار الحالي بدون بادئة اللغة. |
+
+## السلوك
+
+- **إزالة اللغة**: يزيل جزء اللغة الأولي (مثل `/ar/dashboard` → `/dashboard`).
+- **تفاعلي**: يتم التحديث تلقائيًا عند أحداث `popstate` (تنقل المتصفح للخلف / للأمام).
+- **آمن لـ SSR**: يُرجع `""` عندما لا يكون `window` متاحًا.
+- **التنظيف**: يتم إزالة مستمع الحدث `popstate` عبر `DestroyRef.onDestroy` عند تدمير المكون المُضيف.
+
+## مثال
+
+```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: "لوحة التحكم" },
+    { href: "/settings", label: "الإعدادات" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## مواضيع ذات صلة
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/angular-intlayer/exports.md) — اللغة الحالية + مبدل اللغة
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) — الأداة المساعدة الأساسية التي يستخدمها هذا الـ hook

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: وثائق دالة comparePaths | intlayer
+description: تعرف على كيفية استخدام دالة comparePaths لحزمة intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - الرابط النشط
+  - التنقل
+  - Intlayer
+  - intlayer
+  - التدويل
+  - الوثائق
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "الوثائق الأولية"
+author: aymericzip
+---
+
+# الوثائق: دالة `comparePaths` في `intlayer`
+
+## الوصف
+
+تقوم دالة `comparePaths` بمقارنة عنواني URL أو مسارين للتحقق من تطابقهما مع تجاهل جزء اللغة (locale)، البروتوكول/المضيف، سلسلة الاستعلام (query string)، التجزئة (hash)، والشرطات المائلة الختامية (trailing slashes). إنها الطريقة الموصى بها لتحديد ما إذا كان رابط التنقل يشير إلى الصفحة الحالية — على سبيل المثال لتمييز الرابط النشط — دون الحاجة إلى كتابة منطق التسوية (normalization logic) الخاص بك والذي يكون عرضة للأخطاء.
+
+داخليًا، تعيد استخدام [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) لإزالة جزء اللغة، لذلك فهي تحترم وضع التوجيه واللغات التي قمت بتكوينها.
+
+تُصدّر الحزمة أيضًا الأداة المساعدة الأساسية [`normalizePath`](#normalizepath)، والتي تُرجع المسار القياسي المستقل عن اللغة والمُستخدم في المقارنة.
+
+**الميزات الرئيسية:**
+
+- مقارنة مستقلة عن اللغة (`/ar/about` يتطابق مع `/about`)
+- تعمل مع كل من عناوين URL المطلقة والمسارات النسبية
+- تتجاهل سلسلة الاستعلام، التجزئة، والشرطات المائلة الختامية
+- تتسامح مع غياب الشرطات المائلة البادئة والقيم الفارغة (يتم تسويتها إلى `/`)
+- خفيفة الوزن — مبنية على `getPathWithoutLocale`
+
+---
+
+## توقيع الدالة
+
+```typescript
+comparePaths(
+  pathname: string,  // مطلوب
+  href: string,      // مطلوب
+  locales?: Locales[] // اختياري
+): boolean
+
+normalizePath(
+  inputUrl: string,   // مطلوب
+  locales?: Locales[] // اختياري
+): string
+```
+
+---
+
+## المعلمات (Parameters)
+
+- `pathname: string`
+  - **الوصف**: سلسلة URL الأولى أو المسار الأول للمقارنة (عادةً ما يكون المسار الحالي).
+  - **النوع**: `string`
+  - **مطلوب**: نعم
+
+- `href: string`
+  - **الوصف**: سلسلة URL الثانية أو المسار الثاني للمقارنة (عادةً ما يكون `href` لرابط التنقل).
+  - **النوع**: `string`
+  - **مطلوب**: نعم
+
+- `locales: Locales[]`
+  - **الوصف**: مصفوفة اختيارية للغات المدعومة. يتم افتراض اللغات المكوّنة في المشروع.
+  - **النوع**: `Locales[]`
+  - **مطلوب**: لا (اختياري)
+
+### الإرجاع (Returns)
+
+- **النوع**: `boolean`
+- **الوصف**: `true` عندما يتم حل كلا الإدخالين إلى نفس المسار المستقل عن اللغة، وإلا `false`.
+
+---
+
+## مثال على الاستخدام
+
+### الاستخدام الأساسي
+
+```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
+```
+
+### عناوين URL المطلقة والنسبية
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### تمييز رابط التنقل النشط
+
+```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`. تقوم بإزالة جزء اللغة، البروتوكول/المضيف، سلسلة الاستعلام، والتجزئة، وتضمن وجود شرطة مائلة بادئة واحدة، وتزيل أي شرطات مائلة ختامية (باستثناء الجذر)، وتستخدم `/` كقيمة احتياطية للقيم الفارغة.
+
+```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"
+```
+
+---
+
+## دوال ذات صلة
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md): يزيل جزء اللغة من عنوان URL أو مسار.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPrefix.md): يحدد بادئة URL للغة معينة.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md): يولد عنوان URL محلي للغة معينة.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "إضافة الأداة المساعدة comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد التوثيق لجميع الصادرات"
@@ -119,6 +122,8 @@ import "intlayer";
 | `getMultilingualUrls`  | `Function` | ينشئ URLs لجميع اللغات المدعومة.           | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getMultilingualUrls.md)   |
 | `getPathWithoutLocale` | `Function` | يزيل بادئة اللغة من المسار.                | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) |
 | `getPrefix`            | `Function` | يحصل على بادئة اللغة من المسار.            | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | يقارن بين مسارين مع تجاهل اللغة (locale).  | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | يقوم بتسوية مسار ليكون مستقلاً عن اللغة.   | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/comparePaths.md)                 |
 | `getHTMLTextDir`       | `Function` | يحصل على اتجاه النص (LTR/RTL).             | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getHTMLTextDir.md)             |
 | `validatePrefix`       | `Function` | يتحقق من صحة بادئة اللغة.                  | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/validatePrefix.md)             |
 

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لجميع الصادرات"
@@ -99,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/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/preact-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد الوثائق لجميع الصادرات"
@@ -40,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) — الأداة الأساسية التي يستخدمها هذا الهوك