@intlayer/docs 7.0.8 → 7.0.9-canary.2

package/frequent_questions/ja/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. グローバルインストールを確認する
+
+CLI コマンドにアクセスするために、`intlayer` または `intlayer-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/ko/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"를 위한 일치하는 export를 찾을 수 없습니다.
+
+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`와 같은 동일한 서브 패키지를 재사용하고 있습니다.
+
+두 버전 사이에서 서브 패키지의 exports가 동일하다는 보장이 없습니다. 이 문제를 제한하기 위해, 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. 전역 설치 확인
+
+CLI 명령어에 접근하기 위해 `intlayer` 또는 `intlayer-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/pl/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Otrzymuję błąd związany z sub-pakietami `@intlayer/*`
+description: Napraw błąd związany z sub-pakietami `@intlayer/*`.
+keywords:
+  - @intlayer/*
+  - sub-pakiety
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Otrzymuję błąd związany z sub-pakietami `@intlayer/*`
+
+Ten problem zwykle występuje po aktualizacji pakietów Intlayer.
+
+Przykład komunikatu o błędzie:
+
+```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";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ BŁĄD  Brak odpowiedniego eksportu w "node_modules/@intlayer/config/dist/esm/client.mjs" dla importu "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Powód
+
+Podstawowe pakiety takie jak `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` ponownie wykorzystują te same sub-pakiety jak `@intlayer/config`, `@intlayer/core`, `@intlayer/types`, aby uniknąć duplikacji kodu.
+
+Między dwiema wersjami eksporty sub-pakietów nie są gwarantowane jako identyczne. Aby ograniczyć ten problem, intlayer przypisuje wersję sub-pakietów do wersji głównego pakietu.
+
+> Przykład: `intlayer@1.0.0` używa `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (Z wyjątkiem `@intlayer/swc`), sub-pakiety `@intlayer/*` nie są przeznaczone do bezpośredniego użycia. Dlatego zalecamy, aby ich nie instalować bezpośrednio.
+
+## Rozwiązanie
+
+1. Upewnij się, że wersje głównego pakietu i sub-pakietów są takie same.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Nieprawidłowa wersja, powinna być 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Spróbuj usunąć plik blokady (lockfile) oraz folder node_modules i ponownie zainstalować zależności.
+
+Czasami menedżer pakietów przechowuje starą wersję sub-pakietów w pliku blokady w pamięci podręcznej. Aby to naprawić, możesz spróbować usunąć plik blokady oraz folder node_modules i ponownie zainstalować zależności.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Sprawdź instalację globalną
+
+Zalecamy zainstalowanie `intlayer` lub `intlayer-cli` globalnie, aby mieć dostęp do poleceń CLI. Jeśli wersja globalna różni się od wersji lokalnej, menedżer pakietów może uznać niewłaściwą wersję.
+
+**Sprawdź, czy pakiet jest zainstalowany globalnie**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Napraw potencjalne konflikty zależności globalnych**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Spróbuj wyczyścić pamięć podręczną
+
+W niektórych środowiskach, takich jak docker, github actions czy platformy hostingowe jak Vercel, może istnieć pamięć podręczna. Możesz spróbować wyczyścić pamięć podręczną i ponowić instalację.
+
+Możesz także spróbować wyczyścić pamięć podręczną menedżera pakietów za pomocą następującego polecenia:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

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
+```