@intlayer/docs 9.3.1 → 9.3.3

package/docs/ru/configuration.md

@@ -478,6 +478,29 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Группировать чанки словарей по локали в соответствии с границей разделения
+     * кода, которая их использует, чтобы лениво загружаемая страница получала своё
+     * содержимое одним запросом.
+     * По умолчанию: true
+     *
+     * Примечание:
+     * - Применяется только к словарям с `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Загружать словарь вместе с чанком, который его использует, вместо получения
+     * после отрисовки этого чанка. Чтения отрисовываются синхронно вместо
+     * приостановки, поэтому при навигации больше не мелькает состояние загрузки.
+     * По умолчанию: true
+     *
+     * Примечание:
+     * - Ожидается только разрешённая локаль, поэтому страница загружает лишь тот
+     *   язык, который отображает.
+     */
+    dictionariesPreload: true,
+
     /**
      * Формат вывода для сгенерированных файлов словарей.
      * По умолчанию: ['cjs', 'esm']
@@ -1054,15 +1077,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` форсирует оптимизацию даже в dev режиме.<br/>• `false` отключает ее.<br/>• Если включено, заменяет вызовы словарей для оптимизации чанкинга.<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` форсирует оптимизацию даже в dev режиме.<br/>• `false` отключает ее.<br/>• Если включено, заменяет вызовы словарей для оптимизации чанкинга.<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/ru/dictionary/content_file.md

@@ -536,28 +536,6 @@ export default aboutPageMetaContent;
 
 > См. [Варианты](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/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/ru/dynamic_dictionaries/dynamic_content.md) для получения дополнительной информации.
-
 ### Свойства CMS
 
 ##### `version` (строка)

package/docs/ru/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/ru/eslint.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2026-08-12
+updatedAt: 2026-08-13
+title: Плагин ESLint | Правила линтинга для Intlayer
+description: Находите жестко закодированные строки, динамические вызовы, которые компилятор Intlayer не может оптимизировать, и неиспользуемый контент словарей с помощью eslint-plugin-intlayer. Работает с ESLint и oxlint для React, Vue, Svelte, Angular и Astro.
+keywords:
+  - Intlayer
+  - ESLint
+  - oxlint
+  - Линтинг
+  - i18n
+  - Интернационализация
+  - no-raw-text
+  - Жестко закодированные строки
+  - Неиспользуемые переводы
+  - Мертвый контент
+  - React
+  - Vue
+  - Svelte
+  - Angular
+slugs:
+  - doc
+  - eslint
+history:
+  - version: 9.3.1
+    date: 2026-08-12
+    changes: "Начальная история"
+author: aymericzip
+---
+
+# Плагин ESLint x OXLint
+
+`eslint-plugin-intlayer` отслеживает типичные ошибки i18n, которые TypeScript не способен обнаружить:
+
+1. **Жестко закодированный текст**, который так и не был вынесен в словарь.
+2. **Динамические вызовы**, которые проходят проверку типов и выполняются, но не могут быть оптимизированы компилятором Intlayer.
+3. **Мертвый контент** — словари и поля, которые нигде в проекте не считываются (по желанию).
+
+Неизвестные ключи словарей, неизвестные пути к полям и отсутствующие локали уже приводят к ошибкам компиляции, поэтому плагин не дублирует их проверку.
+
+## Установка
+
+```bash packageManager="npm"
+npm install --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add --dev eslint-plugin-intlayer
+```
+
+Требуется ESLint 9 или новее (flat config). ESLint 10 поддерживается.
+
+## Использование
+
+Плагин работает как в ESLint, так и в [oxlint](https://oxc.rs) — одни и те же правила, одни и те же параметры.
+
+<Tabs defaultTab="eslint">
+  <Tab label="ESLint" value="eslint">
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [...intlayer.configs.recommended];
+```
+
+Либо разверните конфигурацию и задайте уровни сами:
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [
+  ...intlayer.configs.recommended,
+  {
+    rules: {
+      "intlayer/no-raw-text": "warn",
+      "intlayer/static-dictionary-key": "error",
+      "intlayer/no-dynamic-field-access": "error",
+      "intlayer/enforce-adapter-import": "warn",
+      "intlayer/no-unused-content": "warn",
+    },
+  },
+];
+```
+
+  </Tab>
+  <Tab label="oxlint" value="oxlint">
+
+```json fileName=".oxlintrc.json"
+{
+  "jsPlugins": ["eslint-plugin-intlayer"],
+  "rules": {
+    "intlayer/no-raw-text": "warn",
+    "intlayer/static-dictionary-key": "error",
+    "intlayer/no-dynamic-field-access": "error",
+    "intlayer/enforce-adapter-import": "warn"
+  }
+}
+```
+
+Два нюанса: поддержка JS-плагинов в oxlint все еще находится в альфа-стадии, а oxlint не поддерживает пользовательские парсеры — поэтому файлы `.vue`, `.svelte`, `.astro` и шаблоны Angular там не линтятся. Запускайте oxlint для файлов JS/TS/JSX, а для остальных используйте ESLint.
+
+Правило `no-unused-content` намеренно исключено выше: ему требуется рабочий каталог и путь к проверяемому файлу из контекста правила, что альфа-мост для JS-плагинов не гарантирует. Запускайте его в ESLint.
+
+  </Tab>
+</Tabs>
+
+### Пресеты конфигураций
+
+| Конфигурация    | `no-raw-text`                        | `static-dictionary-key` | `no-dynamic-field-access` | `enforce-adapter-import` | `no-unused-content` |
+| --------------- | ------------------------------------ | ----------------------- | ------------------------- | ------------------------ | ------------------- |
+| `recommended`   | warn                                 | error                   | error                     | off                      | off                 |
+| `strict`        | error (+ строковые литералы вне JSX) | error                   | error                     | error                    | off                 |
+| `contract-only` | off                                  | error                   | error                     | off                      | off                 |
+
+Пресет `recommended` намеренно оставляет `no-raw-text` со статусом `warn`: применение правила к существующей кодовой базе покажет сразу все непереведенные строки, что не должно ломать сборку с первого же дня.
+
+`enforce-adapter-import` по умолчанию выключено — включите его явно при необходимости.
+
+`no-unused-content` выключено во всех пресетах, включая `strict`. Это единственное правило, которое считывает конфигурацию Intlayer и сканирует исходные файлы на диске, поэтому его включение должно быть осознанным выбором, а не автоматическим решением пресета.
+
+## Правила
+
+### `no-raw-text`
+
+Сообщает о тексте для пользователя, который не объявлен в словаре. Использует ту же логику обнаружения, что и `intlayer extract`, поэтому названия брендов, CSS-классы и технические идентификаторы игнорируются.
+
+```jsx
+// ✗ Ошибка
+<h1>Welcome to our documentation</h1>
+<input placeholder="Enter your email address" />
+
+// ✓ Корректно
+const { title } = useIntlayer("home");
+<h1>{title}</h1>
+```
+
+Файлы объявления контента (`*.content.ts`, …) пропускаются.
+
+Чтобы исправить весь файл сразу, выполните `npx intlayer extract`, и компилятор автоматически перенесет строки в словарь.
+
+**Параметры**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-raw-text": [
+    "warn",
+    {
+      // Атрибуты, значениями которых является текст для пользователя.
+      // По умолчанию: title, placeholder, alt, aria-label, label
+      attributes: ["title", "placeholder", "alt", "aria-label", "label"],
+
+      // Элементы, содержимое которых никогда не является текстом для пользователя.
+      // По умолчанию: code, pre, script, style
+      ignoreElements: ["code", "pre", "script", "style"],
+
+      // Регулярные выражения для текста, о котором никогда не нужно сообщать.
+      ignorePatterns: ["^Powered by"],
+
+      // Сообщать ли также о строковых литералах вне разметки. По умолчанию: false
+      includeStringLiterals: false,
+    },
+  ],
+}
+```
+
+### `static-dictionary-key`
+
+Требует, чтобы ключ словаря был строковым литералом.
+
+Компилятор может предварительно загрузить словарь только тогда, когда он может прочитать ключ непосредственно в месте вызова. При использовании вычисляемого ключа оптимизация автоматически пропускается, и вместо этого в бандл включаются все словари.
+
+```typescript
+// ✗ Ошибка
+useIntlayer(dictionaryKey);
+useIntlayer(`home-${suffix}`);
+getTranslations({ namespace: page });
+
+// ✗ Переменная по-прежнему не является литералом
+const key = "home";
+useIntlayer(key);
+
+// ✓ Корректно
+useIntlayer("home");
+getTranslations({ namespace: "home" });
+```
+
+Это относится к `useIntlayer`, `getIntlayer` и всем адаптерам совместимости (`useTranslation`, `useTranslations`, `formatMessage`, `<FormattedMessage id>`, `<Trans i18nKey>`, …).
+
+### `no-dynamic-field-access`
+
+Требует, чтобы поле, считываемое из словаря, было статически известно.
+
+Компилятор удаляет поля, использование которых он не обнаружил. Динамический доступ для него невидим, поэтому чтение может вернуть `undefined` во время выполнения.
+
+```typescript
+// ✗ Ошибка
+const content = useIntlayer("home");
+content[fieldName];
+
+const t = useTranslations("home");
+t(messageKey);
+
+// ✓ Корректно
+content.title;
+content["title"];
+content.items[0];
+t("hero.title");
+```
+
+### `enforce-adapter-import`
+
+Отдает предпочтение адаптеру совместимости `@intlayer/*` перед оригинальным пакетом. Оригинальный пакет разрешается в Intlayer только при настроенном псевдониме бандлера, тогда как адаптер работает всегда. Поддерживает автоисправление через `--fix`.
+
+```typescript
+// ✗ Ошибка
+import { useTranslation } from "react-i18next";
+import { getTranslations } from "next-intl/server";
+
+// ✓ Корректно
+import { useTranslation } from "@intlayer/react-i18next";
+import { getTranslations } from "@intlayer/next-intl/server";
+```
+
+### `no-unused-content`
+
+**По умолчанию отключено.** Сообщает о контенте, который нигде в проекте не считывается, а также о ключах словарей, объявленных более чем в одном месте.
+
+```typescript fileName="src/home.content.ts"
+export default {
+  key: "home", // ✗ Сообщается, если ни одно место в проекте не запрашивает "home"
+  content: {
+    title: t({ ru: "Заголовок", en: "Title" }),
+
+    // ✗ Сообщается, если ничто не считывает `hero`
+    hero: {
+      subtitle: t({ ru: "Подзаголовок", en: "Subtitle" }),
+    },
+  },
+};
+```
+
+В отличие от других правил, это правило не может принять решение только по проверяемому файлу — неиспользуемость поля определяется относительно всего проекта. При первом объявлении контента во время линтинга оно загружает конфигурацию Intlayer, ищет исходные файлы по путям из конфигурации (`build.traversePattern`, `compiler.transformPattern`) и запускает тот же анализатор использования, который используется в `@intlayer/lsp` и зачеркивании «неиспользуемого» в расширении VS Code. Результат кэшируется на `cacheTtl` миллисекунд, поэтому сканирование выполняется один раз за запуск, а не для каждого файла.
+
+**Параметры**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-unused-content": [
+    "warn",
+    {
+      // Сообщать о ключах словарей, на которые ничто не ссылается. По умолчанию: true
+      reportUnusedDictionaries: true,
+
+      // Сообщать о полях контента, которые ничто не считывает. По умолчанию: true
+      reportUnusedFields: true,
+
+      // Сообщать о дублирующихся ключах, объявленных в нескольких местах. По умолчанию: true
+      reportDuplicateKeys: true,
+
+      // Регулярные выражения для путей полей, о которых никогда не нужно сообщать.
+      ignoreFields: ["^meta"],
+
+      // Корень проекта, с которого начинается сканирование. По умолчанию: рабочий каталог ESLint
+      baseDir: process.cwd(),
+
+      // Время повторного использования результатов сканирования проекта (в мс). По умолчанию: 30000
+      cacheTtl: 30000,
+    },
+  ],
+}
+```
+
+Уменьшите `cacheTtl`, если вы линтите из долгоживущего сервера редактора и хотите быстрее видеть изменения; установите `baseDir`, если один запуск линтера охватывает несколько проектов Intlayer в монорепозитории.
+
+> **Стремится к минимизации ложных срабатываний.** Ложное срабатывание здесь может привести к удалению нужного перевода, поэтому ничего не сообщается, когда словарь используется способом, который анализ не может отследить: объект контента передан целиком, функция перевода привязана от него (`const t = useTranslations("home")`), объявление получено через прямой импорт (`useDictionary(myDictionary)`), `nest()` из другого словаря или список полей, ставший неполным из-за spread-оператора. Однофайловые компоненты (`.vue`, `.svelte`, `.astro`) считаются использующими все поля упомянутых словарей, поскольку их блоки скриптов здесь не парсятся.
+
+`reportDuplicateKeys` считывает необъединенные словари, которые сборка записывает в `.intlayer/`, поэтому оно не срабатывает, пока проект не будет собран хотя бы один раз. Два объявления с одинаковым ключом объединяются, что является допустимым паттерном — отчет формируется потому, что поле, определенное с обеих сторон, без предупреждения сохраняет только одно из двух значений.
+
+Анализатор загружается из `@intlayer/lsp`, который поставляется как ESM. Поэтому правилу требуется версия Node, поддерживающая `require()` для ES-модулей — Node 20.19+ или 22.12+. На более старых версиях оно ничего не сообщает, чтобы не прерывать выполнение линтинга.
+
+## Фреймворки
+
+Каждое правило работает во всех интеграциях Intlayer, включая шаблоны Vue, Svelte и Angular. Вам нужно лишь указать ESLint, какой парсер использовать для каждого типа файлов.
+
+| Фреймворк                 | Файлы             | Парсер                            |
+| ------------------------- | ----------------- | --------------------------------- |
+| React, Preact, Solid, Lit | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Next.js                   | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Vue, Nuxt                 | `.vue`            | `vue-eslint-parser`               |
+| Svelte, SvelteKit         | `.svelte`         | `svelte-eslint-parser`            |
+| Angular                   | `.ts`             | `typescript-eslint`               |
+| Шаблоны Angular           | `.component.html` | `@angular-eslint/template-parser` |
+| Astro                     | `.astro`          | `astro-eslint-parser`             |
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+import tseslint from "typescript-eslint";
+import vueParser from "vue-eslint-parser";
+import svelteParser from "svelte-eslint-parser";
+import angularTemplateParser from "@angular-eslint/template-parser";
+
+export default [
+  ...intlayer.configs.recommended,
+
+  {
+    files: ["**/*.{ts,tsx,jsx}"],
+    languageOptions: { parser: tseslint.parser },
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.svelte"],
+    languageOptions: {
+      parser: svelteParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.component.html"],
+    languageOptions: { parser: angularTemplateParser },
+  },
+];
+```
+
+Устанавливайте только те парсеры, которые требуются вашему проекту.
+
+> **Известное ограничение.** В шаблонах Vue и Angular выражение вида `{{ content[key] }}` не проверяется правилом `no-dynamic-field-access`. Динамическое чтение внутри блока script определяется в штатном режиме.

package/docs/tr/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/tr/configuration.md

@@ -478,6 +478,28 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * Yerel ayara özgü sözlük parçalarını, onları kullanan kod bölme sınırına göre
+     * grupla; böylece geç yüklenen bir sayfa içeriğini tek istekte alır.
+     * Varsayılan: true
+     *
+     * Not:
+     * - Yalnızca `importMode: 'dynamic'` kullanan sözlükler için geçerlidir.
+     */
+    chunkGrouping: true,
+
+    /**
+     * Bir sözlüğü, onu kullanan parça render edildikten sonra getirmek yerine o
+     * parçayla birlikte yükle. Okumalar askıya alınmak yerine eşzamanlı render
+     * edilir, böylece gezinme sırasında artık yükleme durumu görünmez.
+     * Varsayılan: true
+     *
+     * Not:
+     * - Yalnızca çözümlenen yerel ayar beklenir, bu nedenle sayfa yalnızca
+     *   gösterdiği dili indirir.
+     */
+    dictionariesPreload: true,
+
     /**
      * Oluşturulan sözlük dosyaları için çıktı formatı.
      * Varsayılan: ['cjs', 'esm']
@@ -1054,15 +1076,17 @@ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentileri için geç
 
 > Optimizasyon sırasında Intlayer, yığınlamayı (chunking) optimize etmek için sözlük çağrılarını değiştirecektir, böylece final paketi yalnızca gerçekte kullanılan sözlükleri içe aktaracaktır.
 
-| Alan              | Açıklama                                                                                                          | Tür                              | Varsayılan                                                                                                                                                                        | Örnek                                                                         | Not                                                                                                                                                                                                                                                                                                                                         |
-| ----------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | Derleme modunu kontrol eder.                                                                                      | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: uygulama derlemesi sırasında derleme otomatik olarak tetiklenir.<br/>• `'manual'`: yalnızca derleme komutu açıkça çağrıldığında yürütülür.<br/>• Sözlük derlemelerini devre dışı bırakmak için kullanılabilir (örneğin Node.js ortamlarında yürütmeyi durdurmak için).                                                          |
-| `optimize`        | Derlemenin optimize edilip edilmeyeceğini kontrol eder.                                                           | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Tanımlanmazsa, optimizasyon framework derlemesinde (Vite/Next.js) tetiklenir.<br/>• `true` ise geliştirme modunda bile optimizasyonu zorlar.<br/>• `false` ise devre dışı bırakır.<br/>• Etkinse, yığınlamayı optimize etmek için sözlük çağrılarını yer değiştirir.<br/>• `@intlayer/babel` ve `@intlayer/swc` eklentilerini gerektirir. |
-| `minify`          | Demet boyutunu azaltmak için sözlükleri küçültün (Minify).                                                        | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Paketin küçültülüp küçültülmeyeceğini belirtir.<br/>• Varsayılan: Üretimde `true`.<br/>• `optimize` devre dışı bırakılırsa bu seçenek yoksayılır.<br/>• `editor.enabled` true ise bu seçenek yoksayılır.                                                                                                                                  |
-| `purge`           | Sözlüklerdeki kullanılmayan anahtarları temizleyin (Purge).                                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Paketin temizlenip temizlenmeyeceğini belirtir.<br/>• Varsayılan: Üretimde `true`.<br/>• `optimize` devre dışı bırakılırsa bu seçenek yoksayılır.                                                                                                                                                                                         |
-| `checkTypes`      | Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları günlüğe kaydedip kaydetmeyeceğini belirtir. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Derleme sürecini yavaşlatabilir.                                                                                                                                                                                                                                                                                                            |
-| `outputFormat`    | Sözlüklerin çıktı formatını kontrol eder.                                                                         | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                             |
-| `traversePattern` | Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan kalıplar.                                         | `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/**']` | • Derleme performansını artırmak için optimizasyonu ilgili dosyalarla sınırlayın.<br/>• `optimize` kapalıysa yok sayılır.<br/>• Glob kalıplarını kullanır.                                                                                                                                                                                  |
+| Alan                  | Açıklama                                                                                                                           | Tür                              | Varsayılan                                                                                                                                                                        | Örnek                                                                         | Not                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | Derleme modunu kontrol eder.                                                                                                       | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: uygulama derlemesi sırasında derleme otomatik olarak tetiklenir.<br/>• `'manual'`: yalnızca derleme komutu açıkça çağrıldığında yürütülür.<br/>• Sözlük derlemelerini devre dışı bırakmak için kullanılabilir (örneğin Node.js ortamlarında yürütmeyi durdurmak için).                                                                                                                                                                                                                                                                              |
+| `optimize`            | Derlemenin optimize edilip edilmeyeceğini kontrol eder.                                                                            | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Tanımlanmazsa, optimizasyon framework derlemesinde (Vite/Next.js) tetiklenir.<br/>• `true` ise geliştirme modunda bile optimizasyonu zorlar.<br/>• `false` ise devre dışı bırakır.<br/>• Etkinse, yığınlamayı optimize etmek için sözlük çağrılarını yer değiştirir.<br/>• `@intlayer/babel` ve `@intlayer/swc` eklentilerini gerektirir.                                                                                                                                                                                                                     |
+| `minify`              | Demet boyutunu azaltmak için sözlükleri küçültün (Minify).                                                                         | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Paketin küçültülüp küçültülmeyeceğini belirtir.<br/>• Varsayılan: Üretimde `true`.<br/>• `optimize` devre dışı bırakılırsa bu seçenek yoksayılır.<br/>• `editor.enabled` true ise bu seçenek yoksayılır.                                                                                                                                                                                                                                                                                                                                                      |
+| `purge`               | Sözlüklerdeki kullanılmayan anahtarları temizleyin (Purge).                                                                        | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Paketin temizlenip temizlenmeyeceğini belirtir.<br/>• Varsayılan: Üretimde `true`.<br/>• `optimize` devre dışı bırakılırsa bu seçenek yoksayılır.                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `checkTypes`          | Derlemenin TypeScript türlerini kontrol edip etmeyeceğini ve hataları günlüğe kaydedip kaydetmeyeceğini belirtir.                  | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Derleme sürecini yavaşlatabilir.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `chunkGrouping`       | Yerel ayara özgü sözlük parçalarının, onları kullanan kod bölme sınırına göre gruplanıp gruplanmayacağını belirtir.                | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Gruplama olmadan, çok sayıda bileşenden oluşan bir sayfa sözlük başına bir istek gönderir.<br/>• Birden fazla sınırdan erişilen sözlükler paylaşılan bir parçaya taşınır, böylece hiçbir sayfa başka bir sayfanın içeriğini taşımaz.<br/>• Yalnızca `importMode: 'dynamic'` kullanan sözlükler için geçerlidir.<br/>• Yalnızca istemci derlemesi için ve yalnızca paketleme sırasında geçerlidir (geliştirme modunda değil).                                                                                                                                  |
+| `dictionariesPreload` | Bir sözlüğün, onu kullanan parça render edildikten sonra getirilmek yerine o parçayla birlikte yüklenip yüklenmeyeceğini belirtir. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Oluşturulan giriş noktası gezinme yerel ayarını en üst düzeyde bekler, bu nedenle geç yüklenen bir rota, içeriği hazır olana kadar yüklenmiş sayılmaz.<br/>• Okumalar askıya alınmak yerine eşzamanlı render edilir, böylece gezinme sırasında artık yükleme durumu görünmez.<br/>• Yalnızca çözümlenen yerel ayar beklenir, bu nedenle sayfa yalnızca gösterdiği dili indirir.<br/>• Yalnızca istemci derlemesinde `importMode: 'dynamic'` kullanan sözlükler için geçerlidir.<br/>• Top-level await destekleyen bir paketleyici gerektirir (Vite, esbuild). |
+| `outputFormat`        | Sözlüklerin çıktı formatını kontrol eder.                                                                                          | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `traversePattern`     | Optimizasyon sırasında hangi dosyaların taranacağını tanımlayan kalıplar.                                                          | `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/**']` | • Derleme performansını artırmak için optimizasyonu ilgili dosyalarla sınırlayın.<br/>• `optimize` kapalıysa yok sayılır.<br/>• Glob kalıplarını kullanır.                                                                                                                                                                                                                                                                                                                                                                                                      |
 
 ---
 

package/docs/tr/dictionary/content_file.md

@@ -532,28 +532,6 @@ Varyantlar (Variants) ile birlikte kullanılan bu alan, adlandırılmış içeri
 
 > Daha fazla bilgi için [Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/variants.md) sayfasına bakın.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-Dinamik Kayıtlar (Dynamic Records) ile birlikte kullanılan bu alan, CMS tarafından yönetilen kayıtları veya çalışma zamanında opak bir kimlik (ID) ile getirilen rastgele verileri bildirmeyi sağlar. Sözlük kimliği, bu `meta` alanında bildirilen rastgele anahtar-değer çiftleri kümesiyle tanımlanır.
-
-**Örnek:**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> Daha fazla bilgi için [Dinamik Kayıtlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/dynamic_content.md) sayfasına bakın.
-
 ### CMS Özellikleri
 
 ##### `version` (string)