@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

package/docs/ar/dictionary/content_file.md

@@ -582,6 +582,10 @@ export default aboutPageMetaContent;
 
 بالنسبة للقواميس البعيدة، هذا هو المعرف الفريد للقاموس في الخادم البعيد. يُستخدم لجلب وإدارة المحتوى البعيد.
 
+##### `projectIds` (string[])
+
+بالنسبة للقواميس البعيدة، تحتوي هذه المصفوفة على معرّفات المشاريع التي يمكنها استخدام هذا القاموس. يمكن مشاركة القاموس البعيد بين عدة مشاريع.
+
 ##### `localId` (LocalDictionaryId)
 
 معرف فريد للقواميس المحلية. يتم إنشاؤه تلقائيًا بواسطة Intlayer للمساعدة في تحديد القاموس وتحديد ما إذا كان محليًا أو بعيدًا، بالإضافة إلى موقعه.
@@ -602,13 +606,6 @@ export default aboutPageMetaContent;
 
 يشير إلى ما إذا كان القاموس قد تم تعبئته تلقائيًا من مصادر خارجية. في حالة وجود تعارضات، ستتجاوز القواميس الأساسية القواميس المعبأة تلقائيًا.
 
-##### `location` ('distant' | 'locale')
-
-يشير إلى موقع القاموس:
-
-- `'locale'`: قاموس محلي (من ملفات المحتوى)
-- `'distant'`: قاموس بعيد (من مصدر خارجي)
-
 ## أنواع عقد المحتوى
 
 يوفر Intlayer عدة أنواع متخصصة من عقد المحتوى التي توسع القيم الأولية الأساسية:

package/docs/ar/dictionary/enumeration.md

@@ -468,193 +468,6 @@ document.getElementById("ranking")!.textContent = content.ordinal(lastDigit)({
   </Tab>
 </Tabs>
 
-## Combining Enumeration with Insert for Ordinal Numbers
-
-<Tabs group="framework">
-  <Tab label="React" value="react">
-
-To use enumeration in a React component, you can leverage the `useIntlayer` hook from the `react-intlayer` package. This hook retrieves the correct content based on the specified ID. Here's an example of how to use it:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const CarComponent: FC = () => {
-  const { numberOfCar } = useIntlayer("car_count");
-
-  return (
-    <div>
-      <p>
-        {
-          numberOfCar(0) // Output: No cars
-        }
-      </p>
-      <p>
-        {
-          numberOfCar(6) // Output: Some cars
-        }
-      </p>
-      <p>
-        {
-          numberOfCar(20) // Output: Many cars
-        }
-      </p>
-      <p>
-        {
-          numberOfCar(0.01) // Output: Fallback value
-        }
-      </p>
-    </div>
-  );
-};
-```
-
-  </Tab>
-  <Tab label="Next.js" value="nextjs">
-
-To use enumeration in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-"use client";
-
-import type { FC } from "react";
-import { useIntlayer } from "next-intlayer";
-
-const CarComponent: FC = () => {
-  const { numberOfCar } = useIntlayer("car_count");
-
-  return (
-    <div>
-      <p>{numberOfCar(6)}</p>
-    </div>
-  );
-};
-
-export default CarComponent;
-```
-
-  </Tab>
-  <Tab label="Vue" value="vue">
-
-To use enumeration in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```vue fileName="**/*.vue"
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { numberOfCar } = useIntlayer("car_count");
-</script>
-
-<template>
-  <div>
-    <p>{{ numberOfCar(6) }}</p>
-  </div>
-</template>
-```
-
-  </Tab>
-  <Tab label="Svelte" value="svelte">
-
-To use enumeration in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
-
-```svelte fileName="**/*.svelte"
-<script lang="ts">
-import { useIntlayer } from "svelte-intlayer";
-
-const content = useIntlayer("car_count");
-</script>
-
-<div>
-  <p>{$content.numberOfCar(6)}</p>
-</div>
-```
-
-  </Tab>
-  <Tab label="Preact" value="preact">
-
-To use enumeration in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "preact";
-import { useIntlayer } from "preact-intlayer";
-
-const CarComponent: FC = () => {
-  const { numberOfCar } = useIntlayer("car_count");
-
-  return (
-    <div>
-      <p>{numberOfCar(6)}</p>
-    </div>
-  );
-};
-
-export default CarComponent;
-```
-
-  </Tab>
-  <Tab label="Solid" value="solid">
-
-To use enumeration in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
-import type { Component } from "solid-js";
-import { useIntlayer } from "solid-intlayer";
-
-const CarComponent: Component = () => {
-  const { numberOfCar } = useIntlayer("car_count");
-
-  return (
-    <div>
-      <p>{numberOfCar(6)}</p>
-    </div>
-  );
-};
-
-export default CarComponent;
-```
-
-  </Tab>
-  <Tab label="Angular" value="angular">
-
-To use enumeration in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="app.component.ts" codeFormat="typescript"
-import { Component } from "@angular/core";
-import { useIntlayer } from "angular-intlayer";
-
-@Component({
-  selector: "app-car",
-  template: `
-    <div>
-      <p>{{ content().numberOfCar(6) }}</p>
-    </div>
-  `,
-})
-export class CarComponent {
-  content = useIntlayer("car_count");
-}
-```
-
-  </Tab>
-  <Tab label="Vanilla JS" value="vanilla">
-
-To use enumeration with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
-
-```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
-import { installIntlayer, useIntlayer } from "vanilla-intlayer";
-
-installIntlayer();
-
-const content = useIntlayer("car_count").onChange((newContent) => {
-  document.getElementById("cars")!.textContent = newContent.numberOfCar(6);
-});
-
-// Initial render
-document.getElementById("cars")!.textContent = content.numberOfCar(6);
-```
-
-  </Tab>
-</Tabs>
 ## Additional Resources
 
 For more detailed information on configuration and usage, refer to the following resources:

package/docs/ar/dictionary/file.md

@@ -256,6 +256,14 @@ export default myMultilingualContent;
 
 يتيح هذا الإعداد استرجاع المحتوى بشكل ديناميكي بناءً على تفضيل لغة المستخدم. عند استخدامه في محرر Intlayer المرئي أو نظام إدارة المحتوى (CMS)، سيتعرف النظام على أن المحتوى يأتي من ملفات Markdown المحددة ويضمن بقاؤها قابلة للتحرير.
 
+## أنواع المسارات المختلفة
+
+عند استخدام دالة `file`، يمكنك استخدام أنواع مختلفة من المسارات لتحديد الملف المراد دمجه.
+
+- `file("./path/to/file.txt")` - مسار نسبي إلى الملف الحالي
+- `file("path/to/file.txt")` - مسار نسبي إلى دليل جذر المشروع
+- `file("/users/username/path/to/file.txt")` - مسار مطلق
+
 ## كيف يتعامل Intlayer مع محتوى الملفات
 
 تعتمد دالة `file` على وحدة `fs` الخاصة بـ Node.js لقراءة محتوى الملف المحدد وإدراجه في القاموس. عند استخدامها بالتزامن مع محرر Intlayer المرئي أو نظام إدارة المحتوى، يمكن لـ Intlayer تتبع العلاقة بين القاموس والملف. هذا يسمح لـ Intlayer بـ:

package/docs/ar/dictionary/nesting.md

@@ -25,6 +25,45 @@ author: aymericzip
 
 في Intlayer، يتم تحقيق التعشيش من خلال وظيفة `nest`، التي تتيح لك الإشارة إلى وإعادة استخدام المحتوى من قاموس آخر. بدلاً من تكرار المحتوى، يمكنك الإشارة إلى وحدة محتوى موجودة باستخدام مفتاحها.
 
+## إعداد التداخل
+
+لإعداد التداخل في مشروع Intlayer الخاص بك، تقوم أولاً بتعريف المحتوى الأساسي الذي تريد إعادة استخدامه. ثم، في وحدة محتوى منفصلة، تستخدم دالة `nest` لاستيراد هذا المحتوى.
+
+### القاموس الأساسي
+
+فيما يلي مثال على قاموس أساسي للتداخل في قاموس آخر:
+
+```typescript fileName="firstDictionary.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { type Dictionary } from "intlayer";
+
+const firstDictionary = {
+  key: "key_of_my_first_dictionary",
+  content: {
+    content: "content",
+    subContent: {
+      contentNumber: 0,
+      contentString: "string",
+    },
+  },
+} satisfies Dictionary;
+
+export default firstDictionary;
+```
+
+```json fileName="firstDictionary.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "key_of_my_first_dictionary",
+  "content": {
+    "content": "content",
+    "subContent": {
+      "contentNumber": 0,
+      "contentString": "string"
+    }
+  }
+}
+```
+
 ## إعداد التعشيش
 
 <Tabs group="framework">

package/docs/ar/dictionary/translation.md

@@ -268,64 +268,3 @@ document.getElementById("welcome-message")!.textContent = String(
 
   </Tab>
 </Tabs>
-
-## كائنات المحتوى المخصصة
-
-يدعم `intlayer` كائنات المحتوى المخصصة للترجمة، مما يتيح لك تعريف هياكل أكثر تعقيدًا مع ضمان سلامة الأنواع. إليك مثالًا مع كائن مخصص:
-
-```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-interface ICustomContent {
-  title: string;
-  content: string;
-}
-
-const customContent = {
-  key: "custom_content",
-  content: {
-    profileText: t<ICustomContent>({
-      en: {
-        title: "Page Title",
-        content: "Page Content",
-      },
-      fr: {
-        title: "Titre de la Page",
-        content: "Contenu de la Page",
-      },
-      es: {
-        title: "عنوان الصفحة",
-        content: "محتوى الصفحة",
-      },
-    }),
-  },
-} satisfies Dictionary;
-
-export default customContent;
-```
-
-```json fileName="**/*.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "custom_content",
-  "content": {
-    "profileText": {
-      "nodeType": "translation",
-      "translation": {
-        "en": {
-          "title": "عنوان الصفحة",
-          "content": "محتوى الصفحة"
-        },
-        "fr": {
-          "title": "عنوان الصفحة",
-          "content": "محتوى الصفحة"
-        },
-        "es": {
-          "title": "عنوان الصفحة",
-          "content": "محتوى الصفحة"
-        }
-      }
-    }
-  }
-}
-```

package/docs/ar/dynamic_dictionaries/index.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
+updatedAt: 2026-06-26
 title: القواميس الديناميكية
-description: نظرة عامة على ميزات القاموس الديناميكي الثلاثة لـ Intlayer — المجموعات، والمتغيرات، والسجلات الديناميكية — لإنشاء محتوى i18n مرن وموجه لوقت التشغيل.
+description: نظرة عامة على ميزات القواميس الديناميكية في Intlayer — المجموعات والمتغيرات — لبناء محتوى i18n مرن ومُوجَّه في وقت التشغيل.
 keywords:
   - القواميس الديناميكية
   - المجموعات
   - المتغيرات
-  - السجلات الديناميكية
   - Intlayer
-  - تدويل
+  - التدويل
 slugs:
   - doc
   - concept
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "إصدار ميزة القواميس الديناميكية"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "دمج السجلات الديناميكية في المتغيرات — أصبح `variant` يقبل سلسلة نصية أو كائنًا"
 author: aymericzip
 ---
 
 # القواميس الديناميكية
 
-يدعم Intlayer ثلاث آليات للتعبير عن المحتوى الذي يتجاوز قاموساً ثابتاً واحداً لكل مفتاح. يُعلن عن كل منها من خلال **حقل بيانات تعريف (metadata) عالي المستوى** في ملف المحتوى؛ ولا حاجة لوجود دالة تغليف (wrapper).
+يدعم Intlayer آليتين للتعبير عن محتوى يتجاوز قاموسًا ثابتًا واحدًا لكل مفتاح. تُعلَن كل منهما عبر **حقل بيانات وصفية على المستوى الأعلى** في ملف المحتوى؛ ولا حاجة إلى دالة تغليف.
 
-| الميزة                                                                                                                       | حقل البيانات التعريفية | المحدد في `useIntlayer` |
-| ---------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ----------------------- |
-| [المجموعات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/collections.md)               | `item: N`              | `{ item: N }`           |
-| [المتغيرات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/variants.md)                  | `variant: "name"`      | `{ variant: "name" }`   |
-| [السجلات الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }`      | `{ id, … }`             |
+| الميزة                                                                                                         | حقل البيانات الوصفية                    | المُحدِّد في `useIntlayer`                      |
+| -------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ----------------------------------------------- |
+| [المجموعات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/collections.md) | `item: N`                               | `{ item: N }`                                   |
+| [المتغيرات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/variants.md)    | `variant: "name"` _أو_ `variant: { … }` | `{ variant: "name" }` _أو_ `{ variant: { … } }` |
 
-تتكامل الآليات الثلاث مع وسيط اللغة (locale) وتدعم التحميل الانتقائي / الكسول (lazy loading) عبر `importMode`.
+كلاهما يتكامل مع وسيط locale ويدعم التحميل الانتقائي / المؤجل عبر `importMode`.
 
-## متى تستخدم كل منها
+## متى تستخدم أيًّا منها
 
-- **المجموعات** — قائمة مرتبة من العناصر المُدارة في ملفات منفصلة (إدخالات الأسئلة الشائعة، منشورات المدونة، المنتجات).
-- **المتغيرات** — بدائل محتوى مسماة لاختبارات A/B، أو اللافتات الموسمية، أو أعلام الميزات (feature flags).
-- **السجلات الديناميكية** — محتوى يتم جلبه في وقت التشغيل بواسطة معرّف غامض (سجلات CMS، النصوص المخصصة للمستخدم).
+- **المجموعات** — قائمة مرتبة من العناصر تُدار في ملفات منفصلة (مدخلات الأسئلة الشائعة، منشورات المدونة، المنتجات).
+- **المتغيرات** — بدائل محتوى مُسمّاة أو منظّمة:
+  - متغير **نصي** لاختبارات A/B، أو اللافتات الموسمية، أو أعلام الميزات؛
+  - متغير **كائني** لسجلات CMS، أو المحتوى الخاص بالمستخدم، أو أي محتوى يُعنوَن بمجموعة من الحقول («السجلات الديناميكية» سابقًا).
 
-## حل تعارض المحددات
+> كانت الإصدارات السابقة تعرض حقل `meta` منفصلًا للمحتوى المُفهرَس حسب السجل. وقد تم دمجه في `variant`: مرّر **كائنًا** إلى `variant` بدلًا من استخدام `meta`.
 
-عندما تتوفر محددات متعددة في قاموس ما، يكون ترتيب الحل كالتالي:
+## إزالة غموض المُحدِّد
+
+قد يُعلِن المفتاح عن البُعدين معًا (مثلًا مجموعة لكل عنصر فيها متغير). ويتم حلّها بالترتيب:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+وهكذا فإن `{ variant: "promo" }` على مفتاح variant × item يُعيد كل عناصر promo كمصفوفة، وإضافة `{ item: 2 }` تُضيّقها إلى مدخلة واحدة.