@intlayer/docs 9.5.6 → 9.5.8

package/docs/uk/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Дізнайтеся, як використовувати команду init infra CLI Intlayer для встановлення десктопного застосунку або запуску Intlayer CMS на власній інфраструктурі за допомогою Docker (all-in-one контейнер або стек Docker Compose).
+keywords:
+  - CLI
+  - Інфраструктура
+  - Власний хостинг
+  - Десктопний застосунок
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Додати команду init infra"
+author: aymericzip
+---
+
+# Команда Intlayer CLI Init Infra
+
+## Опис
+
+Команда `init infra` налаштовує інфраструктуру Intlayer на вашому комп'ютері. Вона завантажує інсталятор для вашої платформи (`https://intlayer.org/install.sh` на macOS / Linux, `https://intlayer.org/install.ps1` на Windows) і запускає його у вашому терміналі, тому меню інсталятора та вивід прогресу відображаються без змін.
+
+Інсталятор запитує, як саме ви хочете запускати Intlayer:
+
+- **Десктопний застосунок**: завантажує нативну панель керування для вашої ОС та процесора і відкриває або встановлює її. Десктопна версія взаємодіє з бекендом Intlayer Cloud.
+- **All-in-one Docker**: панель керування + API + MongoDB + Redis + MinIO в одному контейнері з одним томом даних. Записує `./intlayer.env` зі згенерованими секретами та завантажує образ `intlayer/cms-all`.
+- **Docker Compose**: один контейнер на сервіс для масштабованого власного хостингу. Записує `docker-compose.yml` та `.env` у `./intlayer/` і завантажує образи.
+
+Розміщений інсталятор є єдиним джерелом правди для процесу встановлення: CLI запускає його замість повторної реалізації тих самих кроків, тому `npx intlayer init infra` та `curl -fsSL https://intlayer.org/install.sh | sh` роблять абсолютно те саме.
+
+## Використання
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+Цей самий крок пропонується в інтерактивному списку `npx intlayer init --interactive` у пункті **Інфраструктура (десктопний застосунок / власний хостинг)**.
+
+## Опції
+
+- `-m, --mode <mode>` - Необов'язково. Пропускає меню інсталятора та запускає вибраний режим безпосередньо. Допустимі значення: `desktop`, `docker` (all-in-one) або `compose`. Будь-яке інше значення завершує роботу з помилкою.
+
+## Приклади
+
+### Інтерактивний вибір режиму
+
+```bash
+npx intlayer init infra
+```
+
+### Встановлення десктопного застосунку
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Власний хостинг з all-in-one контейнером
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Власний хостинг з Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Приклад виводу
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## Налаштування інсталятора
+
+Інсталятор зчитує кілька змінних середовища, які CLI передає без змін. Задайте їх у командній оболонці перед запуском команди:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Змінна                    | За замовчуванням          | Застосовується до | Опис                                                             |
+| ------------------------- | ------------------------- | ----------------- | ---------------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(запитується)_           | всі               | `desktop`, `docker` або `compose`, аналогічно до `--mode`        |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop           | Куди зберігається інсталятор застосунку                          |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker            | Образ all-in-one для завантаження                                |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker            | Куди записувати файл середовища                                  |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker            | Назва контейнера                                                 |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker            | Іменований том, змонтований у `/data`                            |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker            | Порт хоста для панелі керування                                  |
+| `INTLAYER_API_PORT`       | `3100`                    | docker            | Порт хоста для API                                               |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker            | Порт хоста для MinIO S3 API                                      |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker            | Порт хоста для консолі MinIO                                     |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose           | Куди записуються `docker-compose.yml` та `.env`                  |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | обидва            | Git-посилання, з якого завантажуються compose-файл та шаблон env |
+
+> Змінні портів змінюють лише сторону **хоста** у відображенні. Опубліковані образи мають значення `http://localhost:3000`, `http://localhost:3100` та `http://localhost:9000`, скомпільовані в пакет панелі керування, тому залишайте значення за замовчуванням, якщо не збираєте власні образи: див. [посібник із власного хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md#limitations).
+
+## Вимоги
+
+- **Десктопний застосунок** потребує [Node.js](https://nodejs.org): застосунок містить сервер панелі керування та запускає його за допомогою системного бінарного файлу `node`.
+- **Режими Docker** потребують [Docker](https://docs.docker.com/get-docker/) (Docker Desktop із бекендом WSL 2 на Windows). Для режиму Compose також потрібен плагін `docker compose`.
+
+## Примітки
+
+- Повторний запуск команди є безпечним: наявний файл середовища ніколи не перезаписується, що також слугує шляхом оновлення (інсталятор завантажує найновіші образи та зберігає ваші секрети).
+- Інсталятор завантажується в тимчасовий каталог і видаляється після завершення незалежно від результату.
+- Код виходу команди відповідає коду інсталятора. Якщо завантаження не вдалося, CLI виводить еквівалентну команду `curl … | sh` (або `irm … | iex`).
+- Режимам Docker все ще потрібен поштовий сервіс для надсилання листів для входу. Після завершення роботи інсталятора налаштуйте Resend або SMTP у згенерованому файлі середовища: див. [Глобальний поштовий сервіс](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md#global-mailer).
+
+## Пов'язані посилання
+
+- [Посібник із власного хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md) - Архітектура, перші кроки та обмеження кожного режиму
+- [Ініціалізація Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/init.md) - Батьківська команда `init` та її інтерактивний чеклист
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_CMS.md) - Можливості щойно встановленої панелі керування

package/docs/uk/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Ініціалізація Intlayer
 description: Дізнайтеся, як ініціалізувати Intlayer у вашому проєкті.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Додати підкоманду init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Додано опцію --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Це налаштує всі файли конфігурації, але не змінить ваш файл `.gitignore`.
 
+### Налаштування інфраструктури (десктопний застосунок або власний хостинг):
+
+```bash
+npx intlayer init infra
+```
+
+Завантажує та запускає інсталятор (`https://intlayer.org/install.sh`, або `install.ps1` на Windows), який запитує, як ви хочете запускати Intlayer:
+
+- **Десктопний застосунок** - встановлює нативну панель керування на ваш комп'ютер, підключену до Intlayer Cloud.
+- **All-in-one Docker** - панель керування + API + MongoDB + Redis + MinIO в одному контейнері.
+- **Docker Compose** - один контейнер на сервіс для масштабованого власного хостингу.
+
+Пропустіть меню за допомогою `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+Цей же крок пропонується через `npx intlayer init --interactive`. Дивіться [довідку `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/infra.md) щодо налаштувань інсталятора та [посібник із власного хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md) щодо того, що налаштовує кожен режим.
+
 ## Приклад виводу:
 
 ```bash

package/docs/uk/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Оновлення пакетів Intlayer
+description: Дізнайтеся, як використовувати команду upgrade в Intlayer CLI, щоб отримати список усіх пакетів Intlayer вашого проєкту або монорепозиторію та оновити їх до останньої версії.
+keywords:
+  - CLI
+  - Upgrade
+  - Оновлення
+  - Пакети
+  - Монорепозиторій
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Додати команду upgrade"
+author: aymericzip
+---
+
+# Оновлення пакетів Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+Команда `upgrade` виводить список пакетів Intlayer, оголошених у кожному `package.json` вашого проєкту, включно з робочими просторами (workspaces) монорепозиторію, та оновлює їх до останньої опублікованої версії. Вона автономно виконує той самий крок оновлення пакетів, що й `intlayer init`.
+
+## Аргументи:
+
+- `--project-root [projectRoot]` - Необов'язково. Кореневий каталог проєкту. За замовчуванням команда починає з найближчого `package.json` вище поточного робочого каталогу.
+- `--dry-run` - Необов'язково. Виводить список пакетів та їхніх цільових версій без зміни будь-яких файлів.
+- `--tag <tag>` - Необов'язково. npm dist-tag для оновлення (наприклад, `canary`). За замовчуванням `latest`.
+
+## Що вона робить:
+
+1. **Складає список пакетів Intlayer** - Сканує кожен `package.json` проєкту (пропускаючи `node_modules` та результати збірки) на наявність залежностей і devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` та `intlayer-*`.
+2. **Отримує цільову версію** - Зчитує версію обраного dist-tag (за замовчуванням `latest`) кожного пакета з реєстру npm.
+3. **Переписує діапазони версій** - Оновлює кожен застарілий діапазон безпосередньо у файлі, зберігаючи його оператор (`^`, `~` або без оператора) та форматування відступів.
+4. **Встановлює за один раз** - Виконує єдине встановлення з кореня робочого простору (найближчого каталогу з lock-файлом), використовуючи менеджер пакетів, якому належить lock-файл:
+
+| Lock-файл                     | Команда        |
+| ----------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`      | `bun install`  |
+| `pnpm-lock.yaml`              | `pnpm install` |
+| `yarn.lock`                   | `yarn install` |
+| `package-lock.json` або немає | `npm install`  |
+
+Якщо lock-файлу немає, використовується поле `packageManager` з `package.json` (наприклад, `"bun@1.2.0"`), перш ніж перейти до npm.
+
+Діапазони, які не вказують на реєстр, такі як `workspace:*`, `file:`, `link:`, `catalog:` або URL-адреси git, ніколи не змінюються.
+
+## Приклади:
+
+### Показати список доступних оновлень без їх застосування:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Оновити до релізу canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Приклад виводу:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Примітки:
+
+- Запустіть команду з кореня вашого репозиторію, щоб оновити всі робочі простори. Запустіть її з конкретного робочого простору, щоб оновити лише його.
+- Пакети, версію яких неможливо отримати (офлайн, приватний або неопублікований пакет), додаються до списку та залишаються без змін.
+- Якщо встановлення не вдалося, оновлені діапазони зберігаються в `package.json`. Запустіть команду встановлення вашого менеджера пакетів вручну.

package/docs/uk/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-01-22
+updatedAt: 2026-09-21
 title: Вміст HTML
 description: Дізнайтеся, як оголошувати та використовувати HTML-контент із користувацькими компонентами в Intlayer. Дотримуйтесь цієї документації, щоб вбудувати багатий вміст, схожий на HTML, з динамічною заміною компонентів у вашому інтернаціоналізованому проєкті.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
 slugs:
   - doc
   - concept
@@ -236,6 +238,83 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    У Remix 3 вузли HTML перетворюються на рядок HTML. Вставте його за допомогою пропу `innerHTML` у Remix JSX або за допомогою `html.raw` у поданні `html-template`.
+
+    ```tsx fileName="src/views/home.tsx"
+    import { useIntlayer } from "remix-intlayer";
+
+    export const HomePage = () => () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return <div innerHTML={myHtmlContent.value} />;
+    };
+    ```
+
+    ```ts fileName="src/views/home.ts"
+    import { html } from "remix/html-template";
+    import { useIntlayer } from "remix-intlayer";
+
+    export const renderHomePage = () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return html.raw`<div>${myHtmlContent.value}</div>`;
+    };
+    ```
+
+    > Remix екранує інтерпольовані значення за замовчуванням. `innerHTML` та `html.raw` — це два способи відмови від екранування, що й потрібно для рядка HTML.
+
+    Використовуйте метод `.use()` для перевизначення тегів або зіставлення користувацьких компонентів. Перевизначення — це функції, які повертають рядок HTML:
+
+    ```tsx
+    <div
+      innerHTML={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    В Astro вузли HTML перетворюються на рядок HTML. Вставте його за допомогою директиви `set:html` у шаблоні або за допомогою `innerHTML` у клієнтському тегу `<script>`.
+
+    ```astro fileName="src/pages/index.astro"
+    ---
+    import { useIntlayer } from "astro-intlayer";
+
+    const { myHtmlContent } = useIntlayer("app");
+    ---
+
+    <div set:html={myHtmlContent.value} />
+    ```
+
+    ```astro fileName="src/components/Content.astro"
+    <div id="content"></div>
+
+    <script>
+      import { useIntlayer } from "astro-intlayer";
+
+      const { myHtmlContent } = useIntlayer("app");
+
+      document.querySelector("#content")!.innerHTML = myHtmlContent.value;
+    </script>
+    ```
+
+    > Astro екранує `{вирази}` за замовчуванням. `set:html` — це спосіб відмови від екранування, що й потрібно для рядка HTML.
+
+    Використовуйте метод `.use()` для перевизначення тегів або зіставлення користувацьких компонентів. Перевизначення — це функції, які повертають рядок HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Глобальна конфігурація за допомогою `HTMLProvider`
@@ -471,6 +550,41 @@ const myContent = html(
     > Динамічний імпорт вашого HTML-рендерера — це гарний спосіб зменшити розмір бандла вашого застосунку.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    У Remix немає дерева компонентів для розміщення провайдера, тому конфігурація встановлюється один раз як синглтон під час запуску сервера. Вона налаштовує рендерер, що повертається `useHTMLRenderer()`. Вузли `html`, що повертаються `useIntlayer`, відображаються як є; перевизначайте їхні теги для кожного вузла за допомогою `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > Використовуйте `installIntlayerHTMLDynamic(async () => …)` для відкладеного завантаження самого рендерера; завантажувач виконується лише під час першого виклику.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    В Astro немає дерева компонентів для розміщення провайдера, тому конфігурація встановлюється один раз як синглтон у middleware (сервер) та в клієнтському тегу `<script>` (браузер). Вона налаштовує рендерер, що повертається `useHTMLRenderer()`. Вузли `html`, що повертаються `useIntlayer`, відображаються як є; перевизначайте їхні теги для кожного вузла за допомогою `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // Запускається один раз під час запуску сервера; сам middleware Intlayer
+    // реєструється інтеграцією перед цим файлом.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > Використовуйте `installIntlayerHTMLDynamic(async () => …)` для відкладеного завантаження самого рендерера; завантажувач виконується лише під час першого виклику.
+
+  </Tab>
 </Tabs>
 
 ### Ручне відтворення та розширені інструменти
@@ -643,15 +757,69 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Хук `useHTMLRenderer()`
+
+    Отримайте функцію відтворення, попередньо налаштовану за допомогою `installIntlayerHTML()`. Вона повертає рядок HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### Утиліта `renderHTML()`
+
+    Автономна утиліта, яка ігнорує глобальну конфігурацію.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Хук `useHTMLRenderer()`
+
+    Отримайте функцію відтворення, попередньо налаштовану за допомогою `installIntlayerHTML()`. Вона повертає рядок HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### Утиліта `renderHTML()`
+
+    Автономна утиліта, яка ігнорує глобальну конфігурацію.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Довідник опцій
 
 Ці опції можна передавати в `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` та `renderHTML`.
 
-| Опція        | Тип                   | Типово | Опис                                                                                                               |
-| :----------- | :-------------------- | :----- | :----------------------------------------------------------------------------------------------------------------- |
-| `components` | `Record<string, any>` | `{}`   | Мапа HTML-тегів або назв користувацьких компонентів до компонентів.                                                |
-| `renderHTML` | `Function`            | `null` | Користувацька функція відтворення для повної заміни стандартного HTML-парсера (Тільки для провайдерів Vue/Svelte). |
+| Опція        | Тип                   | Типово | Опис                                                                                                                    |
+| :----------- | :-------------------- | :----- | :---------------------------------------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`   | Мапа HTML-тегів або назв користувацьких компонентів до компонентів.                                                     |
+| `renderHTML` | `Function`            | `null` | Користувацька функція відтворення для повної заміни стандартного HTML-парсера (провайдери Vue, Svelte, Remix та Astro). |
 
 > Примітка: Для React та Preact стандартні HTML-теги надаються автоматично. Вам потрібно передавати проп `components`, лише якщо ви хочете перевизначити їх або додати власні компоненти.