@intlayer/docs 7.4.0 → 7.5.0-canary.1

package/docs/it/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Come tradurre la tua Tanstack Start – guida i18n 2025
 description: Scopri come aggiungere l'internazionalizzazione (i18n) alla tua applicazione Tanstack Start utilizzando Intlayer. Segui questa guida completa per rendere la tua app multilingue con il routing consapevole della localizzazione.
 keywords:
@@ -656,17 +656,6 @@ export function NotFoundComponent() {
 }
 ```
 
-```tsx fileName="src/routes/__root.tsx"
-import { createRootRoute } from "@tanstack/react-router";
-
-// La route radice funge da layout di livello superiore
-// Non gestisce i 404 direttamente - questo è delegato alle route figlie
-// Questo mantiene la radice semplice e consente alle route consapevoli della locale di gestire la propria logica 404
-export const Route = createRootRoute({
-  component: Outlet,
-});
-```
-
 ```tsx fileName="src/routes/{-$locale}/route.tsx"
 import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
 import { validatePrefix } from "intlayer";

package/docs/it/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Plugin Sync JSON
 description: Sincronizza i dizionari Intlayer con file JSON i18n di terze parti (i18next, next-intl, react-intl, vue-i18n e altri). Mantieni il tuo i18n esistente mentre usi Intlayer per gestire, tradurre e testare i tuoi messaggi.
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: Aggiunto supporto per i formati ICU e i18next
   - version: 6.1.6
     date: 2025-10-05
     changes: Documentazione iniziale del plugin Sync JSON
 ---
 
-# Sync JSON (ponti i18n)
+# Sync JSON (ponti i18n) - Sync JSON con supporto ICU / i18next
 
 <iframe title="Come mantenere sincronizzate le tue traduzioni JSON con Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // richiesto
   location?: string, // etichetta opzionale, predefinito: "plugin"
   priority?: number, // priorità opzionale per la risoluzione dei conflitti, predefinito: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // formattatore opzionale, predefinito: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Specifica il formattatore da utilizzare per il contenuto del dizionario durante la sincronizzazione dei file JSON. Ciò consente di utilizzare diverse sintassi di formattazione dei messaggi compatibili con varie librerie i18n.
+
+- `'intlayer'`: Il formattatore Intlayer predefinito (predefinito).
+- `'icu'`: Utilizza la formattazione dei messaggi ICU (compatibile con librerie come react-intl, vue-i18n).
+- `'i18next'`: Utilizza la formattazione dei messaggi i18next (compatibile con i18next, next-i18next, Solid-i18next).
+
+**Esempio:**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // Usare la formattazione i18next per la compatibilità
+}),
+```
+
 ## Più sorgenti JSON e priorità
 
 Puoi aggiungere più plugin `syncJSON` per sincronizzare diverse sorgenti JSON. Questo è utile quando hai più librerie i18n o diverse strutture JSON nel tuo progetto.
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // Sorgente JSON primaria (priorità più alta)
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // Sorgente JSON di fallback (priorità più bassa)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // Sorgente JSON legacy (priorità più bassa)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ja/cli/index.md

@@ -103,6 +103,10 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 
 ## intlayer コマンドの実行
 
+### 認証
+
+- **[ログイン](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/login.md)** - Intlayer CMSで認証し、アクセス認証情報を取得する
+
 ### コアコマンド
 
 - **[辞書のビルド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/build.md)** - コンテンツ宣言ファイルから辞書をビルドします
@@ -144,6 +148,7 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",

package/docs/ja/cli/login.md

@@ -0,0 +1,159 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - ログイン
+description: Intlayer CLI の login コマンドを使用して Intlayer CMS に認証し、アクセス認証情報を取得する方法を学びます。
+keywords:
+  - CLI
+  - Login
+  - Authentication
+  - CMS
+  - Intlayer
+  - Credentials
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Intlayer CLI ログインコマンド
+
+---
+
+## 説明
+
+Intlayer CLI の `login` コマンドは Intlayer CMS に対して認証を行うためのコマンドです。このコマンドは既定のブラウザを自動的に開き、認証プロセスを完了して Intlayer サービスを利用するために必要な認証情報（Client ID と Client Secret）を受け取ります。
+
+## 使用方法
+
+```bash
+npx intlayer login [options]
+```
+
+または
+
+```bash
+intlayer login [options]
+```
+
+## オプション
+
+### `--cms-url <url>`
+
+認証のために接続する Intlayer CMS の URL を指定します。
+
+- **型**: `string`
+- **既定値**: `intlayer.config.*` に設定された値、または `https://intlayer.org`
+- **例**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 設定オプション
+
+一般的な設定オプションも使用できます:
+
+- `--env-file <path>`: 環境ファイルへのパス
+- `-e, --env <env>`: 実行環境
+- `--base-dir <dir>`: プロジェクトのベースディレクトリ
+- `--verbose`: 詳細出力を有効にする（デフォルト: true）
+- `--prefix <prefix>`: ログのプレフィックス
+
+## 動作の仕組み
+
+1. **ローカルサーバーの起動**: このコマンドは CMS から認証情報を受け取るためにランダムなポートでローカル HTTP サーバーを起動します
+2. **ブラウザの起動**: コマンドは既定のブラウザで CMS のログイン URL を自動的に開きます
+3. **認証**: ブラウザで Intlayer アカウントを使用して認証を完了します
+4. **認証情報の受信**: ローカルサーバーが CMS から Client ID と Client Secret を受け取ります
+5. **手順**: コマンドはプロジェクトで認証情報を設定するための手順を表示します
+
+## 出力
+
+ログインに成功すると、コマンドは次の内容を表示します:
+
+1. **受信した認証情報**（Client ID と Client Secret）
+2. **`.env` ファイル用の手順**:
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Intlayer 設定ファイル用の手順**:
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## 手動設定
+
+ブラウザが自動で開かない場合、ターミナルに表示されている URL を手動で開いてください。
+
+## 例
+
+### カスタム CMS URL を使用してログイン
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### 特定の環境ファイルを指定してログイン
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### 冗長モードでログイン
+
+```bash
+npx intlayer login --verbose
+```
+
+## トラブルシューティング
+
+### ブラウザが開かない
+
+ブラウザが自動で開かない場合、ターミナルに表示されている URL をコピーしてブラウザで手動で開いてください。
+
+### 接続の問題
+
+接続の問題が発生した場合、次を確認してください：
+
+1. CMS の URL が正しいこと
+2. インターネット接続が正常に動作していること
+3. 接続をブロックするファイアウォールがないこと
+4. インターネット接続が正常に機能していることを確認する
+5. ファイアウォールが接続をブロックしていないこと
+
+### 認証情報が受け取れない場合
+
+認証情報が受け取れない場合:
+
+1. ブラウザで認証プロセスを完了したことを確認する
+2. ローカルポートがブロックされていないことを確認する
+3. コマンドを再実行してみる
+
+## 次の手順
+
+ログイン完了後:
+
+1. 認証情報を `.env` ファイルに追加する
+2. 認証情報を使って `intlayer.config.*` ファイルを設定する
+3. 辞書を管理するためにCLIコマンドを使用する:
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/push.md) - 辞書をCMSにプッシュする
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/pull.md) - 辞書をCMSからプルする
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/fill.md) - 不足している翻訳を埋める
+
+## 関連項目
+
+- [CLI ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/index.md)
+- [Intlayer 設定](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)

package/docs/ja/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: `buildMode` オプションを追加
   - version: 6.0.0
     date: 2025-09-16
     changes: `live` インポートモードを追加
@@ -525,6 +528,15 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
 
 #### プロパティ
 
+- **mode**:
+  - _型_: `'auto' | 'manual'`
+  - _デフォルト_: `'auto'`
+  - _説明_: ビルドのモードを制御します。
+  - _例_: `'manual'`
+  - _注意_: 'auto'の場合、アプリケーションがビルドされると自動的にビルドが有効になります。
+  - _注意_: 'manual'の場合、ビルドコマンドが実行されたときにのみビルドが設定されます。
+  - _注意_: 辞書のビルドを無効にするために使用できます。たとえば、Node.js環境での実行を避ける必要がある場合などです。
+
 - **optimize**:
   - _型_: `boolean`
   - _デフォルト_: `process.env.NODE_ENV === 'production'`

package/docs/ja/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: コンテンツファイル
 description: コンテンツ宣言ファイルの拡張機能をカスタマイズする方法を学びます。このドキュメントに従って、プロジェクトで効率的に条件を実装しましょう。
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICUおよびi18next形式のサポートを追加
   - version: 6.0.0
     date: 2025-09-20
     changes: フィールドのドキュメントを追加
@@ -387,6 +390,26 @@ Intlayerの辞書は`Dictionary`型で定義され、その動作を制御する
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+辞書コンテンツに使用するフォーマッターを指定します。これにより、異なるメッセージフォーマット構文を使用できます。
+
+- `'intlayer'`: デフォルトのIntlayerフォーマッター。
+- `'icu'`: ICUメッセージフォーマットを使用します。
+- `'i18next'`: i18nextメッセージフォーマットを使用します。
+
+**例：**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 辞書をロケールごとの辞書に変換し、content内で宣言された各フィールドが自動的に翻訳ノードに変換されます。このプロパティが設定されている場合：

package/docs/ja/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Astroアプリを翻訳する方法 – i18nガイド 2025
-description: Intlayerを使用してViteとReactアプリケーションに国際化（i18n）を追加する方法を学びます。このガイドに従ってアプリを多言語対応にしましょう。
+description: Intlayerを使用してAstroウェブサイトに国際化（i18n）を追加する方法を学びます。このガイドに従ってサイトを多言語対応にしましょう。
 keywords:
   - 国際化
   - ドキュメント

package/docs/ja/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: Express backendアプリを翻訳する方法 – i18nガイド 2025
-description: viteバックエンドを多言語化する方法を見つけましょう。国際化（i18n）して翻訳するためにドキュメントに従ってください。
+description: Expressバックエンドを多言語化する方法を見つけましょう。国際化（i18n）して翻訳するためにドキュメントに従ってください。
 keywords:
   - 国際化
   - ドキュメンテーション

package/docs/ja/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Nest backendアプリを翻訳する方法 – i18nガイド 2025
-description: Viteバックエンドを多言語対応にする方法を紹介します。国際化（i18n）と翻訳のためのドキュメントに従ってください。
+description: NestJSバックエンドを多言語対応にする方法を紹介します。国際化（i18n）と翻訳のためのドキュメントに従ってください。
 keywords:
   - 国際化
   - ドキュメント

package/docs/ja/intlayer_with_next-i18next.md

@@ -580,6 +580,7 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ja/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // 各ネームスペースのフォルダ構造をIntlayerと同期させる
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ja/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Tanstack Startアプリを翻訳する方法 – i18nガイド 2025
 description: Intlayerを使ってTanstack Startアプリケーションに国際化（i18n）を追加する方法を学びます。ロケール対応ルーティングで多言語対応アプリを作成するための包括的なガイドです。
 keywords:
@@ -628,17 +628,6 @@ export function NotFoundComponent() {
 }
 ```
 
-```tsx fileName="src/routes/__root.tsx"
-import { createRootRoute } from "@tanstack/react-router";
-
-// ルートルートは最上位レイアウトとして機能します
-// 404を直接処理しません - それは子ルートに委任されます
-// これにより、ルートをシンプルに保ち、ロケール対応ルートが独自の404ロジックを管理できるようになります
-export const Route = createRootRoute({
-  component: Outlet,
-});
-```
-
 ```tsx fileName="src/routes/{-$locale}/route.tsx"
 import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
 import { validatePrefix } from "intlayer";

package/docs/ja/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Sync JSON プラグイン
 description: Intlayerの辞書をサードパーティのi18n JSONファイル（i18next、next-intl、react-intl、vue-i18nなど）と同期します。既存のi18nを維持しながら、Intlayerでメッセージの管理、翻訳、テストを行えます。
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICUおよびi18next形式のサポートを追加
   - version: 6.1.6
     date: 2025-10-05
     changes: Sync JSONプラグインの初期ドキュメント
 ---
 
-# Sync JSON（i18nブリッジ）
+# Sync JSON（i18nブリッジ）- ICU / i18nextサポート付きSync JSON
 
 <iframe title="IntlayerでJSON翻訳を同期状態に保つ方法" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // 必須
   location?: string, // オプションのラベル、デフォルト: "plugin"
   priority?: number, // コンフリクト解決のためのオプションの優先度、デフォルト: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // オプションのフォーマッター、デフォルト: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+JSONファイルを同期する際に辞書コンテンツに使用するフォーマッターを指定します。これにより、さまざまなi18nライブラリと互換性のある異なるメッセージフォーマット構文を使用できます。
+
+- `'intlayer'`: デフォルトのIntlayerフォーマッター（デフォルト）。
+- `'icu'`: ICUメッセージフォーマットを使用します（react-intl、vue-i18nなどのライブラリと互換性があります）。
+- `'i18next'`: i18nextメッセージフォーマットを使用します（i18next、next-i18next、Solid-i18nextと互換性があります）。
+
+**例：**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // 互換性のためにi18nextフォーマットを使用
+}),
+```
+
 ## 複数の JSON ソースと優先度
 
 複数の `syncJSON` プラグインを追加して異なる JSON ソースを同期することができます。これは、複数の i18n ライブラリや異なる JSON 構造をプロジェクトで使用している場合に便利です。
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // プライマリJSONソース（最も高い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // フォールバックJSONソース（低い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // レガシーJSONソース（最も低い優先度）
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ko/cli/index.md

@@ -103,6 +103,10 @@ Intlayer는 여러 구성 파일 형식을 지원합니다:
 
 ## intlayer 명령 실행
 
+### 인증
+
+- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/login.md)** - Intlayer CMS로 인증하고 액세스 자격 증명 받기
+
 ### 핵심 명령
 
 - **[사전 빌드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/build.md)** - 콘텐츠 선언 파일에서 사전을 빌드합니다.
@@ -144,6 +148,7 @@ Intlayer는 여러 구성 파일 형식을 지원합니다:
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",