@intlayer/docs 9.3.2 → 9.3.3

package/docs/uk/configuration.md

@@ -478,6 +478,30 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Групувати чанки словників за локаллю відповідно до межі розділення коду, яка
+     * їх використовує, щоб ліниво завантажена сторінка отримувала свій вміст одним
+     * запитом.
+     * За замовчуванням: true
+     *
+     * Примітка:
+     * - Застосовується лише до словників з `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Завантажувати словник разом із чанком, який його використовує, замість
+     * отримання після рендерингу цього чанка. Читання рендеряться синхронно
+     * замість призупинення, тому під час навігації більше не блимає стан
+     * завантаження.
+     * За замовчуванням: true
+     *
+     * Примітка:
+     * - Очікується лише визначена локаль, тому сторінка завантажує тільки ту мову,
+     *   яку відображає.
+     */
+    dictionariesPreload: true,
+
     /**
      * Формат виводу для згенерованих файлів словників.
      * За замовчуванням: ['cjs', 'esm']
@@ -1054,15 +1078,17 @@ Intlayer підтримує широкий спектр провайдерів A
 
 > Під час оптимізації Intlayer замінює виклики словників для оптимізації поділу коду (chunking), щоб підсумковий пакет імпортував лише ті словники, які фактично використовуються.
 
-| Поле              | Опис                                                                    | Тип                              | За замовчуванням                                                                                                                                                                  | Приклад                                                                       | Примітки                                                                                                                                                                                                                                                                                                           |
-| ----------------- | ----------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `mode`            | Керує режимом збірки.                                                   | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Збірка запускається автоматично під час збірки додатка.<br/>• `'manual'`: Виконується лише через явну команду збірки.<br/>• Може використовуватися для запобігання збірці словників (наприклад, щоб уникнути запуску в середовищі Node.js).                                                            |
-| `optimize`        | Керує виконанням оптимізації збірки.                                    | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Якщо не визначено, оптимізація запускається під час збірки фреймворку (Vite/Next.js).<br/>• `true` форсує оптимізацію навіть у режимі розробки.<br/>• `false` вимикає її.<br/>• Якщо ввімкнено, замінює виклики словників для оптимізації chunking.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`. |
-| `minify`          | Мініфікувати словники для зменшення розміру бандла.                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід мініфікувати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.<br/>• Цей параметр буде ігноруватися, якщо `editor.enabled` має значення true.                                                                              |
-| `purge`           | Видалити невикористані ключі в словниках.                               | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід очищати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.                                                                                                                                                                  |
-| `checkTypes`      | Вказує, чи має збірка перевіряти типи TypeScript та записувати помилки. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Може сповільнити процес збірки.                                                                                                                                                                                                                                                                                    |
-| `outputFormat`    | Керує форматом виводу словників.                                        | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                    |
-| `traversePattern` | Шаблон для файлів, які слід сканувати під час оптимізації.              | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Покращує продуктивність збірки, обмежуючи оптимізацію відповідними файлами.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Використовує glob-патерни.                                                                                                                                                        |
+| Поле                  | Опис                                                                                                                              | Тип                              | За замовчуванням                                                                                                                                                                  | Приклад                                                                       | Примітки                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| --------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | Керує режимом збірки.                                                                                                             | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Збірка запускається автоматично під час збірки додатка.<br/>• `'manual'`: Виконується лише через явну команду збірки.<br/>• Може використовуватися для запобігання збірці словників (наприклад, щоб уникнути запуску в середовищі Node.js).                                                                                                                                                                                                                                                                                           |
+| `optimize`            | Керує виконанням оптимізації збірки.                                                                                              | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Якщо не визначено, оптимізація запускається під час збірки фреймворку (Vite/Next.js).<br/>• `true` форсує оптимізацію навіть у режимі розробки.<br/>• `false` вимикає її.<br/>• Якщо ввімкнено, замінює виклики словників для оптимізації chunking.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`.                                                                                                                                                                                                                                |
+| `minify`              | Мініфікувати словники для зменшення розміру бандла.                                                                               | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід мініфікувати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.<br/>• Цей параметр буде ігноруватися, якщо `editor.enabled` має значення true.                                                                                                                                                                                                                                                                                                             |
+| `purge`               | Видалити невикористані ключі в словниках.                                                                                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Чи слід очищати пакет.<br/>• За замовчуванням: `true` у виробничому середовищі.<br/>• Цей параметр буде ігноруватися, якщо `optimize` вимкнено.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `checkTypes`          | Вказує, чи має збірка перевіряти типи TypeScript та записувати помилки.                                                           | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Може сповільнити процес збірки.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `chunkGrouping`       | Визначає, чи слід групувати чанки словників за локаллю відповідно до межі розділення коду, яка їх використовує.                   | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Без групування сторінка, зібрана з багатьох компонентів, надсилає по одному запиту на кожен словник.<br/>• Словники, досяжні з кількох меж, переносяться до спільного чанка, тому жодна сторінка не містить вміст іншої.<br/>• Застосовується лише до словників з `importMode: 'dynamic'`.<br/>• Застосовується лише до клієнтської збірки і лише під час бандлінгу (не в режимі розробки).                                                                                                                                                     |
+| `dictionariesPreload` | Визначає, чи має словник завантажуватися разом із чанком, який його використовує, замість отримання після рендерингу цього чанка. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Згенерована точка входу очікує локаль перегляду на верхньому рівні, тому ліниво завантажений маршрут не вважається завантаженим, доки його вміст не готовий.<br/>• Читання рендеряться синхронно замість призупинення, тому під час навігації більше не блимає стан завантаження.<br/>• Очікується лише визначена локаль, тому сторінка завантажує тільки ту мову, яку відображає.<br/>• Застосовується лише до словників з `importMode: 'dynamic'` у клієнтській збірці.<br/>• Потребує бандлера з підтримкою top-level await (Vite, esbuild). |
+| `outputFormat`        | Керує форматом виводу словників.                                                                                                  | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `traversePattern`     | Шаблон для файлів, які слід сканувати під час оптимізації.                                                                        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Покращує продуктивність збірки, обмежуючи оптимізацію відповідними файлами.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Використовує glob-патерни.                                                                                                                                                                                                                                                                                                                                                                                       |
 
 ---
 

package/docs/uk/dictionary/content_file.md

@@ -542,28 +542,6 @@ export default aboutPageMetaContent;
 
 > Див. [Варіанти](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/variants.md) для отримання додаткової інформації.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-Використовується разом із Динамічними Записами, це поле дозволяє оголошувати записи, керовані CMS, або довільні дані, отримані під час виконання за непрозорим ID. Ідентичність словника визначається довільним набором пар ключ-значення, оголошених у цьому полі `meta`.
-
-**Приклад:**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> Див. [Динамічні Записи](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/dynamic_content.md) для отримання додаткової інформації.
-
 ### Властивості CMS
 
 ##### `version` (string)

package/docs/uk/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ export default asyncFunctionContent;
 
 У цьому випадку функція `fakeFetch` імітує затримку, щоб симулювати час відповіді сервера. Intlayer виконує асинхронну функцію і використовує результат як вміст для ключа `text`.
 
+## Отримання віддаленого вмісту
+
+Ви також можете призначити проміс безпосередньо полю вмісту. Intlayer дочекається його під час збирання словників і вставить отримане значення:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+Неможливо отримати вміст із JSON-файлу, використовуйте натомість .ts або .js файл
+```
+
+> Запит виконується під час збирання, тому отримані дані — це знімок, вбудований у словник. Перезберіть словники, щоб оновити його.
+
 ## Використання контенту на основі функцій у React-компонентах
 
 Щоб використовувати контент на основі функцій у React-компоненті, потрібно імпортувати `useIntlayer` з `react-intlayer` і викликати його з ідентифікатором контенту, щоб отримати вміст. Ось приклад:

package/docs/uk/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: Плагін ESLint | Правила лінтингу для Intlayer
 description: Знаходьте жорстко закодовані рядки, динамічні виклики, які компілятор Intlayer не може оптимізувати, та невикористаний вміст словників за допомогою eslint-plugin-intlayer. Працює з ESLint та oxlint для React, Vue, Svelte, Angular та Astro.
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-Потрібен ESLint 9 або новішої версії (flat config).
+Потрібен ESLint 9 або новішої версії (flat config). ESLint 10 підтримується.
 
 ## Використання
 
@@ -61,20 +61,20 @@ yarn add --dev eslint-plugin-intlayer
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-Або вмикайте правила окремо:
+Або розгорніть конфігурацію та задайте рівні самостійно:
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **Параметри**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **Параметри**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | Шаблони Angular           | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/docs/ur/configuration.md

@@ -480,6 +480,30 @@ const config: IntlayerConfig = {
      */
     prune: true,
 
+    /**
+     * فی لوکیل ڈکشنری چنکس کو اُس کوڈ اسپلٹ باؤنڈری کے مطابق گروپ کریں جو انہیں
+     * استعمال کرتی ہے، تاکہ سست روی سے لوڈ ہونے والا صفحہ اپنا مواد ایک ہی درخواست
+     * میں حاصل کرے۔
+     * ڈیفالٹ: true
+     *
+     * نوٹ:
+     * - صرف اُن ڈکشنریوں پر لاگو ہوتا ہے جو `importMode: 'dynamic'` استعمال کرتی
+     *   ہیں۔
+     */
+    chunkGrouping: true,
+
+    /**
+     * ڈکشنری کو اُس چنک کے ساتھ لوڈ کریں جو اسے استعمال کرتا ہے، بجائے اس کے کہ وہ
+     * چنک رینڈر ہونے کے بعد اسے حاصل کیا جائے۔ پڑھائی معطل ہونے کے بجائے ہم وقت
+     * رینڈر ہوتی ہے، اس لیے نیویگیشن میں اب لوڈنگ کی حالت نہیں جھلکتی۔
+     * ڈیفالٹ: true
+     *
+     * نوٹ:
+     * - صرف طے شدہ لوکیل کا انتظار کیا جاتا ہے، اس لیے صفحہ صرف وہی زبان ڈاؤن لوڈ
+     *   کرتا ہے جو وہ دکھاتا ہے۔
+     */
+    dictionariesPreload: true,
+
     /**
      * تیار کردہ لغت فائلوں کے لیے آؤٹ پٹ فارمیٹ۔
      * ڈیفالٹ: ['cjs', 'esm']
@@ -1041,15 +1065,17 @@ Intlayer زیادہ سے زیادہ لچک کو یقینی بنانے کے لی
 
 > آپٹیمائزیشن کے دوران، Intlayer لغت کی کالز کو کوڈ اسپلٹنگ (chunking) آپٹیمائزیشن سے بدل دیتا ہے تاکہ حتمی بنڈل صرف وہی لغات امپورٹ کرے جو اصل میں استعمال ہوئی ہیں۔
 
-| فیلڈ              | وضاحت                                                                                | قسم                              | ڈیفالٹ                                                                                                                                                                            | مثال                                                                          | نوٹ                                                                                                                                                                                                                                                                                                                  |
-| ----------------- | ------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | بلڈ ایگزیکیوشن موڈ کو کنٹرول کرتا ہے۔                                                | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: ایپ بلڈ کے دوران خودکار طور پر بلڈ شروع ہوتا ہے۔<br/>• `'manual'`: صرف واضح بلڈ کمانڈ کے ذریعے چلتا ہے۔<br/>• لغت کی بلڈ کو روکنے کے لیے مفید ہو سکتا ہے (مثلاً: Node.js ماحول میں چلنے سے بچنے کے لیے)۔                                                                                                 |
-| `optimize`        | کنٹرول کرتا ہے کہ آیا بلڈ آپٹیمائزیشن کی جاتی ہے۔                                    | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • اگر متعین نہ ہو، تو یہ فریم ورک بلڈ (Vite/Next.js) کے دوران شروع ہوگا۔<br/>• `true` ڈیولپمنٹ موڈ میں بھی آپٹیمائزیشن کو مجبور کرتا ہے۔<br/>• `false` اسے غیر فعال کرتا ہے۔<br/>• اگر فعال ہو، تو لغت کی کالز کو چنکنگ آپٹیمائزیشن سے بدل دیتا ہے۔<br/>• `@intlayer/babel` اور `@intlayer/swc` پلگ انز کی ضرورت ہے۔ |
-| `minify`          | بتاتا ہے کہ آیا بنڈل کے سائز کو کم کرنے کے لیے لغات کو کم (minify) کیا جانا چاہیے۔   | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • بتاتا ہے کہ آیا بنڈل کو منی فائی کرنا ہے۔<br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔<br/>• اگر `editor.enabled` کی ویلیو true ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                         |
-| `prune`           | بتاتا ہے کہ آیا لغات میں غیر استعمال شدہ کلیدوں کو ہٹا دینا (prune) چاہیے۔           | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • بتاتا ہے کہ آیا بنڈل کو پرون (prune) کرنا ہے۔ <br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                                                                                                 |
-| `checkTypes`      | بتاتا ہے کہ آیا بلڈ کو TypeScript اقسام کو چیک کرنا چاہیے اور ایررز لاگ کرنے چاہئیں۔ | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | بلڈ کی کارکردگی کو سست کر سکتا ہے۔                                                                                                                                                                                                                                                                                   |
-| `outputFormat`    | لغت کے آؤٹ پٹ فارمیٹ کو کنٹرول کرتا ہے۔                                              | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                      |
-| `traversePattern` | آپٹیمائزیشن کے دوران اسکین کی جانے والی فائلوں کا پیٹرن۔                             | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • متعلقہ فائلوں تک آپٹیمائزیشن کو محدود کرکے بلڈ کی کارکردگی کو بہتر بناتا ہے۔<br/>• اگر `optimize` غیر فعال ہو تو نظر انداز کر دیا جاتا ہے۔<br/>• گلوب (glob) پیٹرنز استعمال کرتا ہے۔                                                                                                                               |
+| فیلڈ                  | وضاحت                                                                                                                    | قسم                              | ڈیفالٹ                                                                                                                                                                            | مثال                                                                          | نوٹ                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | بلڈ ایگزیکیوشن موڈ کو کنٹرول کرتا ہے۔                                                                                    | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: ایپ بلڈ کے دوران خودکار طور پر بلڈ شروع ہوتا ہے۔<br/>• `'manual'`: صرف واضح بلڈ کمانڈ کے ذریعے چلتا ہے۔<br/>• لغت کی بلڈ کو روکنے کے لیے مفید ہو سکتا ہے (مثلاً: Node.js ماحول میں چلنے سے بچنے کے لیے)۔                                                                                                                                                                                                                                                                                                                                              |
+| `optimize`            | کنٹرول کرتا ہے کہ آیا بلڈ آپٹیمائزیشن کی جاتی ہے۔                                                                        | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • اگر متعین نہ ہو، تو یہ فریم ورک بلڈ (Vite/Next.js) کے دوران شروع ہوگا۔<br/>• `true` ڈیولپمنٹ موڈ میں بھی آپٹیمائزیشن کو مجبور کرتا ہے۔<br/>• `false` اسے غیر فعال کرتا ہے۔<br/>• اگر فعال ہو، تو لغت کی کالز کو چنکنگ آپٹیمائزیشن سے بدل دیتا ہے۔<br/>• `@intlayer/babel` اور `@intlayer/swc` پلگ انز کی ضرورت ہے۔                                                                                                                                                                                                                                              |
+| `minify`              | بتاتا ہے کہ آیا بنڈل کے سائز کو کم کرنے کے لیے لغات کو کم (minify) کیا جانا چاہیے۔                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • بتاتا ہے کہ آیا بنڈل کو منی فائی کرنا ہے۔<br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔<br/>• اگر `editor.enabled` کی ویلیو true ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                                                                                                                                                                                                                                                                      |
+| `prune`               | بتاتا ہے کہ آیا لغات میں غیر استعمال شدہ کلیدوں کو ہٹا دینا (prune) چاہیے۔                                               | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • بتاتا ہے کہ آیا بنڈل کو پرون (prune) کرنا ہے۔ <br/>• ڈیفالٹ: پروڈکشن میں `true`۔<br/>• اگر `optimize` غیر فعال ہو تو اسے نظر انداز کر دیا جائے گا۔                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `checkTypes`          | بتاتا ہے کہ آیا بلڈ کو TypeScript اقسام کو چیک کرنا چاہیے اور ایررز لاگ کرنے چاہئیں۔                                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | بلڈ کی کارکردگی کو سست کر سکتا ہے۔                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `chunkGrouping`       | آیا فی لوکیل ڈکشنری چنکس کو اُس کوڈ اسپلٹ باؤنڈری کے مطابق گروپ کیا جائے جو انہیں استعمال کرتی ہے۔                       | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • گروپنگ کے بغیر، کئی اجزاء پر مشتمل صفحہ ہر ڈکشنری کے لیے ایک درخواست بھیجتا ہے۔<br/>• متعدد باؤنڈریز سے پہنچی جانے والی ڈکشنریاں مشترکہ چنک میں منتقل ہو جاتی ہیں، اس لیے کوئی صفحہ دوسرے صفحے کا مواد نہیں بھیجتا۔<br/>• صرف اُن ڈکشنریوں پر لاگو ہوتا ہے جو `importMode: 'dynamic'` استعمال کرتی ہیں۔<br/>• صرف کلائنٹ بلڈ پر، اور صرف بنڈلنگ کے دوران لاگو ہوتا ہے (dev میں نہیں)۔                                                                                                                                                                           |
+| `dictionariesPreload` | آیا ڈکشنری کو اُس چنک کے ساتھ لوڈ کیا جائے جو اسے استعمال کرتا ہے، بجائے اس کے کہ وہ چنک رینڈر ہونے کے بعد حاصل کی جائے۔ | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • تیار کردہ انٹری پوائنٹ اعلیٰ سطح پر براؤزنگ لوکیل کا انتظار کرتا ہے، اس لیے سست روی سے لوڈ ہونے والا روٹ اُس وقت تک لوڈ شدہ نہیں سمجھا جاتا جب تک اس کا مواد موجود نہ ہو۔<br/>• پڑھائی معطل ہونے کے بجائے ہم وقت رینڈر ہوتی ہے، اس لیے نیویگیشن میں اب لوڈنگ کی حالت نہیں جھلکتی۔<br/>• صرف طے شدہ لوکیل کا انتظار کیا جاتا ہے، اس لیے صفحہ صرف وہی زبان ڈاؤن لوڈ کرتا ہے جو وہ دکھاتا ہے۔<br/>• صرف کلائنٹ بلڈ میں `importMode: 'dynamic'` استعمال کرنے والی ڈکشنریوں پر لاگو ہوتا ہے۔<br/>• ٹاپ لیول await کی حمایت کرنے والا بنڈلر درکار ہے (Vite، esbuild)۔ |
+| `outputFormat`        | لغت کے آؤٹ پٹ فارمیٹ کو کنٹرول کرتا ہے۔                                                                                  | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `traversePattern`     | آپٹیمائزیشن کے دوران اسکین کی جانے والی فائلوں کا پیٹرن۔                                                                 | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • متعلقہ فائلوں تک آپٹیمائزیشن کو محدود کرکے بلڈ کی کارکردگی کو بہتر بناتا ہے۔<br/>• اگر `optimize` غیر فعال ہو تو نظر انداز کر دیا جاتا ہے۔<br/>• گلوب (glob) پیٹرنز استعمال کرتا ہے۔                                                                                                                                                                                                                                                                                                                                                                            |
 
 ---
 

package/docs/ur/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: ESLint پلگ ان | Intlayer کے لیے لنٹ قواعد
 description: eslint-plugin-intlayer کے ذریعے ہارڈ کوڈ شدہ سٹرنگز، ایسی ڈائنامک کالز جنہیں Intlayer کمپائلر بہتر نہیں بنا سکتا، اور غیر استعمال شدہ ڈکشنری مواد کو پکڑیں۔ React، Vue، Svelte، Angular اور Astro میں ESLint اور oxlint کے ساتھ کام کرتا ہے۔
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-ESLint 9 یا اس سے نیا ورژن (flat config) درکار ہے۔
+ESLint 9 یا اس سے نیا ورژن (flat config) درکار ہے۔ ESLint 10 معاون ہے۔
 
 ## استعمال
 
@@ -61,20 +61,20 @@ ESLint 9 یا اس سے نیا ورژن (flat config) درکار ہے۔
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-یا قواعد کو ایک ایک کر کے فعال کریں:
+یا کوئی کنفیگ پھیلائیں اور شدت کی سطحیں خود مقرر کریں:
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **اختیارات**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **اختیارات**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | Angular ٹیمپلیٹس          | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/docs/vi/bundle_optimization.md

@@ -159,7 +159,7 @@ pnpm add -D webpack-bundle-analyzer
 bun add -d webpack-bundle-analyzer
 ```
 
-```typescript fileName="webpack.config.ts
+```typescript fileName="webpack.config.ts"
 import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
 
 export default {

package/docs/vi/configuration.md

@@ -477,6 +477,28 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Nhóm các phần từ điển theo ngôn ngữ dựa trên ranh giới tách mã sử dụng
+     * chúng, để một trang tải lười lấy nội dung của nó trong một yêu cầu duy nhất.
+     * Mặc định: true
+     *
+     * Lưu ý:
+     * - Chỉ áp dụng cho các từ điển dùng `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Tải từ điển cùng với phần mã sử dụng nó, thay vì lấy về sau khi phần mã đó
+     * render. Việc đọc được render đồng bộ thay vì bị treo, nên điều hướng không
+     * còn nhấp nháy trạng thái đang tải.
+     * Mặc định: true
+     *
+     * Lưu ý:
+     * - Chỉ ngôn ngữ đã xác định mới được chờ, nên trang chỉ tải đúng ngôn ngữ mà
+     *   nó hiển thị.
+     */
+    dictionariesPreload: true,
+
     /**
      * Định dạng đầu ra cho các tệp dictionary được tạo.
      * Mặc định: ['cjs', 'esm']
@@ -1053,15 +1075,17 @@ Các tùy chọn build được áp dụng cho các plugin `@intlayer/babel` và
 
 > Trong quá trình tối ưu hóa, Intlayer sẽ thay thế các lời gọi dictionary để tối ưu hóa việc phân tách mã (chunking) sao cho gói kết quả chỉ import những dictionary thực sự được sử dụng.
 
-| Trường            | Mô tả                                                                                         | Kiểu dữ liệu                     | Mặc định                                                                                                                                                                          | Ví dụ                                                                         | Nhận xét                                                                                                                                                                                                                                                                                                                                                            |
-| ----------------- | --------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | Kiểm soát chế độ build.                                                                       | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Quá trình build được khởi chạy tự động trong quá trình build ứng dụng.<br/>• `'manual'`: Chỉ được thực thi thông qua một lệnh build rõ ràng.<br/>• Có thể được sử dụng để ngăn chặn quá trình build dictionary (ví dụ: để tránh chạy trong môi trường Node.js).                                                                                         |
-| `optimize`        | Kiểm soát liệu các tối ưu hóa build có nên được thực hiện hay không.                          | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Nếu chưa được định nghĩa, quá trình tối ưu hóa được khởi chạy trong quá trình build framework (Vite/Next.js).<br/>• `true` buộc thực hiện tối ưu hóa ngay cả trong chế độ dev.<br/>• `false` vô hiệu hóa nó.<br/>• Nếu bật, nó sẽ thay thế các lệnh gọi dictionary để phục vụ tối ưu hóa chunking.<br/>• Yêu cầu các plugin `@intlayer/babel` và `@intlayer/swc`. |
-| `minify`          | Nén (Minify) các từ điển để giảm kích thước bundle.                                           | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Cho biết bundle có nên được rút gọn không.<br/>• Mặc định: `true` trong production.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `optimize` bị tắt.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `editor.enabled` là true.                                                                                                                                                          |
-| `purge`           | Loại bỏ (Purge) các khóa không sử dụng trong từ điển.                                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Cho biết bundle có nên được loại bỏ các khóa không sử dụng không.<br/>• Mặc định: `true` trong production.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `optimize` bị tắt.                                                                                                                                                                                                 |
-| `checkTypes`      | Biểu thị liệu build có nên kiểm tra các kiểu dữ liệu TypeScript và ghi nhật ký lỗi hay không. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Có thể làm chậm quá trình build.                                                                                                                                                                                                                                                                                                                                    |
-| `outputFormat`    | Kiểm soát định dạng đầu ra cho các dictionary.                                                | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                     |
-| `traversePattern` | Pattern chỉ rõ các tệp cần quét trong quá trình tối ưu hóa.                                   | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Hạn chế tối ưu hóa cho các tệp có liên quan để cải thiện hiệu suất build.<br/>• Bị bỏ qua nếu `optimize` tắt.<br/>• Sử dụng các pattern glob.                                                                                                                                                                                                                     |
+| Trường                | Mô tả                                                                                                              | Kiểu dữ liệu                     | Mặc định                                                                                                                                                                          | Ví dụ                                                                         | Nhận xét                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | Kiểm soát chế độ build.                                                                                            | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Quá trình build được khởi chạy tự động trong quá trình build ứng dụng.<br/>• `'manual'`: Chỉ được thực thi thông qua một lệnh build rõ ràng.<br/>• Có thể được sử dụng để ngăn chặn quá trình build dictionary (ví dụ: để tránh chạy trong môi trường Node.js).                                                                                                                                                                                                                           |
+| `optimize`            | Kiểm soát liệu các tối ưu hóa build có nên được thực hiện hay không.                                               | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Nếu chưa được định nghĩa, quá trình tối ưu hóa được khởi chạy trong quá trình build framework (Vite/Next.js).<br/>• `true` buộc thực hiện tối ưu hóa ngay cả trong chế độ dev.<br/>• `false` vô hiệu hóa nó.<br/>• Nếu bật, nó sẽ thay thế các lệnh gọi dictionary để phục vụ tối ưu hóa chunking.<br/>• Yêu cầu các plugin `@intlayer/babel` và `@intlayer/swc`.                                                                                                                                   |
+| `minify`              | Nén (Minify) các từ điển để giảm kích thước bundle.                                                                | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Cho biết bundle có nên được rút gọn không.<br/>• Mặc định: `true` trong production.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `optimize` bị tắt.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `editor.enabled` là true.                                                                                                                                                                                                                                                                                            |
+| `purge`               | Loại bỏ (Purge) các khóa không sử dụng trong từ điển.                                                              | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Cho biết bundle có nên được loại bỏ các khóa không sử dụng không.<br/>• Mặc định: `true` trong production.<br/>• Tùy chọn này sẽ bị bỏ qua nếu `optimize` bị tắt.                                                                                                                                                                                                                                                                                                                                   |
+| `checkTypes`          | Biểu thị liệu build có nên kiểm tra các kiểu dữ liệu TypeScript và ghi nhật ký lỗi hay không.                      | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Có thể làm chậm quá trình build.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `chunkGrouping`       | Xác định có nhóm các phần từ điển theo ngôn ngữ dựa trên ranh giới tách mã sử dụng chúng hay không.                | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Không nhóm, một trang gồm nhiều thành phần sẽ gửi một yêu cầu cho mỗi từ điển.<br/>• Các từ điển được truy cập từ nhiều ranh giới sẽ chuyển sang phần dùng chung, nên không trang nào mang nội dung của trang khác.<br/>• Chỉ áp dụng cho các từ điển dùng `importMode: 'dynamic'`.<br/>• Chỉ áp dụng cho bản build phía client, và chỉ khi đóng gói (không phải ở chế độ dev).                                                                                                                     |
+| `dictionariesPreload` | Xác định từ điển có được tải cùng với phần mã sử dụng nó hay không, thay vì được lấy về sau khi phần mã đó render. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Điểm vào được tạo sẽ chờ ngôn ngữ duyệt ở cấp cao nhất, nên một route tải lười chưa được coi là đã tải cho đến khi có nội dung.<br/>• Việc đọc được render đồng bộ thay vì bị treo, nên điều hướng không còn nhấp nháy trạng thái đang tải.<br/>• Chỉ ngôn ngữ đã xác định mới được chờ, nên trang chỉ tải đúng ngôn ngữ mà nó hiển thị.<br/>• Chỉ áp dụng cho các từ điển dùng `importMode: 'dynamic'`, ở bản build phía client.<br/>• Yêu cầu bộ đóng gói hỗ trợ top-level await (Vite, esbuild). |
+| `outputFormat`        | Kiểm soát định dạng đầu ra cho các dictionary.                                                                     | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `traversePattern`     | Pattern chỉ rõ các tệp cần quét trong quá trình tối ưu hóa.                                                        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Hạn chế tối ưu hóa cho các tệp có liên quan để cải thiện hiệu suất build.<br/>• Bị bỏ qua nếu `optimize` tắt.<br/>• Sử dụng các pattern glob.                                                                                                                                                                                                                                                                                                                                                       |
 
 ---
 

package/docs/vi/dictionary/content_file.md

@@ -539,28 +539,6 @@ Chỉ định độ ưu tiên của từ điển để giải quyết xung độ
 
 > Xem [Biến thể](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/variants.md) để biết thêm thông tin.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-Được sử dụng cùng với Các bản ghi động (Dynamic Records), trường này cho phép khai báo các bản ghi do CMS quản lý hoặc dữ liệu tùy ý được truy xuất tại thời gian chạy bằng một ID ẩn danh. Danh tính từ điển được xác định bởi tập hợp tùy ý các cặp khóa-giá trị được khai báo trong trường `meta` này.
-
-**Ví dụ:**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> Xem [Bản ghi động](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dynamic_dictionaries/dynamic_content.md) để biết thêm thông tin.
-
 ### Thuộc tính CMS
 
 ##### `version` (string)

package/docs/vi/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ Không thể lấy nội dung từ file JSON, hãy sử dụng file .ts hoặc .
 
 Trong trường hợp này, hàm `fakeFetch` mô phỏng một độ trễ để giả lập thời gian phản hồi của server. Intlayer thực thi hàm bất đồng bộ và sử dụng kết quả làm nội dung cho khóa `text`.
 
+## Lấy Nội dung Từ Xa
+
+Bạn cũng có thể gán trực tiếp một promise cho một trường nội dung. Intlayer sẽ chờ promise đó khi build các từ điển và nhúng giá trị đã được phân giải:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+Không thể lấy nội dung từ file JSON, hãy sử dụng file .ts hoặc .js thay thế
+```
+
+> Yêu cầu được thực thi tại thời điểm build, vì vậy dữ liệu lấy về là một bản chụp được nhúng trong từ điển. Hãy build lại các từ điển để cập nhật.
+
 ## Sử dụng Nội dung Dựa trên Hàm trong Các Thành phần React
 
 Để sử dụng nội dung dựa trên hàm trong một thành phần React, bạn cần import `useIntlayer` từ `react-intlayer` và gọi nó với ID nội dung để lấy nội dung. Dưới đây là một ví dụ: