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

package/docs/ru/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 В этом разделе представлено подробное руководство по использованию хука `useIntlayer` в приложениях React, что позволяет эффективно локализовать контент.
 
-## Импорт `useIntlayer` в React
-
-Хук `useIntlayer` можно интегрировать в приложения React, импортируя его в зависимости от контекста:
-
-- **Клиентский компонент:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Используется в клиентских компонентах React
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Используется в клиентских компонентах React
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Используется в клиентских компонентах React
-  ```
-
-- **Серверный компонент:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Используется в серверных компонентах React
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Используется в серверных компонентах React
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Используется в серверных компонентах React
-  ```
-
-## Параметры
-
-Хук принимает два параметра:
-
-1. **`key`**: Ключ словаря для получения локализованного контента.
-2. **`locale`** (необязательно): Желаемая локаль. По умолчанию используется локаль из контекста, если не указано.
-
-## Словарь
-
-Все ключи словаря должны быть объявлены в файлах декларации контента для повышения типобезопасности и избежания ошибок. Инструкции по настройке можно найти [здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
-
 ## Пример использования в React
 
 Демонстрация использования хука `useIntlayer` в React-компоненте:
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Обработка атрибутов
-
-При локализации атрибутов корректно обращайтесь к значениям контента:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Дополнительные ресурсы
 
 - **Визуальный редактор Intlayer**: Для более интуитивного управления контентом обратитесь к документации по визуальному редактору [здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md).

package/docs/ru/packages/react-intlayer/useLocale.md

@@ -72,6 +72,15 @@ export default LocaleSwitcher;
 
 ## Параметры и возвращаемые значения
 
+Когда вы вызываете хук `useLocale`, он возвращает объект, содержащий следующие свойства:
+
+- **`locale`**: Текущая локаль, установленная в React контексте.
+- **`defaultLocale`**: Основная локаль, определённая в конфигурации.
+- **`availableLocales`**: Список всех доступных локалей, определённых в конфигурации.
+- **`setLocale`**: Функция для обновления текущей локали в контексте приложения.
+
+## Параметры и возвращаемые значения
+
 При вызове хука `useLocale` он возвращает объект, содержащий следующие свойства:
 
 - **`locale`**: Текущая локаль, установленная в контексте React.

package/docs/ru/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Документация пакета react-native-intlayer
-description: Поддержка React Native для Intlayer, предоставляющая провайдеры и полифилы.
+description: Поддержка React Native для Intlayer, предоставляющая провайдеры, хуки, полифилы и конфигурацию Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Реэкспорт полного API react-intlayer (хуки, утилиты, подпути format/html/markdown), чтобы приложение React Native зависело только от react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Унифицированная документация для всех экспортов"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Пакет react-native-intlayer
 
-Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он включает провайдер и полифилы для поддержки локалей.
+Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он реэкспортирует полный API `react-intlayer` (хуки и утилиты) с `IntlayerProvider`, адаптированным для React Native, а также полифилы и конфигурацию Metro, необходимые для работы в React Native.
+
+> В приложении React Native импортируйте **всё** из `react-native-intlayer`. Устанавливать или импортировать `react-intlayer` напрямую не нужно.
 
 ## Установка
 
@@ -34,26 +39,57 @@ npm install react-native-intlayer
 
 ### Провайдер
 
-| Компонент          | Описание                                                                                    |
-| ------------------ | ------------------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. |
+| Компонент          | Описание                                                                                                                                  |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. Автоматически применяет необходимые полифилы. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Хуки и утилиты
+
+Они реэкспортируются из `react-intlayer`, поэтому вы можете импортировать их напрямую из `react-native-intlayer`:
 
-Импорт:
+| Экспорт                                                                                                           | Описание                                            |
+| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Доступ к локализованному контенту по ключу словаря. |
+| `useLocale`                                                                                                       | Чтение и изменение текущей локали.                  |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Загрузка содержимого словаря различными способами.  |
+| `useI18n`                                                                                                         | Совместимый с i18next хук.                          |
+| `t`                                                                                                               | Вспомогательная функция для встроенного перевода.   |
+| `getIntlayer`, `getDictionary`                                                                                    | Императивные геттеры контента.                      |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Вспомогательные функции для сохранения локали.      |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
-### Полифилл
+### Полифил
 
 | Функция            | Описание                                                                         |
 | ------------------ | -------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Функция, применяющая необходимые полифилы для поддержки Intlayer в React Native. |
 
-Импорт:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Полифил применяется автоматически при импорте `IntlayerProvider`. Вызывайте `intlayerPolyfill` вручную только если вам нужны полифилы до монтирования провайдера.
+
+### Форматтеры
+
+Хуки форматирования чисел, дат и другие функции на базе Intl доступны из подпути `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown и HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Конфигурация Metro
@@ -64,11 +100,8 @@ import "react-native-intlayer";
 | ------------------------- | ------------------------------------------------------------------------------------------- |
 | `configMetroIntlayer`     | Асинхронная функция, которая подготавливает Intlayer и объединяет конфигурацию Metro.       |
 | `configMetroIntlayerSync` | Синхронная функция, которая объединяет конфигурацию Metro без подготовки ресурсов Intlayer. |
-| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из bundle.        |
-
-Импорт:
+| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из бандла.        |
 
 ```tsx
-import "react-native-intlayer/metro";
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/ru/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v6! Этот релиз сосредоточен на производительности, опыте разработчика и надежности. Ниже приведены основные моменты, а также заметки по миграции и примеры для копирования.
 
+## Содержание
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основные моменты
 
 - Новая команда: `npx intlayer content test` для обнаружения отсутствующих переводов
@@ -295,6 +299,24 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Параллельный процесс для отслеживания файлов на turbopack
+
+При использовании Turbopack на Next.js 14 и выше в качестве сервера разработки с командой `next dev --turbopack` изменения словарей не будут автоматически обнаруживаться по умолчанию.
+
+Это ограничение возникает потому, что Turbopack не может запускать webpack plugins параллельно для отслеживания изменений в ваших файлах контента.
+
+Чтобы обойти это, мы использовали команду `intlayer watch` с опцией `--with` для одновременного запуска сервера разработки и наблюдателя сборки Intlayer.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## Заметки по миграции
 
 - Удалено: `dictionaryOutput` (ранее `i18next` или `next-intl`). Это вернется в виде подключаемых адаптеров в будущих версиях. Удалите это поле из вашей конфигурации.
@@ -313,6 +335,12 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Примечания миграции с v6 на v7
+
+Дополнительную информацию см. в [примечаниях миграции с v6 на v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v7.md).
+
+---
+
 ## Полезные ссылки
 
 - [Справочник CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md)

package/docs/ru/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v7! Этот крупный релиз представляет значительные улучшения в производительности, безопасности типов и опыте разработчика. Ниже приведены основные моменты, а также заметки по миграции и практические примеры.
 
+## Оглавление
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основные моменты
 
 - Стратегия кэширования для ускорения сборок
@@ -260,6 +264,126 @@ setLocale("en");
 
 ---
 
+## Автоматическое форматирование кода: конфигурация formatCommand
+
+v7 вводит опцию `formatCommand` в конфигурации редактора, позволяя вам автоматически форматировать файлы содержимого при их записи Intlayer. Это обеспечивает согласованный стиль кода и форматирование во всех файлах объявления контента.
+
+Если не установлено, Intlayer попытается автоматически определить команду форматирования. Путем попытки разрешить следующие команды: prettier, biome, eslint.
+
+### Конфигурация
+
+Опция `formatCommand` принимает строковый шаблон, где `{{file}}` будет заменена на фактический путь файла:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Поддерживаемые форматеры
+
+Вы можете использовать любой форматер кода, который принимает пути к файлам в качестве аргументов:
+
+**Using Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Using Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Using ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Using Bun's built-in formatter:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Преимущества
+
+- **Согласованное форматирование**: Все файлы содержимого автоматически форматируются в соответствии с рекомендациями стиля вашего проекта
+- **Опыт разработчика**: Нет необходимости вручную форматировать файлы после их создания Intlayer
+- **Согласованность команды**: Гарантирует, что все члены команды имеют одинаковое форматирование, применяемое к файлам содержимого
+- **Интеграция CI/CD**: Файлы содержимого сохраняют согласованное форматирование в автоматизированных рабочих процессах
+
+### Как это работает
+
+When Intlayer writes or updates a content declaration file (`.content.ts`, `.content.js`, etc.), it automatically runs the specified format command on the file. The `{{file}}` placeholder is replaced with the actual file path, and the command is executed in the project's base directory.
+
+---
+
+## Dictionary Configuration: Better organization and structure
+
+v7 представляет новый dedicated раздел конфигурации `dictionary`, который обеспечивает лучшую организацию параметров, связанных со словарем, и улучшенное управление содержимым.
+
+### Новая структура конфигурации словаря
+
+Свойство `fill` было перемещено из раздела `content` в новый раздел `dictionary`, обеспечивая более четкое разделение ответственности:
+
+**Конфигурация v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Конфигурация v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Преимущества новой структуры
+
+- **Более четкая организация**: Параметры, характерные для словаря, теперь сгруппированы вместе
+- **Лучшее разделение ответственности**: Обнаружение содержимого и операции со словарем четко разделены
+- **Улучшенная поддерживаемость**: Легче понять и модифицировать конфигурации, связанные со словарем
+- **Будущая расширяемость**: Раздел словаря может вмещать дополнительные параметры, характерные для словаря
+- **Комплексное управление словарем**: Включает свойства, такие как `title`, `live`, `priority`, `tags`, `version` и `description` для создания и управления новыми словарями
+
+### Использование конфигурации
+
+Конфигурация словаря служит двум основным целям:
+
+1. **Значения по умолчанию**: Определение значений по умолчанию при создании файлов объявления контента
+2. **Поведение при отсутствии значения**: Предоставление резервных значений, когда определенные поля не определены, позволяя вам глобально определить поведение операций словаря
+
+Раздел словаря включает комплексные свойства для управления словарем:
+
+- **`fill`**: Поведение автозаполнения при генерации контента
+- **`title`**: Заголовок по умолчанию для новых словарей
+- **`live`**: Конфигурация синхронизации в реальном времени для обновлений
+- **`priority`**: Параметры приоритета для разрешения словаря
+- **`tags`**: Теги по умолчанию для организации контента
+- **`version`**: Управление версиями для обновлений словаря
+- **`description`**: Описание по умолчанию для нового контента
+
+Для получения дополнительной информации о файлах объявления контента и применении значений конфигурации см. [Документация по файлам контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
+
+---
+
 ## Команда fill: обновленное поведение для лучшего управления контентом
 
 v7 вводит улучшенное поведение команды `fill`, обеспечивая более предсказуемое и гибкое управление контентом:
@@ -407,6 +531,10 @@ const content = {
 - **`middleware.prefixDefault`**: заменён на `routing.mode`
 - **`middleware.noPrefix`**: заменён на `routing.mode`
 
+### Новые конфигурации
+
+- **`editor.formatCommand`**: Новый параметр для автоматического форматирования кода файлов содержимого
+
 ### Сопоставление миграции
 
 #### Сопоставление конфигураций

package/docs/ru/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Новый Intlayer v9 — Что нового?
 description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections, Variants и Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ export default {
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Plugin Vite `intlayer()` теперь объединяет **компилятор** и **proxy маршрутизации локалей** напрямую, поэтому большинству проектов нужен только один plugin в `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Активируется автоматически, когда задан параметр `compiler.enabled` и настроена путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
+- **Proxy**: Активируется автоматически на основе нового параметра `routing.enableProxy` (`true` по умолчанию). Он подключает middleware обнаружения локалей / перенаправления / переписи в разработке, preview и production SSR. Вам больше не нужно регистрировать `intlayerProxy()` отдельно.
+
+### Опция `routing.enableProxy`
+
+Новая опция `routing.enableProxy` контролирует, подключен ли прокси для маршрутизации локалей. По умолчанию установлено значение `true`. Отключите его, если вы хотите самостоятельно обрабатывать маршрутизацию локалей:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // По умолчанию: true
+  },
+};
+
+export default config;
+```
+
+Отдельные плагины `intlayerCompiler()` и `intlayerProxy()` остаются экспортированными для продвинутых конфигураций. Регистрация их вместе с `intlayer()` безопасна — каждый плагин дедублицирует себя и выполняется только один раз.
+
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:

package/docs/ru/roadmap.md

@@ -29,6 +29,12 @@ Intlayer - это решение для управления контентом
 
 ---
 
+## Оглавление
+
+<TOC/>
+
+---
+
 ## Текущие возможности
 
 ### 1. Объявление контента

package/docs/tr/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer, içerik bildirim dosyalarınız için çevirilerin otomatik olarak oluşturulmasına izin verir. İş akışınıza bağlı olarak bunu başarmanın birden fazla yolu vardır.
 
+## İçindekiler
+
+<TOC/>
+
 ## CMS Kullanarak
 
 Intlayer ile, sadece tek bir yerel ayar yerel olarak bildirilirken, tüm çevirilerin CMS aracılığıyla uzaktan yönetildiği bir iş akışı benimseyebilirsiniz. Bu, içerik ve çevirileri kod tabanından tamamen ayırmaya izin verir, içerik editörleri için daha fazla esneklik sunar ve sıcak içerik yeniden yüklemesini etkinleştirir (değişiklikleri uygulamak için uygulamayı yeniden oluşturmaya gerek yoktur).

package/docs/tr/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# İçerik Bildirim Dosyası Çevirilerini Doldur
+
+**İçerik bildirim dosyalarını otomatik doldur**, CI'nizde geliştirme iş akışınızı hızlandırmanın bir yoludur.
+
+## Davranışı Anlamak
+
+`fill` komutu iki moda sahiptir:
+
+- **Complete**: Her yerel ayar için tüm eksik içeriği otomatik olarak doldurur ve geçerli dosyayı veya belirtilmişse başka bir dosyayı düzenler. Yani, complete modu, zaten çevrilen varsa mevcut içeriğin çevirisini atlar.
+- **Review**: Her yerel ayar için **tüm** içeriği otomatik olarak doldurur ve belirli bir dosya için veya belirtilmişse başka bir dosya için oluşturur.
+
+`fill` komutu tüm yerel ayar içeriği bildirimi dosyalarınızı işleyecektir. Yani, CMS'den uzak içeriğinizi işlemeyecektir. CMS'nin kendi çevirileri yönetimi vardır.
+`@intlayer/sync-json-plugin` gibi eklentileri kullanıyorsanız, Intlayer JSON dosyalarını yerel ayar içeriği bildirimi dosyalarına dönüştürecektir. Yani, `fill` komutu tarafından işleneceklerdir.
+
+Yeni oluşturulan dosyalar, sözlük metaverisi olarak `filled` talimatını içerir. Bu talimat, Intlayer tarafından dosyanın otomatik olarak doldurulup doldurulmadığını bilmek için kullanılır ve varsa bu dosyayı tekrar çevirilmekten atlar.
+
+Intlayer ayrıca otomatik doldurma için aşağıdaki talimatı dikkate alacaktır:
+
+- `.content.{ts|js|json}` dosyanızdan → `fill` talimatı
+- `.intlayer.config.ts` yapılandırma dosyanızdan → `dictionary.fill` talimatı
+- Aksi takdirde varsayılan olarak `true` olarak ayarlanır
+
+Yerel ayara özgü içerik bildirimi dosyaları için, `true` talimatı `./{{fileName}}.fill.content.json` ile değiştirilecektir. Bunun nedeni, yerel ayara özgü bir içerik bildirimi dosyasının ek yerelleştirilmiş içerik alamamasıdır. Yani, mevcut dosyayı üzerine yazmamak için yeni bir dosya oluşturacaktır.
+
+## Varsayılan Davranış
+
+Varsayılan olarak, `fill` global olarak `true` olarak ayarlanır, bu da Intlayer'ın tüm içerik dosyalarını otomatik olarak dolduracağı ve dosyanın kendisini düzenleyeceği anlamına gelir. Bu davranış çeşitli şekillerde özelleştirilebilir:
+
+### Genel Yapılandırma Seçenekleri
+
+1. **`fill: true` (default)** - Tüm locales'i otomatik olarak doldur ve mevcut dosyayı düzenle
+2. **`fill: false`** - Bu content dosyası için auto-fill'i devre dışı bırak
+3. **`fill: "./relative/path/to/file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve mevcut dosyanın konumuna göre çözümlenen göreli yola işaret et
+4. **`fill: "/absolute/path/to/file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve `.intlayer.config.ts` yapılandırma dosyasındaki base directory konumuna (`baseDir` alanı) göre çözümlenen yola işaret et
+5. **`fill: "C:\\absolute\path\to\file"`** - Mevcut dosyayı düzenlemeden belirtilen dosyayı oluştur/güncelle ve işletim sisteminize göre çözümlenen mutlak yola işaret et
+6. **`fill: { [key in Locales]?: string }`** - Her locale için belirtilen dosyayı oluştur/güncelle
+
+### v7 Davranış Değişiklikleri
+
+v7'de, `fill` komutunun davranışı güncellenmiştir:
+
+- **`fill: true`** - Geçerli dosyayı tüm diller için doldurulmuş içerikle yeniden yazar
+- **`fill: "path/to/file"`** - Belirtilen dosyayı geçerli dosyayı değiştirmeden doldurur
+- **`fill: false`** - Otomatik doldurmayı tamamen devre dışı bırakır
+
+Başka bir dosyaya yazmak için bir yol seçeneği kullanırken, doldurma mekanizması içerik deklarasyon dosyaları arasında _ana-köle_ ilişkisi aracılığıyla çalışır. Ana (master) dosya gerçeğin kaynağı olarak hizmet eder ve güncellendiğinde, Intlayer bu değişiklikleri otomatik olarak yol tarafından belirtilen türetilmiş (doldurulmuş) deklarasyon dosyalarına uygular.
+
 # Otomatik Doldurma İçerik Beyan Dosyası Çevirileri
 
 **Otomatik doldurma içerik beyan dosyaları**, geliştirme iş akışınızı hızlandırmanın bir yoludur.
@@ -88,6 +135,40 @@ Intlayer, ana dosyada henüz beyan edilmemiş tüm yerelleri doldurarak, türeti
 
 Daha sonra, her iki beyan dosyası tek bir sözlükte birleştirilecek ve standart `useIntlayer("example")` hook'u (react) / composable'ı (vue) kullanılarak erişilebilir olacaktır.
 
+## Genel Konfigürasyon
+
+`intlayer.config.ts` dosyasında genel otomatik doldurma konfigürasyonunu yapılandırabilirsiniz.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // Tüm sözlükler için eksik çevirileri otomatik oluştur
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // "./{{fileName}}.content.json" kullanarak tüm sözlükler için eksik çevirileri otomatik oluştur
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+İçerik dosyalarında `fill` alanını kullanarak her sözlük için ince ayar yapabilirsiniz. Intlayer önce sözlük başına konfigürasyonu dikkate alır, ardından genel konfigürasyona geri döner.
+
 ## Otomatik Doldurulmuş Dosya Formatı
 
 Önerilen otomatik doldurulmuş beyan dosyalarının formatı, biçimlendirme kısıtlamalarından kaçınmaya yardımcı olan **JSON** formatıdır. Ancak, Intlayer `.ts`, `.js`, `.mjs`, `.cjs` ve diğer formatları da destekler.

package/docs/tr/benchmark/solid.md

@@ -118,6 +118,28 @@ Framework, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip
 - **Scoped static**: Karmaşık ek ağ istekleri olmadan kodu düzenli tutar (mantıksal ayrım).
 - **Scoped dynamic**: _Kod bölme_ ve performans için en iyi yaklaşım. Yalnızca geçerli görünüm ve aktif dil için gerekenleri yükleyerek belleği minimize eder.
 
+### Ölçtüklerim:
+
+Aynı çok dilli uygulamayı her stack için gerçek bir tarayıcıda çalıştırdım, ardından tel üzerinde tam olarak ne göründüğünü ve işlerin ne kadar sürdüğünü not ettim. Boyutlar **normal web sıkıştırmasından sonra** rapor edilir, çünkü bu ham kaynak sayılarından daha çok insanların indirdiklerine yakındır.
+
+- **Internationalization kütüphanesi boyutu**: Bundling, tree-shaking ve minification işleminden sonra, i18n kütüphanesinin boyutu, boş bir bileşendeki sağlayıcılar + hooks/primitives kodunun boyutudur. Çeviri dosyalarının yüklenmesini içermez. Kütüphanenin içeriğiniz devreye girmeden önceki maliyetinin ne olduğunu yanıtlar.
+
+- **Sayfa başına JavaScript**: Her benchmark rotası için, tarayıcının bu ziyaret için çektiği betik miktarı, paketteki sayfalar (ve rapor onları topladığında yerel ayarlar) arasında ortalanmıştır. Ağır sayfalar yavaş sayfalardır.
+
+- **Diğer yerel ayarlardan sızıntı**: Denetlenen sayfada yanlışlıkla yüklenebilecek başka bir dilde aynı sayfanın içeriğidir. Bu içerik gereksizdir ve kaçınılmalıdır. (ör. `/fr/about` sayfa içeriği `/en/about` sayfa paketinde)
+
+- **Diğer rotalardan sızıntı**: Aynı fikir **uygulamadaki diğer ekranlar** için: sadece bir sayfayı açarken kopyalarının birlikte gidip gitmediği. (ör. `/en/about` sayfa içeriği `/en/contact` sayfa paketinde). Yüksek bir skor zayıf bölme veya çok geniş paketler hinting.
+
+- **Ortalama bileşen paketi boyutu**: Ortak UI parçaları **birer birer** ölçülür, bir dev app numarasının içinde gizlenmek yerine. Internationalization'ın sessizce günlük bileşenleri şişirip şişirmediğini gösterir. Örneğin, bileşeniniz yeniden render edilirse, bellekten tüm bu verileri yükleyecektir. Herhangi bir bileşene bir dev JSON bağlamak, bileşenlerinizin performansını yavaşlatacak kullanılmayan verilerin büyük bir deposunu bağlamak gibidir.
+
+- **Dil değiştirme duyarlılığı**: Uygulamanın kendi kontrolünü kullanarak dili çeviririm ve sayfanın açıkça değiştiği, bir ziyaretçinin fark edeceği, laboratuvar mikro adımı değil ne kadar sürdüğünü ölçerim.
+
+- **Dil değişikliğinden sonraki işleme çalışması**: Dar bir takip: arayüzün geçiş uçuşta iken yeni dil için yeniden boyamak için ne kadar çaba gerektiği. "Hissedilen" zaman ve çerçeve maliyeti farklılık gösterdiğinde yararlı.
+
+- **İlk sayfa yükleme zamanı**: Tarayıcının test ettiğim senaryolar için sayfayı tamamen yüklenmiş olarak görene kadar navigasyon. Soğuk başlangıçları karşılaştırmak için iyi.
+
+- **Rehidrasyon zamanı**: Uygulama bunu gösterdiğinde, istemcinin sunucu HTML'sini gerçekten tıklayabileceğiniz bir şeye dönüştürmek için harcadığı zaman. Tablolardaki bir çizgi, bu uygulamanın bu benchmark'ta güvenilir bir rehidrasyon şekli sağlamadığı anlamına gelir.
+
 ## GitHub Yıldızları
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.

package/docs/tr/benchmark/svelte.md

@@ -116,6 +116,28 @@ Framework, **10 sayfa** ve **10 dilden** oluşan çok dilli bir uygulamaya sahip
 - **Scoped static**: Karmaşık ek ağ istekleri olmadan kodu düzenli tutar (mantıksal ayrım).
 - **Scoped dynamic**: _Kod bölme_ ve performans için en iyi yaklaşım. Yalnızca geçerli görünüm ve aktif dil için gerekenleri yükleyerek belleği minimize eder.
 
+### Ölçtüğüm şeyler:
+
+Aynı çok dilli uygulamayı her stack için gerçek bir tarayıcıda çalıştırdım, ardından tel üzerinde gerçekten ne göründüğünü ve ne kadar sürdüğünü not ettim. Boyutlar **normal web sıkıştırmasından sonra** raporlanır, çünkü bu ham kaynak sayılarından daha yakın olduğu insanları indir.
+
+- **Uluslararasılaştırma kitaplığı boyutu**: Bundling, tree-shaking ve minification sonrasında, i18n kitaplığının boyutu, sağlayıcılar + boş bir bileşendeki kod depolama boyutudur. Çeviri dosyalarının yüklenmesini içermez. Bu, içeriğiniz resme girmeden önce kitaplığın ne kadar pahalı olduğunu yanıtlar.
+
+- **Sayfa başına JavaScript**: Her benchmark rotası için, tarayıcının bu ziyaret için ne kadar script çektiği, paketteki sayfalar arasında ortalaması alınmıştır (ve rapor onları topladığında yerel ayarlar arasında). Ağır sayfalar yavaş sayfalar.
+
+- **Diğer yerel ayarlardan sızıntı**: Denetlenen sayfaya yanlışlıkla yüklenecek aynı sayfanın başka bir dildeki içeriğidir. Bu içerik gereksizdir ve kaçınılmalıdır. (örn. `/fr/about` sayfa içeriği `/en/about` sayfa paketinde)
+
+- **Diğer rotalardan sızıntı**: Aynı fikir **uygulamadaki diğer ekranlar** için: yalnızca bir sayfa açtığınızda kopyalarının eşlik edip etmediği. (örn. `/en/about` sayfa içeriği `/en/contact` sayfa paketinde). Yüksek bir puan, zayıf bölme veya çok geniş paketleri işaret eder.
+
+- **Ortalama bileşen paket boyutu**: Ortak kullanıcı arayüzü parçaları, bir dev uygulama numarası içinde gizlenmek yerine **tek tek** ölçülür. Uluslararasılaştırmanın günlük bileşenleri sessizce şişirip şişirmediğini gösterir. Örneğin, bileşeniniz yeniden işlenirse, bellek içinden tüm bu verileri yükleyecektir. Herhangi bir bileşene devasa bir JSON eklemek, bileşenlerinizin performansını yavaşlatacak kullanılmayan büyük bir veri deposunu bağlamak gibidir.
+
+- **Dil değiştirme yanıt hızı**: Uygulamanın kendi denetimini kullanarak dili değiştiririm ve sayfa açıkça değişinceye kadar ne kadar sürdüğünü ölçerim, ziyaretçinin fark edeceği şey, laboratuvar mikro adımı değil.
+
+- **Dil değişikliğinden sonra işleme çalışması**: Daha dar bir takip: dil değişimi uçuş halinde olduktan sonra arayüzün yeni dili yeniden boyamak için ne kadar çaba harcadığı. "Hissedilen" süre ve çerçeve maliyeti farklılaştığında kullanışlıdır.
+
+- **İlk sayfa yükleme süresi**: Gezintiden tarayıcıya test ettiğim senaryolar için sayfanın tamamen yüklenmiş olarak kabul etmesine kadar. Soğuk başlangıçları karşılaştırmak için iyi.
+
+- **Hidrasyon süresi**: Uygulama bunu ortaya çıkardığında, istemcinin sunucu HTML'sini gerçekten tıklayabileceğiniz bir şeye dönüştürmede harcadığı süre. Tablolardaki bir tire, bu uygulamanın bu kıyaslama da güvenilir bir hidrasyon rakamı sağlamadığı anlamına gelir.
+
 ## GitHub Yıldızları
 
 GitHub yıldızları, bir projenin popülerliğinin, topluluk güveninin ve uzun vadeli alakasının güçlü bir göstergesidir. Teknik kalitenin doğrudan bir ölçüsü olmasa da, kaç geliştiricinin projeyi yararlı bulduğunu, ilerlemesini takip ettiğini ve benimseme olasılığını yansıtır. Bir projenin değerini tahmin etmek için yıldızlar, alternatifler arasındaki çekişi karşılaştırmaya yardımcı olur ve ekosistem büyümesi hakkında içgörüler sağlar.