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

package/docs/ja/releases/v9.md

@@ -0,0 +1,232 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-14
+title: Intlayer v9の新機能
+description: Intlayer v9の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアント、動的レコードのサポートを導入します。
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - Dynamic Records
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# Intlayer v9の新機能
+
+Intlayer v9へようこそ！このメジャーリリースは、主要なi18nライブラリ（`react-i18next`、`next-intl`、`vue-i18n`など）向けの**互換アダプターパッケージ**により、Intlayerへの移行パスを簡素化し、**コレクション**、**バリアント**、**動的レコード**といったリッチなコンテンツ構造のサポートを追加することで、大きな節目となります。
+
+## 目次
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## 互換アダプターパッケージ
+
+人気のi18nライブラリからIntlayerへの移行がこれまで以上に簡単になりました。標準のi18nライブラリと**まったく同じ公開API**を公開しつつ、すべての翻訳作業をIntlayerにランタイムで委譲する5つの互換パッケージを作成しました。
+
+### 厳密な型付けで同じ公開APIを公開
+
+インポートを置き換えるだけで、最小限のコード変更でIntlayerのすべての利点（実際の辞書に対するコンパイル時の型安全性を含む）を得ることができます。
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+
+例えば、次のように変更するだけです。
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+を次のように変更します。
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+これにより、キーはIntlayer辞書に対して**厳密に型付け**され、IDEで完全なドットパスのオートコンプリートが提供されます！
+
+### バンドラーエイリアスプラグイン (Vite, Next.js, Turbopack)
+
+すべてのインポートステートメントを手動で書き換えることなく移行できるように、各互換アダプターパッケージには、`/plugin`サブパスの下に**カスタムバンドラープラグイン**（ViteまたはNext.js）が含まれています。
+
+これらのプラグインは、ビルド時に既存のインポート（例：`react-i18next`や`next-intl`）を自動的に`@intlayer/*`の同等物に書き換えます。
+
+#### Next.js (Webpack / Turbopack) の例
+
+`withIntlayer`の代わりに、互換プラグインでNext.jsの設定をラップします。
+
+```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);
+```
+
+#### Vite (React, Vue, Solid, Svelte) の例
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## 共通化されたランタイムリゾルバー
+
+すべての互換アダプターは、単一の高度に最適化されたランタイムパーサーである`@intlayer/core/messageFormat`を介して翻訳解決をルーティングするようになりました。
+
+- **メッセージ補間**: 標準の`{{var}}`（空白とドットパス）、ICU形式の引数（`{v, number, percent}`など）、および裸の`{var}`テンプレートを解決します。
+- **メッセージノードリゾルバー**: ネストされたノードを解決します：`insert()`、`plural()`（CLDR複数形ルール）、`enu()`（列挙）、`gender()`、HTMLタグ、配列、および呼び出し可能な関数ノード。
+- **トークン化されたタグパーサー**: インラインXML/HTMLタグと番号付きタグ（例：`<1>children</1>`)をサポートし、リッチテキストレンダリングをすぐに利用できるようにします。
+
+---
+
+## 機能仕様：コレクション、バリアント、動的レコード
+
+Intlayer v9は、静的なキーと値のオブジェクトを超えて拡張され、辞書がエンドツーエンドで完全に型付けされた動的なレイアウト構造を宣言できるようになりました。
+
+### 1. コレクション
+
+CMSで管理される順序付きアイテムのリスト（例：FAQ、製品、ブログリスト）を定義します。
+
+```ts fileName="faq.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  content: [
+    {
+      question: t({
+        ja: "Intlayerとは何ですか？",
+        en: "What is Intlayer?",
+        fr: "Qu'est-ce qu'Intlayer ?",
+      }),
+      answer: t({
+        ja: "i18nツールキットです。",
+        en: "An i18n toolkit.",
+        fr: "Une boîte àツール i18n.",
+      }),
+    },
+  ],
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+// Fetch all items
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Fetch single item by index
+const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+```
+
+### 2. バリアント
+
+A/Bテスト、季節限定ヘッダー、機能フラグ、またはカスタムランディングページを提供します。
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ ja: "ようこそ", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      ja: "今すぐ購入",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+### 3. 動的レコード
+
+クエリIDを介してランタイムで動的にエントリがロードされる辞書を定義します。
+
+```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({ ja: "クリーンコード", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### 使用法：
+
+```ts
+// Fetches only the requested item dynamically (requires Suspense)
+const product = useIntlayer("product-copy", {
+  id: "prod_123",
+  category: "books",
+});
+```
+
+---
+
+## 動的ロードとバンドルサイズの最適化
+
+バンドルを極めて小さく保つため、Intlayer v9は動的な遅延ロードをサポートしています。
+
+設定で、`importMode`を`'dynamic'`または`'fetch'`に設定します。
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+ビルド時、`@intlayer/swc`と`@intlayer/babel`はファイルをスキャンし、`useIntlayer` / `getIntlayer`の呼び出しをツリーシェイク可能なラッパー（`useDictionary` / `useDictionaryDynamic`）に置き換えます。選択されたコレクションアイテム、バリアント、またはロケールに必要なコンテンツのみがロードされ、本番バンドルに未使用の翻訳が含まれるのを防ぎます。
+
+---
+
+## v8からの移行に関する注意点
+
+v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。
+
+- **ロケールと方言**: 外部i18n依存関係を使用している場合、設定またはバンドラーセットアップにそれぞれの互換アダプタープラグインを追加して、インポートを自動的に書き換えるようにします。
+- **カスタムセレクター**: `useIntlayer`を呼び出す際、2番目のパラメーターは`{ locale, item, variant, id }`を含むオプションオブジェクトのために予約されるようになりました。以前にロケール文字列を直接渡していた場合でも引き続き可能ですが、高度な選択にはオプションオブジェクトの使用が推奨されます。
+
+---
+
+## 役立つリンク
+
+- [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
+- [動的辞書 - コレクション、バリアント、動的レコード](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)

package/docs/ko/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...]`**: 검토할 문서 파일과 일치하는 Glob 패턴입니다.
 
-전체 인수 목록은 [문서 번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-translate.md) 명령어 문서를 참조하세요.
+  > 예시: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: 검토에서 제외할 Glob 패턴입니다.
+
+  > 예시: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: 지정된 시간 이전에 수정된 파일은 건너뜁니다.
+  - "2025-12-05"와 같은 절대 시간 (문자열 또는 Date)일 수 있습니다.
+  - `1 * 60 * 60 * 1000` (1시간)과 같은 상대 시간(ms)일 수 있습니다.
+  - 이 옵션은 `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시간)과 같은 상대 시간(ms)일 수 있습니다.
+  - 이 옵션은 `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/ko/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/ko/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/ko/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";
 
 /**
@@ -582,10 +586,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * 사전 구성.
+   */
+  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: [],
+  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`                      | DEPRECATED - `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`                      | DEPRECATED - `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` 예시**: