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

package/docs/ja/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname 関数のドキュメント | vue-intlayer
+description: vue-intlayer パッケージの usePathname 関数の使用方法について
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - 国際化 (Internationalization)
+  - ドキュメント
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathnameユーティリティを追加"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "履歴を初期化"
+author: aymericzip
+---
+
+# Vue インテグレーション: `usePathname` ドキュメント
+
+`usePathname` 関数は、ロケールセグメントが削除された現在のブラウザのパス名 (pathname) を Vue の `ComputedRef<string>` として返します。これは、ロケールプレフィックスを手動で削除することなく、ロケールを認識するナビゲーションを構築する（たとえば、どのナビゲーションアイテムがアクティブであるかを決定する）ために便利です。
+
+## Vue での `usePathname` のインポート
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## 概要
+
+`usePathname` は、`window.location.pathname` を読み取り、`getPathWithoutLocale` を介してロケールプレフィックスを削除し、ブラウザが `popstate` イベント（戻る/進むナビゲーション）を発生させるたびにその値を更新する Vue の算出参照 (computed ref) を作成します。取得した値は、Vue テンプレートやセットアップ関数で直接使用できます。
+
+## 使用方法
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## 戻り値
+
+| タイプ                | 説明                                                                             |
+| --------------------- | -------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | ロケールプレフィックスのない現在のパス名 (pathname) を含む Vue の Computed Ref。 |
+
+## 動作
+
+- **ロケールの削除 (Locale stripping)**: 先頭のロケールセグメントを削除します（例: `/ja/dashboard` → `/dashboard`）。
+- **リアクティブ**: `popstate` イベント（ブラウザの戻る / 進む操作）が発生するたびに値を更新します。
+- **SSR セーフ**: `window` が利用できない場合は `""` を返します。
+- **クリーンアップ (Cleanup)**: `popstate` リスナーは初期化時にグローバルに追加され、Vue のライフサイクル管理のおかげで、通常はコンポーネントごとに手動でクリーンアップする必要はありません。
+
+## 例
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "ダッシュボード" },
+  { href: "/settings", label: "設定" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## 関連事項
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vue-intlayer/useLocale.md) — 現在のロケール + ロケールスイッチャー
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/intlayer/getPathWithoutLocale.md) — このフックで使用される基盤となるユーティリティ

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: Sync JSON プラグイン
 description: Intlayerの辞書をサードパーティのi18n JSONファイル（i18next、next-intl、react-intl、vue-i18nなど）と同期します。既存のi18nを維持しながら、Intlayerでメッセージの管理、翻訳、テストを行えます。
 keywords:
@@ -24,6 +24,9 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "splitKeys オプションを追加（next-intl / react-intl の単一ファイルレイアウト向けに、トップレベルの名前空間キーごとに1つの辞書）"
   - version: 7.5.0
     date: 2025-12-13
     changes: "ICUおよびi18next形式のサポートを追加"
@@ -62,7 +65,62 @@ pnpm add -D @intlayer/sync-json-plugin
 npm i -D @intlayer/sync-json-plugin
 ```
 
-## クイックスタート
+## Plugins
+
+このパッケージは2つのプラグインを提供します：
+
+- `loadJSON`: JSONファイルをIntlayer辞書にロードします。
+  - このプラグインは、ソースからJSONファイルをロードし、Intlayer辞書にロードするために使用されます。コードベース全体をスキャンし、特定のJSONファイルを検索できます。
+    このプラグインは以下の場合に使用できます。
+    - JSONのロードに特定の場所を課すi18nライブラリ（例：`next-intl`、`i18next`、`react-intl`、`vue-i18n`など）を使用しているが、コンテンツ宣言をコードベースの好きな場所に配置したい場合。
+    - リモートソース（例：CMS、APIなど）からメッセージをフェッチし、JSONファイルにメッセージを保存したい場合。
+
+  > 内部的には、このプラグインはコードベース全体をスキャンし、特定のJSONファイルを検索してIntlayer辞書にロードします。
+  > このプラグインは出力と翻訳をJSONファイルに書き戻さないことに注意してください。
+
+- `syncJSON`: JSONファイルをIntlayer辞書と同期します。
+  - このプラグインは、JSONファイルをIntlayer辞書と同期するために使用されます。指定された場所をスキャンし、特定のJSONファイルのパターンに一致するJSONをロードできます。このプラグインは、別のi18nライブラリを使用しながらIntlayerの利点を得たい場合に便利です。
+
+## 両方のプラグインを使用する
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // 現在のJSONファイルをIntlayerの辞書と同期させる
+  plugins: [
+    /**
+     * src内のパターン {key}.i18n json に一致するすべてのJSONファイルをロードします
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // これらのJSONファイルが `./locales/en/${key}.json` のファイルよりも優先されるようにします
+      format: "intlayer", // JSONコンテンツのフォーマット
+    }),
+    /**
+     * ロケールディレクトリ内のJSONファイルに、出力と翻訳をロードして書き戻します
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncJSON` plugin
+
+### クイックスタート
 
 `intlayer.config.ts`にプラグインを追加し、既存のJSON構造を指定します。
 
@@ -81,6 +139,7 @@ const config: IntlayerConfig = {
     syncJSON({
       // ロケールごと、名前空間ごとのレイアウト（例：next-intl、名前空間付きのi18next）
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      format: "icu",
     }),
   ],
 };
@@ -91,14 +150,27 @@ export default config;
 代替案：ロケールごとに単一ファイル（i18next/react-intlのセットアップで一般的）：
 
 ```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "i18next",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
 ```
 
-### 動作の仕組み
+#### 動作の仕組み
 
 - 読み込み：プラグインは`source`ビルダーからJSONファイルを検出し、それらをIntlayerの辞書として読み込みます。
 - 書き込み：ビルドと補完の後、ローカライズされたJSONを同じパスに書き戻します（フォーマットの問題を避けるために末尾に改行を追加）。
@@ -112,6 +184,7 @@ syncJSON({
   location?: string, // オプションのラベル、デフォルト: "plugin"
   priority?: number, // コンフリクト解決のためのオプションの優先度、デフォルト: 0
   format?: 'intlayer' | 'icu' | 'i18next', // オプションのフォーマッター、Intlayerランタイム互換性のために使用
+  splitKeys?: boolean, // オプション、単一ファイルをトップレベルキーごとに1つの辞書に分割（自動検出）
 });
 ```
 
@@ -136,11 +209,43 @@ syncJSON({
 }),
 ```
 
-## 複数の JSON ソースと優先度
+#### `splitKeys` (boolean)
+
+**ファーストレベルのキーが名前空間である**単一のJSONファイルを、ファイル全体を保持する単一の辞書ではなく、トップレベルキーごとに1つの辞書にするかどうかを制御します。
+
+これは、`next-intl`や`react-intl`のようなライブラリの名前空間モデルと一致します。これらのライブラリでは、1つの`messages/{locale}.json`ファイルが、そのファーストレベルのキーによって複数の名前空間をグループ化し、それぞれが独立してアドレス指定されます（例：`useTranslations('Hero')`は`Hero`辞書に解決されます）。
+
+- `undefined` (デフォルト): **自動検出** — `source`パターンに`{key}`セグメントがない場合（1つのファイルがすべての名前空間を保持する場合）にファイルが分割され、それ以外の場合（キーごとに1つのファイル）は単一の辞書として保持されます。
+- `true`: 常に各トップレベルキーを独自の辞書に分割します。
+- `false`: 分割しません。ファイル全体が単一の辞書になります。
+
+単一の`messages/{locale}.json`ファイルが与えられた場合：
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // パターンに`{key}`セグメントがないため、暗黙的に有効
+}),
+```
+
+これにより、`Hero`、`Nav`、`About`の3つの辞書が生成され、`useTranslations('Hero')` (next-intl) が正しく解決されます。書き戻し時には、すべての名前空間が同じロケールごとのファイルに再結合されます。
+
+> `source`に明示的な`{key}`セグメントを保持している場合（例：`./locales/${locale}/${key}.json`）、各ファイルはすでに1つの名前空間であるため、分割はデフォルトで無効になります。
+
+### 複数の JSON ソースと優先度
 
 複数の `syncJSON` プラグインを追加して異なる JSON ソースを同期することができます。これは、複数の i18n ライブラリや異なる JSON 構造をプロジェクトで使用している場合に便利です。
 
-### 優先度システム
+#### 優先度システム
 
 複数のプラグインが同じ辞書キーを対象とする場合、`priority` パラメータがどのプラグインが優先されるかを決定します:
 
@@ -189,73 +294,140 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### コンフリクト解決
+## Load JSON plugin
 
-同じ翻訳キーが複数のJSONソースに存在する場合：
+### クイックスタート
 
-1. 最も優先度の高いプラグインが最終的な値を決定します
-2. 優先度の低いソースは、欠落しているキーのフォールバックとして使用されます
-3. これにより、レガシー翻訳を維持しつつ、新しい構造へ段階的に移行できます
+`intlayer.config.ts`にプラグインを追加して、既存のJSONファイルをIntlayer辞書として取り込みます。このプラグインは読み取り専用です（ディスクへの書き込みは行いません）：
 
-## 統合
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-以下は一般的なマッピング例です。ランタイムは変更せず、プラグインのみを追加してください。
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
 
-### i18next
+  plugins: [
+    // ソースツリー内のどこにでも配置されたJSONメッセージを取り込む
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      // プラグインインスタンスごとに単一のロケールをロード（設定のdefaultLocaleにデフォルト設定）
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
 
-典型的なファイル構成: `./public/locales/{locale}/{namespace}.json` または `./locales/{locale}/{namespace}.json`。
+export default config;
+```
+
+代替案：ロケールごとのレイアウト、読み取り専用（選択されたロケールのみがロードされます）：
 
 ```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-export default {
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
   plugins: [
-    syncJSON({
-      format: "i18next",
+    loadJSON({
+      // このパターンからはLocales.FRENCHのファイルのみがロードされます
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      locale: Locales.FRENCH,
     }),
   ],
 };
+
+export default config;
 ```
 
-### next-intl
+### 動作の仕組み
 
-ロケールごとのJSONメッセージ（多くの場合 `./messages/{locale}.json`）または名前空間ごと。
+- 検出：`source`ビルダーからグロブを構築し、一致するJSONファイルを収集します。
+- 取り込み：各JSONファイルを提供された`locale`を持つIntlayer辞書としてロードします。
+- 読み取り専用：出力ファイルの書き込みやフォーマットは行いません。ラウンドトリップ同期が必要な場合は`syncJSON`を使用してください。
+- 自動補完対応：`fill`パターンを定義し、`intlayer content fill`がCLI経由で不足しているキーを埋めることができます。
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
+### API
+
+```ts
+loadJSON({
+  // JSONへのパスを構築します。構造にロケールセグメントがない場合、`locale`はオプションです
+  source: ({ key, locale }) => string,
+
+  // このプラグインインスタンスによってロードされる辞書のターゲットロケール
+  // デフォルトは configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // ソースを識別するためのオプションのラベル
+  location?: string, // デフォルト: "plugin"
+
+  // 他のソースとのコンフリクト解決に使用される優先度
+  priority?: number, // デフォルト: 0
+
+  // JSONコンテンツのオプションのフォーマッター
+  format?: 'intlayer' | 'icu' | 'i18next', // デフォルト: 'intlayer'
+
+  // 単一ファイルをトップレベルキーごとに1つの辞書に分割（自動検出）
+  splitKeys?: boolean,
+});
 ```
 
-参照: `docs/ja/intlayer_with_next-intl.md`。
+#### `format` ('intlayer' | 'icu' | 'i18next')
 
-### react-intl
+JSONファイルをロードする際に辞書コンテンツに使用するフォーマッターを指定します。これにより、さまざまなi18nライブラリと互換性のある異なるメッセージフォーマット構文を使用できます。
 
-ロケールごとに単一のJSONが一般的:
+- `'intlayer'`: デフォルトのIntlayerフォーマッター（デフォルト）。
+- `'icu'`: ICUメッセージフォーマットを使用します（react-intl、vue-i18nなどのライブラリと互換性があります）。
+- `'i18next'`: i18nextメッセージフォーマットを使用します（i18next、next-i18next、Solid-i18nextと互換性があります）。
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+**例：**
+
+```ts
+loadJSON({
+  source: ({ key }) => `./src/**/${key}.i18n.json`,
+  locale: Locales.ENGLISH,
+  format: "icu", // 互換性のためにICUフォーマットを使用
+}),
 ```
 
-### vue-i18n
+#### `splitKeys` (boolean)
 
-ロケールごと、またはネームスペースごとに単一ファイルを使用する場合：
+[`syncJSON`](#splitkeys-boolean) と同じ動作です。単一のJSONファイルがファーストレベルのキーによって複数の名前空間をグループ化する場合、各トップレベルキーが独自の辞書になります。
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
-  }),
-];
+- `undefined` (デフォルト): **自動検出** — `source`パターンに`{key}`セグメントがない場合に分割され、それ以外の場合は単一の辞書になります。
+- `true` / `false`: 分割を強制または無効にします。
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`、`Nav`、`About`などがそれぞれ辞書になります
+}),
 ```
 
+### Behavior and conventions
+
+- `source`マスクにロケールプレースホルダーが含まれている場合、選択された`locale`のファイルのみが取り込まれます。
+- マスクに`{key}`セグメントがない場合、ファイルの各トップレベルキーがデフォルトで独自の辞書になります（[`splitKeys`](#splitkeys-boolean)を参照）。代わりにファイル全体を単一の`index`辞書として読み込むには、`splitKeys: false`を設定します。
+- キーは、`source`ビルダーの`{key}`プレースホルダーを置換することでファイルパスから派生します。
+- プラグインは検出されたファイルのみを使用し、不足しているロケールやキーを捏造することはありません。
+- `fill`パスは`source`から推測され、CLI経由で不足している値を更新するために使用されます（オプトインした場合）。
+
+## Conflict resolution
+
+同じ翻訳キーが複数のJSONソースに存在する場合：
+
+1. 最も優先度の高いプラグインが最終的な値を決定します
+2. 優先度の低いソースは、欠落しているキーのフォールバックとして使用されます
+3. これにより、レガシー翻訳を維持しつつ、新しい構造へ段階的に移行できます
+
 ## CLI
 
 同期されたJSONファイルは他の `.content` ファイルとして扱われます。つまり、すべてのintlayerコマンドが同期されたJSONファイルに対して利用可能です。以下を含みます：
@@ -268,7 +440,7 @@ plugins: [
 
 See [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/index.md) for more details.
 
-## 制限事項（現状）
+## Limitations (current)
 
 - サードパーティライブラリを対象とする場合、挿入や複数形/ICUのサポートはありません。
 - 非Intlayerランタイム向けのビジュアルエディタはまだ利用できません。

package/docs/ja/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v6 へようこそ！このリリースはパフォーマンス、開発者体験、信頼性に重点を置いています。以下にハイライト、移行ノート、コピー＆ペースト可能な例を示します。
 
+## 目次
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## ハイライト
 
 - 新しいコマンド：`npx intlayer content test` で翻訳の欠落を検出
@@ -294,6 +298,24 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Turbopackでファイルを監視するための並列プロセス
+
+`next dev --turbopack`コマンドを使用してNext.js 14以上でTurbopackを開発サーバーとして使用する場合、辞書の変更はデフォルトでは自動的に検出されません。
+
+この制限は、Turbopackがコンテンツファイルの変更を監視するためにwebpackプラグインを並列で実行できないために発生します。
+
+これを回避するために、`intlayer watch`コマンドに`--with`オプションを使用して、開発サーバーとIntlayerビルドウォッチャーを同時に実行するようにしました。
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## マイグレーションノート
 
 - 削除された項目: `dictionaryOutput`（以前は `i18next` または `next-intl`）。これは将来のバージョンでプラグイン可能なアダプターとして復活します。設定からこのフィールドを削除してください。
@@ -312,6 +334,12 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## v6 から v7 への移行ノート
+
+詳細については、[v6 から v7 への移行ノート](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/releases/v7.md)を確認してください。
+
+---
+
 ## 便利なリンク
 
 - [CLIリファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/index.md)

package/docs/ja/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v7 へようこそ！このメジャーリリースでは、パフォーマンス、型安全性、開発者体験において大幅な改善を導入しました。以下にハイライト、移行ノート、実用的な例を示します。
 
+## 目次
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## ハイライト
 
 - より高速なビルドのためのキャッシュ戦略
@@ -261,6 +265,126 @@ setLocale("en");
 
 ---
 
+## 自動コードフォーマット: formatCommand 設定
+
+v7 では、エディタ設定に `formatCommand` オプションが導入されました。これにより、Intlayer によってコンテンツファイルが書き込まれるときに、自動的にコンテンツをフォーマットできます。これにより、コンテンツ宣言ファイル全体で一貫したコードスタイルとフォーマットが保証されます。
+
+設定されていない場合、Intlayer は自動的にフォーマットコマンドを検出しようとします。次のコマンドの解決を試みます: prettier、biome、eslint。
+
+### 設定
+
+`formatCommand` オプションは、`{{file}}` が実際のファイルパスに置き換わる文字列テンプレートを受け入れます:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### サポートされているフォーマッター
+
+ファイルパスを引数として受け入れる任意のコードフォーマッターを使用できます:
+
+**Biomeを使用:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Prettierを使用:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**ESLintを使用:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Bunの組み込みフォーマッターを使用:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### メリット
+
+- **一貫性のあるフォーマット**: すべてのコンテンツファイルは、プロジェクトのスタイルガイドラインに従って自動的にフォーマットされます
+- **開発者体験**: Intlayerがファイルを作成した後、手動でフォーマットする必要がありません
+- **チーム間の一貫性**: すべてのチームメンバーが同じフォーマットをコンテンツファイルに適用していることを保証します
+- **CI/CD統合**: コンテンツファイルは自動化されたワークフローで一貫性のあるフォーマットを維持します
+
+### 仕組み
+
+Intlayer がコンテンツ宣言ファイル（`.content.ts`、`.content.js` など）を書き込みまたは更新する場合、指定された format コマンドをファイルに対して自動的に実行します。`{{file}}` プレースホルダーは実際のファイル パスに置き換えられ、コマンドはプロジェクトのベース ディレクトリで実行されます。
+
+---
+
+## 辞書設定: より良い組織化と構造
+
+v7では、辞書関連の設定をより良く組織化し、コンテンツ管理を改善する新しい専用の`dictionary`設定セクションが導入されています。
+
+### 新しい dictionary 設定構造
+
+`fill` プロパティが `content` セクションから新しい `dictionary` セクションに移動され、より明確な関心の分離を提供します:
+
+**v6 設定:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**v7 設定:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### 新しい構造のメリット
+
+- **より明確な組織**: 辞書固有の設定がまとめられています
+- **関心の分離の向上**: コンテンツディスカバリーと辞書操作が明確に分離されています
+- **保守性の向上**: 辞書関連の設定を理解および変更しやすくなっています
+- **将来の拡張性**: 辞書セクションは追加の辞書固有の設定に対応できます
+- **包括的な辞書管理**: 新しい辞書を作成および管理するための `title`、`live`、`priority`、`tags`、`version`、`description` などのプロパティが含まれています
+
+### 設定の使用方法
+
+辞書設定には、2つの主な目的があります：
+
+1. **デフォルト値**: コンテンツ宣言ファイルを作成する際のデフォルト値を定義します
+2. **フォールバック動作**: 特定のフィールドが定義されていない場合にフォールバック値を提供し、辞書の動作をグローバルに定義できます
+
+辞書セクションには、辞書管理のための包括的なプロパティが含まれています：
+
+- **`fill`**: コンテンツ生成の自動入力動作
+- **`title`**: 新しい辞書のデフォルトタイトル
+- **`live`**: リアルタイム更新のためのライブ同期設定
+- **`priority`**: 辞書解決の優先度設定
+- **`tags`**: コンテンツ整理のためのデフォルトタグ
+- **`version`**: 辞書更新のバージョン管理
+- **`description`**: 新しいコンテンツのデフォルト説明
+
+コンテンツ宣言ファイルおよび設定値がどのように適用されるかについての詳細は、[コンテンツファイルドキュメンテーション](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)を参照してください。
+
+---
+
 ## fillコマンド: より良いコンテンツ管理のための動作更新
 
 v7では、`fill`コマンドの動作が改善され、より予測可能で柔軟なコンテンツ管理が可能になりました：
@@ -408,6 +532,10 @@ const content = {
 - **`middleware.prefixDefault`**：`routing.mode`に置き換え
 - **`middleware.noPrefix`**：`routing.mode`に置き換え
 
+### 新しい設定
+
+- **`editor.formatCommand`**: コンテンツファイルの自動コードフォーマットのための新しいオプション
+
 ### 移行マッピング
 
 #### 設定マッピング