@intlayer/docs 9.4.3 → 9.5.0

package/docs/ko/bundle_optimization.md

@@ -133,8 +133,6 @@ export default config;
 
 > 퍼지와 압축은 `next build`에서만 실행됩니다 — 최적화 파이프라인은 `next dev` 중에는 꺼져 있습니다.
 
-> 호환 어댑터 호출자가 설정된 경우에도 비활성화됩니다(`swcExtraCallers`, `@intlayer/next-intl`이나 `@intlayer/react-i18next` 같은 호환 패키지가 설정합니다). 이러한 호출 지점은 사용 분석기에 보이지 않으므로 퍼지하면 코드가 여전히 읽는 필드를 제거하게 됩니다. 임포트 재작성은 계속 활성 상태로 유지됩니다.
-
 **이전 버전(9.2.1 이전)** 에서는 `@intlayer/babel`과 `intlayerPurgeBabelPlugin` 및 `intlayerMinifyBabelPlugin`을 선언하는 `babel.config.js`가 필요했습니다. 이 파일은 더 이상 필요하지 않으며 삭제할 수 있습니다.
 
  </Tab>

package/docs/ko/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # Intlayer CLI - 다국어 웹사이트를 위한 모든 Intlayer CLI 명령어
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 패키지 설치
 
 npm을 사용하여 필요한 패키지를 설치합니다:

package/docs/ko/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Intlayer CLI 로그인 명령
 
----
-
 ## 설명
 
 `login` 명령은 Intlayer CLI에서 Intlayer CMS에 인증할 수 있게 해줍니다. 이 명령은 기본 브라우저를 자동으로 열어 인증 절차를 완료하고 Intlayer 서비스를 사용하기 위한 필요한 자격증명(Client ID 및 Client Secret)을 수신합니다.

package/docs/ko/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Intlayer 컴파일러 | i18n을 위한 자동화된 콘텐츠 추출
 description: Intlayer 컴파일러로 국제화 프로세스를 자동화하세요. Vite, Next.js 등에서 더 빠르고 효율적인 i18n을 위해 컴포넌트에서 직접 콘텐츠를 추출합니다.
 keywords:
@@ -68,7 +68,7 @@ author: aymericzip
 
 ## 사용법
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> 컴파일러를 연결하는 가장 빠른 방법은 대화형 설정입니다. `npx intlayer init --interactive`를 실행하고 **Compiler**를 선택하세요. Next.js와 Vite에서는 `compiler.enabled`가 설정되고 `compiler.output` 경로가 구성되면 자동으로 활성화됩니다.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > 독립형 `intlayerCompiler()` 플러그인은 고급 설정을 위해 여전히 내보내집니다. `intlayer()`와 함께 등록하는 것은 안전합니다 — 컴파일러는 자신을 중복 제거하고 한 번만 실행됩니다.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### 프레임워크 지원
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+Next.js에서 컴파일러는 번들러 로더인 `next-intlayer/extractor-loader`로 실행됩니다. `withIntlayer`가 Turbopack과 webpack **모두**에 등록하므로 `babel.config.js`를 작성할 필요가 없습니다.
+
+#### 설치
+
+```bash
+npm install @intlayer/babel
+```
+
+#### 구성
+
+설정할 것이 없습니다. `next.config.ts`가 `withIntlayer`를 거치는 한, `@intlayer/babel`을 설치하는 것만으로 로더가 등록됩니다:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+로더는 `next-swc-loader`보다 먼저 `.tsx` 및 `.jsx` 파일에서 실행되므로 원래의 JSX를 읽습니다. 컴포넌트에 선언된 콘텐츠는 `.content` 파일로 추출되며 파일이 컴파일될 때 `.intlayer`로 빌드됩니다.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Next.js 또는 Babel을 사용하는 다른 Webpack 기반 애플리케이션의 경우, `@intlayer/babel` 플러그인을 사용하여 컴파일러를 구성할 수 있습니다.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 이 구성은 컴포넌트 내에 선언된 콘텐츠가 자동으로 추출되어 빌드 과정 중에 사전 생성에 사용되도록 보장합니다.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/ko/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Intlayer 구성 파일을 사용하면 국제화(i18n), 미들웨어, 콘텐츠 관리 등 플러그인의 다양한 측면을 맞춤설정할 수 있습니다. 이 문서는 구성의 각 속성에 대한 자세한 설명을 제공합니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 구성 파일 지원
 
 Intlayer는 JSON, JS, MJS 및 TS 구성 파일 형식을 허용합니다:
@@ -143,8 +139,6 @@ Intlayer는 JSON, JS, MJS 및 TS 구성 파일 형식을 허용합니다:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## 구성 파일 예시
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -692,14 +686,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## 구성 참조
 
 다음 섹션에서는 Intlayer에서 사용 가능한 다양한 구성 설정에 대해 자세히 설명합니다.
 
----
-
 ### 국제화 구성 (Internationalization)
 
 사용 가능한 로케일과 애플리케이션의 기본 로케일을 포함하여 국제화와 관련된 설정을 정의합니다.
@@ -711,8 +701,6 @@ export default config;
 | `strictMode`      | TypeScript를 사용하여 국제화된 콘텐츠의 강력한 구현을 보장합니다. | `string`   | `'inclusive'`       |                      | • `"strict"`인 경우: `t` 함수는 선언된 모든 로케일이 정의되어야 하며, 누락되거나 선언되지 않은 경우 오류를 발생시킵니다.<br/>• `"inclusive"`인 경우: 로케일 누락 시 경고를 표시하지만, 선언되지 않은 로케일도 수용합니다.<br/>• `"loose"`인 경우: 존재하는 모든 로케일을 수용합니다. |
 | `defaultLocale`   | 요청된 로케일을 찾을 수 없을 때 폴백으로 사용되는 기본 로케일.    | `string`   | `Locales.ENGLISH`   | `'en'`               | URL, 쿠키 또는 헤더에 로케일이 지정되지 않은 경우 로케일을 결정하는 데 사용됩니다.                                                                                                                                                                                                   |
 
----
-
 ### 에디터 구성 (Editor)
 
 서버 포트 및 활성화 상태를 포함하여 시각적 에디터 설정을 정의합니다.
@@ -744,8 +732,6 @@ Intlayer 애널리틱스와 관련된 설정을 정의합니다: 사용자에게
 | `flushInterval` | 백엔드로 자동 일괄 전송하는 간격(밀리초).                           | `number`  | `20000` | `10000` |                                                                                                                                                                           |
 | `sampleRate`    | 기록할 세션의 비율, `0`(없음)에서 `1`(전체) 사이.                   | `number`  | `1`     | `0.5`   | 샘플링은 세션별로 결정적이므로, 기록된 세션은 자신의 모든 이벤트를 보고합니다(부분 퍼널 없음).                                                                            |
 
----
-
 ### 라우팅 구성 (Routing)
 
 URL 구조, 로케일 저장 및 미들웨어 처리를 포함하여 라우팅 동작을 제어하기 위한 설정입니다.
@@ -947,8 +933,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### 콘텐츠 구성 (Content)
 
 디렉토리 이름, 파일 확장자 및 파생된 구성을 포함하여 애플리케이션의 콘텐츠 관리를 위한 설정입니다.
@@ -962,8 +946,6 @@ export default config;
 | `excludedPath`   | 콘텐츠 스캔에서 제외할 디렉토리.                                                                    | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | 현재 사용되지 않으며 미래를 위해 계획되었습니다.                                                                                            |
 | `formatCommand`  | Intlayer가 파일 내용을 로컬에 작성할 때 콘텐츠 파일을 포맷팅하는 명령.                              | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}`은 파일 경로로 대체됩니다.<br/>• 정의되지 않은 경우 Intlayer는 자동으로 감지를 시도합니다(prettier, biome, eslint 테스트).      |
 
----
-
 ### 시스템 구성
 
 Intlayer의 내부 경로 및 출력 결과와 관련된 설정입니다. 이러한 설정은 일반적으로 내부용이며 사용자가 수정할 필요가 없습니다.
@@ -1018,8 +1000,6 @@ dictionary: {
 };
 ```
 
----
-
 ### 로거 구성 (Log)
 
 Intlayer 로그 출력 맞춤설정을 위한 설정입니다.
@@ -1090,8 +1070,6 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 | `outputFormat`        | 딕셔너리 출력 형식을 제어합니다.                                                              | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `traversePattern`     | 최적화 중에 스캔할 파일 패턴.                                                                 | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 최적화를 관련 파일로 제한하여 빌드 성능을 향상시킵니다.<br/>• `optimize`가 비활성화된 경우 무시됩니다.<br/>• glob 패턴을 사용합니다.                                                                                                                                                                                                                                                                                                                                  |
 
----
-
 ### 컴파일러 구성 (Compiler)
 
 컴포넌트에서 직접 딕셔너리를 수집하는 Intlayer 컴파일러의 설정을 제어합니다.
@@ -1111,8 +1089,6 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 | --------- | ------------------------------------------------------------------------ | --------------------------- |
 | `schemas` | 딕셔너리 콘텐츠 구조를 검증하기 위해 Zod 스키마를 정의할 수 있게 합니다. | `Record<string, ZodSchema>` |
 
----
-
 ### 플러그인 (Plugins)
 
 | 필드      | 설명                                 | 타입               |
@@ -1128,25 +1104,21 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 프로젝트 루트의 `package.json` 바로 옆에 위치해야 합니다. Intlayer는 `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` 및 JSON도 허용하므로 프로젝트에서 사용하는 모듈 시스템에 맞춰 자유롭게 선택할 수 있습니다.
 
 </Question>
-
 <Question title="i18n이 번들 크기에 얼마나 영향을 미치나요?">
 
 네임스페이스 기반 설정보다 훨씬 적습니다. 페이지는 렌더링하지 않는 언어의 카탈로그를 절대 다운로드하지 않기 때문입니다. 서버 렌더링 마크업은 서버에서 콘텐츠를 확인하고, 빌드 타임 컴파일러는 `useIntlayer` 호출을 컴포넌트가 사용하는 정확한 사전 항목으로 대체하므로 사용되지 않는 키와 언어는 제거됩니다. [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)을 통해 로케일별로 분할됩니다. 일반적인 대안들과 비교했을 때 Intlayer는 번들 및 페이지 크기를 최대 50%까지 줄여줍니다. [번들 최적화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)와 [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)를 참조하세요.
 
 </Question>
-
 <Question title="컴포넌트를 다시 작성하지 않고 i18next, next-intl 또는 react-i18next에서 마이그레이션할 수 있나요?">
 
 네, 두 가지 방법이 있습니다. [i18next 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_i18next_to_intlayer.md) 또는 [next-intl 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_next-intl_to_intlayer.md)를 따라 점진적으로 이전할 수 있습니다. 또는 현재 API를 완전히 유지할 수도 있습니다: [호환 어댑터(compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)는 `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` 및 `Lingui`와 완전히 동일한 API를 노출하면서 Intlayer 사전에서 데이터를 제공하므로, import 구문만 변경하고 컴포넌트 코드는 그대로 유지할 수 있습니다.
 
 </Question>
-
 <Question title="기존 JSON 번역 파일을 유지할 수 있나요?">
 
 네. [sync JSON 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-json.md)은 `/messages/{locale}/{namespace}.json` 파일을 단일 진실 공급원(source of truth)으로 유지하면서 양방향으로 Intlayer 사전을 생성합니다. [sync PO 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-po.md)은 gettext 카탈로그에 대해 동일한 작업을 수행하며, [로케일별 파일](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/per_locale_file.md)을 통해 로케일을 한 파일에 모으는 대신 언어별로 콘텐츠를 분할할 수도 있습니다.
 
 </Question>
-
 <Question title="콘텐츠를 키 단위로 하나씩 옮겨야 하나요?">
 
 아닙니다. `npx intlayer extract`를 실행하면 Intlayer가 소스 파일을 읽고 사용자 대면 문자열을 추출하여 각 컴포넌트 옆에 `.content` 파일을 생성하므로 카탈로그에 일일이 복사할 필요 없이 diff만 검토하면 됩니다. [extract 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)을 참조하세요.
@@ -1154,7 +1126,6 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 완전 자동화된 파이프라인을 위해 [Intlayer 컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md)는 빌드 타임에 JSX, TSX, Vue 및 Svelte 소스에서 동일한 작업을 수행하여 변경될 때마다 사전을 생성하고 HMR을 통해 동기화하므로 수동으로 키를 관리할 필요가 없습니다. 정적 분석으로 작동하므로 런타임에만 존재하는 문자열은 제외되며, 사용자 텍스트와 애플리케이션 로직을 구분하기 위해 몇 가지 주석이 필요합니다.
 
 </Question>
-
 <Question title="사용 가능한 에디터 및 AI 에이전트 도구는 무엇이 있나요?">
 
 5가지 도구가 모두 선택 사항으로 제공됩니다:
@@ -1166,49 +1137,41 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 - **[ESLint 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/eslint.md)**: `no-raw-text` 규칙으로 하드코딩된 문자열을 표시하고, 정적 사전 키 및 사용되지 않는 콘텐츠에 대한 추가 규칙을 제공합니다.
 
 </Question>
-
 <Question title="앱에 새로운 언어를 어떻게 추가하나요?">
 
 `internationalization.locales`에 새 로케일을 추가한 다음 `npx intlayer fill`을 실행하여 기존 콘텐츠를 번역하세요. 생성된 타입이 동시에 업데이트되므로 새 로케일이 누락된 콘텐츠 파일은 조용한 폴백 대신 컴파일 타입 오류가 되어 즉시 감지할 수 있습니다.
 
 </Question>
-
 <Question title="URL에서 로케일 접두사를 어떻게 제거하나요?">
 
 `routing.mode`를 설정하세요. 기본값 `"prefix-no-default"`는 기본 로케일에 대해 `/about`을, 다른 로케일에 대해 `/ko/about`을 제공합니다. `"prefix-all"`은 모든 로케일에 접두사를 붙입니다. `"no-prefix"`는 경로에서 로케일을 완전히 제거하고 쿠키, 헤더 또는 도메인에서 로케일을 확인합니다. `"search-params"`는 쿼리 문자열에 `/about?locale=ko`와 같이 추가합니다.
 
 </Question>
-
 <Question title="각 언어를 자체 도메인에서 제공할 수 있나요?">
 
 네. `routing.domains`를 통해 로케일을 호스트 이름에 매핑할 수 있습니다(예: `{ ko: 'example.co.kr', en: 'example.com' }`). 도메인이 로케일을 식별하므로 경로에 접두사가 추가되지 않으며, `getLocalizedUrl`은 올바른 도메인의 절대 URL을 반환합니다.
 
 </Question>
-
 <Question title="사용자의 언어는 어떻게 감지되나요?">
 
 `routing.storage`를 통해 확인하며, 일반적으로 URL, 쿠키, `Accept-Language` 헤더 순으로 읽을 소스 목록을 지정합니다. 사용자가 명시적으로 선택한 언어는 저장되므로 다음 방문 시 우선 적용됩니다.
 
 </Question>
-
 <Question title="routing.enableProxy는 어떤 역할을 하나요?">
 
 접두사를 확인하고 리디렉션하는 미들웨어인 로케일 라우팅 프록시를 제어합니다. 설정하지 않은 경우 프록시가 실행되지만 개발 및 미리보기 서버는 리디렉션 소스로서 저장된 로케일을 무시하여 테스트하지 않는 언어로 튕겨 나가는 현상을 방지합니다. 프로덕션 환경은 `true`인 것처럼 작동합니다. 로케일 라우팅을 직접 처리하려면 `false`로 설정하세요.
 
 </Question>
-
 <Question title="importMode static, dynamic, fetch의 차이점은 무엇인가요?">
 
 기본값인 `"static"`은 사전을 정적으로 가져와 함께 번들링되고 동기식으로 읽힙니다. `"dynamic"`은 Suspense를 통해 가져오므로 컴포넌트가 렌더링할 때만 해당 로케일이 다운로드되어 대용량 콘텐츠에 이상적입니다. `"fetch"`는 실시간 동기화 API에서 사전을 검색하고 실패 시 `"dynamic"`으로 폴백합니다. [번들 최적화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)와 [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)을 참조하세요.
 
 </Question>
-
 <Question title="자동 번역을 위한 AI 제공업체 및 API 키는 어디에 설정하나요?">
 
 구성 파일 내에서 설정하거나 커맨드라인에서 `--provider`, `--model`, `--api-key` 플래그로 지정할 수 있습니다. 키는 완전히 사용자 소유로 유지됩니다. 번역 호출은 로컬 머신 또는 CI 러너에서 선택한 제공업체로 직접 전송되므로 어떠한 제3자도 거치지 않습니다. [fill 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md)을 참조하세요.
 
 </Question>
-
 <Question title="구성을 변경한 후 개발 서버를 다시 시작해야 하나요?">
 
 대부분의 경우 필요하지 않습니다. Intlayer 감시자(watcher)는 `intlayer.config.ts` 자체를 감시합니다: 저장 시 구성을 다시 로드하고 사전을 다시 준비하므로 로케일을 추가하거나 라우팅 모드를 변경하는 것도 콘텐츠 변경처럼 자동으로 반영됩니다. 단, 시스템 환경에 따라 캐시될 수 있으므로 변경 사항이 보이지 않을 경우 앱을 다시 시작하는 것이 좋습니다.

package/docs/ko/dictionary/html.md

@@ -119,8 +119,6 @@ const myContent = html(
 
 HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트는 `html()` 함수에 제공된 정의(사용 가능한 경우)에 따라 확인됩니다.
 
----
-
 ## HTML 렌더링
 
 렌더링은 Intlayer의 콘텐츠 시스템을 통해 자동으로 처리하거나, 전문 도구를 사용해 수동으로 처리할 수 있습니다.
@@ -474,8 +472,6 @@ HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트
   </Tab>
 </Tabs>
 
----
-
 ### 수동 렌더링 및 고급 도구
 
 원시 HTML 문자열을 렌더링하거나 컴포넌트 매핑을 더 세밀하게 제어해야 하는 경우, 다음 도구들을 사용하세요.
@@ -649,8 +645,6 @@ HTML 노드에서 `.use()` 메서드를 사용할 때, 제공하는 컴포넌트
   </Tab>
 </Tabs>
 
----
-
 ## 옵션 참조
 
 이 옵션들은 `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer`, 및 `renderHTML`에 전달할 수 있습니다.

package/docs/ko/dictionary/markdown.md

@@ -1172,8 +1172,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## 서버 사이드 렌더링 (SSR) 및 하이드레이션
 
 remark / rehype와 같은 다른 마크다운 파서와 비교할 때, Intlayer 마크다운은 의존성이 없으며 클라이언트와 서버 사이드 모두에서 실행됩니다.

package/docs/ko/how_works_intlayer.md

@@ -269,25 +269,21 @@ Express를 기반으로 한 서버는 시각적 편집기 요청을 수신하고
 빌드 타임에 빌드됩니다. 번들러 플러그인 또는 `npx intlayer build`가 `.content.ts` 파일을 스캔하여 `.intlayer` 폴더에 사전으로 컴파일하고 해당하는 TypeScript 타입을 생성합니다. 런타임 시 컴포넌트는 결과물만 읽으므로 요청 경로에서 파싱이나 파일 로딩이 전혀 발생하지 않습니다.
 
 </Question>
-
 <Question title="i18n이 번들 크기에 얼마나 영향을 미치나요?">
 
 네임스페이스 기반 설정보다 훨씬 적습니다. 페이지는 렌더링하지 않는 언어의 카탈로그를 절대 다운로드하지 않기 때문입니다. 서버 렌더링 마크업은 서버에서 콘텐츠를 확인하고, 빌드 타임 컴파일러는 `useIntlayer` 호출을 컴포넌트가 사용하는 정확한 사전 항목으로 대체하므로 사용되지 않는 키와 언어는 제거됩니다. [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)을 통해 로케일별로 분할됩니다. 일반적인 대안들과 비교했을 때 Intlayer는 번들 및 페이지 크기를 최대 50%까지 줄여줍니다. [번들 최적화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)와 [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)를 참조하세요.
 
 </Question>
-
 <Question title="컴포넌트를 다시 작성하지 않고 i18next, next-intl 또는 react-i18next에서 마이그레이션할 수 있나요?">
 
 네, 두 가지 방법이 있습니다. [i18next 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_i18next_to_intlayer.md) 또는 [next-intl 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_next-intl_to_intlayer.md)를 따라 점진적으로 이전할 수 있습니다. 또는 현재 API를 완전히 유지할 수도 있습니다: [호환 어댑터(compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)는 `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` 및 `Lingui`와 완전히 동일한 API를 노출하면서 Intlayer 사전에서 데이터를 제공하므로, import 구문만 변경하고 컴포넌트 코드는 그대로 유지할 수 있습니다.
 
 </Question>
-
 <Question title="기존 JSON 번역 파일을 유지할 수 있나요?">
 
 네. [sync JSON 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-json.md)은 `/messages/{locale}/{namespace}.json` 파일을 단일 진실 공급원(source of truth)으로 유지하면서 양방향으로 Intlayer 사전을 생성합니다. [sync PO 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-po.md)은 gettext 카탈로그에 대해 동일한 작업을 수행하며, [로케일별 파일](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/per_locale_file.md)을 통해 로케일을 한 파일에 모으는 대신 언어별로 콘텐츠를 분할할 수도 있습니다.
 
 </Question>
-
 <Question title="콘텐츠를 키 단위로 하나씩 옮겨야 하나요?">
 
 아닙니다. `npx intlayer extract`를 실행하면 Intlayer가 소스 파일을 읽고 사용자 대면 문자열을 추출하여 각 컴포넌트 옆에 `.content` 파일을 생성하므로 카탈로그에 일일이 복사할 필요 없이 diff만 검토하면 됩니다. [extract 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)을 참조하세요.
@@ -295,7 +291,6 @@ Express를 기반으로 한 서버는 시각적 편집기 요청을 수신하고
 완전 자동화된 파이프라인을 위해 [Intlayer 컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md)는 빌드 타임에 JSX, TSX, Vue 및 Svelte 소스에서 동일한 작업을 수행하여 변경될 때마다 사전을 생성하고 HMR을 통해 동기화하므로 수동으로 키를 관리할 필요가 없습니다. 정적 분석으로 작동하므로 런타임에만 존재하는 문자열은 제외되며, 사용자 텍스트와 애플리케이션 로직을 구분하기 위해 몇 가지 주석이 필요합니다.
 
 </Question>
-
 <Question title="사용 가능한 에디터 및 AI 에이전트 도구는 무엇이 있나요?">
 
 5가지 도구가 모두 선택 사항으로 제공됩니다:
@@ -307,43 +302,36 @@ Express를 기반으로 한 서버는 시각적 편집기 요청을 수신하고
 - **[ESLint 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/eslint.md)**: `no-raw-text` 규칙으로 하드코딩된 문자열을 표시하고, 정적 사전 키 및 사용되지 않는 콘텐츠에 대한 추가 규칙을 제공합니다.
 
 </Question>
-
 <Question title=".intlayer 폴더는 무엇이며 Git에 커밋해야 하나요?">
 
 컴파일된 사전과 생성된 타입이 포함된 생성 출력 디렉토리입니다. 콘텐츠 파일로부터 유도되므로 `dist` 폴더와 마찬가지로 `.gitignore`에 등록하고 빌드 단계에서 다시 생성해야 합니다.
 
 </Question>
-
 <Question title="활성 로케일은 어떻게 결정되나요?">
 
 `routing.storage`에 나열된 순서대로 소스를 읽어 결정됩니다: `routing.mode`에서 접두사를 사용하는 경우의 URL 접두사, 쿠키, `Accept-Language` 헤더, 기본 로케일 순입니다. 사용자가 명시적으로 선택한 로케일은 저장되어 다음 방문 시에도 유지됩니다. [설정 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
 
 </Question>
-
 <Question title="로컬 사전과 원격 사전의 차이점은 무엇인가요?">
 
 로컬 사전은 코드베이스에 선언되어 애플리케이션과 함께 컴파일됩니다. 원격 사전은 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)에서 관리되고 런타임에 확인되므로 배포 없이도 변경될 수 있습니다. 둘 다 동일한 훅을 통해 읽히며, 원격 콘텐츠를 사용할 수 없는 경우 로컬 선언으로 원활하게 폴백됩니다.
 
 </Question>
-
 <Question title="Intlayer는 TypeScript 없이도 작동하나요?">
 
 네. 콘텐츠 파일은 TypeScript, JavaScript, ESM, CommonJS 또는 JSON으로 작성할 수 있습니다. TypeScript는 생성된 타입과 자동 완성을 활성화하므로 권장되지만 필수는 아닙니다.
 
 </Question>
-
 <Question title="서버 렌더링과 클라이언트 렌더링이 동일한 콘텐츠를 어떻게 공유하나요?">
 
 서버는 서버 렌더링된 컴포넌트의 콘텐츠를 직접 확인하므로 해당 마크업에 대해 클라이언트로 사전이 전송되지 않습니다. 클라이언트 컴포넌트는 서버에서 확인된 로케일을 수신하는 프로바이더를 통해 동일한 사전을 읽으므로, 첫 번째 클라이언트 렌더링이 서버 HTML과 일치하여 다른 언어로 깜빡이는 현상(flash)이 발생하지 않습니다.
 
 </Question>
-
 <Question title="Intlayer는 로케일로 인한 하이드레이션 불일치(hydration mismatch)를 어떻게 방지하나요?">
 
 로케일은 브라우저에서 다시 감지되는 대신 서버에서 한 번 확인되어 프로바이더로 전달됩니다. 클라이언트는 서버가 렌더링한 것과 동일한 로케일에서 시작하므로 마크업이 정확히 일치하여 클라이언트 측 로케일 감지에서 흔히 발생하는 문제가 해결됩니다.
 
 </Question>
-
 <Question title="번역을 추가할 때 다시 빌드해야 하나요?">
 
 개발 환경에서는 필요하지 않습니다. 플러그인이 콘텐츠 파일을 감시하고 저장 시 영향을 받는 사전을 자동으로 다시 빌드합니다. 프로덕션 환경에서는 사전이 빌드의 일부가 되지만, 원격 콘텐츠인 경우 [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md) 및 [실시간 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md)를 통해 배포 없이 변경 사항을 적용할 수 있습니다.

package/docs/ko/interest_of_intlayer.md

@@ -44,43 +44,36 @@ author: aymericzip
 페이지에 대용량 JSON 파일을 로드하는 대신, 꼭 필요한 콘텐츠만 로드합니다. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄이는 데** 기여합니다.
 
 </Accordion>
-
 <Accordion header="유지보수성">
 
 애플리케이션 콘텐츠의 범위를 컴포넌트 단위로 분할하여 **대규모 애플리케이션의 유지보수를 원활하게** 합니다. 전체 콘텐츠 코드베이스를 전부 검토해야 하는 인지적 부담 없이 단일 기능 폴더를 간편하게 복제하거나 삭제할 수 있습니다. 또한, Intlayer는 **완전한 타입 지원**을 통해 콘텐츠 선언의 정확성을 보장합니다.
 
 </Accordion>
-
 <Accordion header="AI 에이전트">
 
 콘텐츠 선언을 컴포넌트와 동일한 위치에 두는 것(Co-location)은 대형 언어 모델(LLM)에 필요한 **콘텍스트 크기를 크게 줄여줍니다**. Intlayer는 번역 누락을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구를 지원하여 AI 에이전트를 위한 개발자 경험(DX)을 더욱 매끄럽게 만듭니다.
 
 </Accordion>
-
 <Accordion header="기능성">
 
 Intlayer는 다른 i18n 솔루션에는 없는 [Markdown 지원](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md), [외부 콘텐츠 가져오기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md), [파일 콘텐츠 로드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md), [실시간 콘텐츠 업데이트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md), [비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md) 등 폭넓은 추가 기능을 제공합니다.
 
 </Accordion>
-
 <Accordion header="자동화">
 
 CI/CD 파이프라인에서 원하는 LLM을 사용하여 AI 제공업체의 직접 비용 수준으로 손쉽게 자동 번역을 적용할 수 있습니다. Intlayer는 콘텐츠 추출을 자동화하는 **컴파일러**와 함께 **백그라운드에서 편리하게 번역할 수 있는** [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
 
 </Accordion>
-
 <Accordion header="성능">
 
 대규모 JSON 파일을 컴포넌트에 직접 연결하는 작업은 성능 저하와 반응성 문제를 초래할 수 있습니다. Intlayer는 빌드 시점에 콘텐츠 로드를 최적화하여 이를 해결합니다.
 
 </Accordion>
-
 <Accordion header="비개발 팀과의 협업 확장">
 
 단순한 i18n 솔루션 이상의 가치를 제공하기 위해, Intlayer는 직접 호스팅 가능한 **[비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 **[전체 기능을 제공하는 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 지원합니다. 이를 통해 번역가, 카피라이터 및 기타 협업 부서와 **실시간**으로 다국어 콘텐츠를 매끄럽게 관리할 수 있습니다. 콘텐츠는 로컬 또는 원격으로 유연하게 저장될 수 있습니다.
 
 </Accordion>
-
 <Accordion header="크로스 프레임워크 디자인">
 
 애플리케이션의 여러 영역에서 서로 다른 프레임워크를 사용하고 있는 경우(예: React, React-native, Vue, Angular, Svelte 등), Intlayer는 **모든 주요 프론트엔드 프레임워크에서 범용 구문과 구현을 사용하는 방법**을 제공합니다. 디자인 시스템, 모바일 앱, 백엔드 서비스 전반에 걸쳐 콘텐츠 선언을 손쉽게 공유할 수 있습니다.
@@ -282,8 +275,6 @@ GitHub Star 수는 프로젝트의 인지도, 커뮤니티의 신뢰도 및 장
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## 상호 운용성
 
 `intlayer`는 기존의 `react-intl`, `react-i18next`, `next-intl`, `next-i18next` 및 `vue-i18n` 사전 네임스페이스들을 동시에 손쉽게 지배하고 가공하도록 지원합니다.
@@ -305,25 +296,21 @@ GitHub Star 수는 프로젝트의 인지도, 커뮤니티의 신뢰도 및 장
 - **콘텐츠 레이어 라이브러리**: `Intlayer`. 컴포넌트별로 콘텐츠를 선언하고 컴파일하므로 타입 안전성, 트리 쉐이킹(tree-shaking), 편집 도구 및 AI 번역이 모두 동일한 선언에서 제공됩니다.
 
 </Question>
-
 <Question title="i18n이 번들 크기에 얼마나 영향을 미치나요?">
 
 네임스페이스 기반 설정보다 훨씬 적습니다. 페이지는 렌더링하지 않는 언어의 카탈로그를 절대 다운로드하지 않기 때문입니다. 서버 렌더링 마크업은 서버에서 콘텐츠를 확인하고, 빌드 타임 컴파일러는 `useIntlayer` 호출을 컴포넌트가 사용하는 정확한 사전 항목으로 대체하므로 사용되지 않는 키와 언어는 제거됩니다. [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)을 통해 로케일별로 분할됩니다. 일반적인 대안들과 비교했을 때 Intlayer는 번들 및 페이지 크기를 최대 50%까지 줄여줍니다. [번들 최적화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)와 [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)를 참조하세요.
 
 </Question>
-
 <Question title="컴포넌트를 다시 작성하지 않고 i18next, next-intl 또는 react-i18next에서 마이그레이션할 수 있나요?">
 
 네, 두 가지 방법이 있습니다. [i18next 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_i18next_to_intlayer.md) 또는 [next-intl 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_next-intl_to_intlayer.md)를 따라 점진적으로 이전할 수 있습니다. 또는 현재 API를 완전히 유지할 수도 있습니다: [호환 어댑터(compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)는 `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` 및 `Lingui`와 완전히 동일한 API를 노출하면서 Intlayer 사전에서 데이터를 제공하므로, import 구문만 변경하고 컴포넌트 코드는 그대로 유지할 수 있습니다.
 
 </Question>
-
 <Question title="기존 JSON 번역 파일을 유지할 수 있나요?">
 
 네. [sync JSON 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-json.md)은 `/messages/{locale}/{namespace}.json` 파일을 단일 진실 공급원(source of truth)으로 유지하면서 양방향으로 Intlayer 사전을 생성합니다. [sync PO 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-po.md)은 gettext 카탈로그에 대해 동일한 작업을 수행하며, [로케일별 파일](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/per_locale_file.md)을 통해 로케일을 한 파일에 모으는 대신 언어별로 콘텐츠를 분할할 수도 있습니다.
 
 </Question>
-
 <Question title="콘텐츠를 키 단위로 하나씩 옮겨야 하나요?">
 
 아닙니다. `npx intlayer extract`를 실행하면 Intlayer가 소스 파일을 읽고 사용자 대면 문자열을 추출하여 각 컴포넌트 옆에 `.content` 파일을 생성하므로 카탈로그에 일일이 복사할 필요 없이 diff만 검토하면 됩니다. [extract 명령](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)을 참조하세요.
@@ -331,7 +318,6 @@ GitHub Star 수는 프로젝트의 인지도, 커뮤니티의 신뢰도 및 장
 완전 자동화된 파이프라인을 위해 [Intlayer 컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md)는 빌드 타임에 JSX, TSX, Vue 및 Svelte 소스에서 동일한 작업을 수행하여 변경될 때마다 사전을 생성하고 HMR을 통해 동기화하므로 수동으로 키를 관리할 필요가 없습니다. 정적 분석으로 작동하므로 런타임에만 존재하는 문자열은 제외되며, 사용자 텍스트와 애플리케이션 로직을 구분하기 위해 몇 가지 주석이 필요합니다.
 
 </Question>
-
 <Question title="사용 가능한 에디터 및 AI 에이전트 도구는 무엇이 있나요?">
 
 5가지 도구가 모두 선택 사항으로 제공됩니다:
@@ -343,43 +329,36 @@ GitHub Star 수는 프로젝트의 인지도, 커뮤니티의 신뢰도 및 장
 - **[ESLint 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/eslint.md)**: `no-raw-text` 규칙으로 하드코딩된 문자열을 표시하고, 정적 사전 키 및 사용되지 않는 콘텐츠에 대한 추가 규칙을 제공합니다.
 
 </Question>
-
 <Question title="Intlayer는 next-intl과 어떻게 다른가요?">
 
 `next-intl`은 Next.js를 위한 메시지 계층입니다: 로케일별로 JSON 메시지 파일을 유지하고 `useTranslations`를 통해 읽습니다. Intlayer는 콘텐츠 계층입니다: 선언이 컴포넌트 바로 옆에 위치하며, 선언 자체에서 타입이 지정되고, 컴포넌트별로 컴파일되므로 페이지는 렌더링하는 데 필요한 것만 전달합니다. 또한 Intlayer는 `next-intl`이 다루지 않는 AI 번역, 비주얼 에디터, CMS 및 CI에서의 누락 번역 검사를 모두 기본 제공합니다. `next-intl` API를 그대로 유지하고 싶다면 [호환 어댑터(compat adapter)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)를 통해 Intlayer 사전에서 이를 제공받을 수 있습니다.
 
 </Question>
-
 <Question title="Intlayer는 i18next 및 react-i18next와 어떻게 다른가요?">
 
 `i18next`는 런타임에 네임스페이스에 대해 문자열 키를 확인하므로 키 이름이 변경되거나 오타가 발생하면 조용히 실패하며 페이지가 접근하는 모든 네임스페이스가 통째로 다운로드됩니다. Intlayer는 빌드 타임에 생성된 타입에 대해 콘텐츠를 확인하므로 잘못된 키는 컴파일 오류가 되며 컴포넌트가 렌더링하는 항목만 번들에 포함됩니다. `i18next`는 더 큰 플러그인 생태계와 오랜 역사를 가지고 있지만, Intlayer는 정밀한 타입 검사, 번들 최적화, 그리고 비주얼 편집 및 자동화 도구에서 압도적인 장점을 제공합니다. [i18next 마이그레이션 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/migration_from_i18next_to_intlayer.md) 또는 [호환 어댑터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)를 참조하세요.
 
 </Question>
-
 <Question title="Intlayer는 다른 대안들보다 더 빠르고 가볍나요?">
 
 번들 및 페이지 크기 측면에서 확실히 그렇습니다. 페이지에서 렌더링하지 않는 카탈로그를 로드하지 않음으로써 네임스페이스 기반 설정 대비 번들 및 페이지 크기를 최대 50%까지 줄여줍니다. [벤치마크](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/index.md)에서는 [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/vue.md), [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/benchmark/svelte.md) 등 각 프레임워크별 측정 방법과 수치를 투명하게 공개하고 있어 직접 재현해 볼 수 있습니다.
 
 </Question>
-
 <Question title="기존 앱을 마이그레이션할 가치가 있나요?">
 
 현재 프로젝트가 겪고 있는 병목에 따라 다릅니다. 번들 크기 증가, 조용히 누락되는 번역 오류, 또는 개발자의 도움 없이는 작업할 수 없는 번역팀과의 협업이 고민이라면 마이그레이션은 충분한 가치가 있습니다. 카탈로그가 작고 안정적이라면 체감 효과는 상대적으로 적을 수 있습니다. 어떤 경우든 전면 재작성 없이 이전할 수 있습니다: [호환 어댑터(compat adapters)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)는 현재 API를 그대로 유지해 주며, [sync JSON 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/plugins/sync-json.md)은 두 계층이 공존하는 동안 기존 JSON 파일을 단일 진실 공급원으로 유지해 줍니다.
 
 </Question>
-
 <Question title="다른 i18n 라이브러리에는 없는 Intlayer만의 특별한 기능은 무엇인가요?">
 
 [Markdown 콘텐츠](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md), [외부 소스에서 가져온 콘텐츠](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md), 파일 콘텐츠 로딩, [실시간 콘텐츠 업데이트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md), [비주얼 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md), [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md), 기존 컴포넌트에서 콘텐츠를 추출하는 [컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md), A/B 테스트를 위한 [콘텐츠 변형(content variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/variants.md), 콘텐츠 노출 [애널리틱스](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/analytics.md), [MCP 서버](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md), [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md) 및 [에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)을 제공합니다.
 
 </Question>
-
 <Question title="현재 사용 중인 라이브러리를 유지하면서 Intlayer를 번역 관리 도구로만 사용할 수 있나요?">
 
 네. Intlayer는 현재 라이브러리가 요구하는 형식과 위치(예: `/messages/{locale}/{namespace}.json`)로 네임스페이스를 생성할 수 있으므로, 애플리케이션 코드는 기존 i18n 라이브러리를 그대로 사용하면서 AI 번역, 비주얼 에디터 및 CI 검사 기능의 혜택을 누릴 수 있습니다.
 
 </Question>
-
 <Question title="Intlayer는 무료이며 오픈 소스인가요?">
 
 네, 상업적 사용을 포함하여 Apache 2.0 라이선스에 따라 제공됩니다. 호스팅형 CMS는 선택적 유료 서비스이며 [자체 호스팅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/self_hosting.md)도 가능합니다.