@intlayer/docs 7.0.8 → 7.0.9-canary.0

package/frequent_questions/id/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Saya mendapatkan error terkait sub-paket @intlayer/*
+description: Memperbaiki error terkait sub-paket @intlayer/*.
+keywords:
+  - @intlayer/*
+  - sub-paket
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Saya mendapatkan error terkait sub-paket `@intlayer/*`
+
+Masalah ini biasanya terjadi setelah pembaruan paket Intlayer.
+
+Contoh pesan error:
+
+```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  Tidak ada ekspor yang cocok di "node_modules/@intlayer/config/dist/esm/client.mjs" untuk impor "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Alasan
+
+Paket dasar seperti `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` menggunakan kembali sub-paket yang sama seperti `@intlayer/config`, `@intlayer/core`, `@intlayer/types` untuk menghindari duplikasi kode.
+
+Antara dua versi, ekspor dari sub-paket tidak dijamin sama. Untuk membatasi masalah ini, intlayer mengunci versi sub-paket ke versi paket utama.
+
+> Contoh: `intlayer@1.0.0` menggunakan `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (Kecuali untuk `@intlayer/swc`), sub-paket `@intlayer/*` tidak dimaksudkan untuk digunakan secara langsung. Jadi kami menyarankan untuk tidak menginstalnya secara langsung.
+
+## Resolusi
+
+1. Pastikan versi paket utama dan sub-paket adalah sama.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Versi salah, seharusnya 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Coba hapus lockfile dan folder node_modules lalu instal ulang dependensi.
+
+Terkadang, package manager menyimpan versi lama dari sub-paket di lockfile dalam cache. Untuk memperbaikinya, Anda bisa mencoba menghapus lockfile dan folder node_modules lalu instal ulang dependensi.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Periksa instalasi global
+
+Kami menyarankan untuk menginstal `intlayer` atau `intlayer-cli` secara global untuk mengakses perintah CLI. Jika versi global tidak sama dengan versi lokal, package manager mungkin menganggap versi yang salah.
+
+**Periksa apakah sebuah paket terinstal secara global**
+
+```bash
+npm list -g --depth=0
+```
+
+```bash
+npm list -g --depth=0 | grep intlayer
+```
+
+```bash
+yarn global list
+```
+
+```bash
+pnpm list -g --depth=0
+```
+
+**Perbaiki potensi konflik dependensi global**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Coba bersihkan cache
+
+Untuk beberapa lingkungan seperti docker, github actions, atau platform hosting web seperti Vercel, cache mungkin ada. Anda bisa mencoba membersihkan cache dan mencoba instalasi ulang.
+
+Anda juga bisa mencoba membersihkan cache package manager Anda dengan perintah berikut:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

package/frequent_questions/it/package_version_error.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Ricevo un errore relativo ai sotto-pacchetti @intlayer/*
+description: Risolvi l'errore relativo ai sotto-pacchetti @intlayer/*.
+keywords:
+  - @intlayer/*
+  - sotto-pacchetti
+  - intlayer
+slugs:
+  - frequent-questions
+  - package-version-error
+---
+
+# Ricevo un errore relativo ai sotto-pacchetti `@intlayer/*`
+
+Questo problema si verifica solitamente dopo un aggiornamento dei pacchetti Intlayer.
+
+Esempio di messaggio di errore:
+
+```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";
+  |          ~~~~~~~~~~~~~~~~
+
+✖ ERRORE  Nessuna esportazione corrispondente in "node_modules/@intlayer/config/dist/esm/client.mjs" per l'importazione "configESMxCJSRequire"
+
+node_modules/@intlayer/unmerged-dictionaries-entry/dist/esm/index.mjs:3:27:
+3 | import { clearModuleCache, configESMxCJSRequire } from "@intlayer/config";
+  |                            ~~~~~~~~~~~~~~~~~~~~
+```
+
+## Motivo
+
+I pacchetti base come `intlayer`, `react-intlayer`, `react-native-intlayer`, `vue-intlayer` riutilizzano gli stessi sotto-pacchetti come `@intlayer/config`, `@intlayer/core`, `@intlayer/types` per evitare la duplicazione del codice.
+
+Tra due versioni, le esportazioni dei sotto-pacchetti non sono garantite essere le stesse. Per limitare questo problema, intlayer fissa la versione dei sotto-pacchetti alla versione del pacchetto principale.
+
+> Es: `intlayer@1.0.0` utilizza `@intlayer/config@1.0.0`, `@intlayer/core@1.0.0`, `@intlayer/types@1.0.0`
+
+> (Ad eccezione di `@intlayer/swc`), i sotto-pacchetti `@intlayer/*` non sono pensati per essere usati direttamente. Quindi consigliamo di non installarli direttamente.
+
+## Risoluzione
+
+1. Assicurarsi che le versioni del pacchetto principale e dei sotto-pacchetti siano le stesse.
+
+```json5
+{
+  "dependencies": {
+    "intlayer": "7.0.1",
+    "react-intlayer": "7.0.0", // Versione errata, dovrebbe essere 7.0.1
+  },
+  "devDependencies": {
+    "intlayer-editor": "7.0.1",
+  },
+}
+```
+
+2. Provare a rimuovere il lockfile e la cartella node_modules e reinstallare le dipendenze.
+
+A volte, il package manager mantiene una vecchia versione dei sotto-pacchetti nel lockfile in cache. Per risolvere questo problema, puoi provare a rimuovere il lockfile e la cartella node_modules e reinstallare le dipendenze.
+
+```bash
+rm -rf package-lock.json node_modules
+npm install
+```
+
+3. Controllare l'installazione globale
+
+Consigliamo di installare `intlayer` o `intlayer-cli` globalmente per accedere ai comandi CLI. Se la versione globale non è la stessa della versione locale, il package manager potrebbe considerare la versione sbagliata.
+
+**Controllare se un pacchetto è installato 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
+```
+
+**Risolvi potenziali conflitti di dipendenze globali**
+
+```bash
+npm uninstall -g intlayer intlayer-cli
+```
+
+```bash
+yarn global remove intlayer intlayer-cli
+```
+
+```bash
+pnpm remove -g intlayer intlayer-cli
+```
+
+5. Prova a pulire la cache
+
+Per alcuni ambienti come docker, github actions o piattaforme di hosting web come Vercel, può essere presente una cache. Puoi provare a pulire la cache e ripetere l’installazione.
+
+Puoi anche provare a pulire la cache del tuo package manager con il seguente comando:
+
+```bash
+npm cache clean --force
+```
+
+```bash
+yarn cache clean
+```
+
+```bash
+pnpm cache clean
+```

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