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

package/docs/ru/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Документация плагина Vite intlayerCompiler | vite-intlayer
+description: Плагин Vite, который извлекает встроенные объявления контента Intlayer из файлов компонентов и записывает их в файлы JSON словаря во время сборки/трансформации.
+keywords:
+  - intlayerCompiler
+  - vite
+  - плагин
+  - компилятор
+  - контент
+  - словарь
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Интегрировано в intlayer(); инициализация доки"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` — это плагин Vite, который сканирует исходные файлы компонентов на наличие **встроенных объявлений контента Intlayer** (inline declarations) — контента, определенного непосредственно внутри компонента, а не в отдельном файле `.content.ts`, — и записывает их в файлы JSON словаря во время фазы трансформации.
+
+> **Начиная с Intlayer v9** `intlayerCompiler` автоматически включается в основной плагин [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md), если в конфигурации Intlayer включен компилятор (`compiler.enabled: true`) и задан путь вывода (`compiler.output`). Вам нужно регистрировать его отдельно только в том случае, если вы хотите полностью контролировать конфигурацию компилятора.
+
+## Использование
+
+### В составе `intlayer()` (рекомендуется, v9+)
+
+Включите компилятор в конфигурации Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // куда записываются извлеченные словари
+  },
+});
+```
+
+Затем используйте стандартный плагин без дополнительной регистрации:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Отдельно (при необходимости)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Опции
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Опция            | Тип                       | Описание                                                                                       |
+| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Переопределение конфигурации Intlayer, передаваемое в `getConfiguration()`.                    |
+| `compilerConfig` | `Partial<CompilerConfig>` | Переопределение специфичных настроек компилятора (например, `enabled`, `output`, `filesList`). |
+
+### Пример
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Как это работает
+
+### Фаза трансформации
+
+Для каждого исходного файла, соответствующего `compiler.filesList`, плагин компилятора:
+
+1. Пропускает содержимое файла через `extractContent` из `@intlayer/babel`.
+2. Вызывает `onExtract` для каждого найденного объявления, записывая результирующий JSON словаря в `compiler.output`.
+3. Возвращает трансформированный исходный код со встроенными объявлениями, замененными стандартными вызовами `useIntlayer('key')` / `getIntlayer('key')`.
+
+Поддерживаемые типы файлов: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Когда файл компонента сохраняется в режиме разработки, компилятор:
+
+1. Обнаруживает изменение файла через хук `handleHotUpdate` в Vite.
+2. Повторно извлекает контент из обновленного файла.
+3. Записывает обновленный JSON словаря.
+4. Запускает полную перезагрузку страницы (`server.ws.send({ type: 'full-reload' })`).
+
+Задержка (debounce) в 500 мс предотвращает бесконечный цикл повторного извлечения, вызываемый самой записью словаря (которая также запускает событие изменения файла).
+
+### Дедупликация
+
+`intlayerCompiler` использует тот же механизм дедупликации `createPrimaryInstanceGuard`, что и другие встроенные плагины. Когда присутствуют как `intlayer()` (который включает компилятор), так и ручной вызов `intlayerCompiler()`, запускается только первый зарегистрированный экземпляр — словари не записываются дважды.

package/docs/ru/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Документация плагина Vite intlayerMinify | vite-intlayer
+description: Плагин Vite, который минимизирует скомпилированные файлы JSON словаря Intlayer и опционально скрывает имена полей содержимого для уменьшения размера бандла.
+keywords:
+  - intlayerMinify
+  - vite
+  - плагин
+  - минимизация
+  - размер бандла
+  - словарь
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Инициализация доки"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` — это плагин Vite, который минимизирует скомпилированные JSON-файлы словарей во время сборки для продакшена. Он удаляет все ненужные пробельные символы и, в сочетании с `intlayerPrune`, опционально переименовывает поля содержимого в короткие буквенные алиасы (`a`, `b`, `c`, …) для дополнительного уменьшения размера бандла.
+
+> Плагин уже автоматически включен и настроен, если вы используете [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md). Вам нужно регистрировать его вручную только в том случае, если вы самостоятельно собираете стек плагинов.
+
+## Использование
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Условия активации
+
+`intlayerMinify` активен **только** при выполнении всех трех следующих условий:
+
+1. Команда Vite — `build` (не `serve` / dev).
+2. `build.optimize` имеет значение `true` (или `undefined`, что по умолчанию равно `true` для сборок).
+3. `build.minify` имеет значение `true` в вашей конфигурации Intlayer.
+
+Он автоматически **отключается**, когда `editor.enabled` имеет значение `true`, так как редактору требуется полное, понятное человеку содержимое словарей.
+
+## Что минимизируется
+
+Плагин обрабатывает два пути хранения словарей (определяемых из `intlayer.system`):
+
+- `dictionariesDir` — статические словари для всех языков (например, `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — динамические словари для конкретных языков
+
+> Словари в режиме fetch (`fetchDictionariesDir`) **никовы** не минимизируются, поскольку они запрашиваются из удаленного API во время выполнения с использованием исходных имен полей. Переименование полей привело бы к несоответствию между ответом сервера и обращениями к свойствам на стороне клиента.
+
+## Сокрытие имен полей (минимизация свойств)
+
+Когда `intlayerPrune` анализирует кодовую базу и заполняет карту `pruneContext.dictionaryKeyToFieldRenameMap`, `intlayerMinify` также переименовывает имена полей контента в короткие алиасы. Например:
+
+```json
+// до
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// после (с сокрытием)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Соответствующие обращения к свойствам в исходных файлах переименовываются на шаге Babel в `intlayerOptimize`, поэтому поведение в рантайме остается неизменным.
+
+Внутренние поля Intlayer (`nodeType`, `translation` и т.д.) никогда не переименовываются.
+
+## Крайние случаи (Edge-cases)
+
+Словари, отмеченные в `pruneContext.dictionariesWithEdgeCases` (структурные аномалии, обнаруженные во время фазы очистки), полностью пропускаются — они не минимизируются и не скрываются, чтобы избежать отправки поврежденных данных.
+
+## Квалифицированные группы (коллекции / варианты / метаданные)
+
+Для словарей с массивом `qualifierTypes` (коллекции, варианты и метаданные) плагин сохраняет массив `qualifierTypes` и карту `meta` без изменений. Маскируются только имена полей внутри записей `content`. Композитные ключи (используемые для сопоставления селекторов во время выполнения) никогда не изменяются.

package/docs/ru/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Документация плагина Vite intlayerProxy | vite-intlayer
+description: Middleware локализации роутинга для серверов dev/preview в Vite и серверного рендеринга (SSR) в продакшене. Обрабатывает определение языка, перенаправления URL и внутренние перезаписи путей.
+keywords:
+  - intlayerProxy
+  - vite
+  - плагин
+  - middleware
+  - локаль
+  - роутинг
+  - интернационализация
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Параметр configOptions объединен в один объект настроек; прокси встроен в intlayer()"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy` — это плагин Vite, который регистрирует промежуточное ПО (middleware) локализации роутинга для **любой среды**: dev-сервера, preview-сервера и продакшен SSR (Nitro / TanStack Start).
+
+> **Начиная с Intlayer v9** `intlayerProxy` автоматически включается в основной плагин [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md) и активирован по умолчанию с помощью настройки `routing.enableProxy: true`. Вам нужно регистрировать его отдельно только в том случае, если вам нужен низкоуровневый контроль или если вы используете его за пределами стандартной конфигурации `intlayer()`.
+
+## Использование
+
+### В составе `intlayer()` (рекомендуется, v9+)
+
+Передайте параметры `proxy` в основной плагин вместо отдельной регистрации `intlayerProxy`:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Отдельно (при необходимости)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Параметры
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Все параметры являются необязательными и передаются в виде единого объекта:
+
+| Параметр        | Тип                                 | Описание                                                                                                                                                                                  |
+| --------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ignore`        | `(req: IncomingMessage) => boolean` | Предикат, который исключает запросы из локализации роутинга. Верните `true`, чтобы пропустить запрос (например, для роутов API, health check-ов).                                         |
+| `configOptions` | `GetConfigurationOptions`           | Переопределения конфигурации Intlayer, передаваемые в `getConfiguration()`. Используйте, когда вам нужно, чтобы прокси читал конкретный конфигурационный файл или переопределял значения. |
+
+### Пример
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler` создает независимый от фреймворка Node.js middleware `(req, res, next)`, который содержит всю логику локализации роутинга. Это полезно в средах, где API плагинов Vite недоступен (например, на обычном сервере Node.js или в кастомном модуле Nitro).
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### Продакшен SSR (TanStack Start / Nitro через h3)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Поведение роутинга
+
+Этот middleware дублирует логику роутинга из middleware `next-intlayer` и поддерживает все режимы роутинга Intlayer.
+
+### Режимы роутинга
+
+| Режим           | URL виден в браузере     | Поведение                                                                                                                         |
+| --------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/ru/about`              | По умолчанию. Префикс языка в URL. Язык по умолчанию перенаправляет на URL без префикса, если не активен `prefix-all`.            |
+| `prefix-all`    | `/en/about`, `/ru/about` | Все языки (включая язык по умолчанию) всегда имеют префикс в URL.                                                                 |
+| `no-prefix`     | `/about`                 | Нет языка в URL. Язык сохраняется только в cookies; перезапись URL происходит на внутреннем уровне.                               |
+| `search-params` | `/about?locale=ru`       | Язык передается как query-параметр. Перенаправляет для добавления/обновления параметра `locale`, если он отсутствует или устарел. |
+
+### Приоритет определения
+
+1. Префикс пути URL (например, `/ru/about` → `ru`).
+2. Значение в cookie / localStorage (`intlayer-locale`).
+3. Заголовок `Accept-Language`.
+4. `defaultLocale` из конфигурации.
+
+### Автоматический обход (Bypass)
+
+Этот middleware всегда пропускает следующие запросы напрямую без обработки локали:
+
+- Запросы, соответствующие предикату `ignore`.
+- `/node_modules/**`
+- `/@**` — внутренние запросы Vite (`@vite/`, `@fs/`, `@id/` и т.д.).
+- `/_**` — внутренние запросы сервера (`__vite_ping`, `__manifest` и т.д.).
+- Запросы, путь которых заканчивается расширением файла (статические файлы). Если в пути статического файла присутствует языковой префикс (например, `/ru/logo.png`), он удаляется, чтобы файл мог быть отдан корректно.
+
+### Роутинг по доменам
+
+Когда в вашей конфигурации Intlayer настроен параметр `routing.domains`, этот middleware обрабатывает роутинг языков между разными доменами:
+
+- Запрос для `/zh/about` на домене `intlayer.org` перенаправляется на `https://intlayer.zh/about`, когда `domains.zh = "intlayer.zh"`.
+- Запрос к `intlayer.zh/about` внутренне переписывается в `/zh/about`, чтобы заполнился параметр маршрута `[locale]`.
+
+### Защита от бесконечного редиректа
+
+Этот middleware отслеживает количество перенаправлений для пары `originalUrl → newUrl` в скользящем 2-секундном окне. Более 10 перенаправлений в этом окне возвращают ошибку `500` с подробным описанием вместо бесконечного цикла.
+
+## Nitro / SSR в продакшене (автоматическое внедрение, v9+)
+
+Когда `intlayerProxy` используется как плагин Vite, он содержит свойство `.nitro`. Плагин сборки `nitro/vite` считывает это свойство и помещает его в `nitroConfig.modules`, благодаря чему `intlayerNitroHandler` регистрируется как middleware сервера Nitro автоматически — для продакшен SSR не требуется ручная настройка.
+
+Обработчик Nitro использует модель событий Web Fetch API h3 v2 (а не `fromNodeMiddleware`), поэтому он совместим со всеми пресетами Nitro: Node, Bun, Deno, edge runtimes.
+
+## Устаревшие алиасы
+
+| Устаревший экспорт         | Замена          |
+| -------------------------- | --------------- |
+| `intlayerMiddleware`       | `intlayerProxy` |
+| `intLayerMiddlewarePlugin` | `intlayerProxy` |

package/docs/ru/plugins/sync-json.md

@@ -109,7 +109,6 @@ const config: IntlayerConfig = {
      * Загрузит, а также запишет результат и переводы обратно в JSON-файлы в директории locales
      */
     syncJSON({
-      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       priority: 0,
       format: "i18next",

package/docs/ru/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-23
+updatedAt: 2026-06-26
 title: Новый Intlayer v9 — Что нового?
-description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections, Variants и Dynamic Records.
+description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections и Variants.
 keywords:
   - Intlayer
   - Совместимость
   - Миграция
   - Collections
   - Variants
-  - Dynamic Records
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # Новый Intlayer v9 — Что нового?
 
-Добро пожаловать в Intlayer v9! Этот мажорный релиз знаменует собой важную веху в упрощении миграции на Intlayer благодаря **пакетам адаптеров совместимости (Compat Adapter Packages)** для популярных библиотек i18n (`react-i18next`, `next-intl`, `vue-i18n` и др.), а также добавляет поддержку сложных структур контента: **Collections** (Коллекции), **Variants** (Варианты) и **Dynamic Records** (Динамические записи).
+Добро пожаловать в Intlayer v9! Этот мажорный релиз знаменует собой важную веху в упрощении миграции на Intlayer благодаря **пакетам адаптеров совместимости (Compat Adapter Packages)** для популярных библиотек i18n (`react-i18next`, `next-intl`, `vue-i18n` и др.), а также добавляет поддержку сложных структур контента: **Collections** (Коллекции) и **Variants** (Варианты).
 
 ## Содержание
 
@@ -41,8 +40,10 @@ author: aymericzip
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 Например, просто замените:
 
@@ -100,7 +101,7 @@ export default defineConfig({
 
 ---
 
-## Спецификация функций: Collections, Variants и Dynamic Records
+## Спецификация функций: Collections и Variants
 
 Intlayer v9 выходит за рамки статических объектов типа ключ-значение, позволяя словарям объявлять динамические структуры макетов со сквозной типизацией.
 
@@ -144,6 +145,8 @@ const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: s
 
 Используйте для A/B-тестирования, сезонных заголовков, фича-флагов или кастомных целевых страниц:
 
+#### Строковые варианты (например, A/B-тестирование)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +170,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. Динамические записи (Dynamic Records)
-
-Определяйте словари, записи которых загружаются динамически во время выполнения по идентификаторам запросов:
+#### Объектные варианты (например, динамические записи)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -229,7 +230,7 @@ export default defineConfig({
 });
 ```
 
-- **Compiler**: Активируется автоматически, когда задан параметр `compiler.enabled` и настроена путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
+- **Compiler**: Активируется автоматически, когда параметр `compiler.enabled` установлен в `true` и настроен путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
 - **Proxy**: Активируется автоматически на основе нового параметра `routing.enableProxy` (`true` по умолчанию). Он подключает middleware обнаружения локалей / перенаправления / переписи в разработке, preview и production SSR. Вам больше не нужно регистрировать `intlayerProxy()` отдельно.
 
 ### Опция `routing.enableProxy`
@@ -252,17 +253,61 @@ export default config;
 
 ---
 
+## Компилятор отключён по умолчанию
+
+Начиная с Intlayer v9, **компилятор отключён по умолчанию** (значение `compiler.enabled` теперь по умолчанию равно `false`). Чтобы включить извлечение ваших файлов `.content.ts` во время сборки, установите `compiler.enabled: true` в своей конфигурации:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // По умолчанию: false — требуется для включения компилятора начиная с v9
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+Когда компилятор отключён, Intlayer пропускает этап извлечения во время сборки и полагается на уже объявленные вами словари. Включайте его только тогда, когда хотите, чтобы плагин сборщика (`@intlayer/swc`, `@intlayer/babel` или Vite-плагин `intlayer()`) извлекал содержимое автоматически.
+
+---
+
+## React Native: импорт из одного пакета
+
+В приложении React Native или Expo вам больше не нужно жонглировать `react-intlayer` и `react-native-intlayer`. Пакет `react-native-intlayer` теперь **реэкспортирует весь API `react-intlayer`** (хуки, утилиты и подпути `/format`, `/html` и `/markdown`), а его `IntlayerProvider` автоматически применяет полифиллы React Native.
+
+Импортируйте все из единого пакета `react-native-intlayer`:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> Импорт из `react-intlayer` продолжает работать, но `react-native-intlayer` теперь является рекомендуемой единой точкой входа для React Native — его провайдер включает полифиллы, которых нет в веб-ориентированном провайдере `react-intlayer`.
+
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:
 
+- **Компилятор отключён по умолчанию**: значение `compiler.enabled` теперь по умолчанию равно `false`. Если вы полагаетесь на извлечение ваших файлов `.content.ts` во время сборки, установите `compiler.enabled: true` в своём `intlayer.config.ts`.
 - **Локали и диалекты (Locales & Dialects)**: Если вы используете внешние зависимости i18n, добавьте соответствующие плагины адаптеров совместимости в вашу конфигурацию или настройки сборщика для автоматической перезаписи импортов.
-- **Кастомные селекторы (Custom Selectors)**: При вызове `useIntlayer` второй параметр теперь зарезервирован для объекта опций, содержащего `{ locale, item, variant, id }`. Если ранее вы передавали строку локали напрямую, вы все еще можете это делать, но для расширенного выбора рекомендуется использовать объект опций.
+- **Кастомные селекторы (Custom Selectors)**: При вызове `useIntlayer` второй параметр теперь зарезервирован для объекта опций, содержащего `{ locale, item, variant }`. Если ранее вы передавали строку локали напрямую, вы все еще можете это делать, но для расширенного выбора рекомендуется использовать объект опций.
 
 ---
 
 ## Полезные ссылки
 
 - [Руководство по пакетам адаптеров совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md)
-- [Динамические словари — Collections, Variants и Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
+- [Динамические словари — Collections и Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dynamic_dictionaries/index.md)
 - [Справочник по конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)

package/docs/tr/compiler.md

@@ -81,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Derleyici eklentisini ekler
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/tr/custom_domains.md

@@ -172,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/tr/custom_url_rewrites.md

@@ -342,10 +342,16 @@ SolidJS, Vue ve Svelte için `intlayerProxy` Vite eklentisi geliştirme sırası
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```