@intlayer/docs 9.0.0-canary.9 → 9.0.0

package/docs/ru/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-Для более низкоуровневого доступа функция `scanWebsite` из модуля `@intlayer/chokidar/scan` возвращает структурированный объект `ScanResult`:
+Для более низкоуровневого доступа функция `scanWebsite` из модуля `@intlayer/engine/scan` возвращает структурированный объект `ScanResult`:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);

package/docs/ru/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-23
+updatedAt: 2026-07-11
 title: Конфигурация (Configuration)
 description: Узнайте, как настроить Intlayer для вашего приложения. Разберитесь в различных параметрах и опциях, доступных для настройки Intlayer в соответствии с вашими потребностями.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Добавлена конфигурация `analytics`"
   - version: 9.0.0
     date: 2026-06-24
     changes: "Add `enableProxy` option to the routing configuration"
@@ -355,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Конфигурация аналитики (analytics).
+   */
+  analytics: {
+    /**
+     * Включён ли сбор аналитики (просмотры страниц, показы контента, события A/B).
+     * Требует, чтобы был задан `editor.clientId` для атрибуции.
+     * По умолчанию: false
+     */
+    enabled: true,
+
+    /**
+     * Миллисекунды между автоматическими пакетными отправками на бэкенд.
+     * По умолчанию: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Доля сессий для записи, от 0 (ни одной) до 1 (все).
+     * По умолчанию: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Настройки переводов и генерации с помощью ИИ.
    */
@@ -668,6 +695,20 @@ export default config;
 
 ---
 
+### Конфигурация аналитики (Analytics)
+
+Определяет настройки, связанные с аналитикой Intlayer: сбор данных о том, какой контент действительно показывается пользователям (просмотры страниц, показы контента), и поддержку A/B-тестирования контента.
+
+Аналитика строго опциональна (opt-in): ничего не собирается, если `analytics.enabled` явно не установлен в `true` **и** не настроен ключ проекта (`editor.clientId`) для атрибуции. При отключении (по умолчанию) вся интеграция аналитики удаляется из сборки вашего приложения (dead-code elimination).
+
+| Поле            | Описание                                                                   | Тип       | По умолчанию | Пример  | Примечание                                                                                                                        |
+| --------------- | -------------------------------------------------------------------------- | --------- | ------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Включает сбор аналитики (просмотры страниц, показы контента, события A/B). | `boolean` | `false`      | `true`  | Требует, чтобы был задан `editor.clientId` для атрибуции; иначе аналитика остаётся отключённой, даже если `enabled` равно `true`. |
+| `flushInterval` | Миллисекунды между автоматическими пакетными отправками на бэкенд.         | `number`  | `20000`      | `10000` |                                                                                                                                   |
+| `sampleRate`    | Доля сессий для записи, от `0` (ни одной) до `1` (все).                    | `number`  | `1`          | `0.5`   | Выборка детерминирована для каждой сессии, поэтому записанная сессия сообщает обо всех своих событиях (без частичных воронок).    |
+
+---
+
 ### Конфигурация маршрутизации (Routing)
 
 Настройки, управляющие поведением маршрутизации, включая структуру URL, хранение языков и управление middleware.

package/docs/ru/how_works_intlayer.md

@@ -217,9 +217,9 @@ Intlayer состоит из нескольких пакетов, каждый
 
 Пакеты `@intlayer/dictionaries-entry`, `@intlayer/unmerged-dictionaries-entry` и `@intlayer/dynamic-dictionaries-entry` возвращают путь к точке входа словарей Intlayer. Поскольку поиск по файловой системе из браузера невозможен, использование сборщиков вроде Webpack или Rollup для получения пути к словарям также невозможно. Эти пакеты предназначены для использования с псевдонимами, что позволяет оптимизировать сборку с различными сборщиками, такими как Vite, Webpack и Turbopack.
 
-### @intlayer/chokidar
+### @intlayer/engine
 
-Пакет `@intlayer/chokidar` используется для отслеживания файлов контента и повторной генерации изменённого словаря при каждом изменении.
+Пакет `@intlayer/engine` используется для отслеживания файлов контента и повторной генерации изменённого словаря при каждом изменении.
 
 ### @intlayer/editor
 

package/docs/ru/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2025-08-23
+updatedAt: 2026-07-08
 title: Intlayer CMS | Внешнее управление контентом через Intlayer CMS
 description: Внешнее управление вашим контентом через Intlayer CMS для делегирования управления контентом вашей команде.
 keywords:
@@ -18,6 +18,15 @@ slugs:
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Раздел «Живая синхронизация» перенесён на отдельную страницу (live-sync.md); здесь оставлено краткое введение со ссылкой"
+  - version: 9.0.0
+    date: 2026-06-30
+    changes: "Добавлен раздел «Самостоятельное размещение»: начальная загрузка Docker Compose, инвентаризация сервисов, конфигурация SDK, необязательные функции и примечания по обновлению"
+  - version: 9.0.0
+    date: 2026-06-29
+    changes: "Добавлен раздел SDK @intlayer/api (createIntlayerCMS) для программного доступа к CMS"
   - version: 6.0.1
     date: 2025-09-22
     changes: "Добавлена документация по live sync"
@@ -241,137 +250,175 @@ bun x intlayer dictionary push -d my-first-dictionary-key --env production
 
 После этого вы сможете просматривать и управлять вашим словарём в [Intlayer CMS](https://app.intlayer.org/content).
 
-## Живая синхронизация
+## Программный доступ с помощью SDK `@intlayer/api`
 
-Живая синхронизация позволяет вашему приложению отражать изменения контента CMS в режиме реального времени. Пересборка или повторный деплой не требуются. Когда функция включена, обновления передаются на сервер живой синхронизации, который обновляет словари, используемые вашим приложением.
+Помимо CLI и визуального редактора, Intlayer поставляется с типизированным SDK в пакете [`@intlayer/api`](https://www.npmjs.com/package/@intlayer/api). Он позволяет вам рассматривать CMS как **бесголовую базу данных контента**: вы можете получать проекты, получать словари, а также отправлять или обновлять их непосредственно из вашего собственного приложения, скриптов или CI-конвейера.
 
-> Живая синхронизация требует постоянного подключения к серверу и доступна в тарифном плане enterprise.
+SDK обрабатывает аутентификацию за вас. Пока ваши `clientId` и `clientSecret` доступны (в вашей конфигурации Intlayer или переменных окружения), он автоматически получает и обновляет токен доступа OAuth2 и подписывает каждый запрос.
 
-Включите живую синхронизацию, обновив конфигурацию Intlayer:
+### Установка
 
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
+```bash packageManager="npm"
+npm install @intlayer/api
+```
 
-const config: IntlayerConfig = {
-  // ... другие настройки конфигурации
-  editor: {
-    /**
-     * Включает горячую перезагрузку конфигураций локалей при обнаружении изменений.
-     * Например, когда словарь добавляется или обновляется, приложение обновляет
-     * отображаемый на странице контент.
-     *
-     * Поскольку горячая перезагрузка требует постоянного подключения к серверу,
-     * она доступна только для клиентов с тарифным планом `enterprise`.
-     *
-     * По умолчанию: false
-     */
-    liveSync: true,
-  },
-  dictionary: {
-    /**
-     * Управляет способом импорта словарей:
-     *
-     * - "live": словари загружаются динамически с использованием Live Sync API.
-     *   Заменяет useIntlayer на useDictionaryDynamic.
-     *
-     * Примечание: Режим live использует Live Sync API для загрузки словарей. Если вызов API
-     * не удаётся, словари загружаются динамически.
-     * Примечание: Режим live используется только для словарей с удалённым содержимым и флагом "live".
-     * Другие используют динамический режим для повышения производительности.
-     */
-    importMode: "fetch",
-  },
-};
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
 
-export default config;
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
 ```
 
-Запустите сервер Live Sync, чтобы обернуть ваше приложение:
+```bash packageManager="bun"
+bun add @intlayer/api
+```
 
-Пример с использованием Next.js:
+### Как это работает: аутентификатор + эндпоинты
 
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... другие скрипты
-    "build": "next build",
-    "dev": "next dev",
-    "start": "npx intlayer live --with 'next start'",
-  },
-}
+SDK разделён на **два отдельных импорта** специально, чтобы сохранить размер вашего бандла небольшим:
+
+1. `createIntlayerCMS` — создаёт легковесный **аутентификатор**. Он содержит только учётные данные и управляемый токен доступа; он ничего не знает о каком-либо конкретном домене.
+2. `dictionaryEndpoint`, `projectEndpoint`, … — **биндинги эндпоинтов** для каждого домена, каждый импортируется из своего подпути (`@intlayer/api/dictionary`, `@intlayer/api/project`, …). Вы передаёте аутентификатор нужному эндпоинту.
+
+Поскольку каждый эндпоинт импортируется отдельно, ваш бандл включает только те домены, которые вы фактически используете — импорт `dictionaryEndpoint` никогда не подтягивает проект, ИИ или любой другой клиент домена.
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+
+// Конфигурация необязательна: если она пропущена, учётные данные считываются из
+// `@intlayer/config/built`, который разрешает переменные окружения INTLAYER_CLIENT_ID и
+// INTLAYER_CLIENT_SECRET.
+export const cmsAuthenticator = createIntlayerCMS();
 ```
 
-Пример с использованием Vite:
+> [!WARNING]
+> Учётные данные CMS (`clientId` / `clientSecret`) предоставляют **доступ на запись** к вашему контенту. Создавайте аутентификатор только на **серверной стороне** (серверные действия, обработчики маршрутов, скрипты, CI). Никогда не импортируйте его в клиентский код и не раскрывайте свои учётные данные в браузере.
 
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... другие скрипты
-    "build": "vite build",
-    "dev": "vite dev",
-    "start": "npx intlayer live --with 'vite start'",
+Если вы предпочитаете не полагаться на конфигурацию времени сборки, передайте учётные данные явно:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+
+export const cmsAuthenticator = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    // Необязательно, для самостоятельно размещённых бэкендов:
+    // backendURL: process.env.INTLAYER_BACKEND_URL,
   },
-}
+});
 ```
 
-Сервер Live Sync оборачивает ваше приложение и автоматически применяет обновлённый контент по мере его поступления.
+> Получите свои учётные данные, создав новый ключ доступа в [Панели управления Intlayer - Проекты](https://app.intlayer.org/projects).
 
-Чтобы получать уведомления об изменениях из CMS, сервер Live Sync поддерживает SSE-соединение с бэкендом. Когда контент в CMS изменяется, бэкенд пересылает обновление серверу Live Sync, который записывает новые словари. Ваше приложение отобразит обновление при следующей навигации или перезагрузке браузера, пересборка не требуется.
+### Получение проектов
 
-Блок-схема (CMS/Backend -> Live Sync Server -> Application Server -> Frontend):
+```typescript fileName="projects.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { projectEndpoint } from "@intlayer/api/project";
 
-![Схема логики Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+const cmsAuthenticator = createIntlayerCMS();
 
-Как это работает:
+// Список проектов, доступных с вашими учётными данными
+const { data: projects } =
+  await projectEndpoint(cmsAuthenticator).getProjects();
 
-![Схема потока Live Sync CMS/Backend/Live Sync Server/Application Server/Frontend](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+// Чтение агрегированных данных о локализации выбранного проекта
+const { data: insights } =
+  await projectEndpoint(cmsAuthenticator).getProjectInsights();
+```
 
-### Рабочий процесс разработки (локально)
+### Получение словарей
 
-- В процессе разработки все удалённые словари загружаются при запуске приложения, чтобы вы могли быстро тестировать обновления.
-- Чтобы протестировать Live Sync локально с Next.js, оберните ваш dev-сервер:
+```typescript fileName="read-dictionaries.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
 
-```json5 fileName="package.json"
-{
-  "scripts": {
-    // ... другие скрипты
-    "dev": "npx intlayer live --with 'next dev'",
-    // "dev": "npx intlayer live --with 'vite dev'", // Для Vite
-  },
-}
+const cmsAuthenticator = createIntlayerCMS();
+
+// Вывести каждый удалённый словарь проекта
+const { data: dictionaries } =
+  await dictionaryEndpoint(cmsAuthenticator).getDictionaries();
+
+// Или получить один словарь по ключу
+const { data: dictionary } = await dictionaryEndpoint(
+  cmsAuthenticator
+).getDictionary("my-first-dictionary-key");
 ```
 
-Включите оптимизацию, чтобы Intlayer применял трансформации Live импорта во время разработки:
+### Отправка и обновление словарей
 
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import type { IntlayerConfig } from "intlayer";
+Используйте CMS как базу данных для записи контента:
 
-const config: IntlayerConfig = {
-  editor: {
-    applicationURL: "http://localhost:5173",
-    liveSyncURL: "http://localhost:4000",
-    liveSync: true,
-  },
-  dictionary: {
-    importMode: "fetch",
-  },
-  build: {
-    optimize: true,
-  },
-};
+```typescript fileName="write-dictionaries.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
 
-export default config;
+const cmsAuthenticator = createIntlayerCMS();
+
+// Создать новый словарь
+await dictionaryEndpoint(cmsAuthenticator).addDictionary({
+  key: "my-first-dictionary-key",
+  content: { title: "Hello world" },
+});
+
+// Обновить или вставить партию словарей (создать или обновить их за один вызов)
+await dictionaryEndpoint(cmsAuthenticator).pushDictionaries([
+  { key: "home", content: { title: "Home" } },
+  { key: "about", content: { title: "About" } },
+]);
+
+// Обновить существующий словарь
+await dictionaryEndpoint(cmsAuthenticator).updateDictionary({
+  id: "<dictionary-id>",
+  key: "home",
+  content: { title: "Updated title" },
+});
 ```
 
-Эта настройка оборачивает ваш dev-сервер сервером Live Sync, загружает удалённые словари при запуске и транслирует обновления из CMS через SSE. Обновите страницу, чтобы увидеть изменения.
+> Совет: повторно используйте связанный эндпоинт, чтобы избежать повторений:
+>
+> ```typescript codeFormat="typescript"
+> const dictionary = dictionaryEndpoint(cmsAuthenticator);
+> await dictionary.pushDictionaries([myDictionary]);
+> const { data } = await dictionary.getDictionaries();
+> ```
 
-Примечания и ограничения:
+### Извлечение отдельного метода
 
-- Добавьте источник live sync в политику безопасности вашего сайта (CSP). Убедитесь, что URL live sync разрешён в `connect-src` (и в `frame-ancestors`, если это актуально).
-- Live Sync не работает со статическим выводом. Для Next.js страница должна быть динамической, чтобы получать обновления во время выполнения (например, используйте `generateStaticParams`, `generateMetadata`, `getServerSideProps` или `getStaticProps` соответствующим образом, чтобы избежать ограничений полностью статического вывода).
-- В CMS у каждого словаря есть флаг `live`. Только словари с `live=true` загружаются через API live sync; остальные импортируются динамически и остаются неизменными во время выполнения.
-- Флаг `live` оценивается для каждого словаря во время сборки (build time). Если удалённый контент не был помечен как `live=true` во время сборки (build time), необходимо выполнить повторную сборку, чтобы включить Live Sync для этого словаря.
-- Сервер live sync должен иметь возможность записывать в `.intlayer`. В контейнерах убедитесь, что есть права на запись в `/.intlayer`.
+Каждый метод эндпоинта уже аутентифицирован и самодостаточен (он обрабатывает свой собственный токен), поэтому вы можете извлечь его и передавать — например, для инъекции в качестве зависимости:
+
+```typescript fileName="push.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const dictionary = dictionaryEndpoint(createIntlayerCMS());
+
+// Уже аутентифицирован — автоматически обновляет токен при каждом вызове
+export const pushDictionaries = dictionary.pushDictionaries;
+
+// Использование
+await pushDictionaries([{ key: "home", content: { title: "Home" } }]);
+```
+
+## Живая синхронизация
+
+Живая синхронизация позволяет вашему приложению отражать изменения контента CMS в режиме реального времени. Пересборка или повторный деплой не требуются. Когда функция включена, обновления передаются на сервер живой синхронизации, который обновляет словари, используемые вашим приложением.
+
+Полное руководство по настройке (включение, запуск сервера Live Sync, рабочий процесс локальной разработки и ограничения) см. в [документации Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/live-sync.md).
+
+## Самостоятельное размещение (Self-Hosting)
+
+Intlayer может работать полностью на вашей собственной инфраструктуре. Одна команда поднимает весь стек (дашборд, API, база данных, хранилище объектов и электронная почта) с помощью Docker Compose:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Полное руководство по настройке, справочник по переменным окружения, инструкции по обновлению и процедуры резервного копирования/восстановления см. в [Руководстве по самостоятельному размещению](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md).
+
+---
 
 ## Отладка
 
@@ -381,9 +428,9 @@ export default config;
 
 - Конфигурация [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) корректно настроена в вашем конфигурационном файле Intlayer.
   - Обязательные поля:
-- URL приложения должен совпадать с тем, который вы указали в конфигурации редактора (`applicationURL`).
-- URL CMS
+    - URL приложения должен совпадать с тем, который вы указали в конфигурации редактора (`applicationURL`).
+    - URL CMS
 
 - Убедитесь, что конфигурация проекта была отправлена в Intlayer CMS.
 
-- Визуальный редактор использует iframe для отображения вашего сайта. Убедитесь, что политика безопасности контента (CSP) вашего сайта разрешает URL CMS в качестве `frame-ancestors` (по умолчанию 'https://intlayer.org'). Проверьте консоль редактора на наличие ошибок.
+- Визуальный редактор использует iframe для отображения вашего сайта. Убедитесь, что политика безопасности контента (CSP) вашего сайта разрешает URL CMS в качестве `frame-ancestors` (по умолчанию 'https://app.intlayer.org'). Проверьте консоль редактора на наличие ошибок.

package/docs/ru/intlayer_with_adonisjs.md

@@ -60,19 +60,23 @@ See [Application Template](https://github.com/aymericzip/intlayer-adonis-templat
 Чтобы начать использовать `adonis-intlayer`, установите пакет с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_analog.md

@@ -119,19 +119,23 @@ Intlayer — это больше, чем просто решение i18n. Он
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_angular_19.md

@@ -122,19 +122,23 @@ Intlayer — это больше, чем просто решение i18n. Он
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_angular_21.md

@@ -124,19 +124,23 @@ Intlayer — это больше, чем просто решение i18n. Он
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_astro_vue.md

@@ -121,19 +121,23 @@ Intlayer — это больше, чем просто решение i18n. Он
 Установите необходимые пакеты с помощью вашего менеджера пакетов:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_create_react_app.md

@@ -53,19 +53,23 @@ author: aymericzip
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/docs/ru/intlayer_with_express.md

@@ -62,19 +62,23 @@ See [Application Template](https://github.com/aymericzip/intlayer-express-templa
 Чтобы начать использовать `express-intlayer`, установите пакет с помощью npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.