@intlayer/docs 7.0.8 → 7.0.9-canary.2

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "7.0.8",
+  "version": "7.0.9-canary.2",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -58,6 +58,9 @@
     "lint": "biome lint .",
     "lint:fix": "biome lint --write .",
     "prepublish": "cp -f ../README.md ./README.md",
+    "publish": "bun publish --access public || true",
+    "publish:canary": "bun publish --tag canary --access public || true",
+    "publish:latest": "bun publish --tag latest --access public || true",
     "review": "bun tools/review.ts",
     "serve": "webpack serve --config ./webpack.config.ts",
     "test": "vitest run",
@@ -69,30 +72,30 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "7.0.8",
-    "@intlayer/core": "7.0.8",
-    "@intlayer/types": "7.0.8"
+    "@intlayer/config": "7.0.9-canary.2",
+    "@intlayer/core": "7.0.9-canary.2",
+    "@intlayer/types": "7.0.9-canary.2"
   },
   "devDependencies": {
-    "@intlayer/api": "7.0.8",
-    "@intlayer/cli": "7.0.8",
-    "@types/node": "24.10.0",
-    "@utils/ts-config": "7.0.8",
-    "@utils/ts-config-types": "7.0.8",
-    "@utils/tsdown-config": "7.0.8",
+    "@intlayer/api": "7.0.9-canary.2",
+    "@intlayer/cli": "7.0.9-canary.2",
+    "@types/node": "24.10.1",
+    "@utils/ts-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsdown-config": "1.0.4",
     "fast-glob": "3.3.3",
     "rimraf": "6.1.0",
-    "tsdown": "0.16.0",
+    "tsdown": "0.16.4",
     "tsx": "^4.20.6",
     "typescript": "5.9.3",
-    "vitest": "4.0.7"
+    "vitest": "4.0.8"
   },
   "peerDependencies": {
-    "@intlayer/api": "7.0.8",
-    "@intlayer/cli": "7.0.8",
-    "@intlayer/config": "7.0.8",
-    "@intlayer/core": "7.0.8",
-    "@intlayer/types": "7.0.8"
+    "@intlayer/api": "7.0.9-canary.2",
+    "@intlayer/cli": "7.0.9-canary.2",
+    "@intlayer/config": "7.0.9-canary.2",
+    "@intlayer/core": "7.0.9-canary.2",
+    "@intlayer/types": "7.0.9-canary.2"
   },
   "engines": {
     "node": ">=14.18"

package/src/generated/frequentQuestions.entry.ts

@@ -268,6 +268,25 @@ export const frequentQuestionsEntry = {
     id: readLocale('locale_incorect_in_url.md', 'id'),
     vi: readLocale('locale_incorect_in_url.md', 'vi'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './frequent_questions/en/package_version_error.md': {
+    en: readLocale('package_version_error.md', 'en'),
+    ru: readLocale('package_version_error.md', 'ru'),
+    ja: readLocale('package_version_error.md', 'ja'),
+    fr: readLocale('package_version_error.md', 'fr'),
+    ko: readLocale('package_version_error.md', 'ko'),
+    zh: readLocale('package_version_error.md', 'zh'),
+    es: readLocale('package_version_error.md', 'es'),
+    de: readLocale('package_version_error.md', 'de'),
+    ar: readLocale('package_version_error.md', 'ar'),
+    it: readLocale('package_version_error.md', 'it'),
+    'en-GB': readLocale('package_version_error.md', 'en-GB'),
+    pt: readLocale('package_version_error.md', 'pt'),
+    hi: readLocale('package_version_error.md', 'hi'),
+    tr: readLocale('package_version_error.md', 'tr'),
+    pl: readLocale('package_version_error.md', 'pl'),
+    id: readLocale('package_version_error.md', 'id'),
+    vi: readLocale('package_version_error.md', 'vi'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/static_rendering.md': {
     en: readLocale('static_rendering.md', 'en'),
     ru: readLocale('static_rendering.md', 'ru'),