@intlayer/docs 9.0.0-canary.6 → 9.0.0-canary.8

package/docs/ar/intlayer_with_astro_vanilla.md

@@ -520,6 +520,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Update your `vite.config.ts` to include the `intlayerCompiler` plugin:
 
 ```ts fileName="vite.config.ts"

package/docs/ar/intlayer_with_astro_vue.md

@@ -556,6 +556,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Update your `vite.config.ts` to include the `intlayerCompiler` plugin:
 
 ```ts fileName="vite.config.ts"

package/docs/ar/intlayer_with_lynx+react.md

@@ -206,6 +206,8 @@ if (import.meta.webpackHot) {
 قم بإنشاء ملفات **إعلان المحتوى** في أي مكان في مشروعك (عادةً داخل `src/`)، باستخدام أي من تنسيقات الامتداد التي يدعمها Intlayer:
 
 - `.content.json`
+- `.content.jsonc`
+- `.content.json5`
 - `.content.ts`
 - `.content.tsx`
 - `.content.js`
@@ -213,7 +215,10 @@ if (import.meta.webpackHot) {
 - `.content.mjs`
 - `.content.mjx`
 - `.content.cjs`
-- `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 - إلخ.
 
 مثال:

package/docs/ar/intlayer_with_nextjs_16.md

@@ -962,6 +962,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_nextjs_compiler.md

@@ -583,6 +583,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_react_native+expo.md

@@ -258,6 +258,8 @@ export default RootLayout;
 قم بإنشاء ملفات **إعلان المحتوى** في أي مكان داخل مشروعك (عادةً داخل مجلد `src/`)، باستخدام أي من صيغ الامتداد التي يدعمها Intlayer:
 
 - `.content.json`
+- `.content.jsonc`
+- `.content.json5`
 - `.content.ts`
 - `.content.tsx`
 - `.content.js`
@@ -265,7 +267,10 @@ export default RootLayout;
 - `.content.mjs`
 - `.content.mjx`
 - `.content.cjs`
-- `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 - إلخ.
 
 > **Expo Router (الويب): احتفظ بملفات `.content.*` خارج مجلد `app/`.** يعامل Expo Router كل ملف JavaScript/TypeScript داخل `app/` كمسار. على الويب، يقوم اكتشاف المسار بمسح نظام الملفات مباشرة ولا **يحترم** `resolver.blockList` الخاص بـ Metro، لذلك يتم تسجيل `*.content.ts` الموجود في نفس المكان كمسار. حتى أن ملفًا مثل `app/(tabs)/_layout.content.ts` يتم تحليله كتخطيط (تُقرأ اللاحقة `.content` كلاحقة للمنصة)، مما يتعارض مع `_layout.tsx` الحقيقي ويطرح الخطأ:

package/docs/ar/intlayer_with_react_router_v7.md

@@ -618,6 +618,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 قم بتحديث `vite.config.ts` لتضمين مكون `intlayerCompiler` الإضافي:
 
 ```ts fileName="vite.config.ts"
@@ -627,7 +629,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // يضيف المكون الإضافي للمترجم
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ar/intlayer_with_react_router_v7_fs_routes.md

@@ -583,6 +583,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 قم بتحديث `vite.config.ts` لتضمين مكون `intlayerCompiler` الإضافي:
 
 ```ts fileName="vite.config.ts"
@@ -592,7 +594,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // يضيف المكون الإضافي للمترجم
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ar/intlayer_with_storybook.md

@@ -173,7 +173,13 @@ const config: StorybookConfig = {
     } as const;
 
     const viteConfig = defineConfig(() => ({
-      plugins: [intlayer()],
+      plugins: [
+        intlayer({
+          proxy: {
+            ignore: (req) => req.url?.startsWith("/api"),
+          },
+        }),
+      ],
     }));
 
     return mergeConfig(baseConfig, viteConfig(env));

package/docs/ar/intlayer_with_svelte_kit.md

@@ -597,14 +597,17 @@ goto(localizedPath); // ينتقل إلى /en/about أو /fr/about حسب الل
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 import { sveltekit } from "@sveltejs/kit/vite";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     sveltekit(),
   ],],
 });
@@ -702,6 +705,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_tanstack+solid.md

@@ -210,11 +210,15 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -550,22 +554,25 @@ const RootComponent: ParentComponent = (props) => {
 
 > لاحظ أنه لاستخدام `intlayerProxy` في الإنتاج، تحتاج إلى نقل حزمة `vite-intlayer` من `devDependencies` إلى `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/solid-start/plugin/vite";
 import solid from "vite-plugin-solid";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // يجب وضع الوكيل قبل الخادم إذا كنت تستخدم Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solid(),
@@ -808,9 +815,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
-قم بتحديث `vite.config.ts` الخاص بك لتشمل إضافة `intlayerCompiler`:
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-> بدءًا من الإصدار Intlayer v9، تم دمج المترجم (compiler) مباشرة في إضافة `intlayer()` ويتم تنشيطه تلقائيًا بمجرد تعيين `compiler.enabled` وتهيئة مسار `compiler.output`. أصبح تسجيل `intlayerCompiler()` بشكل منفصل كما هو موضح أدناه اختياريًا الآن — فهو يلغي النسخ المكررة من نفسه إذا تمت إضافته أيضًا. راجع [ملاحظات إصدار v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/releases/v9.md).
+قم بتحديث `vite.config.ts` الخاص بك لتشمل إضافة `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
 import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -825,12 +832,12 @@ export default defineConfig({
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     solidPlugin({ ssr: true }),
     intlayer(),
-    intlayerCompiler(),
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ar/intlayer_with_tanstack.md

@@ -224,11 +224,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -632,22 +636,25 @@ function RootDocument({ children }: { children: ReactNode }) {
 
 > لاحظ أنه لاستخدام `intlayerProxy` في الإنتاج، تحتاج إلى نقل حزمة `vite-intlayer` من `devDependencies` إلى `dependencies`.
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // يجب وضع البروكسي قبل الخادم إذا كنت تستخدم Nitro
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -908,6 +915,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_vite+lit.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -457,7 +463,7 @@ export class MyElement extends LitElement {
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [intlayer(), intlayerProxy()],

package/docs/ar/intlayer_with_vite+preact.md

@@ -812,6 +812,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_vite+react.md

@@ -492,14 +492,17 @@ const App: FC = () => (
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     react(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -803,6 +806,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_vite+react_compiler.md

@@ -213,11 +213,18 @@ export default config;
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ar/intlayer_with_vite+solid.md

@@ -579,6 +579,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_vite+svelte.md

@@ -441,12 +441,12 @@ $: content = useIntlayer('app', locale);
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
@@ -558,6 +558,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/intlayer_with_vite+vanilla.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -449,12 +455,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // يجب وضعه أولاً
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -586,6 +595,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 قم بتحديث `vite.config.ts` الخاص بك لتضمين ملحق `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -595,7 +606,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // يضيف ملحق المترجم
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ar/intlayer_with_vite+vue.md

@@ -608,14 +608,17 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -940,6 +943,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='مترجم Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 ```bash packageManager="npm"
 npm install @intlayer/babel --save-dev
 ```

package/docs/ar/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: توثيق حزمة @intlayer/babel
+description: إضافات Babel لـ Intlayer تُعالج استخراج المحتوى، وتحسين الاستيراد، وتنقية الحقول غير المستخدمة، وتصغير أسماء الحقول أثناء البناء.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internationalization
+  - i18n
+  - compiler
+  - optimize
+  - purge
+  - minify
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "توحيد توثيق جميع الصادرات"
+author: aymericzip
+---
+
+# حزمة @intlayer/babel
+
+توفر حزمة `@intlayer/babel` مجموعة من إضافات Babel المتخصصة لـ Intlayer. تُغطي دورة البناء الكاملة: استخراج تصريحات المحتوى، وإعادة كتابة استدعاءات `useIntlayer` / `getIntlayer` إلى استيرادات قواميس مُحسَّنة، وتنقية الحقول غير المستخدمة، وتصغير أسماء الحقول.
+
+## التثبيت
+
+```bash
+npm install @intlayer/babel
+```
+
+## التصديرات
+
+استيراد:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### الإضافات (Plugins)
+
+| الدالة / الفئة                 | الوصف                                                                                                                                                                           |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | إضافة Babel تستخرج المحتوى القابل للترجمة من ملفات المصدر وتُدرج hooks `useIntlayer` / `getIntlayer` تلقائيًا. مُصمَّمة للاستخدام مع Next.js وأدوات البناء المعتمدة على Babel.  |
+| `intlayerOptimizeBabelPlugin`  | إضافة Babel تُحوِّل استدعاءات `useIntlayer` و`getIntlayer` وتُعيد كتابة استيراداتها إلى استيرادات قواميس JSON مُحسَّنة (ثابتة أو ديناميكية أو عبر fetch).                       |
+| `intlayerPurgeBabelPlugin`     | إضافة Babel تُحلِّل ملفات المصدر وتُعيد كتابة ملفات JSON للقواميس المُجمَّعة لحذف الحقول غير المستخدمة (`build.purge`) أو إعادة تسميتها بأسماء مختصرة (`build.minify`).         |
+| `intlayerMinifyBabelPlugin`    | إضافة Babel تُعيد كتابة ملفات المصدر لاستخدام أسماء الحقول المختصرة المُعيَّنة أثناء مرحلة التصغير (مثلاً `content.title` ← `content.a`). تعتمد على `intlayerPurgeBabelPlugin`. |
+| `makeFieldRenameBabelPlugin`   | دالة مُنشِئة (factory) تُنتج إضافة Babel تُعيد تسمية وصولات حقول محتوى القاموس في ملفات المصدر وفق خريطة `dictionaryKeyToFieldRenameMap` الموجودة في `PruneContext`.            |
+| `makeUsageAnalyzerBabelPlugin` | دالة مُنشِئة تُنتج إضافة Babel تُحلِّل استخدام `useIntlayer` / `getIntlayer` في الكود المصدري وتُجمِّع بيانات استخدام الحقول في `PruneContext` المُشترك.                        |
+| `getSharedPruneContext`        | دالة مساعدة تُعيد كائن `PruneContext` المُشترك للمجلد الأساسي المُحدَّد، أو `null` إن لم يُهيَّأ بعد.                                                                           |
+
+---
+
+### دوال إعداد الإضافات
+
+| الدالة                     | الوصف                                                                                                                               |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | تُحمِّل إعداد Intlayer وتُعيد خيارات `ExtractPluginOptions` جاهزة للاستخدام مع `intlayerExtractBabelPlugin`.                        |
+| `getOptimizePluginOptions` | تُحمِّل إعداد Intlayer والقواميس المُجمَّعة وتُعيد خيارات `OptimizePluginOptions` جاهزة للاستخدام مع `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | تُحمِّل إعداد Intlayer وتُعيد خيارات `PurgePluginOptions` جاهزة للاستخدام مع `intlayerPurgeBabelPlugin`.                            |
+| `getMinifyPluginOptions`   | تُحمِّل إعداد Intlayer وتُعيد خيارات `MinifyPluginOptions` جاهزة للاستخدام مع `intlayerMinifyBabelPlugin`.                          |
+
+---
+
+### الأنواع
+
+| النوع                   | الوصف                                                                                                   |
+| ----------------------- | ------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | وضع المُجمِّع: `'dev'` للتطوير مع دعم HMR أو `'build'` لبناء الإنتاج.                                   |
+| `ExtractPluginOptions`  | خيارات `intlayerExtractBabelPlugin`: قائمة الملفات، الإعداد، callback `onExtract`، وغيرها.              |
+| `ExtractResult`         | نتيجة الاستخراج: مفتاح القاموس، مسار الملف، المحتوى، واللغة.                                            |
+| `OptimizePluginOptions` | خيارات `intlayerOptimizeBabelPlugin`: مسارات القواميس، وضع الاستيراد، خريطة الأوضاع لكل قاموس، إلخ.     |
+| `PurgePluginOptions`    | خيارات `intlayerPurgeBabelPlugin`: المجلد الأساسي، علامات purge/minify/optimize، قائمة ملفات المكوّنات. |
+| `MinifyPluginOptions`   | خيارات `intlayerMinifyBabelPlugin`: المجلد الأساسي، علامات minify/optimize/editorEnabled.               |
+| `PruneContext`          | الحالة المُشتركة بين إضافات التحليل والتنقية: خرائط استخدام الحقول، خرائط إعادة التسمية، إلخ.           |
+| `DictionaryFieldUsage`  | نتيجة استخدام الحقول لقاموس واحد: `Set<string>` أو `'all'` عند تعذُّر التحديد الساكن.                   |
+| `NestedRenameEntry`     | عقدة في شجرة إعادة التسمية: الاسم المختصر `shortName` وخريطة الأبناء `children`.                        |
+| `NestedRenameMap`       | مستوى واحد في شجرة إعادة التسمية: `Map<string, NestedRenameEntry>`.                                     |
+| `CompatCallerConfig`    | إعداد مُحلِّل استخدام مُتوافق لحزم الـ compat-adapter (اسم المُستدعي وخيارات المعالجة).                 |
+| `ScriptBlock`           | كتلة script مستخرجة من ملف SFC (Vue أو Svelte): المحتوى وإزاحتا البداية والنهاية.                       |
+
+---
+
+### الأدوات المساعدة
+
+| الدالة                            | الوصف                                                                                                                            |
+| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | تُحوِّل رقمًا صحيحًا (ابتداءً من الصفر) إلى معرِّف أبجدي مختصر: `0 → 'a'`, `25 → 'z'`, `26 → 'aa'`, إلخ.                         |
+| `buildNestedRenameMapFromContent` | تبني `NestedRenameMap` بصورة مُتكرِّرة من قيمة محتوى قاموس مُجمَّع، مع احترام بنية عقد Intlayer (translation، enumeration، إلخ). |
+| `createPruneContext`              | تُنشئ كائن `PruneContext` فارغًا جديدًا مُهيَّأً بالقيم الافتراضية.                                                              |
+| `extractScriptBlocks`             | تستخرج كتل `<script>` من ملفات SFC (Vue / Svelte) للتحليل اللاحق بـ Babel.                                                       |
+| `BABEL_PARSER_OPTIONS`            | ثابت يُمثِّل خيارات مُحلِّل Babel تُغطي مجموعة الأُطر المدعومة (React/Vue/Svelte/Angular/…).                                     |
+| `INTLAYER_CALLER_NAMES`           | قائمة ثابتة بأسماء المُستدعِيين الأصلية لـ Intlayer: `['useIntlayer', 'getIntlayer']`.                                           |
+
+---
+
+## مثال على الاستخدام
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **ملاحظة:** يجب أن تُدرَج `intlayerPurgeBabelPlugin` **قبل** `intlayerMinifyBabelPlugin`، لأن الأخيرة تقرأ خريطة إعادة التسمية التي تبنيها الأولى. كما يجب أن تسبقهما معًا `intlayerOptimizeBabelPlugin` حتى تتمكّن من رؤية مفاتيح القاموس قبل إعادة كتابة استدعاءات `useIntlayer`.