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

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/exports.md

@@ -14,6 +14,9 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "توثيق موحّد لجميع الصادرات"
@@ -64,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 الحالي تلقائيًا ويستخدم تخزينًا مؤقتًا محسّنًا.                    | -                                                                                                                       |

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

@@ -188,19 +188,6 @@ const text = t(translations);
 
 ## الخاتمة
 
-تُعد دالة `t` في مكتبة `react-intlayer` أداة قوية ومريحة لإدارة الترجمات المضمنة داخل تطبيقات React الخاصة بك. من خلال دمجها بشكل فعال، تقوم بتحسين قدرات التدويل في تطبيقك، مما يوفر تجربة أفضل للمستخدمين حول العالم.
-
-لمزيد من الاستخدامات التفصيلية والميزات المتقدمة، راجع [توثيق react-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
-
----
-
-3. **توفير اللغة بشكل متسق**: تأكد من توفير اللغة الخاصة بك بشكل متسق عبر تطبيقك من خلال `IntlayerProvider`.
-4. **الاستفادة من TypeScript**: استخدم أنواع TypeScript لاكتشاف الترجمات المفقودة وضمان سلامة الأنواع.
-
----
-
-## الخاتمة
-
 تُعد دالة `t` في `react-intlayer` أداة قوية ومريحة لإدارة الترجمات المضمنة في تطبيقات React الخاصة بك. من خلال دمجها بشكل فعال، تقوم بتحسين قدرات التدويل في تطبيقك، مما يوفر تجربة أفضل للمستخدمين حول العالم.
 
 للحصول على استخدام أكثر تفصيلاً وميزات متقدمة، راجع [توثيق react-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).

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

@@ -24,102 +24,6 @@ history:
 author: aymericzip
 ---
 
-# تكامل React: توثيق هوك `useDictionary`
-
-يوفر هذا القسم إرشادات مفصلة حول استخدام هوك `useDictionary` داخل تطبيقات React، مما يتيح إدارة فعالة للمحتوى المحلي بدون محرر بصري.
-
-## استيراد `useDictionary` في React
-
-يمكن دمج هوك `useDictionary` في تطبيقات React عن طريق استيراده بناءً على السياق:
-
-- **مكون العميل:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // يستخدم في مكونات React على جانب العميل
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // يستخدم في مكونات React على جانب العميل
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // يستخدم في مكونات React على جانب العميل
-  ```
-
-- **مكون الخادم:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // يستخدم في مكونات React على جانب الخادم
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // يستخدم في مكونات React على جانب الخادم
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // يستخدم في مكونات React على جانب الخادم
-  ```
-
-## المعاملات
-
-يقبل الهوك معاملين:
-
-1. **`dictionary`**: كائن قاموس معلن يحتوي على محتوى محلي لمفاتيح محددة.
-2. **`locale`** (اختياري): اللغة المطلوبة. الافتراضي هو لغة السياق الحالي إذا لم يتم تحديدها.
-
-## القاموس
-
-يجب إعلان جميع كائنات القاموس في ملفات محتوى منظمة لضمان سلامة الأنواع ومنع أخطاء وقت التشغيل. يمكنك العثور على [تعليمات الإعداد هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md). إليك مثال على إعلان المحتوى:
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "ar": "مثال على مكون العميل",
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Ejemplo de componente cliente"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "ar": "هذا هو محتوى مثال على مكون العميل",
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente"
-      }
-    }
-  }
-}
-```
-
 ## مثال على الاستخدام في React
 
 فيما يلي مثال على كيفية استخدام الخطاف `useDictionary` في مكون React:
@@ -162,14 +66,6 @@ const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
 };
 ```
 
-## ملاحظات حول السمات
-
-على عكس التكاملات التي تستخدم المحررات المرئية، فإن السمات مثل `buttonTitle.value` لا تنطبق هنا. بدلاً من ذلك، قم بالوصول مباشرة إلى السلاسل المحلية كما هو معلن في المحتوى الخاص بك.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## نصائح إضافية
 
 - **سلامة النوع**: استخدم دائمًا `Dictionary` لتعريف القواميس الخاصة بك لضمان سلامة النوع.

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

@@ -142,7 +142,3 @@ const ServerComponentExample = () => {
 - **محرر Intlayer المرئي**: للحصول على تجربة إدارة محتوى أكثر سهولة وبديهية، راجع توثيق المحرر المرئي [هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
 
 يغطي هذا القسم بشكل خاص دمج الخطاف `useI18n` في تطبيقات React، مما يبسط عملية التعريب ويضمن اتساق المحتوى عبر اللغات المختلفة.
-
-## تاريخ التوثيق
-
-- 6.0.0 - 2025-06-29: الكتابة الأولية لتوثيق الخطاف `useI18n`

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

@@ -21,49 +21,6 @@ slugs:
 author: aymericzip
 ---
 
-# تكامل React: توثيق هوك `useIntlayer`
-
-يوفر هذا القسم إرشادات مفصلة حول استخدام هوك `useIntlayer` داخل تطبيقات React، مما يتيح تعريب المحتوى بكفاءة.
-
-## استيراد `useIntlayer` في React
-
-يمكن دمج هوك `useIntlayer` في تطبيقات React عن طريق استيراده بناءً على السياق:
-
-- **مكون العميل:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // يُستخدم في مكونات React على جانب العميل
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // يُستخدم في مكونات React على جانب العميل
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // يُستخدم في مكونات React على جانب العميل
-  ```
-
-- **مكون الخادم:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // يُستخدم في مكونات React على جانب الخادم
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // يُستخدم في مكونات React على جانب الخادم
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // يُستخدم في مكونات React على جانب الخادم
-  ```
-
-## المعاملات
-
-يقبل الـ hook معاملين:
-
-1. **`key`**: مفتاح القاموس لاسترجاع المحتوى المحلي.
-2. **`locale`** (اختياري): اللغة المطلوبة. القيمة الافتراضية هي لغة السياق إذا لم يتم تحديدها.
-
 ## القاموس
 
 يجب إعلان جميع مفاتيح القاموس داخل ملفات إعلان المحتوى لتعزيز أمان النوع وتجنب الأخطاء. يمكنك العثور على [تعليمات الإعداد هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md).
@@ -127,20 +84,8 @@ const ServerComponentExample = () => {
 };
 ```
 
-## التعامل مع السمات
-
-عند تعريب السمات، قم بالوصول إلى قيم المحتوى بشكل مناسب:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## موارد إضافية
 
 - **محرر Intlayer المرئي**: لتجربة إدارة محتوى أكثر سهولة وبديهية، راجع توثيق المحرر المرئي [هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
 
 تستهدف هذه القسم بشكل خاص دمج الخطاف `useIntlayer` في تطبيقات React، مما يبسط عملية التعريب ويضمن تناسق المحتوى عبر اللغات المختلفة.
-
-## تاريخ التوثيق
-
-- 5.5.10 - 2025-06-29: بداية السجل

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

@@ -0,0 +1,87 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: توثيق الخطاف usePathname | react-intlayer
+description: تعرف على كيفية استخدام الخطاف usePathname من حزمة react-intlayer للحصول على مسار URL الحالي بدون جزء الإعداد المحلي (locale).
+keywords:
+  - usePathname
+  - مسار الرابط
+  - react
+  - intlayer
+  - التوجيه
+  - التدويل
+slugs:
+  - doc
+  - packages
+  - react-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "تهيئة السجل"
+author: aymericzip
+---
+
+# تكامل React: توثيق الخطاف `usePathname`
+
+الخطاف `usePathname` من `react-intlayer` يعيد المسار الحالي للمتصفح (pathname) مع إزالة جزء الإعداد المحلي (locale). يعتمد على الخاصية الأصلية `window.location.pathname` ويتفاعل مع أحداث تنقل المتصفح عبر `popstate`.
+
+## استيراد `usePathname`
+
+```typescript
+import { usePathname } from "react-intlayer";
+```
+
+## نظرة عامة
+
+على عكس خطافات التوجيه الخاصة بأطر العمل (مثل تلك الموجودة في `next-intlayer` أو `react-router`)، يُعد هذا الخطاف حلاً خفيف الوزن ومستقلاً عن أطر العمل لتطبيقات React الخالصة. يقوم باستخراج مسار URL الحالي ويزيل أي بادئة محلية مطابقة (على سبيل المثال، `/ar/about` تصبح `/about`).
+
+## الاستخدام
+
+```tsx fileName="src/components/Navigation.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { usePathname } from "react-intlayer";
+
+const Navigation: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <a
+        href="/home"
+        style={{ fontWeight: pathname === "/home" ? "bold" : "normal" }}
+      >
+        الرئيسية
+      </a>
+      <a
+        href="/about"
+        style={{ fontWeight: pathname === "/about" ? "bold" : "normal" }}
+      >
+        من نحن
+      </a>
+    </nav>
+  );
+};
+
+export default Navigation;
+```
+
+## القيمة المرجعة
+
+| النوع    | الوصف                                                                                                |
+| -------- | ---------------------------------------------------------------------------------------------------- |
+| `string` | مسار المتصفح الحالي مع إزالة بادئة الإعداد المحلي (على سبيل المثال، `/ar/dashboard` → `/dashboard`). |
+
+## السلوك
+
+- **إزالة الإعداد المحلي**: يستخدم أداة `getPathWithoutLocale` داخليًا لاكتشاف وإزالة الإعداد المحلي تلقائيًا من المسار بناءً على تكوين Intlayer للتطبيق.
+- **التفاعلية**: يستمع إلى الحدث `popstate`. عندما يتنقل المستخدم باستخدام أزرار الرجوع/التقدم في المتصفح أو عندما يتم استدعاء `pushState`/`replaceState`، يقوم الخطاف بتحديث المسار المرجع.
+- **SSR Fallback**: على الخادم (حيث تكون `window` غير معرفة)، فإنه يرجع `/` افتراضيًا لأنه لا يمتلك وصولًا إلى URL الخاص بالطلب بشكل افتراضي في سياق React خالص.
+
+## الوثائق ذات الصلة
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useLocale.md)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md)

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

@@ -14,6 +14,9 @@ slugs:
   - solid-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد التوثيق لجميع الصادرات"
@@ -59,6 +62,7 @@ import "solid-intlayer";
 | `useDictionaryAsync`   | مثل `useDictionary`، ولكن يتعامل مع القواميس غير المتزامنة.                                                            | -                                                                                                                       |
 | `useDictionaryDynamic` | مثل `useDictionary`، ولكن يتعامل مع القواميس الديناميكية.                                                              | -                                                                                                                       |
 | `useLocale`            | يعيد الـ locale الحالية ودالة لتعيينها.                                                                                | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | يُعيد مسار الرابط الحالي (pathname) كـ `Accessor<string>` مع إزالة جزء اللغة (locale). متفاعل مع `popstate`.           | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | هو hook على جانب العميل لإدارة إعادة كتابة عناوين URL. يقوم بتحديث الـ URL تلقائيًا إذا وُجدت قاعدة إعادة كتابة محلية. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | يعيد كائن Intl للـ locale الحالية.                                                                                     | -                                                                                                                       |
 | `useLoadDynamic`       | هوك لتحميل القواميس الديناميكية.                                                                                       | -                                                                                                                       |

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: توثيق Hook usePathname | solid-intlayer
+description: تعرف على كيفية استخدام hook usePathname من حزمة solid-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - تدويل
+  - توثيق
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "تهيئة السجل"
+author: aymericzip
+---
+
+# تكامل Solid: توثيق Hook `usePathname`
+
+يُعيد الـ hook `usePathname` مسار المتصفح الحالي (pathname) مع إزالة جزء اللغة (locale)، على شكل `Accessor<string>` خاص بـ Solid. إنه مفيد للتنقل القائم على اللغة — على سبيل المثال، لتحديد عنصر التنقل النشط — دون الحاجة إلى إزالة بادئة اللغة يدويًا.
+
+## استيراد `usePathname` في Solid
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## نظرة عامة
+
+يقوم `usePathname` بإنشاء إشارة تفاعلية (reactive signal) مُهيأة من `window.location.pathname`، ويزيل بادئة اللغة عبر `getPathWithoutLocale`، ثم يُحدّث الإشارة كلما أصدر المتصفح حدث `popstate` (التنقل للخلف/للأمام). يتم تنظيف مستمع الحدث (event listener) تلقائيًا عبر `onCleanup`.
+
+## الاستخدام
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## القيمة المرجعة
+
+| النوع              | الوصف                                                                                         |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | Accessor خاص بـ Solid (حصول تفاعلي - getter) يُعيد المسار الحالي (pathname) بدون بادئة اللغة. |
+
+## السلوك
+
+- **إزالة اللغة**: يُزيل الجزء الأمامي للغة من المسار (مثال: `/ar/dashboard` ← `/dashboard`).
+- **تفاعلي**: يتم التحديث تلقائيًا عند وقوع أحداث `popstate` (التنقل للخلف / للأمام في المتصفح).
+- **آمن لـ SSR**: يُعيد `""` عندما لا يكون كائن `window` متاحًا.
+- **التنظيف**: يُزال مستمع `popstate` تلقائيًا من خلال وظيفة `onCleanup` في Solid.
+
+## مثال
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "لوحة التحكم" },
+  { href: "/settings", label: "الإعدادات" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## مواضيع ذات صلة
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/solid-intlayer/useLocale.md) — اللغة الحالية + مفتاح تغيير اللغة
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md) — الأداة الأساسية التي يستخدمها هذا الـ hook

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

@@ -14,6 +14,9 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "إضافة أداة usePathname المساعدة"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توحيد التوثيق لجميع الصادرات"
@@ -71,6 +74,7 @@ import "svelte-intlayer";
 | `useDictionaryAsync`   | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس غير المتزامنة.                                                                      | -                                                                                                                        |
 | `useDictionaryDynamic` | نفس عمل `useDictionary`، لكنه يتعامل مع القواميس الديناميكية.                                                                        | -                                                                                                                        |
 | `useLocale`            | تعيد الـ locale الحالي ودالة لتعيينها.                                                                                               | -                                                                                                                        |
+| `usePathname`          | تُرجع مسار URL الحالي (pathname) كمخزن `Readable<string>` مع إزالة جزء locale. يتفاعل مع أحداث `popstate`.                           | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/svelte-intlayer/usePathname.md)     |
 | `useRewriteURL`        | دالة على جانب العميل لإدارة إعادة كتابة عناوين URL. تقوم بتحديث عنوان URL تلقائيًا إذا كانت هناك قاعدة إعادة كتابة مخصصة للـ locale. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/svelte-intlayer/useRewriteURL.md) |
 | `useIntl`              | تعيد كائن Intl للـ locale الحالي.                                                                                                    | -                                                                                                                        |