@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.2

package/docs/it/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Nuovo Intlayer v9 - Cosa c'è di nuovo?
+description: Scopri le novità di Intlayer v9. Introduzione di package di compatibilità drop-in per le più diffuse librerie i18n e supporto per Collections, Variants e Dynamic Records.
+keywords:
+  - Intlayer
+  - Compatibilità
+  - Migrazione
+  - Collections
+  - Variants
+  - Dynamic Records
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Nuovo Intlayer v9 - Cosa c'è di nuovo?
+
+Benvenuti a Intlayer v9! Questa major release segna un'enorme pietra miliare nella semplificazione del percorso di migrazione a Intlayer con i **Compat Adapter Packages** per le principali librerie i18n (`react-i18next`, `next-intl`, `vue-i18n`, ecc.) e aggiunge il supporto per strutture di contenuto ricche: **Collections**, **Variants** e **Dynamic Records**.
+
+## Indice
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Packages
+
+La migrazione a Intlayer dalle popolari librerie i18n è ora più facile che mai. Abbiamo creato cinque compat package che espongono le **stesse identiche API pubbliche** delle librerie i18n standard, ma delegano tutto il lavoro di traduzione a Intlayer a runtime.
+
+### Esporre la stessa API pubblica con tipizzazione stretta
+
+Sostituendo gli import, ottieni tutti i vantaggi di Intlayer (inclusa la type safety in fase di compilazione rispetto ai tuoi dizionari effettivi) con modifiche minime al codice:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+Ad esempio, è sufficiente cambiare:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+in:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Le tue chiavi saranno ora **strettamente tipizzate** rispetto ai tuoi dizionari Intlayer, offrendo il completamento automatico completo del dot-path nel tuo IDE!
+
+### Bundler Alias Plugins (Vite, Next.js, Turbopack)
+
+Per consentire la migrazione senza riscrivere manualmente tutte le tue istruzioni di import, ogni compat adapter package include un **plugin bundler personalizzato** (Vite o Next.js) sotto il sottopercorso `/plugin`.
+
+Questi plugin riscrivono automaticamente gli import esistenti (ad esempio `react-i18next` o `next-intl`) nei loro equivalenti `@intlayer/*` in fase di build.
+
+#### Esempio Next.js (Webpack / Turbopack)
+
+Invece di `withIntlayer`, avvolgi la tua configurazione Next.js con il compat plugin:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Esempio Vite (React, Vue, Solid, Svelte)
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Risolutore Runtime Mutualizzato
+
+Tutti i compat adapter ora instradano la risoluzione delle traduzioni attraverso un singolo parser runtime altamente ottimizzato: `@intlayer/core/messageFormat`.
+
+- **Interpolate Message**: Risolve `{{var}}` standard (spazi bianchi e dot-paths), argomenti formattati ICU (`{v, number, percent}` ecc.) e template `{var}` semplici.
+- **Message Node Resolver**: Risolve nodi annidati: `insert()`, `plural()` (regole plurali CLDR), `enu()` (enumerazione), `gender()`, tag HTML, array e nodi di funzione richiamabili.
+- **Tokenized Tag Parser**: Supporta tag XML/HTML inline e tag numerati (ad esempio, `<1>children</1>`) per abilitare il rendering di testo ricco out of the box.
+
+---
+
+## Specifica delle Funzionalità: Collections, Variants & Dynamic Records
+
+Intlayer v9 si espande oltre gli oggetti chiave-valore statici, consentendo ai dizionari di dichiarare strutture di layout dinamiche che sono completamente tipizzate end-to-end.
+
+### 1. Collections
+
+Definisci un elenco di elementi ordinati gestito da CMS (ad esempio FAQ, prodotti o elenchi di blog):
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        it: "Cos'è Intlayer?",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        it: "Un toolkit i18n.",
+        en: "An i18n toolkit.",
+        fr: "Une boîte à outils i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### Utilizzo:
+
+```ts
+// Recupera tutti gli elementi
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Recupera un singolo elemento per indice
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. Variants
+
+Fornisci A/B test, header stagionali, feature flag o landing page personalizzate:
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ it: "Benvenuto", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      it: "Acquista ora",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### Utilizzo:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. Dynamic Records
+
+Definisci dizionari le cui voci vengono caricate dinamicamente a runtime tramite ID di query:
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  meta: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ it: "Clean Code", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Utilizzo:
+
+```ts
+// Recupera solo l'elemento richiesto dinamicamente (richiede Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## Caricamento Dinamico e Ottimizzazioni delle Dimensioni del Bundle
+
+Per mantenere i bundle estremamente piccoli, Intlayer v9 supporta il caricamento dinamico lazy loading.
+
+Nella tua configurazione, imposta `importMode` su `'dynamic'` o `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+In fase di build, `@intlayer/swc` e `@intlayer/babel` scansionano i tuoi file e sostituiscono le chiamate `useIntlayer` / `getIntlayer` con wrapper tree-shakeable (`useDictionary` / `useDictionaryDynamic`). Viene caricato solo il contenuto richiesto per l'elemento della collection, la variante o la locale selezionati, impedendo al tuo bundle di produzione di contenere traduzioni inutilizzate.
+
+---
+
+## Note di migrazione da v8
+
+Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking changes. Ma ecco le modifiche chiave:
+
+- **Locales & Dialects**: Se utilizzi dipendenze i18n esterne, aggiungi i rispettivi compat adapter plugin nella tua configurazione o setup del bundler per riscrivere automaticamente gli import.
+- **Custom Selectors**: Quando chiami `useIntlayer`, il secondo parametro è ora riservato a un oggetto di opzioni contenente `{ locale, item, variant, id }`. Se in precedenza passavi direttamente una stringa locale, puoi ancora farlo, ma l'utilizzo dell'oggetto di opzioni è consigliato per selezioni avanzate.
+
+---
+
+## Link utili
+
+- [Guida ai Compat Adapter Packages](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/compat/index.md)
+- [Dizionari Dinamici - Collections, Variants & Dynamic Records](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dynamic_dictionaries/index.md)
+- [Riferimento alla Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)

package/docs/ja/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: ドキュメントのレビュー
 description: 異なるロケール間での品質、一貫性、完全性を確認するためのドキュメントファイルのレビュー方法を学びます。
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "--log オプションを追加"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ bun x intlayer doc review
 
 ## 引数:
 
-`doc review` コマンドは `doc translate` と同じ引数を受け付け、特定のドキュメントファイルをレビューし品質チェックを適用できます。
+**ファイルリストオプション:**
 
-もし git オプションのいずれかを有効にしている場合、コマンドは変更されているファイルの部分のみをレビューします。スクリプトはファイルをチャンクに分割して処理し、各チャンクをレビューします。チャンクに変更がなければ、レビュー処理を高速化し AI プロバイダーの API コストを抑えるためにそのチャンクはスキップされます。
+- **`--doc-pattern [docPattern...]`**: レビューするドキュメントファイルにマッチするグロブパターン。
 
-完全な引数の一覧については、[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/doc-translate.md) コマンドのドキュメントを参照してください。
+  > 例: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: レビューから除外するグロブパターン。
+
+  > 例: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: 指定した日時より前に変更されたファイルをスキップします。
+  - 絶対日時として "2025-12-05"（文字列またはDate型）を指定可能
+  - ミリ秒単位の相対時間として `1 * 60 * 60 * 1000`（1時間）を指定可能
+  - このオプションは `fs.stat` メソッドを使ってファイルの更新日時をチェックします。そのため、Gitやその他のツールによるファイル変更の影響を受ける可能性があります。
+
+  > 例: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: 指定した日時以内に変更されたファイルをスキップします。
+  - 絶対日時として "2025-12-05"（文字列またはDate型）を指定可能
+  - ミリ秒単位の相対時間として `1 * 60 * 60 * 1000`（1時間）を指定可能
+  - このオプションは `fs.stat` メソッドを使ってファイルの更新日時をチェックします。そのため、Gitやその他のツールによるファイル変更の影響を受ける可能性があります。
+
+  > 例: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: 既にファイルが存在する場合、そのファイルをスキップします。
+
+  > 例: `npx intlayer doc review --skip-if-exists`
+
+**レビューモードオプション:**
+
+- **`--log`**: ログ出力のみモード。AIによる翻訳は行わず、代わりに別のエージェントが翻訳を生成できるように、ベースロケールとターゲットロケールで注意が必要なブロック（行番号と内容を含む）をログ出力します。
+
+  > 例: `npx intlayer doc review --log`
+
+**エントリー出力オプション:**
+
+- **`--locales [locales...]`**: ドキュメントをレビューする対象のロケール。
+
+  > 例: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: 比較元のソースロケール（ベースドキュメント）。
+
+  > 例: `npx intlayer doc review --base-locale en`
+
+**ファイル処理オプション:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: レビューのために同時に処理するファイル数。
+
+  > 例: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**AIオプション:**
+
+- **`--model [model]`**: レビューに使用するAIモデル（例: `gpt-3.5-turbo`）。
+- **`--provider [provider]`**: レビューに使用するAIプロバイダー。
+- **`--temperature [temperature]`**: AIモデルの温度設定。
+- **`--api-key [apiKey]`**: AIサービス用のAPIキーを提供。
+- **`--application-context [applicationContext]`**: AIレビューに追加のコンテキストを提供。
+- **`--data-serialization [dataSerialization]`**: IntlayerのAI機能に使用するデータシリアライズ形式。オプション: `json` (標準的で信頼性が高い), `toon` (トークン消費が少ないが、一貫性が低い)。
+- **`--custom-prompt [prompt]`**: レビューに使用する基本プロンプトをカスタマイズします。（注：ほとんどのユースケースでは、挙動をより良く制御できるため `--custom-instructions` オプションの使用が推奨されます。）
+
+  > 例: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**環境変数オプション:**
+
+- **`--env`**: 環境を指定します（例：`development`、`production`）。
+- **`--env-file [envFile]`**: 変数を読み込むためのカスタム環境ファイルを指定します。
+- **`--base-dir`**: プロジェクトのベースディレクトリを指定します。
+- **`--no-cache`**: キャッシュを無効にします。
+
+  > 例: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**ログオプション:**
+
+- **`--verbose`**: デバッグのために詳細なログを有効にします。（CLIではデフォルトでtrue）
+
+  > 例: `npx intlayer doc review --verbose`
+
+**カスタム指示オプション:**
+
+- **`--custom-instructions [customInstructions]`**: プロンプトに追加するカスタム指示。フォーマットやURLの翻訳など特定のルールを適用するのに便利です。
+
+  > 例: `npx intlayer doc review --custom-instructions "URLの翻訳を避け、マークダウン形式を維持する"`
+
+  > 例: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Gitオプション:**
+
+- **`--git-diff`**: 変更を含むファイル（デフォルトは `origin/main` から現在のブランチ `HEAD` への変更）のみで実行します。
+- **`--git-diff-base`**: git diffのベース参照を指定します（デフォルトは `origin/main`）。
+- **`--git-diff-current`**: git diffの現在の参照を指定します（デフォルトは `HEAD`）。
+- **`--uncommitted`**: ココミットされていない変更を含めます。
+- **`--unpushed`**: プッシュされていない変更を含めます。
+- **`--untracked`**: トラッキングされていないファイルを含めます。
+
+  > 例: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 例: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> 出力ファイルのパスは、以下のパターンを置換することで決定されることに注意してください:
+>
+> - `/{{baseLocale}}/` を `/{{locale}}/` に置換（Unix）
+> - `\{{baseLocale}}\` を `\{{locale}}\` に置換（Windows）
+> - `_{{baseLocale}}.` を `_{{locale}}.` に置換
+> - `{{baseLocale}}_` を `{{locale}}_` に置換
+> - `.{{baseLocaleName}}.` を `.{{localeName}}.` に置換
+>
+> もしパターンが見つからない場合、出力ファイルはファイル拡張子の前に `.{{locale}}` を追加します。例えば `./my/file.md` はレビューされ、フランス語ロケールの場合 `./my/file.fr.md` に更新されます。

package/docs/ja/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "scanコマンドの追加"
   - version: 8.6.4

package/docs/ja/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "scanコマンドの追加"
 author: aymericzip

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "辞書設定に `format` オプションを追加"
   - version: 8.9.4
     date: 2026-05-12
     changes: "LM Studio プロバイダーのサポートを追加"
@@ -135,6 +138,7 @@ Intlayer は、JSON、JS、MJS、および TS の設定ファイル形式をサ
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -583,9 +587,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * プラグイン設定。
+   * 辞書設定。
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * 辞書のインポート方法を制御します。
+     * - "static": ビルド時に静的にインポート。
+     * - "dynamic": Suspenseを使用して動的にインポート。
+     * - "fetch": ライブ同期APIを介して動的に取得。
+     */
+    importMode: "static",
+
+    /**
+     * プロジェクト内のすべての辞書のデフォルトのメッセージ形式。
+     * - 'intlayer': ネイティブの intlayer 形式 (デフォルト)。
+     * - 'icu': ICU メッセージ形式。
+     * - 'i18next': i18next 形式。
+     * - 'vue-i18n': Vue I18n 形式。
+     * - 'po': GNU Gettext PO 形式。
+     */
+    format: "icu",
+  },
+
+  /**
+   * プラグインの設定。
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -854,20 +886,21 @@ export default config;
 
 自動入力動作やコンテンツ生成など、辞書操作を制御するパラメータ。
 
-| フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト  | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
-| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | 自動入力 (AI 翻訳) の出力ファイルがどのように生成されるかを制御します。                                                                       | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: デフォルトパス (ソースと同じファイル)。<br/>• `false`: 無効化。<br/>• 文字列/関数パターンは、ロケールごとのファイルを生成します。<br/>• ロケールごとのオブジェクト: 各ロケールが独自のパターンに対応します。`false` はそのロケールを無視します。<br/>• `{{locale}}` を含めると、ロケールごとの生成がトリガーされます。<br/>• 辞書レベルの `fill` は、常にこのグローバル設定よりも優先されます。 |
-| `description`               | エディタや CMS が辞書の目的を理解するのに役立ちます。AI による翻訳生成のコンテキストとしても使用されます。                                    | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `locale`                    | 辞書をロケールごとの形式に変換します。宣言された各フィールドが翻訳ノードになります。存在しない場合、辞書は多言語対応として扱われます。        | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | 辞書が複数の言語の翻訳を含むのではなく、特定のロケール専用である場合に使用します。                                                                                                                                                                                                                                                                                                                        |
-| `contentAutoTransformation` | コンテンツの文字列を型付きノード (markdown, HTML, または insertion) に自動変換します。                                                        | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`。<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`。<br/>• 挿入 (Insertion) : `Hello {{name}}` → `insert('Hello {{name}}')`。                                                                                                                                                                                                                    |
-| `location`                  | 辞書ファイルの保存場所と CMS との同期方法を指定します。                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'`: ローカルでのみ管理。<br/>• `'remote'`: リモート (CMS) でのみ管理。<br/>• `'hybrid'`: ローカルとリモートの両方で管理。<br/>• `'plugin'` またはカスタム文字列: プラグインやカスタムソースによって管理。                                                                                                                                                                                        |
-| `importMode`                | 辞書のインポート方法を制御します。                                                                                                            | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: 静的インポート。<br/>• `'dynamic'`: Suspense を介した動的インポート。<br/>• `'fetch'`: Live Sync API を介して取得。失敗した場合は `'dynamic'` にフォールバック。<br/>• `@intlayer/babel` および `@intlayer/swc` プラグインが必要。<br/>• キーは静的に宣言される必要があります。<br/>• `optimize` がオフの場合は無視されます。<br/>• `getIntlayer`、`getDictionary` などには影響しません。   |
-| `priority`                  | 辞書の優先順位。辞書間の競合を解決する際、高い値が低い値に優先されます。                                                                      | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `live`                      | 非推奨 - 代わりに `importMode: 'fetch'` を使用してください。辞書コンテンツを Live Sync API を介して動的に取得するかどうかを指定していました。 | `boolean`                                                                                                       | `undefined` |                                                                                             | v8.0.0 で `importMode: 'fetch'` に名前変更。                                                                                                                                                                                                                                                                                                                                                              |
-| `schema`                    | JSON スキーマ検証のために Intlayer によって自動生成されます。                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | 自動生成    |                                                                                             | 手動で編集しないでください。                                                                                                                                                                                                                                                                                                                                                                              |
-| `title`                     | エディタや CMS で辞書を識別するのに役立ちます。                                                                                               | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `tags`                      | 辞書をカテゴリ化し、エディタや AI にコンテキストや指示を提供します。                                                                          | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                           |
-| `version`                   | リモート辞書のバージョン。現在使用されているバージョンを追跡するのに役立ちます。                                                              | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • CMS で管理可能。<br/>• ローカルで編集しないでください。                                                                                                                                                                                                                                                                                                                                                 |
+| フィールド                  | 説明                                                                                                                                          | 型                                                                                                              | デフォルト   | 例                                                                                          | 備考                                                                                                                                                                                                                                                                                                                                                                                                      |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | 自動入力 (AI 翻訳) の出力ファイルがどのように生成されるかを制御します。                                                                       | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: デフォルトパス (ソースと同じファイル)。<br/>• `false`: 無効化。<br/>• 文字列/関数パターンは、ロケールごとのファイルを生成します。<br/>• ロケールごとのオブジェクト: 各ロケールが独自のパターンに対応します。`false` はそのロケールを無視します。<br/>• `{{locale}}` を含めると、ロケールごとの生成がトリガーされます。<br/>• 辞書レベルの `fill` は、常にこのグローバル設定よりも優先されます。 |
+| `description`               | エディタや CMS が辞書の目的を理解するのに役立ちます。AI による翻訳生成のコンテキストとしても使用されます。                                    | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `locale`                    | 辞書をロケールごとの形式に変換します。宣言された各フィールドが翻訳ノードになります。存在しない場合、辞書は多言語対応として扱われます。        | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | 辞書が複数の言語の翻訳を含むのではなく、特定のロケール専用である場合に使用します。                                                                                                                                                                                                                                                                                                                        |
+| `contentAutoTransformation` | コンテンツの文字列を型付きノード (markdown, HTML, または insertion) に自動変換します。                                                        | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`。<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`。<br/>• 挿入 (Insertion) : `Hello {{name}}` → `insert('Hello {{name}}')`。                                                                                                                                                                                                                    |
+| `location`                  | 辞書ファイルの保存場所と CMS との同期方法を指定します。                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: ローカルでのみ管理。<br/>• `'remote'`: リモート (CMS) でのみ管理。<br/>• `'hybrid'`: ローカルとリモートの両方で管理。<br/>• `'plugin'` またはカスタム文字列: プラグインやカスタムソースによって管理。                                                                                                                                                                                        |
+| `importMode`                | 辞書のインポート方法を制御します。                                                                                                            | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: 静的インポート。<br/>• `'dynamic'`: Suspense を介した動的インポート。<br/>• `'fetch'`: Live Sync API を介して取得。失敗した場合は `'dynamic'` にフォールバック。<br/>• `@intlayer/babel` および `@intlayer/swc` プラグインが必要。<br/>• キーは静的に宣言される必要があります。<br/>• `optimize` がオフの場合は無視されます。<br/>• `getIntlayer`、`getDictionary` などには影響しません。   |
+| `format`                    | プロジェクト内のすべての辞書のデフォルトのメッセージ形式。                                                                                    | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: ネイティブ intlayer 形式。<br/>• `'icu'`: ICU メッセージ形式。<br/>• `'i18next'`: i18next 形式。<br/>• `'vue-i18n'`: Vue I18n 形式。<br/>• `'po'`: GNU Gettext PO 形式。                                                                                                                                                                                                                  |
+| `priority`                  | 辞書の優先順位。辞書間の競合を解決する際、高い値が低い値に優先されます。                                                                      | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `live`                      | 非推奨 - 代わりに `importMode: 'fetch'` を使用してください。辞書コンテンツを Live Sync API を介して動的に取得するかどうかを指定していました。 | `boolean`                                                                                                       | `undefined`  |                                                                                             | v8.0.0 で `importMode: 'fetch'` に名前変更。                                                                                                                                                                                                                                                                                                                                                              |
+| `schema`                    | JSON スキーマ検証のために Intlayer によって自動生成されます。                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | 自動生成     |                                                                                             | 手動で編集しないでください。                                                                                                                                                                                                                                                                                                                                                                              |
+| `title`                     | エディタや CMS で辞書を識別するのに役立ちます。                                                                                               | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `tags`                      | 辞書をカテゴリ化し、エディタや AI にコンテキストや指示を提供します。                                                                          | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `version`                   | リモート辞書のバージョン。現在使用されているバージョンを追跡するのに役立ちます。                                                              | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • CMS で管理可能。<br/>• ローカルで編集しないでください。                                                                                                                                                                                                                                                                                                                                                 |
 
 **`fill` の例**: