@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: وثائق حزمة react-native-intlayer
-description: دعم React Native لـ Intlayer، يوفر موفّرين وpolyfills.
+description: دعم React Native لـ Intlayer، يوفر موفّرين وخطافات وpolyfills وتكوين Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "إعادة تصدير واجهة برمجة تطبيقات react-intlayer الكاملة (الخطافات والأدوات ومسارات format/html/markdown الفرعية) حتى يعتمد تطبيق React Native على react-native-intlayer فقط"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لجميع الصادرات"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # حزمة react-native-intlayer
 
-توفر حزمة `react-native-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات React Native. تتضمن موفّرًا وpolyfills لدعم locales.
+توفر حزمة `react-native-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات React Native. تُعيد تصدير واجهة برمجة تطبيقات `react-intlayer` الكاملة (الخطافات والأدوات) مع `IntlayerProvider` جاهز لـ React Native، بالإضافة إلى polyfills وتكوين Metro المطلوبين بواسطة React Native.
+
+> في تطبيق React Native، قم باستيراد **كل شيء** من `react-native-intlayer`. لا تحتاج إلى تثبيت `react-intlayer` أو استيراده مباشرة.
 
 ## التثبيت
 
@@ -32,16 +37,32 @@ npm install react-native-intlayer
 
 ## الصادرات
 
-### الموفر
+### الموفّر
+
+| المكوّن            | الوصف                                                                             |
+| ------------------ | --------------------------------------------------------------------------------- |
+| `IntlayerProvider` | مكوّن Provider يلف تطبيقك ويوفر سياق Intlayer. يطبّق تلقائيًا polyfills المطلوبة. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### الخطافات والأدوات
 
-| المكوّن            | الوصف                                          |
-| ------------------ | ---------------------------------------------- |
-| `IntlayerProvider` | مكوّن Provider يلف تطبيقك ويوفر سياق Intlayer. |
+يتم إعادة تصدير هذه العناصر من `react-intlayer`، لذلك يمكنك استيرادها مباشرةً من `react-native-intlayer`:
 
-استيراد:
+| الصادر                                                                                                            | الوصف                                          |
+| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `useIntlayer`                                                                                                     | الوصول إلى المحتوى المحلّي لمفتاح قاموس معيّن. |
+| `useLocale`                                                                                                       | قراءة اللغة الحالية وتغييرها.                  |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | تحميل محتوى القاموس بطرق مختلفة.               |
+| `useI18n`                                                                                                         | خطاف متوافق مع i18next.                        |
+| `t`                                                                                                               | مساعد الترجمة المضمّن.                         |
+| `getIntlayer`, `getDictionary`                                                                                    | أدوات استرجاع المحتوى الأمرية.                 |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | مساعدات استمرارية اللغة.                       |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### ملحق التوافق (Polyfill)
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ------------------------------------------------------------ |
 | `intlayerPolyfill` | دالة تطبّق polyfills الضرورية لـ React Native لدعم Intlayer. |
 
-استيراد:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> يتم تطبيق polyfill تلقائيًا عند استيراد `IntlayerProvider`. استدعِ `intlayerPolyfill` يدويًا فقط إذا كنت بحاجة إلى polyfills قبل تحميل الموفّر.
+
+### المنسّقات
+
+خطافات التنسيق المعتمدة على Intl للأرقام والتواريخ وغيرها متاحة من المسار الفرعي `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### عرض Markdown و HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### تكوين Metro
@@ -66,8 +102,6 @@ import "react-native-intlayer";
 | `configMetroIntlayerSync` | دالة متزامنة تدمج تكوين Metro دون تحضير موارد Intlayer.                             |
 | `exclusionList`           | تنشئ نمط RegExp لقائمة الحظر (blockList) في Metro لاستبعاد ملفات المحتوى من الحزمة. |
 
-الاستيراد:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

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`       | هوك لتحميل القواميس الديناميكية.                                                                                       | -                                                                                                                       |