@intlayer/docs 9.5.4 → 9.5.5

package/docs/ar/packages/astro-intlayer/intlayer.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: توثيق تكامل intlayer | astro-intlayer
+description: تعرّف على كيفية تهيئة واستخدام تكامل Astro intlayer في ملف astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - تكامل
+  - i18n
+  - التدويل
+  - توثيق
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "تحديث توثيق التكامل بتفاصيل البرمجية الوسيطة والخطافات"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "توثيق أولي"
+author: aymericzip
+---
+
+# توثيق تكامل Astro intlayer
+
+يقوم تكامل `intlayer` لـ Astro بتهيئة مشروعك للتدويل متعدد اللغات (i18n). حيث يتولى إعداد القواميس أثناء البناء، وحقن إضافات Vite، والتسجيل التلقائي لبرمجية الطلب الوسيطة، وإخراج الصفحات المعروضة مسبقًا والمترجمة.
+
+## الاستخدام
+
+أضف `intlayer()` إلى ملف `astro.config.mjs`:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+ينشئ أمر Astro CLI codemod (`astro add astro-intlayer`) أيضًا استيرادًا افتراضيًا مدعومًا:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## الوصف
+
+يرتبط التكامل بدورة حياة البناء والتشغيل في Astro:
+
+1. **إعداد التهيئة (`astro:config:setup`)**:
+   - **إعداد القواميس**: يجهز قواميس Intlayer والأنواع المنشأة قبل بدء عملية البناء.
+   - **إضافات Vite**: يحقن إضافات لأسماء Vite المستعارة (مما يتيح استيراد القواميس بسلاسة)، ووكلاء توجيه اللغة، وتقليم البناء.
+   - **تسجيل البرمجية الوسيطة**: يحقن تلقائيًا `astro-intlayer/middleware` في سلسلة برمجيات مشروعك الوسيطة، ويملأ `Astro.locals.intlayer` مع كل طلب وارد.
+2. **اكتمال البناء (`astro:build:done`)**:
+   - **إعادة كتابة الصفحات**: يفحص قواعد إعادة كتابة عناوين URL المترجمة ويُخرج صفحات HTML المعروضة مسبقًا في مساراتها المترجمة المناسبة.
+
+## ما يتم توفيره افتراضيًا
+
+بمجرد التهيئة، يمكن لتطبيق Astro الخاص بك استخدام ما يلي مباشرة:
+
+- خطافات `useIntlayer` و `useDictionary` و `useLocale` داخل واجهة مكونات `.astro`.
+- كائن `Astro.locals.intlayer` في نقاط النهاية وصفحات Astro.
+- استيرادات جانب العميل في كتل `<script>` التي تعكس نفس واجهة برمجة التطبيقات مع تحديثات تفاعلية.
+- أدوات التنسيق المضمنة ضمن `astro-intlayer/format` (`useDate` و `useNumber` و `useCurrency` إلخ).
+
+## المستندات ذات الصلة
+
+- [خطاف `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useIntlayer.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useLocale.md)
+- [البرمجية الوسيطة `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/onRequest.md)

package/docs/ar/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق البرمجية الوسيطة onRequest | astro-intlayer
+description: تعرّف على كيفية استخدام البرمجية الوسيطة onRequest في تطبيقات Astro لتحديد لغة الطلب وملء Astro.locals.intlayer.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - التدويل
+  - توثيق
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي"
+author: aymericzip
+---
+
+# توثيق برمجية Astro الوسيطة onRequest
+
+تقوم البرمجية الوسيطة `onRequest` من `astro-intlayer/middleware` بتحديد لغة كل طلب HTTP وارد وملء `Astro.locals.intlayer`.
+
+عند تسجيل تكامل `intlayer()` في `astro.config.mjs`، يتم حقن هذه البرمجية الوسيطة تلقائيًا. تحتاج فقط إلى استيرادها مباشرة إذا كنت تقوم بتركيب برمجيات Astro الوسيطة يدويًا باستخدام `sequence(...)`.
+
+## الاستخدام
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // الوصول إلى اللغة المحددة في برمجيتك الوسيطة المخصصة
+  const { locale } = context.locals.intlayer;
+  console.log(`معالجة الطلب للغة: ${locale}`);
+
+  return next();
+});
+```
+
+## الوصف
+
+تقوم البرمجية الوسيطة بالإجراءات التالية:
+
+1. **اكتشاف اللغة**:
+   - **URL**: يحلل بادئة مسار URL أو معلمة البحث `?locale=` (ما لم يتم تعيين `routing.mode` على `no-prefix`).
+   - **ملفات تعريف الارتباط / الترويسات**: يتحقق من ملفات تعريف الارتباط المحفوظة للغة أو قيم الترويسات المخصصة.
+   - **Accept-Language**: يعتمد على تفاوض اللغة المفضلة للمتصفح كحل احتياطي.
+   - بالنسبة للصفحات المعروضة مسبقًا (`context.isPrerendered`)، يتم استخراج اللغة بدقة من عنوان URL لمنع تحذيرات بناء Astro.
+2. **ملء السياق**: يملأ `Astro.locals.intlayer` بما يلي:
+   - `locale`: اللغة المحددة.
+   - `defaultLocale`: اللغة الاحتياطية الافتراضية.
+   - `availableLocales`: مصفوفة اللغات المكونة.
+3. **نطاق AsyncLocalStorage**: يغلف معالجة الطلب اللاحقة داخل نطاق `AsyncLocalStorage`، مما يسمح لـ `useIntlayer()` و `useDictionary()` و `useLocale()` بالوصول إلى حالة الطلب دون تمرير معاملات.
+
+## نوع `IntlayerLocals`
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## المستندات ذات الصلة
+
+- [تكامل `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/intlayer.md)
+- [خطاف `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useIntlayer.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق خطاف useDictionary | astro-intlayer
+description: تعرّف على كيفية استخدام خطاف useDictionary في مكونات وسكربتات Astro لتحليل كائنات القاموس.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - التدويل
+  - توثيق
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي"
+author: aymericzip
+---
+
+# توثيق خطاف useDictionary
+
+يقوم خطاف `useDictionary` بتحليل كائن قاموس مستورد أو مضمن ويُرجع محتواه للغة الحالية في تطبيقات Astro.
+
+على عكس `useIntlayer`، الذي يسترد القواميس بالمفتاح من سجل القواميس العام، يعمل `useDictionary` مباشرة مع كائن القاموس.
+
+## الاستخدام
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+يمكنك أيضًا تمرير قواميس مضمنة محددة باستخدام `t()`:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      ar: "جميع الحقوق محفوظة.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## المعاملات
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: كائن قاموس أو مجموعة قواميس مؤهلة.
+2. **`localeOrSelector`** (اختياري): لغة محددة أو كائن محدد (`{ item }`، `{ variant }`، مع `locale` اختياريًا).
+
+## الوصف
+
+يقوم الخطاف بالمهام التالية:
+
+1. **اكتشاف اللغة**: على الخادم، يحصل على اللغة من `Astro.locals.intlayer`. في المتصفح، يستخدم لغة متجر جانب العميل.
+2. **معالجة المحتوى**: يحلل الترجمات (`t()`) والتعدادات والشروط والهياكل المتداخلة وفقًا للغة المحددة.
+3. **المحددات**: يطبق أي محددات عناصر أو متغيرات متوفرة في المعاملات.
+
+## المستندات ذات الصلة
+
+- [تكامل `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/intlayer.md)
+- [خطاف `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useIntlayer.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق خطاف useIntlayer | astro-intlayer
+description: تعرّف على كيفية استخدام خطاف useIntlayer في مكونات Astro وسكربتات العميل للوصول إلى المحتوى المترجم.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - التدويل
+  - توثيق
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي"
+author: aymericzip
+---
+
+# توثيق خطاف useIntlayer
+
+يتيح لك خطاف `useIntlayer` استرداد محتوى القاموس المترجم بواسطة المفتاح في تطبيقات Astro.
+
+يمكن استدعاؤه في سياقين مختلفين باستخدام نفس مسار الاستيراد:
+
+1. **الخادم / Frontmatter**: داخل ملفات `.astro`، يحلل المحتوى تلقائيًا باستخدام لغة الطلب المخزنة في `Astro.locals.intlayer`.
+2. **المتصفح / وسم `<script>` للعميل**: داخل سكربتات العميل أو مكونات أطر عمل واجهة المستخدم، يحل إلى تطبيق متجر جانب العميل (`vanilla-intlayer`).
+
+## الاستخدام
+
+### في Frontmatter الخاص بمكون Astro
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### في كتل `<script>` للعميل
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## المعاملات
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: المفتاح الفريد للقاموس (كما هو محدد في ملفات تعريف `.content.ts`).
+2. **`localeOrSelector`** (اختياري): لغة محددة أو كائن محدد (`{ item }`، `{ variant }`، مع `locale` اختياريًا). عند تمريره، فإنه يتجاوز اللغة المكتشفة من سياق الطلب أو متجر العميل.
+
+## الوصف
+
+يقوم الخطاف بالمهام التالية:
+
+1. **تحديد اللغة**:
+   - على الخادم، يقرأ اللغة النشطة من `Astro.locals.intlayer` عبر نطاق `AsyncLocalStorage` الذي تم إنشاؤه بواسطة `astro-intlayer/middleware`.
+   - في المتصفح، يقرأ اللغة النشطة من تخزين/متجر العميل.
+2. **استرداد القاموس**: يدرج محتوى القاموس المطابق للمفتاح المحدد.
+3. **معالجة الترجمة**: يحلل الترجمات (`t()`) والتعدادات والشروط وmarkdown إلى محتوى جاهز للعرض.
+
+## المستندات ذات الصلة
+
+- [تكامل `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/intlayer.md)
+- [خطاف `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useDictionary.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق خطاف useLocale | astro-intlayer
+description: تعرّف على كيفية استخدام خطاف useLocale في تطبيقات Astro للوصول إلى اللغة الحالية وإدارتها.
+keywords:
+  - useLocale
+  - locale
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - التدويل
+  - توثيق
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي"
+author: aymericzip
+---
+
+# توثيق خطاف useLocale
+
+يوفر خطاف `useLocale` من `astro-intlayer` إمكانية الوصول إلى لغة الطلب الحالية واللغة الافتراضية المكونة وجميع اللغات المتاحة في تطبيقات Astro.
+
+وهو يعمل بشكل متسق عبر واجهة مكونات `.astro` المعروضة على الخادم وكتل `<script>` على جانب العميل.
+
+## الاستخدام
+
+### في Frontmatter المكون (معروض على الخادم)
+
+```astro fileName="src/layouts/Layout.astro"
+---
+import { useLocale } from "astro-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+const { locale, defaultLocale, availableLocales } = useLocale();
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<!DOCTYPE html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <title>Astro + Intlayer</title>
+  </head>
+  <body>
+    <header>
+      <span>الحالية: {locale}</span>
+      <span>الافتراضية: {defaultLocale}</span>
+      <nav>
+        <ul>
+          {availableLocales.map((localeItem) => (
+            <li key={localeItem} className="p-1">
+              <a
+                href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                aria-current={localeItem === locale ? "page" : undefined}
+              >
+                {localeItem.toUpperCase()}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+    <slot />
+  </body>
+</html>
+```
+
+### في `<script>` العميل (تفاعلي)
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import { useLocale } from "astro-intlayer";
+
+const { locale, availableLocales } = useLocale();
+---
+
+<select id="locale-select">
+  {availableLocales.map((loc) => (
+    <option value={loc} selected={loc === locale}>
+      {loc.toUpperCase()}
+    </option>
+  ))}
+</select>
+
+<script>
+  import { useLocale, setLocaleInStorage } from "astro-intlayer";
+
+  const { setLocale } = useLocale();
+
+  document.getElementById("locale-select")?.addEventListener("change", (e) => {
+    const target = e.target as HTMLSelectElement;
+    setLocale(target.value);
+  });
+</script>
+```
+
+## القيم المرجعة
+
+يُرجع الخطاف كائنًا من النوع `UseLocaleResult`:
+
+| الخاصية            | النوع                                  | الوصف                                                                            |
+| ------------------ | -------------------------------------- | -------------------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`                      | اللغة النشطة.                                                                    |
+| `defaultLocale`    | `DeclaredLocales`                      | اللغة الاحتياطية الافتراضية المكونة في `intlayer.config.ts`.                     |
+| `availableLocales` | `DeclaredLocales[]`                    | مصفوفة بجميع اللغات المدعومة المكونة للمشروع.                                    |
+| `setLocale`        | `(locale: LocalesValues) => void`      | دالة لتحديث اللغة. (تفاعلية في كود `<script>` للعميل، وتُصدر تحذيرًا أثناء SSR). |
+| `subscribe`        | `(callback: () => void) => () => void` | يشترك في تغييرات اللغة من جانب العميل.                                           |
+
+## سلوك الخادم مقابل العميل
+
+- **أثناء SSR / العرض على الخادم**: يتم عرض الطلب مرة واحدة بمعلمات ثابتة. استدعاء `setLocale()` أثناء العرض على الخادم ليس له أي تأثير ويصدر تحذيرًا؛ يجب إجراء تبديل اللغة على العميل أو عن طريق الانتقال إلى عنوان URL الخاص باللغة المستهدفة.
+- **في سكربتات العميل**: تقوم `setLocale` بتحديث متجر العميل وتحديث ملفات تعريف الارتباط المحفوظة أو التخزين المحلي وفقًا لتكوين Intlayer الخاص بك.
+
+## المستندات ذات الصلة
+
+- [تكامل `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/intlayer.md)
+- [خطاف `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useIntlayer.md)
+- [خطاف `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useDictionary.md)

package/docs/ar/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق سياق Intlayer | remix-intlayer
+description: توثيق مفتاح تخزين سياق طلب Intlayer في تطبيقات Remix 3.
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - سياق الطلب
+  - التدويل
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي لمفتاح سياق Intlayer"
+author: aymericzip
+---
+
+# مفتاح سياق طلب Intlayer
+
+يُستخدم التصدير `Intlayer` كمعرّف لتخزين سياق الطلب في Remix 3. وهو يتيح استرداد حالة Intlayer مباشرة من كائن سياق Remix داخل معالجات المسارات أو البرمجيات الوسيطة المخصصة.
+
+## الاستخدام
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/current-locale", (context) => {
+  const intlayerState = context.get(Intlayer);
+
+  return Response.json({
+    locale: intlayerState?.locale,
+  });
+});
+```
+
+## الوصف
+
+يتم استخدام `Intlayer` بواسطة البرمجية الوسيطة `intlayer()` لربط حالة الجلسة الحالية بسياق طلب Remix (`RequestContext`). من المفضل عادةً استخدام خطافات مثل `useLocale()` أو `useIntlayer()`. يُعد الوصول المباشر عبر `context.get(Intlayer)` مفيدًا في معالجات البرمجيات الوسيطة منخفضة المستوى أو مسارات API حيث يتم تمرير مثيل السياق بشكل صريح.
+
+## المستندات ذات الصلة
+
+- [البرمجية الوسيطة `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/intlayerMiddleware.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,80 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق حزمة remix-intlayer
+description: توثيق صادرات حزمة remix-intlayer التي توفر التدويل (i18n) لتطبيقات Remix 3.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - intlayer
+  - التدويل
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي لصادرات remix-intlayer"
+author: aymericzip
+---
+
+# حزمة remix-intlayer
+
+توفر حزمة `remix-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات Remix 3. وتتضمن برمجية وسيطة (middleware) لاكتشاف لغة الطلب، والوصول إلى سياق الطلب، وخطافات (hooks) لجلب القواميس وإدارة اللغات.
+
+## التثبيت
+
+```bash
+npm install remix-intlayer
+```
+
+## صادرات الحزمة
+
+### البرمجيات الوسيطة (Middleware)
+
+| التصدير    | النوع             | الوصف                                                                                | المستند المرتبط                                                                                                                          |
+| ---------- | ----------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | دالة برمجية وسيطة | برمجية وسيطة لـ Remix 3 تكتشف لغة الطلب وتدير عمليات إعادة التوجيه وتملأ سياق الطلب. | [البرمجية الوسيطة intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### تخزين السياق
+
+| التصدير    | النوع                        | الوصف                                                                                           | المستند المرتبط                                                                                                    |
+| ---------- | ---------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `Intlayer` | مفتاح RequestContext / تخزين | مفتاح سياق الطلب المستخدم لاسترداد حالة Intlayer من سياق طلب Remix 3 (`context.get(Intlayer)`). | [سياق Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/Intlayer.md) |
+
+### الخطافات (Hooks)
+
+| التصدير         | النوع | الوصف                                                                                   | المستند المرتبط                                                                                                              |
+| --------------- | ----- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | خطاف  | يجلب محتوى القاموس ويعالجه للمفتاح المحدد وفقًا للغة الطلب الحالية.                     | [خطاف useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | خطاف  | يُرجع محتوى كائن قاموس تم استيراده مسبقًا والمطابق للغة الطلب الحالية.                  | [خطاف useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | خطاف  | يوفر الوصول إلى لغة الطلب الحالية، واللغة الافتراضية، وقائمة اللغات المتاحة في المشروع. | [خطاف useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useLocale.md)         |
+
+## البدء السريع
+
+### تكوين الموجه مع البرمجية الوسيطة
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+### استخدام المحتوى في المكونات والقوالب
+
+```ts fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `<h1>${content.title}</h1><p>${content.description}</p>`;
+};
+```

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

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: توثيق البرمجية الوسيطة intlayer | remix-intlayer
+description: تعرّف على كيفية استخدام البرمجية الوسيطة intlayer في Remix 3 لاكتشاف اللغة والتعامل مع عمليات إعادة التوجيه وحقن حالة Intlayer في سياق الطلب.
+keywords:
+  - intlayer
+  - middleware
+  - remix
+  - remix-3
+  - التدويل
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "توثيق أولي للبرمجية الوسيطة intlayer"
+author: aymericzip
+---
+
+# البرمجية الوسيطة intlayer
+
+تُعد دالة البرمجية الوسيطة `intlayer` مسؤولة عن إعداد التدويل لكل طلب في تطبيقات Remix 3. حيث تكتشف لغة كل طلب وارد، وتطبق قواعد إعادة توجيه URL، وتحفظ حالة اللغة في سياق الطلب.
+
+## الاستخدام
+
+سجّل البرمجية الوسيطة في موجه Remix الخاص بك:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+## كيف تعمل
+
+تؤدي البرمجية الوسيطة المهام التالية لكل طلب وارد:
+
+1. **اكتشاف اللغة**: تستخرج اللغة من بادئة مسار URL (مثل `/ar/about`) أو ملفات تعريف الارتباط أو ترويسة `Accept-Language` وفقًا لتكوين Intlayer الخاص بك.
+2. **إعادة توجيه URL**: إذا كان المسار المطلوب يفتقر إلى بادئة اللغة وكان التكوين يتطلب توجيهًا بالبادئة، فإن البرمجية الوسيطة تُرجع استجابة إعادة توجيه (302/307/308) إلى عنوان URL المناسب المسبوق بالبادئة.
+3. **ملء سياق الطلب**: تحفظ اللغة المحددة الحالية في سياق طلب Remix باستخدام المفتاح `Intlayer`، مما يتيح للخطافات (`useLocale` و `useIntlayer` و `useDictionary`) استهلاكها مباشرة.
+4. **إدارة ملفات تعريف الارتباط**: تُعيّن ترويسة `Set-Cookie` عند الحاجة إلى الاحتفاظ باللغة المفضلة للمستخدم.
+
+## المستندات ذات الصلة
+
+- [سياق الطلب `Intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/Intlayer.md)
+- [خطاف `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useLocale.md)
+- [خطاف `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/remix-intlayer/useIntlayer.md)