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

package/docs/ar/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Intlayer v9 الجديد - ما الجديد؟
+description: اكتشف ما هو جديد في Intlayer v9. نقدم حزم توافق جاهزة للاستخدام لمكتبات i18n الشهيرة ودعمًا للمجموعات (Collections) والمتغيرات (Variants) والسجلات الديناميكية (Dynamic Records).
+keywords:
+  - Intlayer
+  - التوافق
+  - الترحيل
+  - المجموعات
+  - المتغيرات
+  - السجلات الديناميكية
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Intlayer v9 الجديد - ما الجديد؟
+
+مرحبًا بكم في Intlayer v9! يمثل هذا الإصدار الرئيسي علامة فارقة ضخمة في تبسيط مسار الترحيل إلى Intlayer من خلال **حزم محولات التوافق (Compat Adapter Packages)** لمكتبات i18n الرئيسية (`react-i18next`, `next-intl`, `vue-i18n`, إلخ) ويضيف دعمًا لهياكل المحتوى الغنية: **المجموعات (Collections)**، **المتغيرات (Variants)**، و**السجلات الديناميكية (Dynamic Records)**.
+
+## جدول المحتويات
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## حزم محولات التوافق (Compat Adapter Packages)
+
+أصبح الترحيل إلى Intlayer من مكتبات i18n الشهيرة أسهل من أي وقت مضى. لقد أنشأنا خمس حزم توافق تعرض **نفس واجهات برمجة التطبيقات العامة (public APIs) تمامًا** مثل مكتبات i18n القياسية ولكنها تفوض جميع أعمال الترجمة إلى Intlayer في وقت التشغيل (runtime).
+
+### عرض نفس واجهة برمجة التطبيقات العامة (Public API) مع كتابة صارمة (Strict Typing)
+
+باستبدال عمليات الاستيراد (imports)، تحصل على جميع مزايا Intlayer (بما في ذلك أمان النوع في وقت التجميع (compile-time type safety) مقابل قواميسك الفعلية) بأقل تغييرات في الكود:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+على سبيل المثال، قم ببساطة بتغيير:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+إلى:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+ستكون مفاتيحك الآن **مكتوبة بشكل صارم (strictly typed)** مقابل قواميس Intlayer الخاصة بك، مما يوفر إكمالًا تلقائيًا كاملاً للمسار النقطي (dot-path auto-completion) في بيئة التطوير المتكاملة (IDE) الخاصة بك!
+
+### إضافات اسم مستعار للمجمّع (Bundler Alias Plugins) (Vite, Next.js, Turbopack)
+
+للسماح بالترحيل دون إعادة كتابة جميع عبارات الاستيراد (import statements) يدويًا، تتضمن كل حزمة محول توافق (compat adapter package) **إضافة مجمّع مخصصة (custom bundler plugin)** (Vite أو Next.js) ضمن المسار الفرعي `/plugin`.
+
+تعيد هذه الإضافات تلقائيًا كتابة عمليات الاستيراد الموجودة (مثل `react-i18next` أو `next-intl`) إلى مكافئاتها `@intlayer/*` في وقت البناء (build time).
+
+#### مثال Next.js (Webpack / Turbopack)
+
+بدلاً من `withIntlayer`، قم بتغليف إعدادات Next.js الخاصة بك باستخدام إضافة التوافق (compat plugin):
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### مثال Vite (React, Vue, Solid, Svelte)
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## محلل وقت التشغيل المشترك (Mutualized Runtime Resolver)
+
+توجه جميع محولات التوافق (compat adapters) الآن حل الترجمة من خلال محلل وقت تشغيل واحد ومحسن للغاية: `@intlayer/core/messageFormat`.
+
+- **رسالة الاستيفاء (Interpolate Message)**: تحل `{{var}}` القياسية (مسافات بيضاء ومسارات نقطية)، وسيطات ICU المنسقة (`{v, number, percent}` إلخ)، وقوالب `{var}` المجردة.
+- **محلل عقدة الرسالة (Message Node Resolver)**: يحل العقد المتداخلة: `insert()`، `plural()` (قواعد الجمع CLDR)، `enu()` (التعداد)، `gender()`، علامات HTML، المصفوفات، وعقد الوظائف القابلة للاستدعاء.
+- **محلل العلامات المرمزة (Tokenized Tag Parser)**: يدعم علامات XML/HTML المضمنة والعلامات المرقمة (مثل `<1>children</1>`) لتشغيل عرض النص الغني (rich-text rendering) بشكل جاهز.
+
+---
+
+## مواصفات الميزة: المجموعات (Collections)، المتغيرات (Variants) والسجلات الديناميكية (Dynamic Records)
+
+يتوسع Intlayer v9 إلى ما هو أبعد من كائنات المفتاح-القيمة الثابتة، مما يسمح للقواميس بالإعلان عن هياكل تخطيط ديناميكية مكتوبة بالكامل من البداية إلى النهاية.
+
+### 1. المجموعات (Collections)
+
+حدد قائمة من العناصر المرتبة التي يديرها نظام إدارة المحتوى (CMS) (مثل الأسئلة الشائعة، المنتجات، أو قوائم المدونات):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        ar: "ما هو Intlayer؟",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        ar: "مجموعة أدوات i18n.",
+        en: "An i18n toolkit.",
+        fr: "Une boîte أدوات i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### الاستخدام:
+
+```ts
+// جلب جميع العناصر
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// جلب عنصر واحد حسب الفهرس
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. المتغيرات (Variants)
+
+قدم اختبارات A/B، رؤوس صفحات موسمية، علامات ميزات (feature flags)، أو صفحات هبوط مخصصة:
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ ar: "مرحباً", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      ar: "تسوق الآن",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### الاستخدام:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. السجلات الديناميكية (Dynamic Records)
+
+حدد القواميس التي يتم تحميل إدخالاتها ديناميكيًا في وقت التشغيل (runtime) عبر معرفات الاستعلام (query IDs):
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  meta: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ ar: "كود نظيف", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### الاستخدام:
+
+```ts
+// يجلب العنصر المطلوب فقط ديناميكيًا (يتطلب Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## التحميل الديناميكي وتحسينات حجم الحزمة (Bundle Size Optimizations)
+
+للحفاظ على أحجام الحزم (bundles) صغيرة للغاية، يدعم Intlayer v9 التحميل الكسول الديناميكي (dynamic lazy loading).
+
+في إعداداتك، اضبط `importMode` على `'dynamic'` أو `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+في وقت البناء (build time)، يقوم `@intlayer/swc` و`@intlayer/babel` بمسح ملفاتك واستبدال استدعاءات `useIntlayer` / `getIntlayer` بـ wrappers قابلة للإزالة (tree-shakeable wrappers) (`useDictionary` / `useDictionaryDynamic`). يتم تحميل المحتوى المطلوب فقط للعنصر المحدد في المجموعة (collection item)، أو المتغير (variant)، أو اللغة (locale)، مما يمنع حزمة الإنتاج (production bundle) الخاصة بك من احتواء ترجمات غير مستخدمة.
+
+---
+
+## ملاحظات الترحيل من الإصدار 8
+
+إذا كنت تقوم بالترقية من الإصدار 8، لاحظ أن الإصدار 9 لا يتضمن تغييرات جذرية (breaking changes). ولكن إليك التغييرات الرئيسية:
+
+- **اللغات واللهجات (Locales & Dialects)**: إذا كنت تستخدم تبعيات i18n خارجية، أضف إضافات محول التوافق (compat adapter plugins) الخاصة بها في إعداداتك أو إعداد المجمّع (bundler setup) لإعادة كتابة عمليات الاستيراد (imports) تلقائيًا.
+- **المحددات المخصصة (Custom Selectors)**: عند استدعاء `useIntlayer`، تم حجز المعامل الثاني الآن لكائن خيارات يحتوي على `{ locale, item, variant, id }`. إذا كنت قد مررت سابقًا سلسلة لغة (locale string) مباشرة، فلا يزال بإمكانك القيام بذلك، ولكن يوصى باستخدام كائن الخيارات للاختيارات المتقدمة.
+
+---
+
+## روابط مفيدة
+
+- [دليل حزم محولات التوافق (Compat Adapter Packages Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md)
+- [القواميس الديناميكية - المجموعات (Collections)، المتغيرات (Variants) والسجلات الديناميكية (Dynamic Records)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md)
+- [مرجع الإعدادات (Configuration Reference)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)

package/docs/bn/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "scan কমান্ড যোগ করা হয়েছে"
   - version: 8.6.4

package/docs/bn/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "scan কমান্ড যোগ করা হয়েছে"
 author: aymericzip

package/docs/bn/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: কনফিগারেশন (Configuration)
 description: আপনার অ্যাপ্লিকেশনের জন্য Intlayer কীভাবে কনফিগার করবেন তা শিখুন। আপনার প্রয়োজন অনুযায়ী Intlayer কাস্টমাইজ করতে উপলব্ধ বিভিন্ন সেটিংস এবং বিকল্পগুলি বুঝুন।
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "ডিকশনারি কনফিগারেশনে `format` অপশন যোগ করা হয়েছে"
   - version: 8.9.4
     date: 2026-05-12
     changes: "LM Studio প্রদানকারীর জন্য সমর্থন যোগ করুন"
@@ -135,6 +138,7 @@ Intlayer JSON, JS, MJS এবং TS কনফিগারেশন ফাইল
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -576,9 +580,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * প্লাগইনস কনফিগারেশন।
+   * ডিকশনারি কনফিগারেশন।
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * ডিকশনারি কিভাবে ইম্পোর্ট করা হবে তা নিয়ন্ত্রণ করে。
+     * - "static": বিল্ড টাইমে স্ট্যাটিকভাবে ইম্পোর্ট করা হয়。
+     * - "dynamic": Suspense ব্যবহার করে ডাইনামিকভাবে ইম্পোর্ট করা হয়。
+     * - "fetch": লাইভ সিঙ্ক API এর মাধ্যমে ডাইনামিকভাবে ফেচ করা হয়।
+     */
+    importMode: "static",
+
+    /**
+     * প্রজেক্টের সমস্ত ডিকশনারির জন্য ডিফল্ট মেসেজ ফরম্যাট。
+     * - 'intlayer': নেটিভ intlayer ফরম্যাট (ডিফল্ট)।
+     * - 'icu': ICU মেসেজ ফরম্যাট。
+     * - 'i18next': i18next ফরম্যাট。
+     * - 'vue-i18n': Vue I18n ফরম্যাট。
+     * - 'po': GNU Gettext PO ফরম্যাট।
+     */
+    format: "icu",
+  },
+
+  /**
+   * প্লাগিন কনফিগারেশন।
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -855,6 +887,7 @@ export default config;
 | `contentAutoTransformation` | কন্টেন্ট স্ট্রিংগুলোকে স্বয়ংক্রিয়ভাবে টাইপ করা নোডে রূপান্তর করে (মার্কডাউন, HTML অথবা ইনসারশন)।                                                 | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • মার্কডাউন : `### Title` → `md('### Title')` ।<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` ।<br/>• ইনসারশন : `Hello {{name}}` → `insert('Hello {{name}}')` ।                                                                                                                                                                                                                                  |
 | `location`                  | ডিকশনারি ফাইলগুলো কোথায় সংরক্ষিত এবং সেগুলো CMS এর সাথে কীভাবে সিঙ্ক করা হয় তা নির্দেশ করে।                                                      | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: কেবল স্থানীয় ম্যানেজমেন্ট।<br/>• `'remote'`: কেবল দূরবর্তী ম্যানেজমেন্ট (CMS)।<br/>• `'hybrid'`: স্থানীয় এবং দূরবর্তী উভয় ম্যানেজমেন্ট।<br/>• `'plugin'` বা কাস্টম স্ট্রিং: প্লাগইন বা কাস্টম সোর্স দ্বারা ম্যানেজমেন্ট।                                                                                                                                                                        |
 | `importMode`                | ডিকশনারি কীভাবে ইম্পোর্ট করা হয় তা নিয়ন্ত্রণ করে।                                                                                                | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: স্ট্যাটিক ইম্পোর্ট।<br/>• `'dynamic'`: Suspense এর মাধ্যমে ডাইনামিক ইম্পোর্ট।<br/>• `'fetch'`: লাইভ সিঙ্ক API এর মাধ্যমে ফেচ; ব্যর্থ হলে `'dynamic'` এ ফলব্যাক।<br/>• `@intlayer/babel` এবং `@intlayer/swc` প্লাগইন প্রয়োজন।<br/>• কি (keys) গুলো স্ট্যাটিক্যালি ঘোষিত হতে হবে।<br/>• `optimize` বন্ধ থাকলে এটি উপেক্ষা করা হয়।<br/>• `getIntlayer`, `getDictionary` ইত্যাদিকে প্রভাবিত করে না। |
+| `format`                    | প্রজেক্টের সমস্ত ডিকশনারির জন্য ডিফল্ট মেসেজ ফরম্যাট।                                                                                              | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: নেটিভ intlayer ফরম্যাট।<br/>• `'icu'`: ICU মেসেজ ফরম্যাট।<br/>• `'i18next'`: i18next ফরম্যাট।<br/>• `'vue-i18n'`: Vue I18n ফরম্যাট।<br/>• `'po'`: GNU Gettext PO ফরম্যাট。                                                                                                                                                                                                                      |
 | `priority`                  | ডিকশনারি অগ্রাধিকার। ডিকশনারিগুলোর মধ্যে সংঘর্ষ সমাধানের সময় উচ্চতর মান নিম্নতর মানের ওপর বিজয়ী হয়।                                             | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `live`                      | অপ্রচলিত - `importMode: 'fetch'` ব্যবহার করুন। ডিকশনারি কন্টেন্ট লাইভ সিঙ্ক API এর মাধ্যমে ডাইনামিকভাবে ফেচ করা হবে কি না তা নির্দেশ করা হতো।      | `boolean`                                                                                                       | `undefined`  |                                                                                             | v8.0.0-এ এর নাম পরিবর্তন করে `importMode: 'fetch'` করা হয়েছে।                                                                                                                                                                                                                                                                                                                                                  |
 | `schema`                    | JSON স্কিমা ভ্যালিডেশনের জন্য Intlayer দ্বারা স্বয়ংক্রিয়ভাবে জেনারেট করা।                                                                        | `'https://intlayer.org/schema.json'`                                                                            | অটো-জেনারেশন |                                                                                             | ম্যানুয়ালি এডিট করবেন না।                                                                                                                                                                                                                                                                                                                                                                                      |

package/docs/cs/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Přidán obsah příkazu scan"
   - version: 8.6.4

package/docs/cs/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Přidán obsah příkazu scan"
 author: aymericzip

package/docs/cs/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: Konfigurace (Configuration)
 description: Naučte se, jak nakonfigurovat Intlayer pro vaši aplikaci. Porozumějte různým nastavením a možnostem dostupným pro přizpůsobení Intlayer vašim potřebám.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Přidání možnosti `format` do konfigurace slovníku"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Přidána podpora pro poskytovatele LM Studio"
@@ -135,6 +138,7 @@ Intlayer přijímá formáty konfiguračních souborů JSON, JS, MJS a TS:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -582,10 +586,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * Konfigurace slovníku.
+   */
+  dictionary: {
+    /**
+     * Řídí, jak se slovníky importují.
+     * - "static": Staticky importováno v době sestavení.
+     * - "dynamic": Dynamicky importováno pomocí Suspense.
+     * - "fetch": Dynamicky načteno přes API pro živou synchronizaci.
+     */
+    importMode: "static",
+
+    /**
+     * Výchozí formát zpráv pro všechny slovníky v projektu.
+     * - 'intlayer': Nativní formát intlayer (výchozí).
+     * - 'icu': Formát zpráv ICU.
+     * - 'i18next': Formát i18next.
+     * - 'vue-i18n': Formát Vue I18n.
+     * - 'po': Formát GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
   /**
    * Konfigurace pluginů.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -862,6 +894,7 @@ Parametry ovládající operace se slovníky, včetně chování automatického
 | `contentAutoTransformation` | Automaticky transformuje řetězce obsahu do typovaných uzlů (markdown, HTML nebo vložení).                                                                 | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`       | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Vložení : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                 |
 | `location`                  | Udává, kde jsou uloženy soubory slovníků a jak jsou synchronizovány s CMS.                                                                                | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`     | `'hybrid'`                                                                                  | • `'local'`: správa pouze lokálně.<br/>• `'remote'`: správa pouze vzdáleně (CMS).<br/>• `'hybrid'`: správa lokálně i vzdáleně.<br/>• `'plugin'` nebo vlastní řetězec: správa pluginem nebo vlastním zdrojem.                                                                                                                                                                               |
 | `importMode`                | Ovládá způsob importu slovníků.                                                                                                                           | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`    | `'dynamic'`                                                                                 | • `'static'`: statický import.<br/>• `'dynamic'`: dynamický import přes Suspense.<br/>• `'fetch'`: načtení přes Live Sync API; odklad na `'dynamic'` při neúspěchu.<br/>• Vyžaduje pluginy `@intlayer/babel` a `@intlayer/swc`.<br/>• Klíče musí být deklarovány staticky.<br/>• Ignorováno, pokud je `optimize` vypnuto.<br/>• Neovlivňuje `getIntlayer`, `getDictionary` atd.            |
+| `format`                    | Výchozí formát zpráv pro všechny slovníky v projektu.                                                                                                     | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'`  | `'icu'`                                                                                     | • `'intlayer'`: Nativní formát intlayer.<br/>• `'icu'`: Formát zpráv ICU.<br/>• `'i18next'`: Formát i18next.<br/>• `'vue-i18n'`: Formát Vue I18n.<br/>• `'po'`: Formát GNU Gettext PO.                                                                                                                                                                                                     |
 | `priority`                  | Priorita slovníku. Vyšší hodnoty vítězí nad nižšími při řešení konfliktů mezi slovníky.                                                                   | `number`                                                                                                        | `undefined`   | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                            |
 | `live`                      | Zastaralé - použijte `importMode: 'fetch'`. Udávalo, zda se má obsah slovníku načítat dynamicky přes Live Sync API.                                       | `boolean`                                                                                                       | `undefined`   |                                                                                             | Přejmenováno na `importMode: 'fetch'` ve v8.0.0.                                                                                                                                                                                                                                                                                                                                           |
 | `schema`                    | Generováno automaticky Intlayerem pro validaci JSON schématu.                                                                                             | `'https://intlayer.org/schema.json'`                                                                            | auto-generace |                                                                                             | Neupravujte ručně.                                                                                                                                                                                                                                                                                                                                                                         |

package/docs/de/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Dokument überprüfen
 description: Erfahren Sie, wie Sie Dokumentationsdateien auf Qualität, Konsistenz und Vollständigkeit in verschiedenen Sprachversionen überprüfen.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Option --log hinzufügen"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ Für die meisten Anwendungsfälle,
 
 ## Argumente:
 
-Der Befehl `doc review` akzeptiert dieselben Argumente wie `doc translate`, sodass Sie bestimmte Dokumentationsdateien überprüfen und Qualitätsprüfungen anwenden können.
+**Optionen für die Dateiliste:**
 
-Wenn Sie eine der Git-Optionen aktiviert haben, überprüft der Befehl nur die Teile der Dateien, die geändert werden. Das Skript verarbeitet die Datei in Abschnitten (Chunks) und überprüft jeden Abschnitt. Wenn in einem Abschnitt keine Änderungen vorhanden sind, überspringt das Skript diesen, um den Überprüfungsprozess zu beschleunigen und die Kosten für die AI-Provider-API zu begrenzen.
+- **`--doc-pattern [docPattern...]`**: Glob-Muster, um Dokumentationsdateien zur Überprüfung auszuwählen.
 
-Für eine vollständige Liste der Argumente siehe die [Dokumentation zum Befehl „Translate Document“](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-translate.md).
+  > Beispiel: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-Muster, die von der Überprüfung ausgeschlossen werden sollen.
+
+  > Beispiel: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Überspringe die Datei, wenn sie vor dem angegebenen Zeitpunkt geändert wurde.
+  - Kann eine absolute Zeit wie "2025-12-05" sein (String oder Date)
+  - Kann eine relative Zeit in ms sein `1 * 60 * 60 * 1000` (1 Stunde)
+  - Diese Option prüft die Aktualisierungszeit der Datei mit der Methode `fs.stat`. Daher kann sie durch Git oder andere Tools, die die Datei ändern, beeinflusst werden.
+
+  > Beispiel: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Überspringe die Datei, wenn sie innerhalb des angegebenen Zeitraums geändert wurde.
+  - Kann eine absolute Zeit wie "2025-12-05" sein (String oder Date)
+  - Kann eine relative Zeit in ms sein `1 * 60 * 60 * 1000` (1 Stunde)
+  - Diese Option prüft die Aktualisierungszeit der Datei mit der Methode `fs.stat`. Daher kann sie durch Git oder andere Tools, die die Datei ändern, beeinflusst werden.
+
+  > Beispiel: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Überspringe die Datei, wenn sie bereits existiert.
+
+  > Beispiel: `npx intlayer doc review --skip-if-exists`
+
+**Überprüfungsmodus-Optionen:**
+
+- **`--log`**: Nur-Protokollierungsmodus. Nicht mit KI übersetzen; stattdessen die Blöcke, die Aufmerksamkeit erfordern (mit Zeilennummern und Inhalt), für die Basis- und Ziel-Locales protokollieren, um einem anderen Agenten bei der Generierung der Übersetzungen zu helfen.
+
+  > Beispiel: `npx intlayer doc review --log`
+
+**Optionen für die Ausgabe der Einträge:**
+
+- **`--locales [locales...]`**: Ziel-Lokalisierungen, für die die Dokumentation überprüft werden soll.
+
+  > Beispiel: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Quell-Lokalisierung (Basisdokument), mit der verglichen werden soll.
+
+  > Beispiel: `npx intlayer doc review --base-locale en`
+
+**Optionen zur Dateiverarbeitung:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Anzahl der Dateien, die gleichzeitig für die Überprüfung verarbeitet werden.
+
+  > Beispiel: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**KI-Optionen:**
+
+- **`--model [model]`**: Das für die Überprüfung zu verwendende KI-Modell (z. B. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Der für die Überprüfung zu verwendende KI-Anbieter.
+- **`--temperature [temperature]`**: Temperatureinstellung für das KI-Modell.
+- **`--api-key [apiKey]`**: Eigener API-Schlüssel für den KI-Dienst.
+- **`--application-context [applicationContext]`**: Zusätzlicher Kontext für die KI-Überprüfung.
+- **`--data-serialization [dataSerialization]`**: Das Datenserialisierungsformat für die KI-Funktionen von Intlayer. Optionen: `json` (Standard, zuverlässig), `toon` (weniger Token, weniger konsistent).
+- **`--custom-prompt [prompt]`**: Passen Sie den Basis-Prompt an, der für die Überprüfung verwendet wird. (Hinweis: Für die meisten Anwendungsfälle wird stattdessen die Option `--custom-instructions` empfohlen, da sie eine bessere Kontrolle bietet.)
+
+  > Beispiel: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Meine Anwendung ist ein Katzenladen"`
+
+**Optionen für Umgebungsvariablen:**
+
+- **`--env`**: Geben Sie die Umgebung an (z. B. `development`, `production`).
+- **`--env-file [envFile]`**: Geben Sie eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
+- **`--base-dir`**: Geben Sie das Basisverzeichnis für das Projekt an.
+- **`--no-cache`**: Deaktivieren Sie den Cache.
+
+  > Beispiel: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig über CLI auf true gesetzt)
+
+  > Beispiel: `npx intlayer doc review --verbose`
+
+**Optionen für benutzerdefinierte Anweisungen:**
+
+- **`--custom-instructions [customInstructions]`**: Benutzerdefinierte Anweisungen, die dem Prompt hinzugefügt werden. Nützlich, um spezifische Regeln bezüglich Formatierung, URL-Übersetzung usw. anzuwenden.
+
+  > Beispiel: `npx intlayer doc review --custom-instructions "URLs nicht übersetzen und das Markdown-Format beibehalten"`
+
+  > Beispiel: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Git-Optionen:**
+
+- **`--git-diff`**: Nur auf Dateien anwenden, die Änderungen vom Basis-Branch (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+- **`--git-diff-base`**: Basis-Referenz für den Git-Diff angeben (Standard `origin/main`).
+- **`--git-diff-current`**: Aktuelle Referenz für den Git-Diff angeben (Standard: `HEAD`).
+- **`--uncommitted`**: Uncommittete Änderungen einbeziehen.
+- **`--unpushed`**: Nicht gepushte Änderungen einbeziehen.
+- **`--untracked`**: Nicht verfolgte Dateien einbeziehen.
+
+  > Beispiel: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Beispiel: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Beachten Sie, dass der Ausgabepfad der Datei durch Ersetzen der folgenden Muster bestimmt wird:
+>
+> - `/{{baseLocale}}/` durch `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` durch `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` durch `_{{locale}}.`
+> - `{{baseLocale}}_` durch `{{locale}}_`
+> - `.{{baseLocaleName}}.` durch `.{{localeName}}.`
+>
+> Wenn das Muster nicht gefunden wird, wird die Ausgabedatei die Endung `.{{locale}}` erhalten. `./my/file.md` wird überprüft und für die französische Locale zu `./my/file.fr.md` aktualisiert.

package/docs/de/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Befehl scan hinzugefügt"
   - version: 8.6.4

package/docs/de/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Befehl scan hinzugefügt"
 author: aymericzip