@intlayer/docs 8.4.4 → 8.4.6

package/docs/ko/configuration.md

@@ -1,12 +1,12 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-12
-title: 구성
-description: 애플리케이션에 맞게 Intlayer를 구성하는 방법을 배우세요. Intlayer를 사용자 요구에 맞게 맞춤 설정할 수 있는 다양한 설정과 옵션을 이해하세요.
+updatedAt: 2026-03-20
+title: 설정 (Configuration)
+description: 애플리케이션에 Intlayer를 설정하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤 설정할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
-  - 구성
   - 설정
-  - 맞춤화
+  - 세팅
+  - 커스터마이징
   - Intlayer
   - 옵션
 slugs:
@@ -14,61 +14,88 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.4.0
+    date: 2026-03-20
+    changes: 'compiler.output' 및 'dictionary.fill'에 대한 로케일별 객체 표기법 추가
   - version: 8.3.0
     date: 2026-03-11
-    changes: "'baseDir'을 'content' 구성에서 'system' 구성으로 이동"
+    changes: 'baseDir'을 'content' 설정에서 'system' 설정으로 이동
   - version: 8.2.0
-    date: 2026-03-10
+    date: 2026-03-09
     changes: 컴파일러 옵션 업데이트, 'output' 및 'noMetadata' 지원 추가
   - version: 8.1.7
     date: 2026-02-25
     changes: 컴파일러 옵션 업데이트
+  - version: 8.1.5
+    date: 2026-02-23
+    changes: 컴파일러 옵션 'build-only' 및 딕셔너리 접두사 추가
   - version: 8.0.6
     date: 2026-02-12
-    changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, Together.ai 제공업체 지원 추가
+    changes: Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face 및 Together.ai 제공업체 지원 추가
   - version: 8.0.5
     date: 2026-02-06
-    changes: AI 구성에 `dataSerialization` 추가
+    changes: AI 설정에 `dataSerialization` 추가
+  - version: 8.0.0
+    date: 2026-01-24
+    changes: 기본 메커니즘을 더 잘 설명하기 위해 가져오기 모드 `live`를 `fetch`로 변경.
+  - version: 8.0.0
+    date: 2026-01-22
+    changes: 빌드 설정 `importMode`를 `dictionary` 설정으로 이동.
   - version: 8.0.0
     date: 2026-01-22
-    changes: importMode 빌드 구성을 사전 구성으로 이동.
+    changes: 라우팅 설정에 `rewrite` 옵션 추가
   - version: 8.0.0
     date: 2026-01-18
-    changes: 시스템 구성에서 콘텐츠 구성을 분리합니다. 내부 경로를 `system` 속성으로 이동합니다. 콘텐츠 파일과 코드 변환을 분리하기 위해 `codeDir`를 추가합니다.
+    changes: 시스템 설정을 콘텐츠 설정에서 분리. 내부 경로를 `system` 속성으로 이동. 콘텐츠 파일과 코드 변환을 분리하기 위해 `codeDir` 추가.
   - version: 8.0.0
     date: 2026-01-18
-    changes: 사전 옵션 `location` 및 `schema` 추가
+    changes: 딕셔너리 옵션 `location` 및 `schema` 추가
   - version: 7.5.1
     date: 2026-01-10
     changes: JSON5 및 JSONC 파일 형식 지원 추가
   - version: 7.5.0
     date: 2025-12-17
-    changes: "`buildMode` 옵션 추가"
+    changes: `buildMode` 옵션 추가
+  - version: 7.0.0
+    date: 2025-10-25
+    changes: `dictionary` 설정 추가
+  - version: 7.0.0
+    date: 2025-10-21
+    changes: `middleware`를 라우팅 설정 `routing`으로 대체
+  - version: 7.0.0
+    date: 2025-10-12
+    changes: `formatCommand` 옵션 추가
+  - version: 6.2.0
+    date: 2025-10-12
+    changes: `excludedPath` 옵션 업데이트
+  - version: 6.0.2
+    date: 2025-09-23
+    changes: `outputFormat` 옵션 추가
   - version: 6.0.0
-    date: 2025-09-16
-    changes: "`live` 가져오기 모드 추가"
+    date: 2025-09-21
+    changes: `dictionaryOutput` 필드 및 `i18nextResourcesDir` 필드 삭제
   - version: 6.0.0
     date: 2025-09-16
-    changes: "`live` import 모드 추가"
+    changes: `live` 가져오기 모드 추가
   - version: 6.0.0
     date: 2025-09-04
-    changes: "`hotReload` 필드를 `liveSync`로 교체하고 `liveSyncPort` 및 `liveSyncURL` 필드 추가"
+    changes: `hotReload` 필드를 `liveSync`로 대체하고 `liveSyncPort` 및 `liveSyncURL` 필드 추가
   - version: 5.6.1
     date: 2025-07-25
-    changes: "`activateDynamicImport`을 `importMode` 옵션으로 교체"
+    changes: `activateDynamicImport`를 `importMode` 옵션으로 대체
   - version: 5.6.0
     date: 2025-07-13
-    changes: 기본 contentDir를 `['src']`에서 `['.']`로 변경
+    changes: 기본 contentDir을 `['src']`에서 `['.']`로 변경
   - version: 5.5.11
     date: 2025-06-29
-    changes: "`docs` 명령어 추가"
+    changes: `docs` 명령 추가
 ---
 
-# Intlayer 구성 문서
+# Intlayer 설정 문서
 
 ## 개요
 
-Intlayer 구성 파일은 국제화, 미들웨어, 콘텐츠 처리 등 플러그인의 다양한 측면을 사용자 정의할 수 있게 합니다. 이 문서는 구성 내 각 속성에 대한 자세한 설명을 제공합니다.
+Intlayer 설정 파일을 사용하면 국제화 (internationalization), 미들웨어, 콘텐츠 처리 등 플러그인의 다양한 측면을 맞춤 설정할 수 있습니다. 이 문서는 설정의 각 속성에 대한 심층적인 설명을 제공합니다.
 
 ---
 
@@ -78,9 +105,9 @@ Intlayer 구성 파일은 국제화, 미들웨어, 콘텐츠 처리 등 플러
 
 ---
 
-## 구성 파일 지원
+## 지원되는 설정 파일 형식
 
-Intlayer는 JSON, JS, MJS, TS 구성 파일 형식을 지원합니다:
+Intlayer는 JSON, JS, MJS, TS를 포함한 설정 파일 형식을 허용합니다.
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -93,7 +120,7 @@ Intlayer는 JSON, JS, MJS, TS 구성 파일 형식을 지원합니다:
 
 ---
 
-## 예제 구성 파일
+## 설정 파일 예시
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -101,108 +128,108 @@ import { nextjsRewrite } from "intlayer/routing";
 import { z } from "zod";
 
 /**
- * Example Intlayer configuration file showing all available options.
+ * 사용 가능한 모든 옵션을 보여주는 Intlayer 설정 파일 예시.
  */
 const config: IntlayerConfig = {
   /**
-   * Configuration for internationalization settings.
+   * 국제화 설정 구성.
    */
   internationalization: {
     /**
-     * List of supported locales in the application.
-     * Default: [Locales.ENGLISH]
+     * 애플리케이션에서 지원되는 로케일 (locales) 목록.
+     * 기본값: [Locales.ENGLISH]
      */
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
 
     /**
-     * List of required locales that must be defined in every dictionary.
-     * If empty, all locales are required in `strict` mode.
-     * Default: []
+     * 각 딕셔너리에 정의되어야 하는 필수 로케일 목록.
+     * 비어 있는 경우, `strict` 모드에서 모든 로케일이 필수입니다.
+     * 기본값: []
      */
     requiredLocales: [Locales.ENGLISH],
 
     /**
-     * Strictness level for internationalized content.
-     * - "strict": Errors if any declared locale is missing or undeclared.
-     * - "inclusive": Warnings if a declared locale is missing.
-     * - "loose": Accepts any existing locale.
-     * Default: "inclusive"
+     * 국제화된 콘텐츠의 엄격도 수준.
+     * - "strict": 선언된 로케일이 누락되었거나 선언되지 않은 경우 오류.
+     * - "inclusive": 선언된 로케일이 누락된 경우 경고.
+     * - "loose": 기존의 모든 로케일을 수용.
+     * 기본값: "inclusive"
      */
     strictMode: "inclusive",
 
     /**
-     * Default locale used as a fallback if the requested locale is not found.
-     * Default: Locales.ENGLISH
+     * 요청된 로케일을 찾을 수 없을 때 폴백(fallback)으로 요청되는 기본 로케일.
+     * 기본값: Locales.ENGLISH
      */
     defaultLocale: Locales.ENGLISH,
   },
 
   /**
-   * Settings that control dictionary operations and fallback behavior.
+   * 딕셔너리 작업 및 폴백 동작을 제어하는 설정.
    */
   dictionary: {
     /**
-     * Controls how dictionaries are imported.
-     * - "static": Statically imported at build time.
-     * - "dynamic": Dynamically imported using Suspense.
-     * - "fetch": Fetched dynamically via the live sync API.
-     * Default: "static"
+     * 딕셔너리를 가져오는 방법을 제어합니다.
+     * - "static": 빌드 시 정적으로 가져옵니다.
+     * - "dynamic": Suspense를 사용하여 동적으로 가져옵니다.
+     * - "fetch": Live Sync API를 통해 동적으로 가져옵니다.
+     * 기본값: "static"
      */
     importMode: "static",
 
     /**
-     * Strategy for auto-filling missing translations using AI.
-     * Can be a boolean or a path pattern to store filled content.
-     * Default: true
+     * AI를 사용하여 누락된 번역을 자동으로 채우는 전략.
+     * 불리언 값 또는 채워진 콘텐츠를 저장할 경로 패턴일 수 있습니다.
+     * 기본값: true
      */
     fill: true,
 
     /**
-     * Physical location of the dictionary files.
-     * - "local": Stored in the local filesystem.
-     * - "remote": Stored in the Intlayer CMS.
-     * - "hybrid": Stored in the local filesystem and the Intlayer CMS.
-     * - "plugin" (or any custom string): Provided by a plugin or a custom source.
-     * Default: "local"
+     * 딕셔너리 파일의 물리적 위치.
+     * - "local": 로컬 파일 시스템에 저장.
+     * - "remote": Intlayer CMS에 저장.
+     * - "hybrid": 로컬과 Intlayer CMS 모두에 저장.
+     * - "plugin" (또는 모든 사용자 정의 문자열): 플러그인 또는 사용자 정의 소스에 의해 제공.
+     * 기본값: "local"
      */
     location: "local",
 
     /**
-     * Whether to automatically transform content (e.g., Markdown to HTML).
-     * Default: false
+     * 콘텐츠를 자동으로 변환할지 여부 (예: Markdown을 HTML로).
+     * 기본값: false
      */
     contentAutoTransformation: false,
   },
 
   /**
-   * Routing and middleware configuration.
+   * 라우팅 및 미들웨어 설정.
    */
   routing: {
     /**
-     * Locale routing strategy.
-     * - "prefix-no-default": Prefix all except the default locale (e.g., /dashboard, /fr/dashboard).
-     * - "prefix-all": Prefix all locales (e.g., /en/dashboard, /fr/dashboard).
-     * - "no-prefix": No locale in the URL.
-     * - "search-params": Use ?locale=...
-     * Default: "prefix-no-default"
+     * 로케일 라우팅 전략.
+     * - "prefix-no-default": 기본 로케일을 제외한 모든 로케일에 접두사를 붙입니다 (예: /dashboard, /fr/dashboard).
+     * - "prefix-all": 모든 로케일에 접두사를 붙입니다 (예: /en/dashboard, /fr/dashboard).
+     * - "no-prefix": URL에 로케일이 없습니다.
+     * - "search-params": ?locale=... 사용.
+     * 기본값: "prefix-no-default"
      */
     mode: "prefix-no-default",
 
     /**
-     * Where to store the user's selected locale.
-     * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
-     * Default: ['cookie', 'header']
+     * 사용자가 선택한 로케일을 저장할 위치.
+     * 옵션: 'cookie', 'localStorage', 'sessionStorage', 'header' 또는 이들의 배열.
+     * 기본값: ['cookie', 'header']
      */
     storage: ["cookie", "header"],
 
     /**
-     * Base path for the application URLs.
-     * Default: ""
+     * 애플리케이션 URL의 기본 경로.
+     * 기본값: ""
      */
     basePath: "",
 
     /**
-     * Custom URL rewriting rules for locale-specific paths.
+     * 로케일별 특정 경로에 대한 사용자 정의 URL 리라이트(rewrite) 규칙.
      */
     rewrite: nextjsRewrite({
       "/[locale]/about": {
@@ -213,130 +240,130 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Settings for finding and processing content files.
+   * 콘텐츠 파일 찾기 및 처리와 관련된 설정.
    */
   content: {
     /**
-     * File extensions to scan for dictionaries.
-     * Default: ['.content.ts', '.content.js', '.content.json', etc.]
+     * 딕셔너리를 스캔하기 위한 파일 확장자.
+     * 기본값: ['.content.ts', '.content.js', '.content.json' 등]
      */
     fileExtensions: [".content.ts", ".content.js", ".content.json"],
 
     /**
-     * Directories where .content files are located.
-     * Default: ["."]
+     * .content 파일이 위치한 디렉토리.
+     * 기본값: ["."]
      */
     contentDir: ["src"],
 
     /**
-     * Directories where source code is located.
-     * Used for build optimization and code transformation.
-     * Default: ["."]
+     * 소스 코드가 위치한 곳.
+     * 빌드 최적화 및 코드 변환에 사용됩니다.
+     * 기본값: ["."]
      */
     codeDir: ["src"],
 
     /**
-     * Patterns to exclude from scanning.
-     * Default: ['node_modules', '.intlayer', etc.]
+     * 스캔에서 제외되는 패턴.
+     * 기본값: ['node_modules', '.intlayer' 등]
      */
     excludedPath: ["node_modules"],
 
     /**
-     * Whether to watch for changes and rebuild dictionaries in development.
-     * Default: true in development
+     * 개발 중에 변경 사항을 모니터링하고 딕셔너리를 재구축할지 여부.
+     * 기본값: 개발 환경에서 true
      */
     watch: true,
 
     /**
-     * Command to format newly created / updated .content files.
+     * 새로 생성/업데이트된 .content 파일을 포맷하는 데 사용되는 명령.
      */
     formatCommand: 'npx prettier --write "{{file}}"',
   },
 
   /**
-   * Visual Editor configuration.
+   * 비주얼 에디터 (Visual Editor) 설정.
    */
   editor: {
     /**
-     * Whether the visual editor is enabled.
-     * Default: false
+     * 비주얼 에디터 활성화 여부.
+     * 기본값: false
      */
     enabled: true,
 
     /**
-     * URL of your application for origin validation.
-     * Default: ""
+     * 오리진 검증(origin validation)을 위한 애플리케이션 URL.
+     * 기본값: ""
      */
     applicationURL: "http://localhost:3000",
 
     /**
-     * Port for the local editor server.
-     * Default: 8000
+     * 로컬 에디터 서버를 위한 포트.
+     * 기본값: 8000
      */
     port: 8000,
 
     /**
-     * Public URL for the editor.
-     * Default: "http://localhost:8000"
+     * 에디터의 공개 URL.
+     * 기본값: "http://localhost:8000"
      */
     editorURL: "http://localhost:8000",
 
     /**
      * Intlayer CMS URL.
-     * Default: "https://app.intlayer.org"
+     * 기본값: "https://app.intlayer.org"
      */
     cmsURL: "https://app.intlayer.org",
 
     /**
-     * Backend API URL.
-     * Default: "https://back.intlayer.org"
+     * 백엔드 API URL.
+     * 기본값: "https://back.intlayer.org"
      */
     backendURL: "https://back.intlayer.org",
 
     /**
-     * Whether to enable real-time content synchronization.
-     * Default: false
+     * 실시간 콘텐츠 동기화 활성화 여부.
+     * 기본값: false
      */
     liveSync: true,
   },
 
   /**
-   * AI-powered translation and generation settings.
+   * AI 기반 번역 및 구축 설정.
    */
   ai: {
     /**
-     * AI provider to use.
-     * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
-     * Default: 'openai'
+     * 사용할 AI 제공업체.
+     * 옵션: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * 기본값: 'openai'
      */
     provider: "openai",
 
     /**
-     * Model to use from the selected provider.
+     * 사용할 선택된 제공업체의 모델.
      */
     model: "gpt-4o",
 
     /**
-     * Provider API key.
+     * 제공업체 API 키.
      */
     apiKey: process.env.OPENAI_API_KEY,
 
     /**
-     * Global context to guide the AI in generating translations.
+     * 번역 생성 시 AI를 안내하기 위한 전역 컨텍스트.
      */
-    applicationContext: "This is a travel booking application.",
+    applicationContext: "이것은 여행 예약 애플리케이션입니다.",
 
     /**
-     * Base URL for the AI API.
+     * AI API의 기본 경로 URL.
      */
     baseURL: "http://localhost:3000",
 
     /**
-     * 데이터 직렬화
+     * 데이터 직렬화 (Data Serialization)
      *
      * 옵션:
-     * - "json": 표준, 신뢰할 수 있음; 더 많은 토큰을 사용합니다.
-     * - "toon": 토큰을 덜 사용하지만 JSON만큼 일관성이 있지는 않습니다.
+     * - "json": 기본값, 견고함, 더 많은 토큰 소모.
+     * - "toon": 토큰 소모 적음, JSON만큼 일관적이지 않을 수 있음.
      *
      * 기본값: "json"
      */
@@ -344,118 +371,118 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Build and optimization settings.
+   * 빌드 및 최적화 설정.
    */
   build: {
     /**
-     * Build execution mode.
-     * - "auto": Automatic build during app build.
-     * - "manual": Requires explicit build command.
-     * Default: "auto"
+     * 빌드 실행 모드.
+     * - "auto": 애플리케이션 빌드 중에 자동으로 빌드됩니다.
+     * - "manual": 명시적인 빌드 명령이 필요합니다.
+     * 기본값: "auto"
      */
     mode: "auto",
 
     /**
-     * Whether to optimize the final bundle by pruning unused dictionaries.
-     * Default: true in production
+     * 사용되지 않는 딕셔너리를 제거하여 최종 번들을 최적화할지 여부.
+     * 기본값: 프로덕션 환경에서 true
      */
     optimize: true,
 
     /**
-     * Output format for generated dictionary files.
-     * Default: ['esm', 'cjs']
+     * 생성된 딕셔너리 파일의 출력 형식.
+     * 기본값: ['cjs', 'esm']
      */
-    outputFormat: ["esm"],
+    outputFormat: ["cjs", "esm"],
 
     /**
-     * Indicates if the build should check TypeScript types.
-     * Default: false
+     * 빌드가 TypeScript 유형을 확인해야 하는지 여부를 나타냅니다.
+     * 기본값: false
      */
     checkTypes: false,
   },
 
   /**
-   * Logger configuration.
+   * 로거 (Logger) 설정.
    */
   log: {
     /**
-     * Logging level.
-     * - "default": Standard logging.
-     * - "verbose": Detailed debug logging.
-     * - "disabled": No logging.
-     * Default: "default"
+     * 로깅 레벨.
+     * - "default": 표준 로깅.
+     * - "verbose": 심층 디버그 로깅.
+     * - "disabled": 로깅 비활성화.
+     * 기본값: "default"
      */
     mode: "default",
 
     /**
-     * Prefix for all log messages.
-     * Default: "[intlayer]"
+     * 모든 로그 메시지에 대한 접두사.
+     * 기본값: "[intlayer]"
      */
     prefix: "[intlayer]",
   },
 
   /**
-   * System configuration (Advanced use cases)
+   * 시스템 설정 (고급 사용자용)
    */
   system: {
     /**
-     * Directory for storing localization dictionaries.
+     * 현지화된 딕셔너리를 저장하기 위한 디렉토리.
      */
     dictionariesDir: ".intlayer/dictionary",
 
     /**
-     * Directory for module augmentation.
+     * TypeScript 모듈 증강(module augmentation)을 위한 디렉토리.
      */
     moduleAugmentationDir: ".intlayer/types",
 
     /**
-     * Directory for storing unmerged dictionaries.
+     * 병합되지 않은 딕셔너리를 저장하기 위한 디렉토리.
      */
     unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
 
     /**
-     * Directory for storing dictionary types.
+     * 딕셔너리 유형을 저장하기 위한 디렉토리.
      */
     typesDir: ".intlayer/types",
 
     /**
-     * Directory where main application files are stored.
+     * 기본 애플리케이션 파일이 저장되는 디렉토리.
      */
     mainDir: ".intlayer/main",
 
     /**
-     * Directory where the configuration files are stored.
+     * 설정 파일이 저장되는 디렉토리.
      */
     configDir: ".intlayer/config",
 
     /**
-     * Directory where the cache files are stored.
+     * 캐시 파일이 저장되는 디렉토리.
      */
     cacheDir: ".intlayer/cache",
   },
 
   /**
-   * Compiler configuration (Advanced use cases)
+   * 컴파일러 설정 (고급 사용자용)
    */
   compiler: {
     /**
      * 컴파일러 활성화 여부를 나타냅니다.
      *
-     * - false : 컴파일러를 비활성화합니다.
-     * - true : 컴파일러를 활성화합니다.
-     * - "build-only" : 개발 중에 컴파일러를 건너뛰고 시작 시간을 단축합니다.
+     * - false: 컴파일러를 비활성화합니다.
+     * - true: 컴파일러를 활성화합니다.
+     * - "build-only": 개발 중 컴파일러를 건너뛰고 시작 시간을 단축합니다.
      *
-     * 기본값 : false
+     * 기본값: false
      */
     enabled: true,
 
     /**
-     * 출력 파일 경로를 정의합니다. `outputDir`을 대체합니다.
+     * 출력 파일의 경로를 정의합니다. `outputDir`을 대체합니다.
      *
-     * - `./` 경로는 컴포넌트 디렉터리를 기준으로 해결됩니다.
-     * - `/` 경로는 프로젝트 루트(`baseDir`)를 기준으로 해결됩니다.
+     * - `./` 경로는 컴포넌트 디렉토리를 기준으로 해석됩니다.
+     * - `/` 경로는 프로젝트 루트(`baseDir`)를 기준으로 해석됩니다.
      *
-     * - 경로에 `{{locale}}` 변수를 넣으면 언어별로 분리된 사전 생성이 활성화됩니다.
+     * - 경로에 `{{locale}}` 변수를 포함하면 언어별로 별도의 딕셔너리가 생성됩니다.
      *
      * 예시:
      * ```ts
@@ -463,16 +490,16 @@ const config: IntlayerConfig = {
      *   // 컴포넌트 옆에 다국어 .content.ts 파일 생성
      *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
      *
-     *   // output: './{{fileName}}{{extension}}', // 문자열 템플릿을 사용한 동일한 표현
+     *   // output: './{{fileName}}{{extension}}', // 템플릿 문자열을 사용한 동일 방식
      * }
      * ```
      *
      * ```ts
      * {
-     *   // 프로젝트 루트의 언어별 중앙 집중식 JSON 파일 생성
+     *   // 프로젝트 루트의 언어별 중앙 집중식 JSON 생성
      *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
      *
-     *   // output: '/locales/{{locale}}/{{key}}.content.json', // 문자열 템플릿을 사용한 동일한 표현
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // 템플릿 문자열을 사용한 동일 방식
      * }
      * ```
      *
@@ -483,31 +510,31 @@ const config: IntlayerConfig = {
      *   - `extension`: 파일 확장자.
      *   - `componentFileName`: 컴포넌트 파일 이름.
      *   - `componentExtension`: 컴포넌트 파일 확장자.
-     *   - `format`: 사전 형식.
-     *   - `componentFormat`: 컴포넌트 사전 형식.
-     *   - `componentDirPath`: 컴포넌트 디렉터리 경로.
+     *   - `format`: 딕셔너리 형식.
+     *   - `componentFormat`: 컴포넌트 딕셔너리 형식.
+     *   - `componentDirPath`: 컴포넌트 디렉토리 경로.
      */
     output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * 변환된 후 구성 요소를 저장할지 여부를 나타냅니다.
-     * 이렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
+     * 변환된 후 컴포넌트를 저장해야 하는지 여부를 나타냅니다.
+     * 이렇게 하면 컴파일러를 한 번만 실행하여 애플리케이션을 변환한 다음 제거할 수 있습니다.
      */
     saveComponents: false,
 
     /**
-     * 생성된 파일에 콘텐츠만 삽입합니다. 로케일별 i18next 또는 ICU MessageFormat JSON 출력에 유용합니다.
+     * 생성된 파일에 콘텐츠만 삽입합니다. i18next 또는 ICU MessageFormat 형식의 언어별 JSON 출력에 유용합니다.
      */
     noMetadata: false,
 
     /**
-     * 사전 키 접두사
+     * 딕셔너리 키 접두사
      */
-    dictionaryKeyPrefix: "", // 추출된 사전 키에 선택적 접두사 추가
+    dictionaryKeyPrefix: "", // 추출된 딕셔너리 키에 선택적 접두사 추가
   },
 
   /**
-   * Custom schemas to validate the dictionaries content.
+   * 딕셔너리 콘텐츠 검증을 위한 사용자 정의 스키마.
    */
   schemas: {
     "my-schema": z.object({
@@ -516,7 +543,7 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Plugins configuration.
+   * 플러그인 설정.
    */
   plugins: [],
 };
@@ -524,598 +551,372 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
-## 구성 참조
+---
+
+## 설정 참조 (Configuration Reference)
+
+다음 섹션은 Intlayer에서 사용 가능한 다양한 설정 항목에 대해 설명합니다.
+
+---
+
+### 국제화 설정 (Internationalization Configuration)
+
+사용 가능한 로케일 및 애플리케이션의 기본 로케일을 포함하여 국제화와 관련된 설정을 정의합니다.
+
+| 필드              | 유형       | 설명                                                                                     | 예시                 | 참고                                                                                                                                                                                                                                                                                  |
+| ----------------- | ---------- | ---------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `locales`         | `string[]` | 애플리케이션에서 지원되는 로케일 목록. 기본값: `[Locales.ENGLISH]`                       | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                       |
+| `requiredLocales` | `string[]` | 애플리케이션의 필수 로케일 목록. 기본값: `[]`                                            | `[]`                 | 비어 있는 경우, `strict` 모드에서 모든 로케일이 필수입니다. 필수 로케일이 `locales` 필드에도 정의되어 있는지 확인하세요.                                                                                                                                                              |
+| `strictMode`      | `string`   | TypeScript를 사용하여 견고한 국제화 콘텐츠 구현을 보장합니다. 기본값: `inclusive`        |                      | `"strict"`인 경우: `t` 기능은 선언된 모든 로케일이 정의되어야 함을 요구합니다 — 누락되거나 선언되지 않은 경우 오류를 발생시킵니다. `"inclusive"`인 경우: 누락된 로케일에 대해 경고하지만 기존에 선언되지 않은 로케일을 수용합니다. `"loose"`인 경우: 기존의 모든 로케일을 수용합니다. |
+| `defaultLocale`   | `string`   | 요청된 로케일을 찾을 수 없을 때 폴백으로 사용되는 기본 로케일. 기본값: `Locales.ENGLISH` | `'en'`               | URL, 쿠키 또는 헤더에 로케일이 지정되지 않은 경우 로케일을 결정하는 데 사용됩니다.                                                                                                                                                                                                    |
+
+---
+
+### 에디터 설정 (Editor Configuration)
+
+서버 포트 및 활동 상태를 포함하여 통합 에디터와 관련된 설정을 정의합니다.
+
+| 필드                         | 유형                      | 설명                                                                                                                                                                                            | 예시                                                                                  | 참고                                                                                                                                                                                                                  |
+| ---------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `applicationURL`             | `string`                  | 애플리케이션의 URL. 기본값: `''`                                                                                                                                                                | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | 보안상의 이유로 에디터의 오리진(origin)을 제한하는 데 사용됩니다. `'*'`로 설정하면 모든 오리진에서 에디터에 액세스할 수 있습니다.                                                                                     |
+| `port`                       | `number`                  | 비주얼 에디터 서버에서 사용하는 포트. 기본값: `8000`                                                                                                                                            |                                                                                       |                                                                                                                                                                                                                       |
+| `editorURL`                  | `string`                  | 에디터 서버 URL. 기본값: `'http://localhost:8000'`                                                                                                                                              | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | 애플리케이션과 상호 작용할 수 있는 오리진을 제한하는 데 사용됩니다. `'*'`로 설정하면 모든 오리진에서 액세스할 수 있습니다. 포트를 변경하거나 에디터가 다른 도메인에서 호스팅되는 경우 설정해야 합니다.                |
+| `cmsURL`                     | `string`                  | Intlayer CMS URL. 기본값: `'https://intlayer.org'`                                                                                                                                              | `'https://intlayer.org'`                                                              |                                                                                                                                                                                                                       |
+| `backendURL`                 | `string`                  | 백엔드 서버 URL. 기본값: `https://back.intlayer.org`                                                                                                                                            | `http://localhost:4000`                                                               |                                                                                                                                                                                                                       |
+| `enabled`                    | `boolean`                 | 앱이 비주얼 에디터와 상호 작용할지 여부를 나타냅니다. 기본값: `true`                                                                                                                            | `process.env.NODE_ENV !== 'production'`                                               | `false`인 경우 에디터는 앱과 상호 작용할 수 없습니다. 특정 환경에 대해 비활성화하면 보안이 강화됩니다.                                                                                                                |
+| `clientId`                   | `string | undefined` | oAuth2를 사용하여 백엔드에서 인증할 수 있도록 intlayer 패키지를 활성화합니다. 액세스 토큰을 받으려면 [intlayer.org/project](https://app.intlayer.org/project)로 이동하세요. 기본값: `undefined` |                                                                                       | 비밀로 유지하고 환경 변수에 저장하세요.                                                                                                                                                                               |
+| `clientSecret`               | `string | undefined` | oAuth2를 사용하여 백엔드에서 인증할 수 있도록 intlayer 패키지를 활성화합니다. 액세스 토큰을 받으려면 [intlayer.org/project](https://app.intlayer.org/project)로 이동하세요. 기본값: `undefined` |                                                                                       | 비밀로 유지하고 환경 변수에 저장하세요.                                                                                                                                                                               |
+| `dictionaryPriorityStrategy` | `string`                  | 로컬 딕셔너리와 원격 딕셔너리가 모두 존재하는 경우 딕셔너리 우선순위 지정을 위한 전략. 기본값: `'local_first'`                                                                                  | `'distant_first'`                                                                     | `'distant_first'`: 로컬보다 원격을 우선시합니다. `'local_first'`: 원격보다 로컬을 우선시합니다.                                                                                                                       |
+| `liveSync`                   | `boolean`                 | CMS / 비주얼 에디터 / 백엔드에서 변경이 감지될 때 앱 서버 속 콘텐츠를 핫 리로드해야 하는지 여부를 나타냅니다. 기본값: `true`                                                                    | `true`                                                                                | 딕셔너리가 추가/업데이트되면 앱은 페이지 콘텐츠를 업데이트합니다. 라이브 동기화는 콘텐츠를 다른 서버에 원격으로 처리하므로 성능에 약간의 영향을 줄 수 있습니다. 두 가지를 동일한 머신에서 호스팅하는 것이 권장됩니다. |
+| `liveSyncPort`               | `number`                  | 라이브 동기화 서버 포트. 기본값: `4000`                                                                                                                                                         | `4000`                                                                                |                                                                                                                                                                                                                       |
+| `liveSyncURL`                | `string`                  | 라이브 동기화 서버 URL. 기본값: `'http://localhost:{liveSyncPort}'`                                                                                                                             | `'https://example.com'`                                                               | 기본적으로 localhost를 가리키며, 원격 라이브 동기화 서버로 변경할 수 있습니다.                                                                                                                                        |
+
+### 라우팅 설정 (Routing Configuration)
+
+URL 구조, 로케일 저장 및 미들웨어 처리를 포함하여 라우팅 동작을 제어하는 설정.
+
+| 필드       | 유형                                                                                                                                                 | 설명                                                                                                                                  | 예시                                                                                                                                                                                     | 참고                                                                                                                                                                                                                                                                         |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`                                                                  | 로케일 처리를 위한 URL 라우팅 모드. 기본값: `'prefix-no-default'`                                                                     | `'prefix-no-default'`: `/dashboard` (en) 또는 `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: 다른 수단으로 로케일 처리. `'search-params'`: `/dashboard?locale=fr` | 쿠키 또는 로케일 저장소 관리에는 영향을 주지 않습니다.                                                                                                                                                                                                                       |
+| `storage`  | `false | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | Array` | 클라이언트에 로케일을 저장하기 위한 구성. 기본값: `['cookie', 'header']`                                                              | `'localStorage'`, `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                            | 아래의 저장소 옵션 테이블을 참조하세요.                                                                                                                                                                                                                                      |
+| `basePath` | `string`                                                                                                                                             | 애플리케이션 URL의 기본 경로. 기본값: `''`                                                                                            | `'/my-app'`                                                                                                                                                                              | 앱이 `https://example.com/my-app`에 있는 경우 basePath는 `'/my-app'`이며 URL은 `https://example.com/my-app/en`이 됩니다.                                                                                                                                                     |
+| `rewrite`  | `Record<string, StrictModeLocaleMap<string>>`                                                                                                        | 특정 경로에 대해 기본 라우팅 모드를 대체하는 사용자 정의 URL 리라이트 규칙. 동적 매개변수 `[param]`를 지원합니다. 기본값: `undefined` | 아래 예시 참조                                                                                                                                                                           | 리라이트 규칙은 `mode`보다 우선순위가 높습니다. Next.js 및 Vite와 함께 작동합니다. `getLocalizedUrl()`은 일치하는 규칙을 자동으로 적용합니다. [사용자 정의 URL 리라이트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/custom_url_rewrites.md)를 참조하세요. |
+
+**`rewrite` 예시**:
+
+```typescript
+routing: {
+  mode: "prefix-no-default", // 폴백 전략
+  rewrite: nextjsRewrite({
+    "/about": {
+      en: "/about",
+      fr: "/a-propos",
+    },
+    "/product/[slug]": {
+      en: "/product/[slug]",
+      fr: "/produit/[slug]",
+    },
+    "/blog/[category]/[id]": {
+      en: "/blog/[category]/[id]",
+      fr: "/journal/[category]/[id]",
+    },
+  }),
+}
+```
+
+#### 저장소 옵션 (Storage Options)
+
+| 값                 | 설명                                                                          | 참고                                                                                                                                                                                             |
+| ------------------ | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `'cookie'`         | 쿠키에 로케일을 저장합니다 — 클라이언트와 서버 측 모두에서 액세스 가능합니다. | GDPR 준수를 위해 적절한 사용자 동의를 얻었는지 확인하세요. `CookiesAttributes`를 통해 맞춤 설정 가능합니다 (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).         |
+| `'localStorage'`   | 만료 날짜 없이 브라우저에 로케일을 저장합니다 — 클라이언트 측 전용입니다.     | 명시적으로 삭제하지 않는 한 만료되지 않습니다. Intlayer 프록시는 이에 액세스할 수 없습니다. `StorageAttributes`를 통해 맞춤 설정 가능합니다 (`{ type: 'localStorage', name: 'custom-locale' }`). |
+| `'sessionStorage'` | 페이지 세션 동안 로케일을 저장합니다 — 클라이언트 측 전용입니다.              | 탭/창을 닫으면 지워집니다. Intlayer 프록시는 이에 액세스할 수 없습니다. `StorageAttributes`를 통해 맞춤 설정 가능합니다 (`{ type: 'sessionStorage', name: 'custom-locale' }`).                   |
+| `'header'`         | HTTP 헤더를 통해 로케일을 저장하거나 전송합니다 — 서버 측 전용입니다.         | API 호출에 유용합니다. 클라이언트 측에서는 액세스할 수 없습니다. `StorageAttributes`를 통해 맞춤 설정 가능합니다 (`{ type: 'header', name: 'custom-locale' }`).                                  |
+
+#### 쿠키 속성 (Cookie Attributes)
+
+쿠키 저장소를 사용할 때 추가 쿠키 속성을 구성할 수 있습니다.
+
+| 필드       | 유형                                  | 설명                                     |
+| ---------- | ------------------------------------- | ---------------------------------------- |
+| `name`     | `string`                              | 쿠키 이름. 기본값: `'INTLAYER_LOCALE'`   |
+| `domain`   | `string`                              | 쿠키 도메인. 기본값: `undefined`         |
+| `path`     | `string`                              | 쿠키 경로. 기본값: `undefined`           |
+| `secure`   | `boolean`                             | HTTPS가 필요합니다. 기본값: `undefined`  |
+| `httpOnly` | `boolean`                             | HTTP 전용 플래그. 기본값: `undefined`    |
+| `sameSite` | `'strict' &#124; 'lax' &#124; 'none'` | SameSite 정책.                           |
+| `expires`  | `Date &#124; number`                  | 만료 날짜 또는 일수. 기본값: `undefined` |
+
+#### 로케일 저장소 속성 (Locale Storage Attributes)
+
+localStorage 또는 sessionStorage를 사용할 때:
+
+| 필드   | 유형                                     | 설명                                        |
+| ------ | ---------------------------------------- | ------------------------------------------- |
+| `type` | `'localStorage' &#124; 'sessionStorage'` | 저장소 유형.                                |
+| `name` | `string`                                 | 저장소 키 이름. 기본값: `'INTLAYER_LOCALE'` |
+
+#### 설정 예시
+
+새로운 v7 라우팅 구조에 대한 몇 가지 일반적인 설정 예시는 다음과 같습니다.
+
+**기본 구성 (기본값)**:
+
+```typescript
+import { Locales, type IntlayerConfig } from "intlayer";
+// intlayer.config.ts
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr", "es"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "prefix-no-default",
+    storage: "localStorage",
+    basePath: "",
+  },
+};
+
+export default config;
+```
+
+**GDPR 준수 구성**:
+
+```typescript
+import { Locales, type IntlayerConfig } from "intlayer";
+// intlayer.config.ts
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr", "es"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "prefix-no-default",
+    storage: [
+      {
+        type: "localStorage",
+        name: "user-locale",
+      },
+      {
+        type: "cookie",
+        name: "user-locale",
+        secure: true,
+        sameSite: "strict",
+        httpOnly: false,
+      },
+    ],
+    basePath: "",
+  },
+};
+
+export default config;
+```
+
+**검색 매개변수 모드 (Search Parameters Mode)**:
+
+```typescript
+import { Locales, type IntlayerConfig } from "intlayer";
+// intlayer.config.ts
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr", "es"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "search-params",
+    storage: "localStorage",
+    basePath: "",
+  },
+};
+
+export default config;
+```
+
+**사용자 정의 저장소를 사용한 접두사 없음(No Prefix) 모드**:
+
+```typescript
+import { Locales, type IntlayerConfig } from "intlayer";
+// intlayer.config.ts
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr", "es"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "no-prefix",
+    storage: {
+      type: "sessionStorage",
+      name: "app-locale",
+    },
+    basePath: "/my-app",
+  },
+};
+
+export default config;
+```
+
+**동적 경로를 사용한 사용자 정의 URL 리라이트**:
+
+```typescript
+// intlayer.config.ts
+import { nextjsRewrite } from "intlayer/routing";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "prefix-no-default", // 리라이트되지 않은 경로에 대한 폴백
+    storage: "cookie",
+    rewrite: nextjsRewrite({
+      "/about": {
+        en: "/about",
+        fr: "/a-propos",
+      },
+      "/product/[slug]": {
+        en: "/product/[slug]",
+        fr: "/produit/[slug]",
+      },
+      "/blog/[category]/[id]": {
+        en: "/blog/[category]/[id]",
+        fr: "/journal/[category]/[id]",
+      },
+    }),
+  },
+};
+
+export default config;
+```
 
-다음 섹션에서는 Intlayer에서 사용할 수 있는 다양한 구성 설정에 대해 설명합니다.
+---
+
+### 콘텐츠 설정 (Content Configuration)
+
+애플리케이션 내 콘텐츠 처리와 관련된 설정 (디렉토리 이름, 파일 확장자 및 파생 설정).
+
+| 필드             | 유형       | 설명                                                                                                                                                                               | 예시                                | 참고                                                                                      |
+| ---------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------- |
+| `watch`          | `boolean`  | 딕셔너리를 재구축하기 위해 Intlayer가 콘텐츠 선언 파일의 변경 사항을 감시해야 하는지 여부를 나타냅니다. 기본값: `process.env.NODE_ENV === 'development'`                           |                                     |                                                                                           |
+| `fileExtensions` | `string[]` | 콘텐츠 선언 파일을 스캔하는 데 사용되는 파일 확장자. 기본값: `['.content.ts', '.content.js', '.content.mjs', '.content.cjs', '.content.json', '.content.json5', '.content.jsonc']` | `['.content.ts', '.content.js']`    |                                                                                           |
+| `contentDir`     | `string[]` | 콘텐츠 선언 파일이 위치한 디렉토리에 대한 경로. 기본값: `['.']`                                                                                                                    | `['src/content']`                   |                                                                                           |
+| `codeDir`        | `string[]` | 애플리케이션 소스 코드 파일이 위치한 디렉토리에 대한 경로. 기본값: `['.']`                                                                                                         | `['src']`                           | 빌드를 최적화하고 코드 변환 및 핫 리로드가 필요한 파일에만 적용되도록 하는 데 사용됩니다. |
+| `excludedPath`   | `string[]` | 콘텐츠 스캔에서 제외되는 경로. 기본값: `['node_modules', '.intlayer', '.next', 'dist', 'build']`                                                                                   | `['src/styles']`                    |                                                                                           |
+| `formatCommand`  | `string`   | 새로 생성되거나 업데이트된 콘텐츠 파일을 포맷하기 위해 실행될 명령. 기본값: `undefined`                                                                                            | `'npx prettier --write "{{file}}"'` | 콘텐츠 추출 시 또는 비주얼 에디터를 통해 사용됩니다.                                      |
 
 ---
 
-### 국제화 구성
-
-애플리케이션에서 사용 가능한 로케일과 기본 로케일을 포함하여 국제화와 관련된 설정을 정의합니다.
-
-#### 속성
-
-- **locales**:
-  - _유형_: `string[]`
-  - _기본값_: `['en']`
-  - _설명_: 애플리케이션에서 지원하는 로케일 목록입니다.
-  - _예시_: `['en', 'fr', 'es']`
-
-- **requiredLocales**:
-  - _유형_: `string[]`
-  - _기본값_: `[]`
-  - _설명_: 애플리케이션에서 필수로 요구되는 로케일 목록입니다.
-  - _예시_: `[]`
-  - _참고_: 비어 있으면 `strict` 모드에서 모든 로케일이 필수입니다.
-  - _참고_: 필수 로케일이 `locales` 필드에도 정의되어 있는지 확인하세요.
-- **strictMode**:
-  - _유형_: `string`
-  - _기본값_: `inclusive`
-  - _설명_: 타입스크립트를 사용하여 국제화된 콘텐츠의 강력한 구현을 보장합니다.
-  - _참고_: "strict"로 설정하면, 번역 함수 `t`는 선언된 각 로케일이 정의되어 있어야 합니다. 하나의 로케일이 누락되었거나 구성에 선언되지 않은 로케일이 있으면 오류를 발생시킵니다.
-  - _참고_: "inclusive"로 설정하면, 번역 함수 `t`는 선언된 각 로케일이 정의되어 있어야 합니다. 하나의 로케일이 누락되면 경고를 발생시키지만, 구성에 선언되지 않았더라도 존재하는 로케일은 허용합니다.
-  - _참고_: "loose"로 설정하면, 번역 함수 `t`는 존재하는 모든 로케일을 허용합니다.
-
-- **defaultLocale**:
-  - _유형_: `string`
-  - _기본값_: `'en'`
-  - _설명_: 요청한 로케일을 찾을 수 없을 때 대체로 사용되는 기본 로케일입니다.
-  - _예시_: `'en'`
-  - _참고_: URL, 쿠키 또는 헤더에 로케일이 지정되지 않은 경우 이 값을 사용하여 로케일을 결정합니다.
+### 딕셔너리 설정 (Dictionary Configuration)
+
+자동 채우기 동작 및 콘텐츠 생성을 포함하여 딕셔너리 작업을 제어하는 설정입니다.
+
+이 딕셔너리 설정은 두 가지 주요 목적을 가집니다:
+
+1. **기본값**: 콘텐츠 선언 파일을 생성할 때 기본값을 정의합니다.
+2. **폴백 동작**: 특정 필드가 정의되지 않았을 때 폴백 값을 제공하여 딕셔너리 작업 동작을 전역적으로 정의할 수 있도록 합니다.
+
+콘텐츠 선언 파일 및 설정값이 적용되는 방식에 대한 자세한 내용은 [콘텐츠 파일 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)를 참조하세요.
+
+| 필드                        | 유형                                                                                            | 설명                                                                                  | 예시           | 참고                                                                                                                                                                                                                                                                                                               |
+| --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `fill`                      | `boolean &#124; FilePathPattern &#124; Partial<Record<Locale, boolean &#124; FilePathPattern>>` | 자동 채우기(AI 번역) 출력 파일이 생성되는 방식을 제어합니다. 기본값: `true`           | 아래 예시 참조 | `true`: 기본 경로(소스와 동일한 파일). `false`: 비활성화. 문자열/함수 템플릿은 로케일별 파일을 생성합니다. 로케일별 객체: 각 로케일은 자체 패턴에 매핑됩니다. `false`는 해당 로케일을 건너뜁니다. `{{locale}}`을 포함하면 로케일별 생성이 트리거됩니다. 딕셔너리 수준의 `fill`은 항상 이 전역 설정보다 우선합니다. |
+| `importMode`                | `'static' &#124; 'dynamic' &#124; 'fetch'`                                                      | 딕셔너리를 가져오는 방법을 제어합니다. 기본값: `'static'`                             | `'dynamic'`    | `'static'`: 정적으로 가져옵니다. `'dynamic'`: Suspense를 통해 동적으로 가져옵니다. `'fetch'`: Live Sync API를 통해 동적으로 가져옵니다. `getIntlayer`, `getDictionary`, `useDictionary` 등에는 영향을 주지 않습니다.                                                                                               |
+| `location`                  | `'local' &#124; 'remote' &#124; 'hybrid' &#124; string`                                         | 딕셔너리가 저장되는 위치입니다. 기본값: `'local'`                                     | `'remote'`     | `'local'`: 파일 시스템. `'remote'`: Intlayer CMS. `'hybrid'`: 둘 다.                                                                                                                                                                                                                                               |
+| `contentAutoTransformation` | `boolean`                                                                                       | 콘텐츠 파일을 자동으로 변환해야 하는지 여부(예: Markdown에서 HTML로). 기본값: `false` | `true`         | @intlayer/markdown을 통해 Markdown 필드를 처리하는 데 유용합니다.                                                                                                                                                                                                                                                  |
+
+**`fill` 예시**:
+
+```ts
+dictionary: {
+  fill: {
+    en: '/locales/en/{{key}}.content.json',
+    fr: ({ key }) => `/locales/fr/${key}.content.json`,
+    es: false,
+  }
+}
+```
 
 ---
 
-### 에디터 구성
-
-통합 에디터와 관련된 설정을 정의하며, 서버 포트와 활성 상태를 포함합니다.
-
-#### 속성
-
-- **applicationURL**:
-  - _유형_: `string`
-  - _기본값_: `http://localhost:3000`
-  - _설명_: 애플리케이션의 URL입니다. 보안상의 이유로 에디터의 출처를 제한하는 데 사용됩니다.
-  - _예시_:
-    - `'http://localhost:3000'`
-    - `'https://example.com'`
-- `process.env.INTLAYER_EDITOR_URL`
-  - _참고_: 애플리케이션의 URL입니다. 보안상의 이유로 에디터의 출처를 제한하는 데 사용됩니다. `'*'`로 설정하면 에디터는 모든 출처에서 접근할 수 있습니다.
-
-- **port**:
-  - _유형_: `number`
-  - _기본값_: `8000`
-  - _설명_: 비주얼 에디터 서버가 사용하는 포트입니다.
-
-- **editorURL**:
-  - _유형_: `string`
-  - _기본값_: `'http://localhost:8000'`
-  - _설명_: 에디터 서버의 URL입니다. 보안상의 이유로 에디터의 출처를 제한하는 데 사용됩니다.
-    - `'http://localhost:3000'`
-    - `'https://example.com'`
-    - `process.env.INTLAYER_EDITOR_URL`
-  - _참고_: 애플리케이션에서 접근하는 에디터 서버의 URL입니다. 보안상의 이유로 애플리케이션과 상호작용할 수 있는 출처를 제한하는 데 사용됩니다. `'*'`로 설정하면 모든 출처에서 에디터에 접근할 수 있습니다. 포트가 변경되었거나 에디터가 다른 도메인에 호스팅되는 경우 설정해야 합니다.
-
-- **cmsURL**:
-  - _유형_: `string`
-  - _기본값_: `'https://intlayer.org'`
-  - _설명_: Intlayer CMS의 URL입니다.
-  - _예시_: `'https://intlayer.org'`
-  - _참고_: Intlayer CMS의 URL입니다.
-
-- **backendURL**:
-  - _유형_: `string`
-  - _기본값_: `https://back.intlayer.org`
-  - _설명_: 백엔드 서버의 URL입니다.
-  - _예시_: `http://localhost:4000`
-
-- **enabled**:
-  - _유형_: `boolean`
-  - _기본값_: `true`
-  - _설명_: 애플리케이션이 비주얼 에디터와 상호작용하는지 여부를 나타냅니다.
-  - _예시_: `process.env.NODE_ENV !== 'production'`
-  - _참고_: true인 경우, 에디터가 애플리케이션과 상호작용할 수 있습니다. false인 경우, 에디터가 애플리케이션과 상호작용할 수 없습니다. 어떤 경우든 에디터는 비주얼 에디터에 의해서만 활성화될 수 있습니다. 특정 환경에서 에디터를 비활성화하는 것은 보안을 강화하는 방법입니다.
-
-- **clientId**:
-  - _유형_: `string` | `undefined`
-  - _기본값_: `undefined`
-  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://app.intlayer.org/project 에서 계정을 생성하세요.
-  - _예시_: `true`
-  - _참고_: 중요: clientId와 clientSecret은 비밀로 유지되어야 하며 공개적으로 공유되어서는 안 됩니다. 환경 변수와 같은 안전한 위치에 보관하시기 바랍니다.
-
-- **clientSecret**:
-  - _유형_: `string` | `undefined`
-  - _기본값_: `undefined`
-  - _설명_: clientId와 clientSecret은 intlayer 패키지가 oAuth2 인증을 사용하여 백엔드와 인증할 수 있도록 합니다. 액세스 토큰은 프로젝트와 관련된 사용자를 인증하는 데 사용됩니다. 액세스 토큰을 얻으려면 https://app.intlayer.org/project 에서 계정을 생성하세요.
-  - _예시_: `true`
-  - _참고_: 중요: clientId와 clientSecret은 비밀로 유지되어야 하며 공개적으로 공유해서는 안 됩니다. 환경 변수와 같은 안전한 위치에 보관하시기 바랍니다.
-
-- **dictionaryPriorityStrategy**:
-  - _유형_: `string`
-  - _기본값_: `'local_first'`
-  - _설명_: 로컬 사전과 원격 사전이 모두 존재할 경우 사전의 우선순위를 정하는 전략입니다. `'distant_first'`로 설정하면 애플리케이션이 원격 사전을 로컬 사전보다 우선시합니다. `'local_first'`로 설정하면 애플리케이션이 로컬 사전을 원격 사전보다 우선시합니다.
-  - _예시_: `'distant_first'`
-
-- **liveSync**:
-  - _유형_: `boolean`
-  - _기본값_: `false`
-  - _설명_: CMS / 비주얼 에디터 / 백엔드에서 변경 사항이 감지되었을 때 애플리케이션 서버가 콘텐츠를 핫 리로드할지 여부를 나타냅니다.
-  - _예시_: `true`
-  - _참고_: 예를 들어, 새로운 사전이 추가되거나 업데이트되면 애플리케이션이 페이지에 표시할 콘텐츠를 업데이트합니다.
-  - _참고_: 라이브 싱크는 애플리케이션의 콘텐츠를 다른 서버로 외부화해야 합니다. 이는 애플리케이션 성능에 약간의 영향을 미칠 수 있음을 의미합니다. 이를 제한하기 위해 애플리케이션과 라이브 싱크 서버를 동일한 머신에 호스팅할 것을 권장합니다. 또한, 라이브 싱크와 `optimize`의 조합은 라이브 싱크 서버에 상당한 수의 요청을 발생시킬 수 있습니다. 인프라 환경에 따라 두 옵션과 그 조합을 테스트해보는 것을 권장합니다.
-
-- **liveSyncPort**:
-  - _유형_: `number`
-  - _기본값_: `4000`
-  - _설명_: 라이브 싱크 서버의 포트입니다.
-  - _예시_: `4000`
-  - _참고_: 라이브 싱크 서버의 포트입니다.
-
-- **liveSyncURL**:
-  - _유형_: `string`
-  - _기본값_: `'http://localhost:{liveSyncPort}'`
-  - _설명_: 라이브 싱크 서버의 URL입니다.
-  - _예시_: `'https://example.com'`
-  - _참고_: 기본적으로 localhost를 가리키지만 원격 라이브 싱크 서버의 경우 어떤 URL로도 변경할 수 있습니다.
-
-### 미들웨어 설정
-
-애플리케이션이 쿠키, 헤더 및 로케일 관리를 위한 URL 접두사를 처리하는 방식을 제어하는 설정입니다.
-
-#### 속성
-
-- **headerName**:
-  - _유형_: `string`
-  - _기본값_: `'x-intlayer-locale'`
-  - _설명_: 로케일을 결정하는 데 사용되는 HTTP 헤더의 이름입니다.
-  - _예시_: `'x-custom-locale'`
-  - _참고_: API 기반 로케일 결정에 유용합니다.
-
-- **cookieName**:
-  - _유형_: `string`
-  - _기본값_: `'intlayer-locale'`
-  - _설명_: 로케일을 저장하는 데 사용되는 쿠키의 이름입니다.
-  - _예시_: `'custom-locale'`
-  - _참고_: 세션 간 로케일을 유지하는 데 사용됩니다.
-
-- **prefixDefault**:
-  - _유형_: `boolean`
-  - _기본값_: `false`
-  - _설명_: 기본 로케일을 URL에 포함할지 여부입니다.
-  - _예시_: `true`
-  - _참고_:
-    - `true`이고 `defaultLocale = 'en'`인 경우: 경로 = `/en/dashboard` 또는 `/fr/dashboard`
-    - `false`이고 `defaultLocale = 'en'`인 경우: 경로 = `/dashboard` 또는 `/fr/dashboard`
-
-- **basePath**:
-  - _유형_: `string`
-  - _기본값_: `''`
-  - _설명_: 애플리케이션 URL의 기본 경로입니다.
-  - _예시_: `'/my-app'`
-  - _참고_:
-    - 애플리케이션이 `https://example.com/my-app`에 호스팅되는 경우
-    - 기본 경로는 `'/my-app'`입니다.
-    - URL은 `https://example.com/my-app/en`이 됩니다.
-    - 기본 경로가 설정되지 않은 경우, URL은 `https://example.com/en`이 됩니다.
-
-- **rewrite**:
-  - _유형_: `Record<string, StrictModeLocaleMap<string>>`
-  - _기본값_: `undefined`
-  - _설명_: 특정 경로에 대한 기본 라우팅 모드를 재정의하는 사용자 정의 URL 재작성 규칙. 표준 라우팅 동작과 다른 언어별 경로를 정의할 수 있습니다. `[param]` 구문을 사용한 동적 라우트 매개변수를 지원합니다.
-  - _예시_:
-    ```typescript
-    routing: {
-      mode: "prefix-no-default", // 폴백 전략
-      rewrite: nextjsRewrite({
-        "/[locale]/about": {
-          en: "/[locale]/about",
-          fr: "/[locale]/a-propos",
-        },
-        "/[locale]/product/[slug]": {
-          en: "/[locale]/product/[slug]",
-          fr: "/[locale]/produit/[slug]",
-        },
-        "/[locale]/blog/[category]/[id]": {
-          en: "/[locale]/blog/[category]/[id]",
-          fr: "/[locale]/journal/[category]/[id]",
-        },
-      }),
-    }
-    ```
-  - _참고_: 재작성 규칙은 기본 `mode` 동작보다 우선순위가 높습니다. 경로가 재작성 규칙과 일치하는 경우, 표준 언어 접두사 대신 재작성 구성의 지역화된 경로가 사용됩니다.
-  - _참고_: 동적 라우트 매개변수는 대괄호 표기법(예: `[slug]`, `[id]`)을 사용하여 지원됩니다. 매개변수 값은 URL에서 자동으로 추출되어 재작성된 경로에 보간됩니다.
-  - _참고_: Next.js 및 Vite 애플리케이션에서 작동합니다. 미들웨어/프록시는 내부 라우트 구조와 일치하도록 들어오는 요청을 자동으로 재작성합니다.
-  - _참고_: `getLocalizedUrl()`로 URL을 생성할 때, 제공된 경로와 일치하는 경우 재작성 규칙이 자동으로 적용됩니다.
-  - _참조_: 자세한 내용은 [사용자 정의 URL 재작성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/custom_url_rewrites.md)을 참조하세요.
-
-- **serverSetCookie**:
-  - _유형_: `string`
-  - _기본값_: `'always'`
-  - _설명_: 서버에서 로케일 쿠키를 설정하는 규칙입니다.
-  - _옵션_: `'always'`, `'never'`
-  - _예시_: `'never'`
-  - _참고_: 로케일 쿠키를 모든 요청마다 설정할지 또는 전혀 설정하지 않을지를 제어합니다.
-
-- **noPrefix**:
-  - _유형_: `boolean`
-  - _기본값_: `false`
-  - _설명_: URL에서 로케일 접두사를 생략할지 여부입니다.
-  - _예시_: `true`
-  - _참고_:
-    - `true`인 경우: URL에 접두사가 없습니다.
-    - `false`인 경우: URL에 접두사가 있습니다.
-    - `basePath = '/my-app'`인 경우 예시:
-      - `noPrefix = false`인 경우: URL은 `https://example.com/my-app/en`이 됩니다.
-      - `noPrefix = true`인 경우: URL은 `https://example.com`이 됩니다.
+### AI 설정 (AI Configuration)
+
+번역 구축과 같은 Intlayer의 AI 기반 기능에 대한 설정을 정의합니다.
+
+| 필드                 | 유형                   | 설명                                                       | 예시                                        | 참고                                                                                    |
+| -------------------- | ---------------------- | ---------------------------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------- |
+| `provider`           | `string`               | 사용할 AI 제공업체.                                        | `'openai'`, `'anthropic'`, `'googlevertex'` |                                                                                         |
+| `model`              | `string`               | 사용할 AI 모델.                                            | `'gpt-4o'`, `'claude-3-5-sonnet-20240620'`  |                                                                                         |
+| `apiKey`             | `string`               | 선택한 제공업체의 API 키.                                  | `process.env.OPENAI_API_KEY`                |                                                                                         |
+| `applicationContext` | `string`               | AI 번역 정확도를 높이기 위한 앱에 대한 추가 컨텍스트.      | `'어린이를 위한 학습 플랫폼.'`              |                                                                                         |
+| `baseURL`            | `string`               | API 호출을 위한 선택적 기본 URL.                           |                                             | 프록시 또는 로컬 AI 배포를 사용하는 경우 유용합니다.                                    |
+| `dataSerialization`  | `'json' &#124; 'toon'` | 데이터를 AI로 전송하는 방법을 정의합니다. 기본값: `'json'` | `'json'`                                    | `'json'`: 더 견고하고 정확함. `'toon'`: 토큰을 적게 소모하지만 안정성이 떨어질 수 있음. |
 
 ---
 
-### 콘텐츠 구성
-
-애플리케이션 내 콘텐츠 처리와 관련된 설정으로, 디렉터리 이름, 파일 확장자 및 파생 구성 등을 포함합니다.
-
-#### 속성
-
-- **autoFill**:
-  - _유형_: `boolean | string | FilePathPattern | { [key in Locales]?: string }`
-  - _기본값_: `undefined`
-  - _설명_: AI를 사용하여 콘텐츠를 자동으로 채우는 방식을 지정합니다. `intlayer.config.ts` 파일에서 전역으로 선언할 수 있습니다.
-  - _예시_: true
-  - _예시_: `'./{{fileName}}.content.json'`
-  - _예시_: `{ fr: './{{fileName}}.fr.content.json', es: './{{fileName}}.es.content.json' }`
-  - _참고_: 자동 채우기 설정은 다음과 같이 구성할 수 있습니다:
-    - boolean: 모든 로케일에 대해 자동 채우기 활성화
-    - string: 단일 파일 경로나 변수 템플릿 경로
-    - object: 로케일별 파일 경로
-
-- **watch**:
-  - _타입_: `boolean`
-  - _기본값_: `process.env.NODE_ENV === 'development'`
-  - _설명_: Intlayer가 앱 내 콘텐츠 선언 파일의 변경 사항을 감지하여 관련 사전을 재빌드할지 여부를 나타냅니다.
-
-- **fileExtensions**:
-  - _타입_: `string[]`
-  - _기본값_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
-  - _설명_: 사전을 빌드할 때 찾을 파일 확장자들입니다.
-  - _예시_: `['.data.ts', '.data.js', '.data.json']`
-  - _참고_: 파일 확장자를 사용자 정의하면 충돌을 방지할 수 있습니다.
-
-- **dictionaryOutput**:
-  - _유형_: `string[]`
-  - _기본값_: `['intlayer']`
-  - _설명_: 사용할 사전 출력 유형입니다. 예: `'intlayer'` 또는 `'i18next'`.
-
-- **contentDir**:
-  - _유형_: `string[]`
-  - _기본값_: `['.']`
-  - _예시_: `['src', '../../ui-library', require.resolve("@my-package/content")]`
-  - _설명_: 콘텐츠 정의 파일（`.content.*`）이 저장된 디렉토리 경로입니다.
-  - _참고_: 사전을 다시 빌드하기 위해 콘텐츠 파일을 감시하는 데 사용됩니다.
-
-- **codeDir**:
-  - _유형_: `string[]`
-  - _기본값_: `['.']`
-  - _예시_: `['src', '../../ui-library']`
-  - _설명_: 코드가 저장된 디렉토리 경로입니다（기본 디렉토리 기준 상대 경로）。
-  - _참고_: 코드 파일을 변환（정리, 최적화）하기 위해 감시하는 데 사용됩니다. 이를 `contentDir`와 분리해 두면 콘텐츠 파일의 불필요한 스캔을 피해 빌드 성능을 향상시킬 수 있습니다.
-
-- **dictionariesDir**:
-  - _타입_: `string`
-  - _기본값_: `'.intlayer/dictionaries'`
-  - _설명_: 중간 결과나 출력 결과를 저장하는 디렉토리 경로입니다.
-
-- **moduleAugmentationDir**:
-  - _타입_: `string`
-  - _기본값_: `'.intlayer/types'`
-  - _설명_: 모듈 확장을 위한 디렉토리로, IDE의 더 나은 제안과 타입 검사를 가능하게 합니다.
-  - _예시_: `'intlayer-types'`
-  - _참고_: 반드시 `tsconfig.json`에 포함시켜야 합니다.
-
-- **unmergedDictionariesDir**:
-  - _타입_: `string`
-  - _기본값_: `'.intlayer/unmerged_dictionary'`
-  - _설명_: 병합되지 않은 사전을 저장하는 디렉토리입니다.
-  - _예시_: `'translations'`
-
-- **dictionariesDir**:
-  - _유형_: `string`
-  - _기본값_: `'.intlayer/dictionary'`
-  - _설명_: 지역화 사전을 저장하는 디렉토리입니다.
-  - _예시_: `'translations'`
-
-- **i18nextResourcesDir**:
-  - _유형_: `string`
-  - _기본값_: `'i18next_dictionary'`
-  - _설명_: i18n 사전을 저장하는 디렉토리입니다.
-  - _예시_: `'translations'`
-  - _참고_: 이 디렉토리가 i18next 출력 유형에 맞게 구성되어 있는지 확인하세요.
-
-- **typesDir**:
-  - _유형_: `string`
-  - _기본값_: `'types'`
-  - _설명_: 사전 타입을 저장하는 디렉토리입니다.
-  - _예시_: `'intlayer-types'`
-
-- **mainDir**:
-  - _유형_: `string`
-  - _기본값_: `'main'`
-  - _설명_: 주요 애플리케이션 파일이 저장되는 디렉토리입니다.
-  - _예시_: `'intlayer-main'`
-
-- **excludedPath**:
-  - _유형_: `string[]`
-  - _기본값_: `['node_modules']`
-  - _설명_: 콘텐츠 검색에서 제외할 디렉토리 목록입니다.
-  - _참고_: 이 설정은 아직 사용되지 않았으며, 향후 구현될 예정입니다.
+### 빌드 설정 (Build Configuration)
+
+Intlayer 빌드 프로세스 및 최적화 설정.
+
+| 필드           | 유형                     | 설명                                                                                                 | 예시 | 참고 |
+| -------------- | ------------------------ | ---------------------------------------------------------------------------------------------------- | ---- | ---- |
+| `mode`         | `'auto' &#124; 'manual'` | 앱의 프리빌드 단계에서 Intlayer가 자동으로 실행되어야 하는지 여부를 나타냅니다. 기본값: `'auto'`     |      |      |
+| `optimize`     | `boolean`                | 컴파일된 딕셔너리가 런타임에 최적화되어야 하는지 여부를 나타냅니다. 기본값: 프로덕션 환경에서 `true` |      |      |
+| `outputFormat` | `('cjs' &#124; 'esm')[]` | 생성된 딕셔너리 파일의 출력 형식. 기본값: `['cjs', 'esm']`                                           |      |      |
+| `checkTypes`   | `boolean`                | Intlayer가 생성된 파일의 유형을 확인해야 하는지 여부를 나타냅니다. 기본값: `false`                   |      |      |
 
 ---
 
-### 시스템 구성
+### 시스템 설정 (System Configuration)
 
-Intlayer의 내부 경로 및 출력 결과와 관련된 설정입니다. 이러한 설정은 일반적으로 내부적이며 사용자가 수정할 필요가 없습니다.
+이 설정은 고급 사용 사례 및 Intlayer의 내부 구성을 위한 것입니다.
 
-#### 속성
+| 필드                      | 유형     | 설명                             | 기본값                            |
+| ------------------------- | -------- | -------------------------------- | --------------------------------- |
+| `dictionariesDir`         | `string` | 컴파일된 딕셔너리 디렉토리.      | `'.intlayer/dictionary'`          |
+| `moduleAugmentationDir`   | `string` | TypeScript 모듈 확장 디렉토리.   | `'.intlayer/types'`               |
+| `unmergedDictionariesDir` | `string` | 병합되지 않은 딕셔너리 디렉토리. | `'.intlayer/unmerged_dictionary'` |
+| `typesDir`                | `string` | 생성된 유형 디렉토리.            | `'.intlayer/types'`               |
+| `mainDir`                 | `string` | 메인 Intlayer 파일 디렉토리.     | `'.intlayer/main'`                |
+| `configDir`               | `string` | 컴파일된 설정 파일 디렉토리.     | `'.intlayer/config'`              |
+| `cacheDir`                | `string` | 캐시 파일 디렉토리.              | `'.intlayer/cache'`               |
 
-- **baseDir**:
-  - _유형_: `string`
-  - _기본값_: `process.cwd()`
-  - _설명_: 프로젝트의 기본 디렉토리입니다.
-  - _예시_: `'/path/to/project'`
-  - _참고_: 모든 Intlayer 관련 디렉토리를 해석하는 데 사용됩니다.
+---
 
-### 사전 구성
+### 컴파일러 설정 (Compiler Configuration)
 
-자동 채우기 동작 및 콘텐츠 생성을 포함하여 사전 작업을 제어하는 설정입니다.
+Intlayer 컴파일러 (`intlayer compiler`) 설정.
 
-이 사전 구성은 두 가지 주요 목적을 제공합니다:
+| 필드                  | 유형                     | 설명                                                                   | 기본값  |
+| --------------------- | ------------------------ | ---------------------------------------------------------------------- | ------- |
+| `enabled`             | `boolean`                | 컴파일러 활성화 여부를 나타냅니다.                                     | `false` |
+| `output`              | `string &#124; Function` | 추출된 딕셔너리의 출력 경로.                                           |         |
+| `saveComponents`      | `boolean`                | 원본 소스 파일을 변환된 버전으로 덮어쓸지 여부를 나타냅니다.           | `false` |
+| `noMetadata`          | `boolean`                | `true`인 경우 컴파일러는 생성된 파일에 메타데이터를 포함하지 않습니다. | `false` |
+| `dictionaryKeyPrefix` | `string`                 | 선택적 딕셔너리 키 접두사.                                             | `''`    |
 
-1. **기본값**: 콘텐츠 선언 파일을 생성할 때 기본값 정의
-2. **폴백 동작**: 특정 필드가 정의되지 않은 경우 폴백 값을 제공하여 사전 작업 동작을 전역적으로 정의할 수 있도록 함
+---
 
-콘텐츠 선언 파일 및 구성 값 적용 방법에 대한 자세한 내용은 [콘텐츠 파일 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)를 참조하세요.
+### 로거 설정 (Logger Configuration)
 
-#### 속성
+Intlayer 로그 출력 맞춤 설정을 위한 설정.
 
-- **fill**
-- **description**
-- **locale**
-- **location**
-- **priority**
-- **live**
-- **schema**
-- **title**
-- **tags**
-- **version**
+| 필드     | 유형                                           | 설명                | 기본값         |
+| -------- | ---------------------------------------------- | ------------------- | -------------- |
+| `mode`   | `'default' &#124; 'verbose' &#124; 'disabled'` | 로깅 모드.          | `'default'`    |
+| `prefix` | `string`                                       | 로그 메시지 접두사. | `'[intlayer]'` |
 
 ---
 
-### 로거 설정
-
-로거를 제어하는 설정으로, 사용할 접두사(prefix)를 포함합니다.
-
-#### 속성
-
-- **mode**:
-  - _유형_: `string`
-  - _기본값_: `default`
-  - _설명_: 로거의 모드를 나타냅니다.
-  - _옵션_: `default`, `verbose`, `disabled`
-  - _예시_: `default`
-  - _참고_: 로거의 모드입니다. verbose 모드는 더 많은 정보를 기록하지만 디버깅 목적으로 사용할 수 있습니다. disabled 모드는 로거를 비활성화합니다.
-
-- **prefix**:
-  - _유형_: `string`
-  - _기본값_: `'[intlayer] '`
-  - _설명_: 로거의 접두사입니다.
-  - _예시_: `'[my custom prefix] '`
-  - _참고_: 로거의 접두사입니다.
-
-### AI 구성
-
-Intlayer의 AI 기능을 제어하는 설정으로, 제공자(provider), 모델(model), API 키를 포함합니다.
-
-이 구성은 [Intlayer 대시보드](https://app.intlayer.org/project)에 액세스 키로 등록된 경우 선택 사항입니다. Intlayer는 귀하의 요구에 가장 효율적이고 비용 효과적인 AI 솔루션을 자동으로 관리합니다. 기본 옵션을 사용하면 Intlayer가 가장 적합한 모델을 지속적으로 업데이트하므로 장기적인 유지 관리가 더 용이합니다.
-
-자신의 API 키나 특정 모델을 사용하려는 경우, 사용자 정의 AI 구성을 정의할 수 있습니다.
-이 AI 구성은 Intlayer 환경 전반에 걸쳐 전역적으로 사용됩니다. CLI 명령어는 이 설정을 기본값으로 사용하며(예: `fill`), SDK, 비주얼 에디터, CMS에서도 동일하게 적용됩니다. 특정 사용 사례에 대해서는 명령어 매개변수를 사용하여 이러한 기본값을 재정의할 수 있습니다.
-
-Intlayer는 향상된 유연성과 선택권을 위해 여러 AI 공급자를 지원합니다. 현재 지원되는 공급자는 다음과 같습니다:
-
-- **OpenAI** (기본값)
-- **Anthropic Claude**
-- **Mistral AI**
-- **DeepSeek**
-- **Google Gemini**
-- **Meta Llama**
-- **Ollama**
-- **OpenRouter**
-- **Alibaba Cloud**
-- **Fireworks**
-- **Hugging Face**
-- **Groq**
-- **Amazon Bedrock**
-- **Google AI Studio**
-- **Google Vertex**
-- **Together.ai**
-- **ollama**
-
-#### 속성
-
-- **provider**:
-  - _유형_: `string`
-  - _기본값_: `'openai'`
-  - _설명_: Intlayer의 AI 기능에 사용할 공급자입니다.
-  - _옵션_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
-  - _예시_: `'anthropic'`
-  - _참고_: 서로 다른 공급자는 서로 다른 API 키와 가격 모델을 요구할 수 있습니다.
-
-- **model**:
-  - _유형_: `string`
-  - _기본값_: 없음
-  - _설명_: Intlayer의 AI 기능에 사용할 모델입니다.
-  - _예시_: `'gpt-4o-2024-11-20'`
-  - _참고_: 사용할 특정 모델은 공급자에 따라 다릅니다.
-
-- **temperature**:
-  - _유형_: `number`
-  - _기본값_: 없음
-  - _설명_: temperature는 AI 응답의 무작위성을 제어합니다.
-  - _예시_: `0.1`
-  - _참고_: 더 높은 temperature는 AI를 더 창의적이고 예측 불가능하게 만듭니다.
-
-- **apiKey**:
-  - _유형_: `string`
-  - _기본값_: 없음
-  - _설명_: 선택한 공급자에 대한 API 키입니다.
-  - _예시_: `process.env.OPENAI_API_KEY`
-  - _참고_: 중요: API 키는 비밀로 유지해야 하며 공개적으로 공유해서는 안 됩니다. 환경 변수와 같은 안전한 위치에 보관하시기 바랍니다.
-
-- **applicationContext**:
-  - _유형_: `string`
-  - _기본값_: 없음
-  - _설명_: AI 모델에 애플리케이션에 대한 추가 컨텍스트를 제공하여 더 정확하고 상황에 적합한 번역을 생성하도록 돕습니다. 여기에는 앱의 도메인, 대상 사용자, 톤 또는 특정 용어에 대한 정보가 포함될 수 있습니다.
-
-- **baseURL**:
-  - _유형_: `string`
-  - _기본값_: 없음
-  - _설명_: AI API의 기본 URL입니다.
-  - _예시_: `'https://api.openai.com/v1'`
-  - _참고_: 로컬 또는 사용자 정의 AI API 엔드포인트를 가리키는 데 사용할 수 있습니다.
-
-- **dataSerialization**:
-  - _타입_: `'json' | 'toon'`
-  - _기본값_: `'json'`
-  - _설명_: Intlayer의 AI 기능에 사용할 데이터 직렬화 형식.
-  - _예시_: `'toon'`
-  - _참고_: `json`: 표준적이고 신뢰할 수 있음; 더 많은 토큰을 사용함. `toon`: 토큰이 적게 들지만 JSON보다 일관성이 떨어짐.
-
-### 빌드 구성
-
-Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방식을 제어하는 설정입니다.
-
-빌드 옵션은 `@intlayer/babel` 및 `@intlayer/swc` 플러그인에 적용됩니다.
-
-> 개발 모드에서는 Intlayer가 사전을 정적 임포트하여 개발 경험을 단순화합니다.
-
-> 최적화 시, Intlayer는 청크 최적화를 위해 사전 호출을 대체하여 최종 번들이 실제로 사용되는 사전만 임포트하도록 합니다.
-
-#### 속성
-
-- **mode**:
-  - _타입_: `'auto' | 'manual'`
-  - _기본값_: `'auto'`
-  - _설명_: 빌드 모드를 제어합니다.
-  - _예시_: `'manual'`
-  - _참고_: 'auto'인 경우, 애플리케이션이 빌드될 때 빌드가 자동으로 활성화됩니다.
-  - _참고_: 'manual'인 경우, 빌드 명령이 실행될 때만 빌드가 설정됩니다.
-  - _참고_: 사전 빌드를 비활성화하는 데 사용할 수 있습니다. 예를 들어 Node.js 환경에서 실행을 피해야 하는 경우입니다.
-
-- **checkTypes**:
-  - _형식_: `boolean`
-  - _기본값_: `false`
-  - _설명_: 빌드가 TypeScript 유형을 확인하고 오류를 기록해야 하는지 여부를 나타냅니다.
-  - _참고_: 이로 인해 빌드 속도가 느려질 수 있습니다.
-
-- **optimize**:
-  - _타입_: `boolean`
-  - _기본값_: `process.env.NODE_ENV === 'production'`
-  - _설명_: 빌드를 최적화할지 여부를 제어합니다.
-  - _예시_: `true`
-  - _참고_: 활성화되면 Intlayer는 청크 최적화를 위해 모든 사전 호출을 대체합니다. 이렇게 하면 최종 번들은 사용되는 사전만 임포트합니다. 모든 임포트는 사전 로딩 시 비동기 처리를 피하기 위해 정적 임포트로 유지됩니다.
-  - _참고_: Intlayer는 `importMode` 옵션에 정의된 모드에 따라 모든 `useIntlayer` 호출을 대체하며, `getIntlayer`는 `getDictionary`로 대체합니다.
-  - _참고_: 이 옵션은 `@intlayer/babel` 및 `@intlayer/swc` 플러그인에 의존합니다.
-  - _참고_: `useIntlayer` 호출에서 모든 키가 정적으로 선언되어 있는지 확인하세요. 예: `useIntlayer('navbar')`.
-
-- **outputFormat**:
-  - _타입_: `'esm' | 'cjs'`
-  - _기본값_: `'esm'`
-  - _설명_: 사전의 출력 형식을 제어합니다.
-  - _예시_: `'cjs'`
-  - _참고_: 사전의 출력 형식입니다.
-
-- **traversePattern**:
-  - _유형_: `string[]`
-  - _기본값_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
-  - _설명_: 최적화 중에 탐색할 파일을 정의하는 패턴입니다.
-    - _예시_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
-  - _참고_: 최적화를 관련 코드 파일로 제한하여 빌드 성능을 향상시키는 데 사용합니다.
-  - _참고_: `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.
-  - _참고_: glob 패턴을 사용하세요.
+### 사용자 정의 스키마 (Custom Schemas)
+
+| 필드      | 유형                        | 설명                                                           |
+| --------- | --------------------------- | -------------------------------------------------------------- |
+| `schemas` | `Record<string, ZodSchema>` | 딕셔너리 구조를 검증하기 위한 Zod 스키마를 정의할 수 있습니다. |
 
 ---
 
-### 컴파일러 설정
-
-구성 요소에서 직접 사전을 추출하는 Intlayer 컴파일러를 제어하는 설정입니다.
-
-#### 속성
-
-- **enabled**:
-  - _타입_: `boolean | 'build-only'`
-  - _기본값_: `true`
-  - _설명_: 사전을 추출하기 위해 컴파일러를 활성화해야 하는지 여부를 나타냅니다.
-  - _예시_: `'build-only'`
-  - _참고_: `'build-only'`로 설정하면 개발 모드 동안 컴파일러를 건너뛰어 시작 시간을 단축합니다. 빌드 명령 시에만 실행됩니다.
-
-- **dictionaryKeyPrefix**:
-  - _타입_: `string`
-  - _기본값_: `''`
-  - _설명_: 추출된 사전 키의 접두사입니다.
-  - _예시_: `'my-key-'`
-  - _참고_: 사전을 추출할 때 파일 이름을 기반으로 키가 생성됩니다. 충돌을 방지하기 위해 생성된 키에 이 접두사가 추가됩니다.
-
-- **saveComponents**:
-  - _타입_: `boolean`
-  - _기본값_: `false`
-  - _설명_: 변환 후 구성 요소를 저장해야 하는지 여부를 나타냅니다.
-  - _참고_: true인 경우 컴파일러는 원본 파일을 변환된 파일로 대체합니다. 그렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
-
-- **transformPattern**:
-  - _타입_: `string | string[]`
-  - _기본값_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
-  - _설명_: 최적화 중에 탐색할 파일을 정의하는 패턴입니다.
-  - _예시_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
-  - _참고_: 최적화를 관련 코드 파일로 제한하여 빌드 성능을 향상시키는 데 사용합니다.
-
-- **excludePattern**:
-  - _타입_: `string | string[]`
-  - _기본값_: `['**/node_modules/**']`
-  - _설명_: 최적화 중에 제외할 파일을 정의하는 패턴입니다.
-  - _예시_: `['**/node_modules/**', '!**/node_modules/react/**']`
-
-- **output**:
-  - _형식_: `FilePathPattern`
-  - _기본값_: `undefined`
-  - _설명_: 출력 파일 경로를 정의합니다. `outputDir`을 대체합니다. 문자열 템플릿 또는 함수를 통해 동적 변수를 지원합니다. 지원되는 변수: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}`, `{{componentDirPath}}`.
-  - _참고_: `./` 경로는 구성 요소를 기준으로 해결됩니다. `/` 경로는 프로젝트 루트(`baseDir`)를 기준으로 해결됩니다.
-  - _참고_: 경로에 `{{locale}}` 변수를 포함하면 로케일별로 분리된 사전 생성이 활성화됩니다.
-  - _예시_:
-    - **구성 요소 옆에 다국어 파일 생성**:
-    - 문자열: `'./{{fileName}}{{extension}}'`
-    - 함수: `({ fileName, extension }) => \`./${fileName}${extension}\``
-
-    - **로케일별 중앙 집중식 JSON 출력**:
-    - 문자열: `'/locales/{{locale}}/{{key}}.content.json'`
-    - 함수: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
-
-- **noMetadata**:
-  - _형식_: `boolean`
-  - _기본값_: `false`
-  - _설명_: 메타데이터를 파일에 저장할지 여부를 나타냅니다. true인 경우 컴파일러는 사전의 메타데이터(키, 콘텐츠 래퍼)를 저장하지 않습니다. 로케일별 i18next 또는 ICU MessageFormat JSON 출력에 유용합니다.
-  - _참고_: `loadJSON` 플러그인과 함께 사용할 때 유용합니다.
-  - _예시_:
-    `true`인 경우:
-    ```json
-    {
-      "key": "value"
-    }
-    ```
-    `false`인 경우:
-    ```json
-    {
-      "key": "value",
-      "content": {
-        "key": "value"
-      }
-    }
-    ```
+### 플러그인 (Plugins)
+
+| 필드      | 유형               | 설명                             |
+| --------- | ------------------ | -------------------------------- |
+| `plugins` | `IntlayerPlugin[]` | 활성화할 Intlayer 플러그인 목록. |