@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/tr/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer, tamamen kendi altyapınızda çalışabilir; Intlayer Cloud hesabı gerekmez. Tek bir komutla üretime hazır bir yığını başlatabilirsiniz:
 
+Tek bir komut her şeyi kurar:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Yükleyici, bir `docker-compose.yml` ve bir `.env` indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve tüm kapsayıcıları `docker compose up -d` ile başlatır.
 
+Tek dış bağımlılık **MongoDB**'dir: backend, sağladığınız bir MongoDB **Atlas** cluster'ına bağlanır. Diğer her şey kontainer içinde çalışır.
+
 ## İçindekiler
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (Puppeteer ekran görüntüsü oluşturma için kullanılır) backend g
 - Ana bilgisayarda `3000`, `3100`, `8025`, `9000` ve `9001` bağlantı noktalarının kullanılabilir olması.
 - Bir Linux veya macOS ana bilgisayarı (veya Windows'ta WSL2).
 
+Diğer her şey — Bun, Redis, MinIO, Chromium — image içinde gelir.
+
 ---
 
-## Hızlı Başlangıç
+## Hızlı başlangıç
+
+### 1. Installer'ı çalıştırın
 
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Yükleyicinin yaptığı işlemler:
+Docker'ın yüklü ve çalışır durumda olduğunu doğrular, `BETTER_AUTH_SECRET` ve `S3_SECRET_ACCESS_KEY` zaten oluşturulmuş şekilde `./intlayer.env` dosyasını yazar ve image'ı çeker. Container'ı başlatmaz — backend, veritabanı kimlik bilgileriniz olmadan önyüklenemiyor.
+
+Installer'ı yeniden çalıştırmak güvenlidir: mevcut `intlayer.env` asla üzerine yazılmaz, bu nedenle güncelleme yolu olarak da işlev görür.
+
+### 2. Kimlik bilgilerinizi doldurun
+
+`intlayer.env` dosyasını açın ve `TODO` ile işaretlenmiş değerleri tamamlayın:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Dosya ayrıca isteğe bağlı özellikler için yorum satırı içeren bloklar taşır — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` ve OAuth sağlayıcıları. İhtiyacınız olanların yorum satırını kaldırın.
+
+> Dosya `docker run --env-file` tarafından okunur ve tırnak işaretlerini kaldırmaz ve `=` işaretinden sonraki her şeyi değer olarak kabul eder. Çıplak değerler yazın ve açıklamaları kendi satırlarında tutun.
+
+### 3. Container'ı başlat
+
+Bu, yükleyici bittiğinde yazdıran komuttur:
+
+```sh
+docker run -d --name intlayer \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+Ardından **http://localhost:3000** adresini açın. İlk başlangıçta veri depolarını başlatır, bu nedenle bir dakika bekleyin.
+
+> Dashboard `localhost` üzerinde sunulur. Bkz. [Sınırlamalar](#limitations) — yayınlanan görüntü özel alanları desteklemez.
 
-1. `docker` ve `docker compose`'un mevcut olduğunu kontrol eder.
-2. `docker-compose.yml` ve `.env.example` dosyalarını `./intlayer/` dizinine indirir.
-3. `.env` dosyası mevcut değilse, örneği kopyalar ve `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` ve `S3_SECRET_ACCESS_KEY` için `openssl rand` aracılığıyla rastgele gizli anahtarlar oluşturur.
-4. `docker compose pull` + `docker compose up -d` komutlarını çalıştırır.
-5. URL'leri yazdırır: kontrol paneli `:3000`, API `:3100`, e-posta arayüzü `:8025`, MinIO konsolu `:9001`.
+### Installer ayarları
 
-Yığın çalışmaya başladıktan sonra **http://localhost:3000** adresini açın ve ilk hesabınızı oluşturun.
+Installer birkaç ortam değişkenini okur. `sh` içine yönlendirildiği için, onları `curl` yerine shell'e iletin:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Değişken                  | Varsayılan                                    | Açıklama                      |
+| ------------------------- | --------------------------------------------- | ----------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Çekilecek image               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Env dosyasının yazılacağı yer |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container adı                 |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | `/data` dizinine bağlı volume |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Dashboard için host portu     |
+| `INTLAYER_API_PORT`       | `3100`                                        | API için host portu           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API için host portu  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO konsolu için host portu |
+
+> Dört port değişkeni yalnızca `docker run` komutunda yazdırılan eşlemenin **host** tarafını değiştirir. Yayınlanan image, derleme zamanında dashboard bundle'ına `http://localhost:3000`, `http://localhost:3100` ve `http://localhost:9000` derlenmiş olarak sahiptir, bu nedenle onları yeniden eşlemek tarayıcıyı eski portlara işaret ettirir. Kendi image'ınızı oluşturmıyorsanız varsayılanları tutun — [Sınırlamalar](#limitations)'a bakın.
 
 ---
 
@@ -103,8 +161,6 @@ Bir admin mevcut olduğunda, `/init` standart oturum açma sayfasına yönlendir
 | **minio**   | `minio/minio`                                     | `9000` (S3), `9001` (konsol)          | Avatarlar ve ekran görüntüleri için S3 uyumlu nesne depolama |
 | **mailpit** | `axllent/mailpit`                                 | `1025` (SMTP), `8025` (web UI)        | Yerel işlem e-postası alıcısı                                |
 
-Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara açık değildir.
-
 > MinIO bağlantı noktası `9000` tarayıcı tarafından erişilebilir olmalıdır çünkü yüklenen varlıklar (avatarlar, ekran görüntüleri) doğrudan `S3_PUBLIC_URL=http://localhost:9000/intlayer` adresinden yüklenir.
 
 ---
@@ -160,8 +216,6 @@ Dahili bağlantı noktaları (mongo, redis) varsayılan olarak ana bilgisayara a
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth girişi                                                       |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth girişi                                                      |
 
----
-
 ### Global mailer
 
 Varsayılan olarak, tüm işlemsel e-postalar Resend üzerinden `RESEND_API_KEY` kullanılarak gönderilir. Self-hosted dağıtımlar bunun yerine **tüm** e-postaları — şifre sıfırlamaları ve magic linkler gibi organizasyon dışı e-postalar dahil — ortam değişkenleriyle yapılandırılmış global bir mailer üzerinden yönlendirebilir.
@@ -247,16 +301,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Yükseltme
 
-Mevcut bir dağıtım üzerinde yükleyiciyi yeniden çalıştırmak, kademeli bir yükseltme gerçekleştirir:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Bu, en son görüntüleri çeker ve kapsayıcıları `docker compose pull && docker compose up -d` ile yeniden başlatır. Mevcut birimler (`mongo-data`, `redis-data`, `minio-data`) korunur; veri kaybı olmaz.
 
-Manuel olarak `./intlayer/` dizini içinden yükseltme yapmak için:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,15 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Log dosyasının üst kısmına yakın yerde `MongoDB connection error` (MongoDB bağlantı hatası) ifadesini arayın.
+
 ### Kontrol Paneli API'ye Ulaşamıyor
 
 `VITE_BACKEND_URL`'in backend'e **tarayıcıdan** (Docker ağı değil) erişilebilen URL ile eşleştiğini doğrulayın. Backend portunu değiştirdiyseniz veya bir ters proxy eklediyseniz, kontrol paneli görüntüsünü yeniden oluşturun:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### MinIO Kovası Eksik
 
 Eğer `minio-init` tek seferlik servisi çalışmadıysa (veya MinIO hazır olmadan önce çalıştıysa), kovayı manuel olarak oluşturun:

package/docs/uk/CI_CD.md

@@ -100,6 +100,8 @@ npx intlayer fill --unpushed --mode fill    # Заповнює лише відс
 >
 > If you have multiple apps in your repo using separate intlayer instances, you can use the `--base-dir` argument like this:
 
+> Якщо у вашому репозиторіумі є кілька програм, які використовують окремі екземпляри intlayer, ви можете використовувати аргумент `--base-dir` таким чином:
+
 ```bash fileName=".husky/pre-push"
 # Додаток 1
 npx intlayer build --base-dir ./app1

package/docs/uk/benchmark/tanstack.md

@@ -194,6 +194,8 @@ history:
 
 `Tolgee` вирішує багато зі згаданих проблем. Проте почати роботу з ним здалося мені важче, ніж з іншими інструментами з подібними підходами. Він не забезпечує типізацію, що значно ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати Tolgee API своїми рішеннями, щоб додати перевірку відсутніх ключів.
 
+Пакет досить важкий (~11.1kb, що більш ніж у 2 рази більше за `react-intlayer`).
+
 На TanStack Start я також мав проблеми з реактивністю: при зміні локалі довелося примусово перерендерити провайдер і підписуватися на події зміни локалі, щоб завантаження іншою мовою працювало коректно.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ history:
 
 Проте він має ті ж недоліки, що й стеки на базі `t('a.b.c')`: оптимізація можлива, але забирає багато часу, а великі проекти ризикують скотитися до поганих практик (простори імен + динамічне завантаження + типи).
 
+Пакет особливо важкий (~17.3kb, що становить близько 3.5× `react-intlayer`).
+
 Формати повідомлень також відрізняються: `use-intl` використовує ICU MessageFormat, тоді як `i18next` має власний формат - це ускладнює інструментарій або міграцію, якщо ви їх змішуєте.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ history:
 
 `react-intl` - це продуктивна реалізація від команди Format.js. DX залишається багатослівним: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` додає складності, додаткової роботи JavaScript та прив'язує глобальний екземпляр i18n до багатьох вузлів у React-дереві.
 
+Пакет також важкий (~14.4kb, що становить близько 3× `react-intlayer`).
+
 ### 4 - Рекомендації
 
 Цей бенчмарк TanStack Start не має прямого еквівалента `next-translate` (Next.js плагін + `getStaticProps`). Командам, які справді хочуть API у стилі `t()` зі зрілою екосистемою, `react-i18next` та `use-intl` залишаються "розумним" вибором, але будьте готові витратити багато часу на оптимізацію для уникнення витоків.

package/docs/uk/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Використання в CI/CD пайплайнах
 
+Запуск `intlayer init` створює два готові до використання workflow'и GitHub Actions для вас (див. [Scaffolded GitHub Actions](#scaffolded-github-actions) нижче). Приклад тут показує еквівалентне налаштування за допомогою команди `ci` для monorepo, де облікові дані вводяться для кожного проекту з `INTLAYER_PROJECT_CREDENTIALS`.
+
 У вашій конфігурації CI/CD (наприклад, GitHub Actions, GitLab CI) встановіть `INTLAYER_PROJECT_CREDENTIALS` як секрет:
 
 ```yaml

package/docs/uk/cli/doc-review.md

@@ -91,7 +91,15 @@ bun x intlayer doc review
 
 - **`--log`**: Режим тільки логування. Не перекладати з допомогою AI; замість цього логувати блоки, які потребують уваги (з номерами рядків і вмістом) для базової та цільової локалей, щоб допомогти іншому агенту згенерувати переклади.
 
-  > Приклад: `npx intlayer doc review --log`
+- The English source file content (BLOCK 1)
+- The Ukrainian translation to audit (BLOCK 2)
+- The mode you'd like me to use (`apply`, `report`, or `synthesis`)
+
+> Приклад: `npx intlayer doc review --mode report`
+
+> Приклад: `npx intlayer doc review --log`
+
+Незалежно від режиму, запуск завершується синтезом, який розраховує документи, вирівняні з їх базовим документом, та ті, які все ще мають блоки для редагування.
 
 **Параметри виводу записів:**
 

package/docs/uk/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Ця команда аналізує ваші файли декларацій контенту на предмет потенційних проблем, таких як відсутні переклади, структурні невідповідності або невідповідності типів. Якщо будуть виявлені якісь проблеми, **intlayer fill** запропонує або застосує оновлення, щоб тримати ваші словники консистентними та повними.
 
-Ключові моменти:
-
-- Розділяє великі JSON-файли на частини, щоб залишатися в межах вікна контексту моделі AI.
-- Повторює переклад, якщо формат виводу невірний.
-- Включає контекст, специфічний для додатка та файлу, для підвищення точності перекладу.
-- Зберігає існуючі переклади, не перезаписуючи їх.
-- Обробляє файли, частини та локалі паралельно, використовуючи систему черг для збільшення швидкості.
-
 ## Ключові моменти:
 
 - Розбиває великі JSON файли на частини, щоб залишатися в межах контекстного вікна AI моделі.

package/docs/uk/cli/index.md

@@ -127,6 +127,8 @@ Intlayer приймає кілька форматів файлів конфіг
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
 
+> `intlayer login` видає **ключ доступу** (`clientId` / `clientSecret`), який використовують всі команди з обліковими даними. Секрет — це облікові дані на стороні сервера і ніколи не потрапляють до вашого bundle клієнта — див. [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/login.md#keeping-the-access-key-safe).
+
 ### Основні команди
 
 - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/build.md)** - Створення словників з ваших файлів оголошення контенту

package/docs/uk/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Збереження ключа доступу в безпеці
+
+`intlayer login` видає **ключ доступу**: пару `clientId` / `clientSecret`, яку використовують усі команди з авторизацією (`push`, `pull`, `fill`, `configuration push`, `live`, …) для аутентифікації.
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` — це серверна облікові дані.** Вони надають повний доступ до API в межах проекту — читання та запис ваших словників, вашого проекту та вашої організації. Зберігайте це в `.env` (git-ignored) або у вашому сховищі секретів CI, і ніколи не вставляйте це в файл конфігурації.
+
+Intlayer забезпечує це, а не просто документує:
+
+- `clientSecret` **видаляється з конфігурації, яку inline ваш bundler**, тому він не може потрапити в bundle браузера, незалежно від того, яку інтеграцію фреймворку ви використовуєте. Він читається лише на сервері під час виконання з навколишнього середовища.
+- `clientId` інший: це **публічний** ключ проекту, безпечний для розповсюдження, і використовується [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/analytics.md#how-events-are-authenticated) для отримання короткочасного токена лише для прийому.
+
+Закоментування `clientId` достатньо, щоб вимкнути кожну поведінку з авторизацією — отримання віддалених словників, доступ до CMS, аналітику — навіть якщо змінні середовища все ще визначені.
+
+Для конвеєрів CI надавайте перевагу [`ci` команді](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md), яка вводить облікові дані на час виконання однієї операції, замість того щоб зберігати їх.
+
 ## Ручна конфігурація
 
 Якщо браузер не відкрився автоматично, ви можете вручну перейти за URL, вказаним у терміналі.

package/docs/uk/compiler.md

@@ -40,11 +40,17 @@ author: aymericzip
 
 ## Чому використовувати Intlayer Compiler?
 
+- **Автоматизація**: Усуває необхідність ручного копіювання вмісту в словники.
+
+- **Speed**: Оптимізована екстракція контенту, що забезпечує швидкість вашого процесу збірки.
+
 - **Автоматизація**: Усуває ручне копіювання та вставляння контенту у словники.
 - **Швидкість**: Оптимізоване витягування контенту забезпечує швидкість процесу збірки.
 - **Досвід розробника**: Тримайте декларації контенту там, де вони використовуються, що покращує підтримуваність.
 - **Оновлення в реальному часі**: Підтримує Hot Module Replacement (HMR) для миттєвого зворотного зв'язку під час розробки.
 
+- **Live Updates**: Підтримує Hot Module Replacement (HMR) для миттєвого зворотного зв'язку під час розробки.
+
 Див. статтю в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md) для глибшого порівняння.
 
 ## Чому не використовувати Intlayer Compiler?
@@ -54,6 +60,8 @@ author: aymericzip
 - **Евристична неоднозначність**: Компілятор має вгадувати, що є контентом для користувача, а що - логікою додатка (наприклад, `className="active"`, коди статусів, ID продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатиме ручних анотацій та винятків.
 - **Тільки статична екстракція**: Екстракція на основі компілятора покладається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені лише компілятором, тому вам усе одно знадобиться додаткова стратегія i18n під час виконання.
 
+- **Лише статична екстракція**: Екстракція на основі компілятора спирається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені компілятором самостійно, тому вам все ще потрібна додаткова стратегія runtime i18n.
+
 Для глибшого архітектурного порівняння див. статтю в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md).
 
 Як альтернативу, щоб автоматизувати ваш процес i18n і зберегти повний контроль над контентом, Intlayer також пропонує команду автоматичної екстракції `intlayer extract` (див. [документацію CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md)), або команду `Intlayer: extract content to Dictionary` з розширення Intlayer для VS Code (див. [документацію розширення VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Плагін `intlayerCompiler()` все ще експортується для розширених налаштувань. Реєстрація його разом з `intlayer()` є безпечною — компілятор дублює себе та запускається лише один раз.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Підтримка фреймворків
 
 Плагін Vite автоматично визначає та обробляє різні типи файлів:
 
+- **React / JSX / TSX**: Обробляється нативно.
+
+- **Vue**: Requires `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Обробляються нативно.
 - **Vue**: Потребує `@intlayer/vue-compiler`.
 - **Svelte**: Потребує `@intlayer/svelte-compiler`.

package/docs/uk/configuration.md

@@ -736,8 +736,6 @@ export default config;
 | `liveSyncPort`               | Порт сервера Live Sync.                                                                                                                                                 | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                               |
 | `liveSyncURL`                | URL сервера Live Sync.                                                                                                                                                  | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | За замовчуванням вказує на localhost; можна змінити на віддалений сервер Live Sync.                                                                                                                                           |
 
----
-
 ### Конфігурація аналітики (Analytics)
 
 Визначає налаштування, пов'язані з аналітикою Intlayer: збір даних про те, який контент дійсно показується користувачам (перегляди сторінок, показ контенту), та підтримку A/B-тестування контенту.
@@ -989,6 +987,13 @@ export default config;
 
 Параметри для контролю операцій зі словниками, включаючи поведінку автоматичного заповнення та генерацію контенту.
 
+Ця конфігурація словника служить двом основним цілям:
+
+1. **Значення за замовчуванням**: Визначте значення за замовчуванням під час створення файлів оголошення вмісту
+2. **Поведінка при відсутності значення**: Надайте резервні значення, коли певні поля не визначені, що дозволяє вам визначити поведінку операцій словника глобально
+
+Для отримання додаткової інформації про файли оголошення вмісту та способи застосування значень конфігурації див. [Документацію файлу вмісту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
+
 | Поле                        | Опис                                                                                                                                           | Тип                                                                                                             | За замовчуванням | Приклад                                                                                     | Примітки                                                                                                                                                                                                                                                                                                                                                                                                            |
 | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `fill`                      | Керує генерацією вихідних файлів автоматичного заповнення (перекладів AI).                                                                     | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`           | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: Шлях за замовчуванням (той самий файл, що й джерело).<br/>• `false`: Вимкнено.<br/>• Шаблонний рядок/Функція дозволяє генерацію за локалями.<br/>• Об'єкт за локалями: Кожна локаль відповідає власному шаблону; `false` виключає локаль.<br/>• Включення `{{locale}}` дозволяє генерацію за локалями.<br/>• Налаштування `fill` на рівні словника завжди має пріоритет над цим глобальним налаштуванням. |
@@ -1028,8 +1033,6 @@ dictionary: {
 | `mode`   | Вказує режим логера.                  | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`      | `'verbose'`        | • `'verbose'`: Записує більше інформації для відлагодження.<br/>• `'disabled'`: Повністю вимикає логер. |
 | `prefix` | Префікс для всіх повідомлень у логах. | `string`                                                       | `'[intlayer] '`  | `'[мій префікс] '` |                                                                                                         |
 
----
-
 ### Конфігурація AI (AI)
 
 Налаштування для управління можливостями AI в Intlayer, включаючи провайдера, модель та API-ключ.
@@ -1069,8 +1072,6 @@ Intlayer підтримує широкий спектр провайдерів A
 | `baseURL`            | Базовий URL для AI API.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                             | Немає            | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Може вказувати на локальні або власні кінцеві точки AI API.                                                                                                                                       |
 | `dataSerialization`  | Формат серіалізації даних для функцій AI.                                                                                         | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                                                       | `undefined`      | `'toon'`                                                      | • `'json'`: за замовчуванням, надійний; використовує більше токенів.<br/>• `'toon'`: менше токенів, менш стабільно.<br/>• Передає моделі контекст як додатковий параметр (reasoning effort тощо). |
 
----
-
 ### Конфігурація збірки (Build)
 
 Параметри, що контролюють спосіб оптимізації та компіляції інтернаціоналізації вашого додатка в Intlayer.
@@ -1108,8 +1109,6 @@ Intlayer підтримує широкий спектр провайдерів A
 | `noMetadata`          | Якщо `true`, компілятор видаляє метадані словника (ключ, content wrapper) з виводу.                                                                                                                                                                                                                          | `boolean`                                                                                                       | `false`          | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • Корисно для форматів i18next або ICU MessageFormat JSON.<br/>• Добре працює з плагіном `loadJSON`.                                                                                                                       |
 | `dictionaryKeyPrefix` | Префікс ключів словника                                                                                                                                                                                                                                                                                      | `string`                                                                                                        | `''`             |                                                                                                                                                          | Додає необов'язковий префікс до витягнутих ключів словника                                                                                                                                                                 |
 
----
-
 ### Настроювані схеми (Custom Schemas)
 
 | Поле      | Опис                                                                  | Тип                         |

package/docs/uk/custom_domains.md

@@ -138,6 +138,39 @@ getMultilingualUrls("/about", { currentDomain: "intlayer.org" });
 
 Ці абсолютні URL готові до використання в тегах `<link rel="alternate" hreflang="...">` для SEO.
 
+## Висновок типів
+
+`routing.domains` серіалізується в згенерований модуль доповнення, тому
+`getLocalizedUrl` та `getLocalizedPath` звужують їхній тип повернення до точної
+URL-адреси, яка розв'язується локаллю, маршрутизованою доменом — включаючи пригнічення префіксу.
+
+```ts
+// routing: { mode: 'prefix-no-default', domains: { en: 'intlayer.org', zh: 'intlayer.zh' } }
+
+getLocalizedUrl("/about", "zh");
+//     ^? "https://intlayer.zh/about" | "/about"
+
+getLocalizedPath("/about", "zh");
+//     ^? "/about"   (ніколи не походження, і без префіксу /zh/)
+```
+
+Тип URL — це **об'єднання** двох значень, які може повернути функція: абсолютна
+URL-адреса на домені локалі та відносна адреса, яку вона повертає, коли сторінка, що
+відображається, вже знаходиться на цьому домені. `getLocalizedPath` не має такої
+неоднозначності — вона ніколи не передає походження — тому вона залишається одним
+літералом.
+
+Локалі, які поділяють домен, також зберігають свій звичайний префікс у типі:
+
+```ts
+getLocalizedUrl("/about", "fr");
+//     ^? "https://intlayer.org/fr/about" | "/fr/about"
+```
+
+> Відновіть типи (`npx intlayer build` або будь-який запуск dev сервера) після
+> зміни `routing.domains` — звуження походить від згенерованого
+> `__RoutingRegistry`, а не від самого файлу конфігурації.
+
 ## Поведінка проксі
 
 ### Next.js
@@ -170,6 +203,8 @@ GET intlayer.zh/about
 
 Плагін Vite `intlayerProxy` застосовує ту саму логіку під час розробки:
 
+> З Intlayer v9, `intlayerProxy()` інтегрований безпосередньо в плагін `intlayer()` і включений за замовчуванням через опцію `routing.enableProxy` (`true` за замовчуванням). Окреме реєстрування, як показано нижче, тепер необов'язкове — воно зберігається для зворотної сумісності та для налаштувань, яким потрібно контролювати порядок плагінів. Встановіть `routing.enableProxy: false`, щоб відмовитися від цієї функції. Див. [примітки до версії v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/uk/custom_url_rewrites.md

@@ -248,7 +248,7 @@ Intlayer внутрішньо нормалізує ці шаблони до ун
 
 <Tabs group='framework'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```tsx
     'use client';
 
@@ -263,7 +263,7 @@ Intlayer внутрішньо нормалізує ці шаблони до ун
   </Tab>
 
   <Tab label="React Router" value="reactrouter">
-  
+
     ```tsx
     'use client';
 
@@ -279,7 +279,7 @@ Intlayer внутрішньо нормалізує ці шаблони до ун
   </Tab>
 
   <Tab label="Vue" value="vue">
-  
+
     ```vue
     <script setup>
     import { useRewriteURL } from "vue-intlayer";
@@ -291,7 +291,7 @@ Intlayer внутрішньо нормалізує ці шаблони до ун
 
   </Tab>
   <Tab label="Solid" value="solid">
-  
+
     ```tsx
     import { useRewriteURL } from "solid-intlayer";
 
@@ -303,7 +303,7 @@ Intlayer внутрішньо нормалізує ці шаблони до ун
 
   </Tab>
   <Tab label="Svelte" value="svelte">
-  
+
     ```svelte
     <script>
     import { useRewriteURL } from "svelte-intlayer";
@@ -340,6 +340,8 @@ export function middleware(request: NextRequest) {
 
 Для SolidJS, Vue та Svelte Vite-плагін `intlayerProxy` керує перезаписами під час розробки.
 
+> Починаючи з Intlayer v9, `intlayerProxy()` включено безпосередньо у плагін `intlayer()` і ввімкнено за замовчуванням через параметр `routing.enableProxy` (`true` за замовчуванням). Реєстрація його окремо, як показано нижче, тепер є необов'язковою — вона зберігається для зворотної сумісності та для налаштувань, які потребують контролю порядку плагінів. Встановіть `routing.enableProxy: false`, щоб відмовитися. Дивіться [примітки до випуску v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/releases/v9.md).
+
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";