@intlayer/docs 7.0.8 → 7.0.9-canary.0

package/frequent_questions/pt/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Recebo um erro relacionado aos sub-pacotes @intlayer/*
+description: Corrigir erro relacionado aos sub-pacotes @intlayer/*.
+keywords:
+  - @intlayer/*
+  - sub-pacotes
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Recebo um erro relacionado aos sub-pacotes `@intlayer/*`
+
+Este problema geralmente ocorre após uma atualização dos pacotes Intlayer.
+
+Exemplo de mensagem de erro:
+
+```bash
+Error: Cannot find module '@intlayer/types'
+```
+
+```bash
+TypeError: (0 , __intlayer_config_client.colorize) is not a function
+
+at import { colorize } from '@intlayer/config';
+```
+
+```bash
+✖ ERROR  No matching export in "node_modules/@intlayer/config/dist/esm/client.mjs" for import "clearModuleCache"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:9:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ ERRO  Nenhuma exportação correspondente em "node_modules/@intlayer/config/dist/esm/client.mjs" para a importação "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Razão
+
+Pacotes base como `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` estão reutilizando os mesmos sub-pacotes como `@intlayer/config`, `@intlayer/core`, `@intlayer/types` para evitar duplicação de código.
+
+Entre duas versões, as exportações dos sub-pacotes não são garantidas como sendo as mesmas. Para limitar esse problema, o intlayer fixa a versão dos sub-pacotes para a versão do pacote principal.
+
+> Ex: `intlayer@1.0.0` usa `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (Exceto para `@intlayer/swc`), os sub-pacotes `@intlayer/*` não são destinados a serem usados diretamente. Portanto, recomendamos não instalá-los diretamente.
+
+## Resolução
+
+1. Garanta que as versões do pacote principal e dos sub-pacotes sejam as mesmas.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Versão errada, deveria ser 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Tente remover o arquivo de bloqueio (lockfile) e a pasta node_modules e reinstalar as dependências.
+
+Às vezes, o gerenciador de pacotes mantém uma versão antiga dos sub-pacotes no arquivo de bloqueio em cache. Para corrigir isso, você pode tentar remover o arquivo de bloqueio e a pasta node_modules e reinstalar as dependências.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Verifique a instalação global
+
+Recomendamos instalar `intlayer` ou `intlayer-cli` globalmente para acessar os comandos CLI. Se a versão global não for a mesma que a versão local, o gerenciador de pacotes pode considerar a versão errada.
+
+**Verifique se um pacote está instalado globalmente**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Corrigir potenciais conflitos de dependências globais**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Tente limpar o cache
+
+Em alguns ambientes como docker, github actions, ou plataformas de hospedagem web como Vercel, pode haver um cache presente. Você pode tentar limpar o cache e tentar a instalação novamente.
+
+Você também pode tentar limpar o cache do seu gerenciador de pacotes com o seguinte comando:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

package/frequent_questions/ru/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Я получаю ошибку, связанную с суб-пакетами `@intlayer/*`
+description: Исправление ошибки, связанной с суб-пакетами `@intlayer/*`.
+keywords:
+  - @intlayer/*
+  - суб-пакеты
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Я получаю ошибку, связанную с суб-пакетами `@intlayer/*`
+
+Эта проблема обычно возникает после обновления пакетов Intlayer.
+
+Пример сообщения об ошибке:
+
+```bash
+Error: Cannot find module '@intlayer/types'
+```
+
+```bash
+TypeError: (0 , __intlayer_config_client.colorize) is not a function
+
+at import { colorize } from '@intlayer/config';
+```
+
+```bash
+✖ ERROR  No matching export in "node_modules/@intlayer/config/dist/esm/client.mjs" for import "clearModuleCache"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:9:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ ERROR  Нет соответствующего экспорта в "node_modules/@intlayer/config/dist/esm/client.mjs" для импорта "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Причина
+
+Базовые пакеты, такие как `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer`, повторно используют одни и те же суб-пакеты, такие как `@intlayer/config`, `@intlayer/core`, `@intlayer/types`, чтобы избежать дублирования кода.
+
+Между двумя версиями экспорты суб-пакетов не гарантируются быть одинаковыми. Чтобы ограничить эту проблему, intlayer фиксирует версию суб-пакетов на версии основного пакета.
+
+> Пример: `intlayer@1.0.0` использует `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (За исключением `@intlayer/swc`), суб-пакеты `@intlayer/*` не предназначены для прямого использования. Поэтому мы рекомендуем не устанавливать их напрямую.
+
+## Решение
+
+1. Убедитесь, что версии основного пакета и суб-пакетов совпадают.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Неверная версия, должна быть 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Попробуйте удалить lockfile и папку node_modules, затем переустановить зависимости.
+
+Иногда менеджер пакетов сохраняет старую версию суб-пакетов в lockfile или кэше. Чтобы исправить это, можно попробовать удалить lockfile и папку node_modules, а затем заново установить зависимости.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Проверьте глобальную установку
+
+Рекомендуется устанавливать `intlayer` или `intlayer-cli` глобально для доступа к CLI-командам. Если глобальная версия отличается от локальной, менеджер пакетов может использовать неправильную версию.
+
+**Проверка, установлен ли пакет глобально**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Исправление возможных конфликтов глобальных зависимостей**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Попробуйте очистить кэш
+
+В некоторых средах, таких как docker, github actions или платформах веб-хостинга, например Vercel, может присутствовать кэш. Вы можете попробовать очистить кэш и повторить установку.
+
+Также можно попробовать очистить кэш вашего менеджера пакетов с помощью следующей команды:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

package/frequent_questions/tr/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Alt paketlerle ilgili @intlayer/* hatası alıyorum
+description: Alt paketlerle ilgili @intlayer/* hatasını düzeltme.
+keywords:
+  - @intlayer/*
+  - alt paketler
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Alt paketlerle ilgili `@intlayer/*` hatası alıyorum
+
+Bu sorun genellikle Intlayer paketlerinin güncellenmesinden sonra ortaya çıkar.
+
+Hata mesajı örneği:
+
+```bash
+Error: Cannot find module '@intlayer/types'
+```
+
+```bash
+TypeError: (0 , __intlayer_config_client.colorize) is not a function
+
+at import { colorize } from '@intlayer/config';
+```
+
+```bash
+✖ ERROR  "node_modules/@intlayer/config/dist/esm/client.mjs" içinde "clearModuleCache" için eşleşen bir export bulunamadı
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:9:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ HATA  "node_modules/@intlayer/config/dist/esm/client.mjs" içinde "configESMxCJSRequire" için eşleşen bir export bulunamadı
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Sebep
+
+`intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` gibi temel paketler, kod tekrarını önlemek için `@intlayer/config`, `@intlayer/core`, `@intlayer/types` gibi aynı alt paketleri yeniden kullanmaktadır.
+
+İki sürüm arasında, alt paketlerin exportları aynı olacağı garanti edilmez. Bu sorunu sınırlamak için, intlayer alt paketlerin sürümünü ana paketin sürümüne sabitler.
+
+> Örnek: `intlayer@1.0.0` `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0` kullanır
+
+> (`@intlayer/swc` hariç), `@intlayer/*` alt paketleri doğrudan kullanılmak üzere tasarlanmamıştır. Bu yüzden doğrudan kurmamanızı öneririz.
+
+## Çözüm
+
+1. Ana paket ve alt paketlerin sürümlerinin aynı olduğundan emin olun.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Yanlış sürüm, 7.0.1 olmalı
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Kilit dosyasını (lockfile) ve node_modules klasörünü kaldırmayı ve bağımlılıkları yeniden yüklemeyi deneyin.
+
+Bazen, paket yöneticisi alt paketlerin eski bir sürümünü kilit dosyasında (lockfile) önbellekte tutar. Bunu düzeltmek için, kilit dosyasını ve node_modules klasörünü kaldırıp bağımlılıkları yeniden yüklemeyi deneyebilirsiniz.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Global kurulumu kontrol edin
+
+CLI komutlarına erişmek için `intlayer` veya `intlayer-cli` paketlerini global olarak kurmanızı öneririz. Eğer global sürüm yerel sürümle aynı değilse, paket yöneticisi yanlış sürümü kullanabilir.
+
+**Bir paketin global olarak kurulu olup olmadığını kontrol edin**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Olası global bağımlılık çatışmalarını düzeltin**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Önbelleği temizlemeyi deneyin
+
+Docker, GitHub Actions veya Vercel gibi web barındırma platformları gibi bazı ortamlarda önbellek bulunabilir. Önbelleği temizlemeyi ve kurulumu tekrar denemeyi deneyebilirsiniz.
+
+Ayrıca, paket yöneticinizin önbelleğini aşağıdaki komutlarla temizlemeyi deneyebilirsiniz:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

package/frequent_questions/vi/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Tôi nhận được lỗi liên quan đến các gói con @intlayer/*
+description: Sửa lỗi liên quan đến các gói con @intlayer/*.
+keywords:
+  - @intlayer/*
+  - các gói con
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Tôi nhận được lỗi liên quan đến các gói con `@intlayer/*`
+
+Vấn đề này thường xảy ra sau khi cập nhật các gói Intlayer.
+
+Ví dụ về thông báo lỗi:
+
+```bash
+Error: Cannot find module '@intlayer/types'
+```
+
+```bash
+TypeError: (0 , __intlayer_config_client.colorize) is not a function
+
+at import { colorize } from '@intlayer/config';
+```
+
+```bash
+✖ ERROR  No matching export in "node_modules/@intlayer/config/dist/esm/client.mjs" for import "clearModuleCache"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:9:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ LỖI  Không có export phù hợp trong "node_modules/@intlayer/config/dist/esm/client.mjs" cho import "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Nguyên nhân
+
+Các gói cơ sở như `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` đang tái sử dụng cùng các gói con như `@intlayer/config`, `@intlayer/core`, `@intlayer/types` để tránh trùng lặp mã nguồn.
+
+Giữa hai phiên bản, các exports của các gói con không được đảm bảo là giống nhau. Để hạn chế vấn đề này, intlayer cố định phiên bản của các gói con theo phiên bản của gói chính.
+
+> Ví dụ: `intlayer@1.0.0` sử dụng `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (Ngoại trừ `@intlayer/swc`), các gói con `@intlayer/*` không được thiết kế để sử dụng trực tiếp. Vì vậy, chúng tôi khuyến nghị không cài đặt chúng trực tiếp.
+
+## Cách khắc phục
+
+1. Đảm bảo phiên bản của gói chính và các gói con là giống nhau.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Phiên bản sai, nên là 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Thử xóa file khóa (lockfile) và thư mục node_modules rồi cài đặt lại các dependencies.
+
+Đôi khi, trình quản lý gói giữ lại phiên bản cũ của các gói con trong file khóa (lockfile) trong bộ nhớ đệm. Để khắc phục, bạn có thể thử xóa file khóa và thư mục node_modules rồi cài đặt lại các dependencies.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Kiểm tra cài đặt toàn cục (global)
+
+Chúng tôi khuyến nghị cài đặt `intlayer` hoặc `intlayer-cli` ở mức toàn cục để truy cập các lệnh CLI. Nếu phiên bản toàn cục không giống với phiên bản cục bộ, trình quản lý gói có thể sử dụng phiên bản sai.
+
+**Kiểm tra xem một gói có được cài đặt toàn cục không**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Khắc phục xung đột phụ thuộc toàn cục tiềm ẩn**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Thử làm sạch bộ nhớ đệm
+
+Đối với một số môi trường như docker, github actions, hoặc các nền tảng lưu trữ web như Vercel, có thể tồn tại bộ nhớ đệm. Bạn có thể thử làm sạch bộ nhớ đệm và thử cài đặt lại.
+
+Bạn cũng có thể thử làm sạch bộ nhớ đệm của trình quản lý gói với lệnh sau:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

package/frequent_questions/zh/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: 我遇到了与子包 @intlayer/* 相关的错误
+description: 解决与子包 @intlayer/* 相关的错误。
+keywords:
+  - @intlayer/*
+  - 子包
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# 我遇到了与子包 `@intlayer/*` 相关的错误
+
+此问题通常发生在更新 Intlayer 包之后。
+
+错误信息示例：
+
+```bash
+Error: Cannot find module '@intlayer/types'
+```
+
+```bash
+TypeError: (0 , __intlayer_config_client.colorize) is not a function
+
+at import { colorize } from '@intlayer/config';
+```
+
+```bash
+✖ ERROR  No matching export in "node_modules/@intlayer/config/dist/esm/client.mjs" for import "clearModuleCache"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:9:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ 错误  在 "node_modules/@intlayer/config/dist/esm/client.mjs" 中没有匹配的导出用于导入 "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## 原因
+
+基础包如 `intlayer`、`react-intlayer`、`react-native-intlayer`、`vue-intlayer` 复用了相同的子包，如 `@intlayer/config`、`@intlayer/core`、`@intlayer/types`，以避免代码重复。
+
+在两个版本之间，子包的导出不保证是相同的。为限制此问题，intlayer 将子包的版本固定为主包的版本。
+
+> 例如：`intlayer@1.0.0` 使用 `@intlayer/config@1.0.0`、`@intlayer/core@1.0.0`、`@intlayer/types@1.0.0`
+
+> （除了 `@intlayer/swc`），`@intlayer/*` 子包不建议直接使用。因此我们建议不要直接安装它们。
+
+## 解决方案
+
+1. 确保主包和子包的版本一致。
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // 版本错误，应该是 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. 尝试删除锁文件和 node_modules 文件夹并重新安装依赖。
+
+有时，包管理器会在缓存的锁文件中保留子包的旧版本。为了解决这个问题，你可以尝试删除锁文件和 node_modules 文件夹，然后重新安装依赖。
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. 检查全局安装
+
+我们建议全局安装 `intlayer` 或 `intlayer-cli` 以访问 CLI 命令。如果全局版本与本地版本不一致，包管理器可能会使用错误的版本。
+
+**检查某个包是否已全局安装**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**修复潜在的全局依赖冲突**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. 尝试清理缓存
+
+在某些环境中，如 docker、GitHub Actions 或 Vercel 等网站托管平台，可能存在缓存。您可以尝试清理缓存并重新安装。
+
+您也可以尝试使用以下命令清理包管理器的缓存：
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```