@intlayer/docs 7.5.11 → 7.5.13

package/frequent_questions/uk/static_rendering.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Статичний vs динамічний рендеринг з i18n у Next.js
+description: Дізнайтеся, як використовувати статичний та динамічний рендеринг з i18n у Next.js.
+keywords:
+  - статичний
+  - динамічний
+  - рендеринг
+  - i18n
+  - next.js
+  - next-intl
+  - intlayer
+  - фреймворк
+  - middleware
+  - конфігурація
+slugs:
+  - frequent-questions
+  - static-rendering
+---
+
+# Статичний vs динамічний рендеринг з i18n у Next.js
+
+## Проблема з **next-intl**
+
+- **Що відбувається?**
+  Коли ви використовуєте `useTranslations`, `getTranslations`, або будь-який хелпер next-intl _всередині Server Component_ в застосунку з i18n-маршрутизацією (`/en/…`, `/fr/…`), Next.js позначає весь маршрут як **dynamic**. ([Next Intl][1])
+
+- **Чому?**
+  next-intl визначає поточну локаль з заголовка, доступного лише в запиті (`x-next-intl-locale`) через `headers()`. Оскільки `headers()` — це **динамічний API**, будь-який компонент, який до нього звертається, втрачає статичну оптимізацію. ([Next Intl][1], [Next.js][2])
+
+- **Офіційне рішення (boilerplate)**
+  1. Експортуйте `generateStaticParams` для кожної підтримуваної локалі.
+  2. Викликайте `setRequestLocale(locale)` у **кожному** layout/page _перед_ тим, як викликати `useTranslations`. ([Next Intl][1])
+     Це усуває залежність від заголовка, але додає додатковий код для підтримки та використовує нестабільний API у продакшені.
+
+## Як **intlayer** обходить проблему
+
+**Дизайн-рішення**
+
+1. **Тільки параметр маршруту (route-param only)** – локаль береться з сегмента URL `[locale]`, який Next.js вже передає кожній сторінці.
+2. **Бандли на етапі компіляції** – Переклади імпортуються як звичайні ES-модулі, тож вони піддаються tree-shaking і вбудовуються під час збірки.
+3. **Без динамічних API** – `useT()` читає з React context, а не з `headers()` або `cookies()`.
+4. **Жодної додаткової конфігурації** – Як тільки ваші сторінки розміщені під `app/[locale]/`, Next.js автоматично генерує по одному HTML‑файлу на кожну локаль.

package/frequent_questions/uk/translated_path_url.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Чи можна перекласти шлях URL?
+description: Дізнайтеся, як перекласти шлях URL.
+keywords:
+  - array
+  - content
+  - declaration
+  - intlayer
+  - middleware
+  - proxy
+  - rewrite
+  - prefix
+  - locale
+  - url
+slugs:
+  - frequent-questions
+  - translated-path-url
+---
+
+# Чи можливо перекласти URL наступним чином:
+
+```bash
+en -> /product (без префікса) або /en/product (з префіксом)
+fr -> /fr/produit
+es -> /es/producto
+```
+
+На жаль, Intlayer не дозволяє перекладати URL так, як зазначено вище. Щоб досягти цього, ви повинні використовувати власний middleware або proxy для перезапису (rewrite) URL.
+
+Але ви можете використовувати функцію `getMultilingualUrl`, щоб вставити префікс у URL для заданої локалі.
+
+```ts
+import { getMultilingualUrl, Locales } from "intlayer";
+
+const url = getMultilingualUrl("/product");
+
+/**
+ * en -> /product (без префікса) або /en/product (з префіксом)
+ * fr -> /fr/product
+ * es -> /es/product
+ */
+console.log(url);
+```
+
+Або `getLocalizedUrl`
+
+```ts
+import { getLocalizedUrl, Locales } from "intlayer";
+
+const url = getLocalizedUrl("/product", Locales.FRENCH);
+
+console.log(url); // виведе: /fr/product
+```

package/frequent_questions/uk/unknown_command.md

@@ -0,0 +1,97 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Невідома команда
+description: Дізнайтеся, як виправити помилку невідомої команди.
+keywords:
+  - невідома
+  - команда
+  - помилка
+  - intlayer
+  - fill
+  - build
+  - verbose
+  - термінал
+  - перезапуск
+  - локально
+slugs:
+  - frequent-questions
+  - unknown-command
+---
+
+# помилка: невідома команда fill / build / тощо
+
+Якщо `npx intlayer fill --verbose` видає:
+
+```
+error: unknown command 'fill'
+```
+
+але ви впевнені, що команда `fill` _повинна_ існувати, ось кроки для вирішення:
+
+## 1. **Переконайтеся, що ви використовуєте найновішу версію**
+
+Запустіть:
+
+```bash
+npx intlayer --version                  # поточна локальна версія intlayer
+npx intlayer@latest --version           # остання доступна версія intlayer
+```
+
+Це змушує `npx` завантажити найновішу версію. Потім спробуйте ще раз:
+
+```bash
+npx intlayer@latest build --verbose
+```
+
+## 2. **Перевірте, чи команда зареєстрована**
+
+Ви можете перевірити за допомогою:
+
+```bash
+npx intlayer --help                     # надає інформацію про команди
+```
+
+Перевірте, чи з'являється команда у списку команд.
+
+Перейдіть у репозиторій та підтвердьте, що ваша команда експортується й зареєстрована в точці входу CLI. Intlayer використовує `commander` як фреймворк.
+
+Код, що стосується CLI:
+https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/cli/src/cli.ts
+
+## 4. **Перезапустіть термінал**
+
+Іноді потрібно перезапустити термінал, щоб він розпізнав нові команди.
+
+## 5. **Якщо ви розробляєте `intlayer`, перебудуйте та підключіть його**
+
+Якщо ви розробляєте `intlayer` локально:
+
+```bash
+# У директорії intlayer
+npm install
+npm run build
+npm link
+```
+
+Потім в іншому терміналі:
+
+```bash
+intlayer fill --verbose
+```
+
+Це використовує локальну версію, над якою ви працюєте.
+
+## 6. **Очистіть кеш npx (якщо ви застрягли на старішій версії)**
+
+```bash
+npx clear-npx-cache
+```
+
+Або вручну видаліть кешовані пакети intlayer:
+
+```bash
+rm -rf ~/.npm/_npx
+```
+
+Перевірте еквівалентні команди, якщо ви використовуєте pnpm, yarn, bun або інший пакетний менеджер

package/frequent_questions/vi/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Có thể sử dụng Intlayer với Next.js mà không có `[locale]` trong đường dẫn trang không?

package/frequent_questions/vi/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` & Intlayer – lỗi từ chối `node:fs` dương tính giả
+description: Tại sao vite-env-only báo một import `node:fs` bị từ chối khi dùng Intlayer + React-Router + Vite và phải làm gì.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import bị từ chối
+  - alias
+  - bundle phía client
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only từ chối `node:fs` với Intlayer
+
+Nếu bạn đã sử dụng plugin **vite-env-only** (như được đề cập trong các gợi ý React-Router v7 cũ hơn) và thấy:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…mặc dù **không có `node:fs` trong bundle phía client của bạn**, đây là một **false positive (dương tính giả)**.
+
+## Nguyên nhân gây ra
+
+`vite-env-only` chạy một kiểm tra dựa trên Babel **rất sớm trong quá trình phân giải graph của Vite**, _trước khi_:
+
+- aliasing (bao gồm ánh xạ browser vs node của Intlayer),
+- dead-code elimination,
+- SSR vs client resolution,
+- các module ảo như của React-Router.
+
+Các package của Intlayer chứa mã có thể chạy trên cả Node và trình duyệt. Ở một giai đoạn _trung gian_, một builtin của Node như `node:fs` có thể xuất hiện trong graph **trước khi** Vite loại bỏ nó khỏi build phía client. `vite-env-only` nhìn thấy điều đó và báo lỗi ngay lập tức, mặc dù bundle cuối cùng không chứa nó.
+
+## React-Router và Server Modules
+
+Trong tài liệu của React-Router về **server module conventions**
+(https://reactrouter.com/api/framework-conventions/server-modules), nhóm **rõ ràng khuyến nghị sử dụng `vite-env-only`** để ngăn các import chỉ dành cho server bị rò rỉ vào bundle phía client.
+
+Tuy nhiên, những quy ước đó dựa vào aliasing của Vite, conditional exports và tree-shaking để loại bỏ mã chỉ dành cho server. Trong khi aliasing và conditional exports đã được áp dụng, một số tiện ích dựa trên Node vẫn còn xuất hiện trong các package như `@intlayer/core` ở giai đoạn đó (mặc dù chúng không bao giờ được import vào client). Vì tree-shaking chưa chạy, các hàm đó vẫn bị Babel phân tích cú pháp, và `vite-env-only` phát hiện các import `node:` của chúng và báo dương tính giả — mặc dù chúng đã được loại bỏ chính xác khỏi bundle cuối cùng của client.
+
+## Cách khắc phục / giải pháp tạm thời
+
+### Khuyến nghị: Gỡ bỏ `vite-env-only`
+
+Chỉ cần gỡ plugin. Trong nhiều trường hợp bạn không cần nó — Vite đã xử lý việc phân biệt imports client và server thông qua cơ chế resolution của nó.
+
+Điều này sửa lỗi báo sai `node:fs` mà không cần thay đổi Intlayer.
+
+### Thay vào đó, kiểm tra bản build cuối cùng
+
+Nếu bạn vẫn muốn đảm bảo không có built-in của Node trong client, hãy làm điều đó **sau khi build**, ví dụ:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Nếu không có kết quả, các bundle client của bạn sạch.
+
+## Tóm tắt
+
+- `vite-env-only` có thể báo lỗi về `node:fs` vì nó kiểm tra quá sớm.
+- Vite + Intlayer + quy ước server modules của React-Router thường loại bỏ tham chiếu chỉ dành cho server một cách chính xác.
+- Gỡ plugin hoặc kiểm tra _kết quả cuối cùng_ thường là giải pháp tốt nhất.

package/frequent_questions/zh/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # 是否可以在页面路径中不使用 `[locale]` 来搭配 Next.js 使用 Intlayer？

package/frequent_questions/zh/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: "`vite-env-only` 与 Intlayer — 错误的 `node:fs` 导入被拒绝"
+description: 为什么在 Intlayer + React-Router + Vite 的组合中，vite-env-only 报告 `node:fs` 导入被拒绝，以及应如何处理。
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - 导入被拒绝
+  - alias
+  - 客户端 bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only 在 Intlayer 中拒绝 `node:fs` 导入
+
+如果你使用了 **vite-env-only** 插件（如旧版 React-Router v7 建议中所述），并且看到：
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…尽管**您的客户端包中没有 `node:fs`**，这仍然是一个**误报**。
+
+## 根本原因
+
+`vite-env-only` 在 Vite 的依赖图解析过程中**较早运行一个基于 Babel 的检查**，_在以下步骤之前_：
+
+- 别名重定向（包括 Intlayer 的 browser 与 node 映射），
+- 死代码消除，
+- SSR 与客户端解析，
+- 像 React-Router 的虚拟模块。
+
+Intlayer 的包包含可以在 Node 与浏览器上运行的代码。在一个 _中间_ 阶段，像 `node:fs` 这样的 Node 内置模块可能会在依赖图中出现，**在** Vite 将其从客户端构建中移除之前。`vite-env-only` 会看到该情况并立即报错，即使最终的 bundle 并不包含它。
+
+## React-Router 与服务端模块
+
+在 React-Router 关于 **服务端模块约定** 的文档中
+(https://reactrouter.com/api/framework-conventions/server-modules)，团队**明确建议使用 `vite-env-only`\*\*以防止仅用于服务器的导入泄漏到客户端包中。
+
+然而，这些约定依赖于 Vite 的 aliasing、conditional exports 和 tree-shaking 来移除仅用于服务器的代码。尽管 aliasing 和 conditional exports 已经被应用，但在该阶段某些基于 Node 的实用工具仍然存在于像 `@intlayer/core` 这样的包中（即便它们从未在客户端被导入）。因为 tree-shaking 尚未运行，那些函数仍会被 Babel 解析，`vite-env-only` 检测到它们的 `node:` 导入并报出误报 —— 即便这些导入在最终的客户端包中已被正确清除。
+
+## 如何修复 / 规避
+
+### 建议：移除 `vite-env-only`
+
+只需移除该插件。在许多情况下你不需要它 — Vite 已通过自身解析处理客户端与服务器导入的区分。
+
+这能修复误报的 `node:fs` 错误，而无需对 Intlayer 进行任何修改。
+
+### 改为验证最终构建
+
+如果你仍想确保客户端中没有 Node 内置模块，可在**构建后**进行验证，例如：
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+如果没有结果，说明你的客户端打包产物是干净的。
+
+## 总结
+
+- `vite-env-only` 可能会在 `node:fs` 上报错，因为它检查得太早。
+- Vite + Intlayer + React-Router 的 server modules 约定通常会正确移除仅用于服务器的引用。
+- 移除该插件或验证 _最终输出_ 通常是最佳解决方案。

package/legal/uk/privacy_notice.md

@@ -0,0 +1,83 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Повідомлення про конфіденційність Intlayer
+description: Дізнайтеся, як Intlayer обробляє інформацію, зібрану через наш вебсайт та CMS. Дотримуйтеся документації, щоб зрозуміти різні формати та сценарії використання.
+keywords:
+  - Інтернаціоналізація
+  - Документація
+  - Intlayer
+  - Конфіденційність
+  - Повідомлення
+  - Файли cookie
+  - Відстеження
+  - Аналітика
+  - Google Analytics
+  - Meta (Facebook) Pixel
+  - Аутентифікація
+  - Дані користувача
+slugs:
+  - privacy-notice
+---
+
+# Повідомлення про конфіденційність Intlayer
+
+## Вступ
+
+У Intlayer ми серйозно ставимося до конфіденційності. Це повідомлення пояснює, як ми обробляємо інформацію, що збирається через наш вебсайт та CMS.
+
+## Контакти
+
+Якщо у вас є питання чи занепокоєння щодо конфіденційності, будь ласка, зв'яжіться з нами за адресою: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Використання файлів cookie та технологій відстеження
+
+Ми використовуємо **Google Analytics** та **Meta (Facebook) Pixel** для аналізу використання нашого вебсайту та покращення послуг. Ці інструменти генерують статистику та іншу інформацію про вебсайт за допомогою файлів cookie, які зберігаються на пристроях користувачів.
+
+Для отримання додаткової інформації:
+
+- [Політика конфіденційності Google](https://policies.google.com/privacy)
+- [Політика конфіденційності Meta](https://www.facebook.com/privacy/policy)
+
+## Аутентифікація та дані користувачів
+
+Доступ до CMS Intlayer вимагає аутентифікації користувача. Ми пропонуємо автентифікацію за допомогою електронної пошти та пароля, а також вхід через сторонніх провайдерів — **Google** та **GitHub**.
+
+Під час аутентифікації ми збираємо:
+
+- Електронну адресу
+- Відображуване ім'я (або обране ім'я)
+
+Користувачі також можуть отримувати доступ до CMS за допомогою access tokens, пов'язаних із їхнім обліковим записом. Ці токени прив'язані до тих самих даних аутентифікації.
+
+## Зберігання даних та безпека
+
+Дані аутентифікації користувачів зберігаються в **MongoDB базі даних**, розміщеній на **cloud.mongodb.com**:
+
+- **Регіон:** AWS / Oregon (us-west-2)
+- **Тип:** Replica Set (3 nodes)
+- **Безпека паролів:** Усі паролі хешуються відповідно до загальноприйнятих практик галузі.
+
+Ми не зберігаємо жодних зайвих персональних даних понад ті, що необхідні для аутентифікації та безпечного доступу до CMS.
+
+## Передача даних третім сторонам
+
+Ми **не** продаємо та не передаємо ваші персональні дані третім сторонам, за винятком випадків, коли це необхідно для аналітики (Google Analytics, Facebook Pixel) або як частина процесу автентифікації (вхід через Google або GitHub).
+
+## Права користувачів
+
+Як користувач, ви маєте право:
+
+- Отримувати доступ до персональних даних, які ми зберігаємо про вас
+- Запитувати виправлення або видалення ваших даних
+- Відкликати доступ або видалити свій акаунт
+
+Для будь-яких запитів щодо ваших даних зв'яжіться з нами за адресою [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Зміни до цього повідомлення
+
+Ми можемо час від часу оновлювати це повідомлення про конфіденційність. Користувачам рекомендується регулярно перевіряти цю сторінку, щоб бути в курсі змін.
+
+---
+
+Повідомте, якщо ви хочете більш формальний тон, додати згадки про GDPR/CCPA або адаптувати це для юридичної сторінки вашого сайту.

package/legal/uk/terms_of_service.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Умови використання Intlayer
+description: Дізнайтеся, як Intlayer обробляє інформацію, зібрану через наш вебсайт і CMS. Дотримуйтесь документації, щоб зрозуміти різні формати та варіанти використання.
+keywords:
+  - Інтернаціоналізація
+  - Документація
+  - Intlayer
+  - Умови використання
+  - Послуга
+  - Використання
+  - Ліцензія
+  - Відповідальність
+  - Конфіденційність
+  - Внески
+  - Авторство
+  - Зміни умов
+slugs:
+  - terms-of-service
+---
+
+# Умови використання Intlayer
+
+## 1. Прийняття умов
+
+Використовуючи Intlayer, ви погоджуєтеся дотримуватися цих умов використання. Якщо ви не приймаєте ці умови, будь ласка, не користуйтеся цим інструментом.
+
+## 2. Ліцензія
+
+Intlayer поширюється під **ліцензією Apache 2.0**, яка дозволяє використання, модифікацію та розповсюдження коду як для open-source, так і для комерційних проєктів. Користувачам дозволяється змінювати вихідний код і надсилати внески через pull requests згідно з вказівками, наведеними в нашому [керівництві з внесків](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). Крадіжка коду для комерційного використання суворо заборонена.
+
+## 3. Комерційне використання
+
+Вам дозволено використовувати Intlayer у комерційних проєктах. Проте повторне використання коду для створення прямих конкурентних інструментів на базі Intlayer без суттєвої трансформації або значного додавання вартості заборонено.
+
+## 4. Відповідальність
+
+Мейнтейнери Intlayer прагнуть виправляти помилки та проблеми безпеки одразу після їх виявлення. Проте вони не несуть відповідальності за збитки, що можуть виникнути внаслідок таких проблем в інфраструктурах користувачів. Ми закликаємо користувачів повідомляти про проблеми через нашу [систему відстеження проблем](https://github.com/aymericzip/intlayer/issues).
+
+## 5. Конфіденційність
+
+Intlayer не збирає і не зберігає жодних персональних даних користувачів.
+
+## 6. Внески
+
+Користувачів заохочують робити внесок у Intlayer, дотримуючись інструкцій, наведених у нашому contribution guide. Будь-який надісланий код повинен відповідати встановленим стандартам якості та буде переглянутий мейнтейнерами перед інтеграцією.
+
+## 7. Визнання авторства
+
+Будь-який інструмент, розроблений для розширення або використання коду Intlayer, повинен чітко вказувати Intlayer як основу цього коду. Це зазначення має бути видимим у вихідному коді, а також у будь-якій документації для користувачів або рекламних матеріалах.
+
+## 8. Зміни умов
+
+Ці умови використання можуть бути змінені в будь-який момент. Користувачів буде повідомлено про будь-які значні зміни умов використання, і вони повинні прийняти ці зміни, щоб продовжувати користуватися Intlayer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "7.5.11",
+  "version": "7.5.13",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,13 +73,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "7.5.11",
-    "@intlayer/core": "7.5.11",
-    "@intlayer/types": "7.5.11"
+    "@intlayer/config": "7.5.13",
+    "@intlayer/core": "7.5.13",
+    "@intlayer/types": "7.5.13"
   },
   "devDependencies": {
-    "@intlayer/api": "7.5.11",
-    "@intlayer/cli": "7.5.11",
+    "@intlayer/api": "7.5.13",
+    "@intlayer/cli": "7.5.13",
     "@types/node": "25.0.3",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",