@intlayer/docs 7.5.12 → 7.5.13

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.12",
+  "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.12",
-    "@intlayer/core": "7.5.12",
-    "@intlayer/types": "7.5.12"
+    "@intlayer/config": "7.5.13",
+    "@intlayer/core": "7.5.13",
+    "@intlayer/types": "7.5.13"
   },
   "devDependencies": {
-    "@intlayer/api": "7.5.12",
-    "@intlayer/cli": "7.5.12",
+    "@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",

package/src/generated/frequentQuestions.entry.ts

@@ -199,6 +199,26 @@ export const frequentQuestionsEntry = {
     vi: readLocale('domain_routing.md', 'vi'),
     uk: readLocale('domain_routing.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './frequent_questions/en/error-vite-env-only.md': {
+    en: readLocale('error-vite-env-only.md', 'en'),
+    ru: readLocale('error-vite-env-only.md', 'ru'),
+    ja: readLocale('error-vite-env-only.md', 'ja'),
+    fr: readLocale('error-vite-env-only.md', 'fr'),
+    ko: readLocale('error-vite-env-only.md', 'ko'),
+    zh: readLocale('error-vite-env-only.md', 'zh'),
+    es: readLocale('error-vite-env-only.md', 'es'),
+    de: readLocale('error-vite-env-only.md', 'de'),
+    ar: readLocale('error-vite-env-only.md', 'ar'),
+    it: readLocale('error-vite-env-only.md', 'it'),
+    'en-GB': readLocale('error-vite-env-only.md', 'en-GB'),
+    pt: readLocale('error-vite-env-only.md', 'pt'),
+    hi: readLocale('error-vite-env-only.md', 'hi'),
+    tr: readLocale('error-vite-env-only.md', 'tr'),
+    pl: readLocale('error-vite-env-only.md', 'pl'),
+    id: readLocale('error-vite-env-only.md', 'id'),
+    vi: readLocale('error-vite-env-only.md', 'vi'),
+    uk: readLocale('error-vite-env-only.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/esbuild_error.md': {
     en: readLocale('esbuild_error.md', 'en'),
     ru: readLocale('esbuild_error.md', 'ru'),