@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/uk/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функція `getLocalizedPath` перетворює канонічний шлях (внутрішній шлях додатка) у його локалізований еквівалент на основі вказаної локалі та правил переписування. Вона особливо корисна для генерації SEO-дружніх URL-адрес, що відрізняються залежно від мови.
 
+Це відносний аналог [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getLocalizedUrl.md) — для відносного вводу обидва повертають одне й те саме значення. На відміну від `getLocalizedUrl`, він ніколи не повертає абсолютний URL: конфігурація `domains` ігнорується, тому локаль, обслужена з власного домену, все одно повертає шлях. Абсолютний вввід прийнятий, але його походження видаляється — зберігаються лише його шлях, рядок запиту та хеш.
+
 **Ключові можливості:**
 
 - Підтримує динамічні параметри маршруту з використанням синтаксису `[param]`.
@@ -60,13 +62,17 @@ getLocalizedPath(
   - **Тип**: `string`
   - **Обов'язковий**: Так
 
-- `locale: Locales`
-  - **Опис**: Цільова локаль, для якої шлях має бути локалізований.
-  - **Тип**: `Locales`
-  - **Обов'язковий**: Так
-
 ### Необов'язкові параметри
 
+- `locale?: Locales`
+  - **Description**: Цільовий локаль, для якого слід локалізувати шлях.
+  - **Type**: `Locales`
+  - **Default**: Локаль за замовчуванням конфігурації вашого проекту.
+
+- `options?: object`
+  - **Description**: Перевизначення маршрутизації. Кожен запис за замовчуванням використовує конфігурацію вашого проекту.
+  - **Type**: `object`
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Опис**: Об'єкт, що визначає кастомні правила переписування. Якщо не вказано, використовується значення `routing.rewrite` з конфігурації вашого проєкту.
   - **Тип**: `RoutingConfig['rewrite']`
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **Тип**: `string`
 - **Опис**: Локалізований шлях для зазначеної локалі.
 
+Тип звужується на основі правил перезапису, оголошених у вашій конфігурації, тому редактор показує розташовану шляхом, а не звичайний `string`:
+
+```typescript codeFormat="typescript"
+// Конфігурація: режим 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (немає правила переписування, застосовується лише префікс)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Те саме звуження поширюється на [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/intlayer/getLocalizedUrl.md), яка застосовує правила переписування перед додаванням префікса локалі.
+
+Два випадки залишаються розширеними до `string`, оскільки вони не можуть бути розв'язані під час компіляції:
+
+- шлях, який не є рядковим літералом (наприклад, побудований зі змінної);
+- шлях, який відповідає правилу з використанням багатосегментного або необов'язкового параметра (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Приклад використання
@@ -126,8 +154,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Вивід: "/contactez-nous"
 ```
 
----
-
 ### Пропуск локалі
 
 Коли локаль не вказана, шлях локалізується для налаштованої локалі за замовчуванням:

package/docs/uk/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 Функція `getTranslationContent` отримує вміст, що відповідає певній локалі, із набору налаштовуваного мовного вмісту. Якщо вказаної локалі не знайдено, вона за замовчуванням повертає вміст для локалі за замовчуванням, налаштованої в проєкті.
 
+Для більш детальної інформації про те, як оголошувати переклади, див. [документацію Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/translation.md).
+
 ## Параметри
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/uk/packages/next-intlayer/t.md

@@ -165,6 +165,23 @@ const greeting = t(translations);
 
 #### Приклад:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -180,6 +197,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+</Tab>
+</Tabs>
+
 ---
 
 ## Загальні помилки та усунення несправностей
@@ -223,8 +243,6 @@ const text = t(translations);
 
 Для детальнішого опису використання та просунутих можливостей див. документацію [next-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).
 
-///
-
 ---
 
 **Примітка**: Не забудьте правильно налаштувати ваші `IntlayerClientProvider` та `IntlayerServerProvider`, щоб поточна локаль коректно передавалася вашим компонентам. Це критично для того, щоб функція `t` повертала правильні переклади.

package/docs/uk/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ author: aymericzip
 
 Ось як ви можете реалізувати хук `useIntlayer` на сторінці Next.js, щоб динамічно завантажувати локалізований контент залежно від поточної локалі застосунку:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/uk/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ Hook `useDictionary` дозволяє обробляти об'єкт, який
 
 ## Інтеграція на сервері
 
-Якщо ви використовуєте хук `useDictionary` поза межами `IntlayerProvider`, локаль має бути явно передана як параметр під час рендерингу компонента:
-
 ```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer/server";

package/docs/uk/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ author: aymericzip
 
 Приклади використання хуку `useI18n` у React-компонентах:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

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

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## Приклад використання в React
 
-Приклад використання хука `useIntlayer` у React-компоненті:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/uk/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Плагін Vite `intlayerPrune` використовується для виконання tree-shaking та видалення невикористаних словників з бандла вашого застосунку. Це допомагає зменшити фінальний розмір бандла, включаючи лише необхідний багатомовний вміст.
 
+> Плагін вже включений та налаштований автоматично, коли ви використовуєте [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/packages/vite-intlayer/intlayer.md). Вам потрібно зареєструвати його вручну лише в тому випадку, якщо ви самостійно складаєте стек плагінів.
+
 ## Використання
 
 ### У складі `intlayer()` (рекомендовано)

package/docs/uk/readme.md

@@ -225,8 +225,8 @@ const HomePage = () => {
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ const HomePage = () => {
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/uk/releases/v8.md

@@ -763,8 +763,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## Правила множини Unicode CLDR (v8.8.0)
 
 Було впроваджено новий хелпер вузла `plural` на основі правил множини, визначених проектом Unicode CLDR, що покращує підтримку складних мов.
@@ -1111,7 +1109,7 @@ Intlayer v8 включає новий шар кешування для комп
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1133,7 +1131,7 @@ Intlayer v8 включає новий шар кешування для комп
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";

package/docs/uk/releases/v9.md

@@ -373,6 +373,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Встановлювач завантажує `docker-compose.yml` та `.env`, автоматично генерує необхідні секрети та запускає `docker compose up -d`. Все — дашборд, API, база даних, сховище об'єктів та транзакційна електронна пошта — працює локально у контейнерах.
 
+---
+
 ## Примітки щодо міграції з v8
 
 Якщо ви оновлюєтеся з v8, зверніть увагу, що v9 не містить критичних змін (breaking changes). Проте ось ключові зміни:

package/docs/uk/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer може повністю працювати на вашій власній інфраструктурі — обліковий запис Intlayer Cloud не потрібен. Одна команда запускає готовий до виробництва стек:
 
+Одна команда встановлює все:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Інсталятор завантажує `docker-compose.yml` та `.env`, автоматично генерує необхідні секрети та запускає всі контейнери за допомогою `docker compose up -d`.
 
+Єдиною зовнішньою залежністю є **MongoDB**: backend підключається до кластера MongoDB **Atlas**, який ви надаєте. Все інше працює всередині контейнера.
+
 ## Зміст
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (використовується для генерації скрін
 - Порти `3000`, `3100`, `8025`, `9000` та `9001` доступні на хості.
 - Хост Linux або macOS (або WSL2 на Windows).
 
+Все інше — Bun, Redis, MinIO, Chromium — поставляється всередині образу.
+
 ---
 
 ## Швидкий старт
 
-Витягніть і запустіть опубліковану image, надавши ваші облікові дані та секрети MongoDB Atlas:
+### 1. Запустити інсталятор
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Він перевіряє, чи встановлено Docker і він запущений, записує `./intlayer.env` із уже згенерованими `BETTER_AUTH_SECRET` та `S3_SECRET_ACCESS_KEY`, і витягує образ. Він не запускає контейнер — backend не може завантажитися без ваших облікових даних бази даних.
+
+Повторне запущення інсталятора безпечне: існуючий `intlayer.env` ніколи не перезаписується, тому він також служить шляхом оновлення.
+
+### 2. Заповніть ваші облікові дані
+
+Відкрийте `intlayer.env` і заповніть значення, позначені як `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Файл також містить закоментовані блоки для опціональних функцій — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` та OAuth провайдери. Розкоментуйте те, що вам потрібно.
+
+> Файл читається за допомогою `docker run --env-file`, який не видаляє лапки та трактує все після `=` як значення. Пишіть значення без лапок і тримайте коментарі на окремих рядках.
+
+### 3. Запустіть контейнер
+
+Це команда, яку виводить установник після завершення:
 
 ```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 \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Потім відкрийте **http://localhost:3000**.
+Потім відкрийте **http://localhost:3000**. При першому завантаженні ініціалізуються сховища даних, тому дайте йому хвилину.
 
-> Dashboard доступний на `localhost`. Див. [Обмеження](#limitations) — користувацькі домени не підтримуються опублікованою image.
+> Панель керування обслуговується на `localhost`. Див. [Обмеження](#limitations) — спеціальні домени не підтримуються опублікованим образом.
 
----
+### Налаштування installer
 
-## Швидкий старт
+Installer читає кілька змінних середовища. Оскільки він передається в `sh`, передайте їх оболонці, а не `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Змінна                    | За замовчуванням                              | Опис                                 |
+| ------------------------- | --------------------------------------------- | ------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image для завантаження               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Де писати env файл                   |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Ім'я контейнера                      |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Названий том, змонтований на `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Хост-порт для dashboard              |
+| `INTLAYER_API_PORT`       | `3100`                                        | Хост-порт для API                    |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Хост-порт для MinIO S3 API           |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Хост-порт для MinIO console          |
+
+> Чотири змінні портів змінюють лише сторону **host** у відображенні, надрукованому в команді `docker run`. Опублікований image має `http://localhost:3000`, `http://localhost:3100` і `http://localhost:9000` скомпільовані в bundle dashboard під час збірки, тому їх переназначення залишає браузер, спрямований на старі порти. Зберігайте значення за замовчуванням, якщо ви не будуєте власний image — див. [Обмеження](#limitations).
+
+---
+
+## Швидкий старт
+
 Що робить інсталятор:
 
 1.  Перевіряє наявність `docker` та `docker compose`.
@@ -117,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                       | `9000` (S3), `9001` (консоль)         | Об'єктне сховище, сумісне з S3, для аватарів та скріншотів |
 | **mailpit** | `axllent/mailpit`                   | `1025` (SMTP), `8025` (веб-інтерфейс) | Локальний приймач транзакційних електронних листів         |
 
-Внутрішні порти (mongo, redis) за замовчуванням не доступні з хосту.
-
 > Порт MinIO `9000` має бути доступним для браузера, оскільки завантажені ресурси (аватари, скріншоти) завантажуються безпосередньо з `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Вхід через LinkedIn OAuth                                                           |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Вхід через Atlassian OAuth                                                          |
 
----
-
 ### Глобальний поштовик
 
 За замовчуванням усі транзакційні електронні листи відправляються через Resend з використанням `RESEND_API_KEY`. Самостійно розгорнуті розгортання можуть натомість маршрутизувати **кожну** електронну пошту — включаючи не-організаційні листи, такі як скидання паролів і магічні посилання — через глобальний поштовик, налаштований за допомогою змінних середовища.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Оновлення
 
-Повторний запуск інсталятора на існуючому розгортанні виконує послідовне оновлення:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Це завантажує останні образи та перезапускає контейнери за допомогою `docker compose pull && docker compose up -d`. Існуючі томи (`mongo-data`, `redis-data`, `minio-data`) зберігаються — без втрати даних.
 
-Щоб оновити вручну з каталогу `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,14 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Шукайте `MongoDB connection error` близько до початку логу.
+
 ### Електронні листи не надсилаються
 
 За замовчуванням усі вихідні електронні листи захоплюються Mailpit. Відкрийте `http://localhost:8025`, щоб побачити надіслані повідомлення. Щоб надсилати реальні електронні листи, встановіть `MAIL_PROVIDER=resend` та `RESEND_API_KEY=<ваш-ключ>` у `.env`, а потім перезапустіть бекенд:
 
-```sh
-docker compose restart backend
-```
-
 ### Відсутній кошик MinIO
 
 Якщо одноразовий сервіс `minio-init` не запустився (або запустився до того, як MinIO був готовий), створіть кошик вручну:

package/docs/ur/intlayer_with_fastify.md

@@ -222,9 +222,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... دیگر ترتیب کے اختیارات
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/ur/intlayer_with_hono.md

@@ -235,9 +235,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... دیگر کنفیگریشن کے اختیارات
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/vi/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Các vấn đề gặp phải:
 
 `Tolgee` giải quyết được nhiều vấn đề đã đề cập trước đó. Tôi thấy việc bắt đầu với Tolgee khó khăn hơn so với các công cụ khác có phương pháp tiếp cận tương tự. Nó không cung cấp tính an toàn kiểu dữ liệu, điều này cũng khiến việc phát hiện các khóa bị thiếu tại thời điểm biên dịch trở nên khó khăn hơn nhiều. Tôi đã phải bao bọc các API của Tolgee bằng các API của riêng mình để thêm tính năng phát hiện khóa bị thiếu.
 
+Package này khá nặng (~11.1kb, gấp hơn 2× `react-intlayer`).
+
 Trên TanStack Start, tôi cũng gặp vấn đề về tính phản ứng: khi ngôn ngữ thay đổi, tôi phải ép buộc provider render lại và đăng ký vào các sự kiện thay đổi ngôn ngữ để việc tải ở một ngôn ngữ khác hoạt động chính xác.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Trên TanStack Start, bạn tránh được các cạm bẫy đặc thù của N
 
 Tuy nhiên, nó có cùng những nhược điểm chính như các ngăn công nghệ được xây dựng trên `t('a.b.c')`: tối ưu hóa là có thể nhưng rất tốn thời gian, và các dự án lớn có rủi ro rơi vào các thực hành xấu (namespace + tải động + kiểu dữ liệu).
 
+Package này đặc biệt nặng (~17.3kb, tức là khoảng 3.5× `react-intlayer`).
+
 Các định dạng thông báo cũng khác nhau: `use-intl` sử dụng ICU MessageFormat, trong khi `i18next` sử dụng định dạng riêng của mình - điều này làm phức tạp thêm công cụ hoặc quá trình di chuyển nếu bạn trộn lẫn chúng.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Các định dạng thông báo cũng khác nhau: `use-intl` sử dụng ICU Mes
 
 `react-intl` là một triển khai hiệu năng từ nhóm Format.js. Trải nghiệm phát triển vẫn còn rườm rà: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` thêm vào sự phức tạp, công việc JavaScript bổ sung và ràng buộc instance i18n toàn cục vào nhiều nút trong cây React.
 
+Package cũng khá nặng (~14.4kb, tức là khoảng 3× `react-intlayer`).
+
 ### 4 - Các khuyến nghị
 
 Benchmark TanStack Start này không có đối trọng trực tiếp cho `next-translate` (Next.js plugin + `getStaticProps`). Đối với các nhóm thực sự muốn một API `t()` với một hệ sinh thái chín muồi, `react-i18next` và `use-intl` vẫn là những lựa chọn "hợp lý", nhưng hãy chuẩn bị đầu tư nhiều thời gian tối ưu hóa để tránh rò rỉ.

package/docs/vi/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Sử dụng trong pipeline CI/CD
 
+Chạy `intlayer init` tạo ra hai GitHub Actions workflows sẵn sàng sử dụng cho bạn (xem [Scaffolded GitHub Actions](#scaffolded-github-actions) dưới đây). Ví dụ ở đây cho thấy cấu hình tương đương bằng cách sử dụng lệnh `ci` cho một monorepo, nơi các credentials được inject cho mỗi project từ `INTLAYER_PROJECT_CREDENTIALS`.
+
 Trong cấu hình CI/CD của bạn (ví dụ: GitHub Actions, GitLab CI), đặt `INTLAYER_PROJECT_CREDENTIALS` làm bí mật:
 
 ```yaml

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

@@ -91,7 +91,15 @@ Lệnh này có thể được sử dụng để đánh giá các tệp đã đ
 
 - **`--log`**: Chế độ chỉ ghi log. Không dịch bằng AI; thay vào đó, ghi lại các phần cần lưu ý (kèm số dòng và nội dung) cho ngôn ngữ cơ sở và ngôn ngữ đích, nhằm hỗ trợ một agent khác tạo bản dịch.
 
-  > Ví dụ: `npx intlayer doc review --log`
+- **If `apply`**: Translate missing/diverging content and return the complete updated Vietnamese file
+- **If `report`**: Log blocks needing attention with line numbers and content for both locales
+- **If `synthesis`**: Skip per-block output and provide only a final recap of up-to-date vs. documents needing edits
+
+> Ví dụ: `npx intlayer doc review --mode report`
+
+> Ví dụ: `npx intlayer doc review --log`
+
+Bất kể chế độ nào, quá trình chạy kết thúc bằng một tổng hợp liệt kê các tài liệu được căn chỉnh với tài liệu cơ sở của chúng và những tài liệu vẫn còn các khối cần chỉnh sửa.
 
 **Tùy chọn xuất đầu vào:**
 

package/docs/vi/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Lệnh này phân tích các tệp khai báo nội dung của bạn để tìm các vấn đề tiềm ẩn như thiếu bản dịch, không nhất quán về cấu trúc hoặc không khớp kiểu dữ liệu. Nếu phát hiện bất kỳ vấn đề nào, **intlayer fill** sẽ đề xuất hoặc áp dụng các cập nhật để giữ cho từ điển của bạn nhất quán và đầy đủ.
 
-Điểm chính:
-
-- Chia các tệp JSON lớn thành các phần nhỏ để nằm trong giới hạn cửa sổ ngữ cảnh của mô hình AI.
-- Thử lại bản dịch nếu định dạng đầu ra không đúng.
-- Tích hợp ngữ cảnh cụ thể cho ứng dụng và tệp để cải thiện độ chính xác của bản dịch.
-- Bảo tồn các bản dịch hiện có bằng cách không ghi đè chúng.
-- Xử lý tệp, phần và ngôn ngữ song song bằng hệ thống hàng đợi để tăng tốc độ.
-
 ## Những Điểm Chính:
 
 - Chia các tệp JSON lớn thành các chunks để duy trì trong giới hạn cửa sổ ngữ cảnh của mô hình AI.

package/docs/vi/cli/index.md

@@ -127,6 +127,8 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình khác nhau:
 
 - **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md)** - Xác thực với Intlayer CMS và nhận thông tin xác thực truy cập
 
+> `intlayer login` cấp một **access key** (`clientId` / `clientSecret`) mà mọi lệnh có xác thực đều sử dụng. Secret là một thông tin xác thực phía server và không bao giờ được gửi tới client bundle của bạn — xem [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md#keeping-the-access-key-safe).
+
 ### Các lệnh cốt lõi
 
 - **[Xây dựng từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung

package/docs/vi/cli/list_projects.md

@@ -52,8 +52,6 @@ Lệnh này tìm kiếm và liệt kê tất cả các dự án Intlayer bằng
 
   > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Ví dụ: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Tìm kiếm từ thư mục gốc của git thay vì thư mục cơ sở. Điều này hữu ích để tìm tất cả các dự án Intlayer trong một monorepo hoặc kho git.
 
   > Ví dụ: `npx intlayer projects list --git-root`