@intlayer/docs 9.5.4 → 9.5.6

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: توثيق حزمة astro-intlayer
-description: تكامل Astro مع Intlayer، يوفر إعداد التوجيه القائم على اللغة وإدارة القواميس.
+description: تكامل Astro لـ Intlayer، يوفّر إعداد التوجيه المستند إلى اللغة، البرمجيات الوسيطة، الخطافات، متجر العميل، وإدارة القواميس.
 keywords:
   - astro-intlayer
   - astro
@@ -14,6 +14,9 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "إضافة توثيق خطافات useIntlayer و useDictionary و useLocale والبرمجية الوسيطة وأدوات التنسيق"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لجميع الصادرات"
@@ -22,7 +25,7 @@ author: aymericzip
 
 # حزمة astro-intlayer
 
-توفر حزمة `astro-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات Astro. تقوم بتكوين التوجيه القائم على اللغة وإدارة القواميس.
+توفر حزمة `astro-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات Astro. حيث تقوم بتهيئة التوجيه المستند إلى اللغة، وإدارة القواميس، وإعادة كتابة الصفحات أثناء البناء، وبرمجيات الطلب الوسيطة، والخطافات للوصول إلى المحتوى متعدد اللغات عبر مكونات `.astro` المعروضة على الخادم وسكربتات العميل.
 
 ## التثبيت
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### التكامل
 
-توفر حزمة `astro-intlayer` تكاملًا مع Astro لإعداد Intlayer في مشروعك.
+توفر حزمة `astro-intlayer` تكامل Astro يقوم بإعداد Intlayer في مشروعك.
 
 استيراد:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-أو إضافة إلى `astro.config.mjs`:
+أو استيراد افتراضي في `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| الدالة     | الوصف                                       |
-| ---------- | ------------------------------------------- |
-| `intlayer` | تكامل Astro يقوم بإعداد Intlayer في مشروعك. |
+| الدالة     | الوصف                                                                                                                                                                                     | المستند ذو الصلة                                                                                              |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | تكامل Astro يجهز القواميس، ويهيئ إضافات Vite (الأسماء المستعارة، وكيل التوجيه، التقليم)، ويسجل تلقائيًا برمجية الطلب الوسيطة، ويُخرج الصفحات المعروضة مسبقًا عبر عناوين URL معاد كتابتها. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/intlayer.md) |
+
+### الخطافات (الخادم والعميل)
+
+استيراد:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| الخطاف          | الوصف                                                                                                                                                   | المستند ذو الصلة                                                                                                        |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | يختار قاموسًا واحدًا بواسطة مفتاحه ويُرجع محتواه المترجم. في واجهة `.astro`، يقرأ لغة الطلب من `Astro.locals`. وفي كود `<script>`، يقرأ من متجر العميل. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | يحول كائن قاموس ويُرجع المحتوى للغة المحددة. يعمل في واجهة المكونات وسكربتات العميل.                                                                    | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | يُرجع اللغة الحالية، واللغة الافتراضية، واللغات المتاحة، ودالة لتحديث اللغة.                                                                            | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/useLocale.md)         |
+
+### البرمجية الوسيطة (astro-intlayer/middleware)
+
+استيراد:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| التصدير     | النوع               | الوصف                                                                                                                                      | المستند ذو الصلة                                                                                                |
+| ----------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | برمجية وسيطة لـ Astro تكتشف لغة الطلب وتربط `Astro.locals.intlayer`. يتم تسجيلها تلقائيًا بواسطة `intlayer()`، أو استيرادها يدويًا لدمجها. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/astro-intlayer/onRequest.md) |
+
+### الأدوات المساعدة
+
+استيراد:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| الدالة              | الوصف                                                                                      | المستند ذو الصلة |
+| ------------------- | ------------------------------------------------------------------------------------------ | ---------------- |
+| `getIntlayerLocals` | دالة مساعدة لاسترداد كائن `IntlayerLocals` الحالي من نطاق تخزين الطلب خارج `Astro.locals`. | -                |
+
+### أدوات العميل (astro-intlayer/client)
+
+استيراد:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+عند استيرادها في المتصفح أو داخل وسوم `<script>` للعميل، يتم تعيين `astro-intlayer` تلقائيًا إلى `astro-intlayer/client` (المدعوم بواسطة `vanilla-intlayer`)، مما يوفر أدوات استرداد القواميس والاشتراك في المتجر وحفظ اللغة على جانب العميل.
+
+### أدوات التنسيق (astro-intlayer/format)
+
+استيراد:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| الخطاف            | الوصف                                                                                    |
+| ----------------- | ---------------------------------------------------------------------------------------- |
+| `useIntl`         | يُرجع مثيل Intl مرتبطًا بلغة الطلب أو العميل مع إمكانيات التخزين المؤقت والاشتراك.       |
+| `useDate`         | يُرجع دالة لتنسيق التاريخ مرتبطة مسبقًا باللغة الحالية (`Intl.DateTimeFormat`).          |
+| `useNumber`       | يُرجع دالة لتنسيق الأرقام مرتبطة مسبقًا باللغة الحالية (`Intl.NumberFormat`).            |
+| `useCurrency`     | يُرجع دالة لتنسيق العملة مرتبطة مسبقًا باللغة الحالية.                                   |
+| `usePercentage`   | يُرجع دالة لتنسيق النسبة المئوية مرتبطة مسبقًا باللغة الحالية.                           |
+| `useRelativeTime` | يُرجع دالة لتنسيق الوقت النسبي مرتبطة مسبقًا باللغة الحالية (`Intl.RelativeTimeFormat`). |
+| `useList`         | يُرجع دالة لتنسيق القوائم مرتبطة مسبقًا باللغة الحالية (`Intl.ListFormat`).              |
+| `useUnit`         | يُرجع دالة لتنسيق الوحدات مرتبطة مسبقًا باللغة الحالية.                                  |
+| `useCompact`      | يُرجع دالة لتنسيق الأرقام المدمجة مرتبطة مسبقًا باللغة الحالية (مثل `1.5K`).             |
+
+### أدوات HTML (astro-intlayer/html)
+
+استيراد:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| التصدير           | النوع      | الوصف                                       |
+| ----------------- | ---------- | ------------------------------------------- |
+| `renderHTML`      | `Function` | دالة مساعدة مستقلة لعرض عُقد HTML.          |
+| `useHTML`         | `Hook`     | خطاف للحصول على سياق وإعدادات مزود HTML.    |
+| `useHTMLRenderer` | `Hook`     | خطاف للحصول على دالة عرض HTML مهيأة مسبقًا. |
+
+### أدوات Markdown (astro-intlayer/markdown)
+
+استيراد:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| التصدير               | النوع      | الوصف                                                         |
+| --------------------- | ---------- | ------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | يترجم سلاسل markdown إلى تمثيل منظم.                          |
+| `renderMarkdown`      | `Function` | يعرض محتوى markdown في عُقد إخراج.                            |
+| `parseMarkdown`       | `Function` | يحلل محتوى markdown الخام إلى شجرة بناء الجملة المجردة (AST). |
+| `useMarkdown`         | `Hook`     | خطاف للحصول على سياق مزود markdown.                           |
+| `useMarkdownRenderer` | `Hook`     | خطاف للحصول على دالة عرض Markdown مهيأة مسبقًا.               |
+
+### الأنواع
+
+استيراد:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| النوع             | الوصف                                                                                                     |
+| ----------------- | --------------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | الكائن المرفق بـ `Astro.locals.intlayer` والذي يحتوي على `locale` و `defaultLocale` و `availableLocales`. |
+| `UseLocaleProps`  | خصائص التهيئة الاختيارية المقبولة بواسطة `useLocale()`.                                                   |
+| `UseLocaleResult` | نوع القيمة المرجعة لـ `useLocale()`، والذي يوفر خصائص اللغة وطرق التحديث.                                 |

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)