@intlayer/docs 8.6.0 → 8.6.10

package/docs/ko/cli/index.md

@@ -1,37 +1,43 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-01-06
-title: CLI
-description: Intlayer CLI를 사용하여 다국어 웹사이트를 관리하는 방법을 알아보세요. 이 온라인 문서의 단계를 따라 몇 분 만에 프로젝트를 설정할 수 있습니다.
+updatedAt: 2026-03-31
+title: CLI - 다국어 웹사이트를 위한 모든 Intlayer CLI 명령어
+description: Intlayer CLI를 사용하여 다국어 웹사이트를 관리하는 방법을 알아보세요. 이 온라인 문서의 단계를 따라 몇 분 만에 프로젝트를 설정하세요.
 keywords:
   - CLI
-  - 명령줄 인터페이스
+  - 명령어 인터페이스
   - 국제화
   - 문서
   - Intlayer
   - Next.js
   - JavaScript
   - React
-slugs:
+slug:
   - doc
   - concept
   - cli
 history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "standalone 명령어 추가"
   - version: 7.5.11
     date: 2026-01-06
-    changes: "projects list 명령어 추가"
+    changes: "CI 명령어 추가"
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: "프로젝트 목록(list projects) 명령어 추가"
   - version: 7.5.9
     date: 2025-12-30
     changes: "init 명령어 추가"
   - version: 7.2.3
     date: 2025-11-22
-    changes: "transform 명령어 추가"
+    changes: "extract 명령어 추가"
   - version: 7.1.0
     date: 2025-11-05
     changes: "translate 명령어에 skipIfExists 옵션 추가"
   - version: 6.1.4
     date: 2025-01-27
-    changes: "CLI 인수 및 명령어에 별칭 추가"
+    changes: "CLI 인수 및 명령어 별칭 추가"
   - version: 6.1.3
     date: 2025-10-05
     changes: "명령어에 build 옵션 추가"
@@ -40,7 +46,7 @@ history:
     changes: "version 명령어 추가"
   - version: 6.1.0
     date: 2025-09-26
-    changes: "CLI를 사용하여 verbose 옵션의 기본값을 true로 설정"
+    changes: "CLI를 통해 verbose 옵션 기본값을 true로 설정"
   - version: 6.1.0
     date: 2025-09-23
     changes: "watch 명령어 및 with 옵션 추가"
@@ -55,10 +61,10 @@ history:
     changes: "CLI 명령어 매개변수 문서 업데이트"
   - version: 5.5.10
     date: 2025-06-29
-    changes: "히스토리 초기화"
+    changes: "기록 초기화"
 ---
 
-# Intlayer CLI
+# Intlayer CLI - 다국어 웹사이트를 위한 모든 Intlayer CLI 명령어
 
 ---
 
@@ -70,7 +76,7 @@ history:
 
 ## 패키지 설치
 
-npm을 사용하여 필요한 패키지를 설치하세요:
+npm을 사용하여 필요한 패키지를 설치합니다:
 
 ```bash packageManager="npm"
 npm install intlayer-cli -g
@@ -88,19 +94,19 @@ pnpm add intlayer-cli -g
 bun add intlayer-cli -g
 ```
 
-> `intlayer` 패키지가 이미 설치되어 있다면, CLI는 자동으로 설치됩니다. 이 단계는 건너뛸 수 있습니다.
+> `intlayer` 패키지가 이미 설치되어 있다면 CLI가 자동으로 설치됩니다. 이 단계는 건너뛸 수 있습니다.
 
 ## intlayer-cli 패키지
 
-`intlayer-cli` 패키지는 여러분의 [intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)을 사전(dictionaries)으로 변환하기 위한 도구입니다.
+`intlayer-cli` 패키지는 [Intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)을 딕셔너리로 트랜스파일하는 데 사용됩니다.
 
-이 패키지는 `src/**/*.content.{ts|js|mjs|cjs|json}`와 같은 모든 intlayer 파일을 변환합니다. [Intlayer 선언 파일을 선언하는 방법을 확인하세요](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+이 패키지는 `src/**/*.content.{ts|js|mjs|cjs|json}`과 같은 모든 Intlayer 파일을 트랜스파일합니다. [Intlayer 선언 파일 선언 방법 알아보기](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
-intlayer 사전을 해석하려면 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 또는 [next-intlayer](https://www.npmjs.com/package/next-intlayer)와 같은 인터프리터를 사용할 수 있습니다.
+Intlayer 딕셔너리를 해석하려면 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 또는 [next-intlayer](https://www.npmjs.com/package/next-intlayer)와 같은 해석기를 사용할 수 있습니다.
 
-## 구성 파일 지원
+## 설정 파일 지원
 
-Intlayer는 여러 구성 파일 형식을 지원합니다:
+Intlayer는 여러 설정 파일 형식을 허용합니다:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -109,54 +115,59 @@ Intlayer는 여러 구성 파일 형식을 지원합니다:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-사용 가능한 로케일이나 기타 매개변수를 구성하는 방법은 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+사용 가능한 언어 또는 기타 매개변수를 구성하는 방법은 [여기에서 구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
 
-## intlayer 명령 실행
+## Intlayer 명령어 실행
 
 ### 인증
 
-- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/login.md)** - Intlayer CMS로 인증하고 액세스 자격 증명 받기
+- **[로그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/login.md)** - Intlayer CMS에 인증하고 액세스 자격 증명을 가져옵니다.
 
-### 핵심 명령
+### 핵심 명령어
 
-- **[사전 빌드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/build.md)** - 콘텐츠 선언 파일에서 사전을 빌드합니다.
-- **[사전 감시](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/watch.md)** - 변경 사항을 감시하고 자동으로 사전을 빌드합니다.
+- **[딕셔너리 빌드 (Build)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/build.md)** - 콘텐츠 선언 파일에서 딕셔너리를 빌드합니다.
+- **[딕셔너리 감시 (Watch)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/watch.md)** - 변경 사항을 감시하고 딕셔너리를 자동으로 빌드합니다.
+- **[독립 실행형 번들 생성 (Standalone)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/standalone.md)** - Intlayer 및 지정된 패키지를 포함하는 독립 실행형 JavaScript 번들을 생성합니다.
 - **[CLI 버전 확인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/version.md)** - 설치된 Intlayer CLI 버전을 확인합니다.
-- **[프로젝트 목록](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/list_projects.md)** - 디렉토리 또는 git 저장소의 모든 Intlayer 프로젝트를 나열합니다
+- **[프로젝트 목록 (List Projects)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/list_projects.md)** - 디렉토리 또는 git 저장소의 모든 Intlayer 프로젝트를 나열합니다.
 
-### 사전 관리
+### 딕셔너리 관리
 
-- **[사전 푸시](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/push.md)** - 사전을 Intlayer 에디터와 CMS로 푸시합니다.
-- **[사전 가져오기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/pull.md)** - Intlayer 에디터와 CMS에서 사전을 가져옵니다
-- **[사전 채우기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md)** - AI를 사용하여 사전을 채우고, 감사하며, 번역합니다
-- **[누락된 번역 테스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/test.md)** - 누락된 번역을 테스트하고 식별합니다
-- **[콘텐츠 선언 파일 목록](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/list.md)** - 프로젝트 내 모든 콘텐츠 선언 파일을 나열합니다
+- **[딕셔너리 푸시 (Push)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/push.md)** - 딕셔너리를 Intlayer 에디터 및 CMS로 전송합니다.
+- **[딕셔너리 풀 (Pull)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/pull.md)** - Intlayer 에디터 및 CMS에서 딕셔너리를 가져옵니다.
+- **[딕셔너리 채우기 (Fill)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md)** - AI를 사용하여 딕셔너리를 채우고 감사하며 번역합니다.
+- **[누락된 번역 테스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/test.md)** - 누락된 번역을 테스트하고 식별합니다.
+- **[콘텐츠 선언 파일 목록](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/list.md)** - 프로젝트의 모든 콘텐츠 선언 파일을 나열합니다.
 
 ### 컴포넌트 관리
 
-- **[컴포넌트 변환](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)** - 기존 컴포넌트를 Intlayer를 사용하도록 변환
+- **[문자열 추출 (Extract)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)** - 컴포넌트 근처의 .content 파일로 컴포넌트에서 문자열을 추출합니다.
 
 ### 구성
 
-- **[Intlayer 초기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/init.md)** - 자동 구성으로 프로젝트에 Intlayer 설정
-- **[구성 관리](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/configuration.md)** - Intlayer 구성을 CMS에서 가져오고 푸시
+- **[Intlayer 초기화 (Init)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/init.md)** - 자동 구성을 사용하여 프로젝트에 Intlayer를 설정합니다.
+- **[구성 관리](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/configuration.md)** - Intlayer 구성을 가져오고 CMS로 전송합니다.
 
 ### 문서 관리
 
-- **[문서 번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-translate.md)** - AI를 사용하여 문서 파일 자동 번역
-- **[문서 검토](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-review.md)** - 품질과 일관성을 위한 문서 파일 검토
+- **[문서 번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-translate.md)** - AI를 사용하여 문서 파일을 자동으로 번역합니다.
+- **[문서 검토](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-review.md)** - 품질과 일관성을 위해 문서 파일을 검토합니다.
+
+### 에디터 및 라이브 동기화 (Live Sync)
+
+- **[에디터 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/editor.md)** - Intlayer 에디터 명령어를 사용합니다.
+- **[라이브 동기화 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md)** - 라이브 동기화를 사용하여 런타임에 CMS의 콘텐츠 변경 사항을 반영합니다.
 
-### 에디터 및 라이브 동기화
+### CI/CD 및 자동화
 
-- **[에디터 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/editor.md)** - Intlayer 에디터 명령어 사용하기
-- **[라이브 싱크 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md)** - 런타임에 CMS 콘텐츠 변경 사항을 반영하는 라이브 싱크 사용하기
+- **[CI 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/ci.md)** - CI/CD 파이프라인을 위해 자동으로 주입된 자격 증명으로 Intlayer 명령어를 실행합니다.
 
 ### 개발 도구
 
-- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/sdk.md)** - 자신의 코드에서 Intlayer CLI SDK 사용하기
-- **[Intlayer 명령어 디버그](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/debug.md)** - Intlayer CLI 문제 디버그 및 문제 해결하기
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/sdk.md)** - 자체 코드에서 Intlayer CLI SDK를 사용합니다.
+- **[Intlayer 명령어 디버그](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/debug.md)** - Intlayer CLI 문제를 디버그하고 해결합니다.
 
-## `package.json`에서 intlayer 명령어 사용하기
+## `package.json`에서 Intlayer 명령어 사용하기
 
 ```json fileName="package.json"
 "scripts": {
@@ -164,6 +175,7 @@ Intlayer는 여러 구성 파일 형식을 지원합니다:
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:standalone": "npx intlayer standalone --packages intlayer vanilla-intlayer",
   "intlayer:push": "npx intlayer push",
   "intlayer:pull": "npx intlayer pull",
   "intlayer:fill": "npx intlayer fill",
@@ -176,8 +188,8 @@ Intlayer는 여러 구성 파일 형식을 지원합니다:
 }
 ```
 
-> **참고**: 다음과 같은 짧은 별칭도 사용할 수 있습니다:
+> **참고**: 다음과 같은 짧은 별칭을 사용할 수도 있습니다:
 >
-> - `npx intlayer list` 는 `npx intlayer content list` 대신 사용
-> - `npx intlayer test` 는 `npx intlayer content test` 대신 사용
-> - `npx intlayer projects-list` 또는 `npx intlayer pl` 는 `npx intlayer projects list` 대신 사용
+> - `npx intlayer list`: `npx intlayer content list` 대신 사용
+> - `npx intlayer test`: `npx intlayer content test` 대신 사용
+> - `npx intlayer projects-list` 또는 `npx intlayer pl`: `npx intlayer projects list` 대신 사용

package/docs/ko/cli/init.md

@@ -2,7 +2,7 @@
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
 title: Intlayer 초기화
-description: 프로젝트에서 Intlayer를 초기화하는 방법을 알아보세요.
+description: 프로젝트에서 Intlayer를 초기화하는 방법을 알아봅니다.
 keywords:
   - 초기화
   - CLI
@@ -14,9 +14,12 @@ slugs:
   - cli
   - init
 history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "--no-gitignore 옵션 추가"
   - version: 7.5.9
     date: 2025-12-30
-    changes: "init 명령 추가"
+    changes: "init 명령어 추가"
 ---
 
 # Intlayer 초기화
@@ -25,7 +28,7 @@ history:
 npx intlayer init
 ```
 
-`init` 명령은 필요한 파일과 설정을 구성하여 프로젝트에 Intlayer를 자동으로 설정합니다. Intlayer를 시작하는 권장 방법입니다.
+`init` 명령어는 필요한 파일과 설정을 구성하여 프로젝트에서 Intlayer를 자동으로 설정합니다. Intlayer를 시작하는 데 권장되는 방법입니다.
 
 ## 별칭:
 
@@ -33,28 +36,21 @@ npx intlayer init
 
 ## 인수:
 
-- `--project-root [projectRoot]` - 선택 사항. 프로젝트 루트 디렉터리를 지정합니다. 제공하지 않으면 명령은 현재 작업 디렉터리에서 시작하여 프로젝트 루트를 검색합니다.
+- `--project-root [projectRoot]` - 선택 사항. 프로젝트 루트 디렉토리를 지정합니다. 제공되지 않으면 명령어는 현재 작업 디렉토리부터 프로젝트 루트를 검색합니다.
+- `--no-gitignore` - 선택 사항. `.gitignore` 파일의 자동 업데이트를 건너뜁니다. 이 플래그가 설정되면 `.intlayer`가 `.gitignore`에 추가되지 않습니다.
 
-## 수행 작업:
+## 작동 원리:
 
-`init` 명령은 다음 설정 작업을 수행합니다:
+`init` 명령어는 다음과 같은 설정 작업을 수행합니다:
 
-1. **프로젝트 구조 검증** - `package.json` 파일이 있는 유효한 프로젝트 디렉터리에 있는지 확인합니다
-2. **`.gitignore` 업데이트** - 생성된 파일을 버전 관리에서 제외하도록 `.gitignore`에 `.intlayer`를 추가합니다
-3. **TypeScript 구성** - 모든 `tsconfig.json` 파일을 업데이트하여 Intlayer 타입 정의(`.intlayer/**/*.ts`)를 포함합니다
-4. **설정 파일 생성** - 기본 설정으로 `intlayer.config.ts`(TypeScript 프로젝트용) 또는 `intlayer.config.mjs`(JavaScript 프로젝트용)를 생성합니다
-5. **Vite 설정 업데이트** - Vite 구성 파일이 감지되면 `vite-intlayer` 플러그인 import를 추가합니다
+1. **프로젝트 구조 유효성 검사** - `package.json` 파일이 있는 유효한 프로젝트 디렉토리에 있는지 확인합니다.
+2. **`.gitignore` 업데이트** - 생성된 파일을 버전 관리에서 제외하기 위해 `.gitignore` 파일에 `.intlayer`를 추가합니다 (`--no-gitignore`로 건너뛸 수 있음).
+3. **TypeScript 구성** - Intlayer 타입 정의(`.intlayer/**/*.ts`)를 포함하도록 모든 `tsconfig.json` 파일을 업데이트합니다.
+4. **설정 파일 생성** - 기본 설정을 사용하여 `intlayer.config.ts`(TypeScript 프로젝트용) 또는 `intlayer.config.mjs`(JavaScript 프로젝트용)를 생성합니다.
+5. **Vite 설정 업데이트** - Vite 설정 파일이 감지되면 `vite-intlayer` 플러그인 임포트를 추가합니다.
+6. **Next.js 설정 업데이트** - Next.js 설정 파일이 감지되면 `next-intlayer` 플러그인 임포트를 추가합니다.
 
-`init` 명령은 다음 설정 작업을 수행합니다:
-
-1. **프로젝트 구조 검증** - `package.json` 파일이 있는 유효한 프로젝트 디렉터리에 있는지 확인합니다
-2. **`.gitignore` 업데이트** - 생성된 파일을 버전 관리에서 제외하기 위해 `.gitignore` 파일에 `.intlayer`를 추가합니다
-3. **TypeScript 구성** - 모든 `tsconfig.json` 파일을 업데이트하여 Intlayer 타입 정의(`.intlayer/**/*.ts`)를 포함합니다
-4. **구성 파일 생성** - 기본 설정으로 TypeScript 프로젝트의 경우 `intlayer.config.ts`, JavaScript 프로젝트의 경우 `intlayer.config.mjs` 파일을 생성합니다
-5. **Vite 구성 업데이트** - Vite 구성 파일이 감지되면 `vite-intlayer` 플러그인 임포트를 추가합니다
-6. **Next.js 설정 업데이트** - Next.js 구성 파일이 감지되면 `next-intlayer` 플러그인 import를 추가합니다
-
-## 예제:
+## 예시:
 
 ### 기본 초기화:
 
@@ -62,31 +58,39 @@ npx intlayer init
 npx intlayer init
 ```
 
-이 명령은 현재 디렉터리에 Intlayer를 초기화하며 프로젝트 루트를 자동으로 감지합니다.
+이 명령어는 현재 디렉토리에서 Intlayer를 초기화하며 프로젝트 루트를 자동으로 감지합니다.
 
-### 사용자 지정 프로젝트 루트로 초기화:
+### 사용자 정의 프로젝트 루트로 초기화:
 
 ```bash
 npx intlayer init --project-root ./my-project
 ```
 
-지정된 디렉터리에 Intlayer를 초기화합니다.
+이 명령어는 지정된 디렉토리에서 Intlayer를 초기화합니다.
+
+### .gitignore를 업데이트하지 않고 초기화:
+
+```bash
+npx intlayer init --no-gitignore
+```
+
+이 명령어는 모든 설정 파일을 구성하지만 `.gitignore`는 수정하지 않습니다.
 
-## 예시 출력:
+## 출력 예시:
 
 ```bash
 npx intlayer init
 Checking Intlayer configuration...
-✓ .gitignore에 .intlayer 추가됨
-✓ intlayer 타입을 포함하도록 tsconfig.json 업데이트됨
-intlayer.config.ts 생성됨
-✓ vite.config.ts에 import 주입됨
-✓ Intlayer 초기화 설정 완료.
+✓ Added .intlayer to .gitignore
+✓ Updated tsconfig.json to include intlayer types
+✓ Created intlayer.config.ts
+✓ Injected import into vite.config.ts
+✓ Intlayer init setup complete.
 ```
 
-## 참고:
+## 참고 사항:
 
-- 명령은 멱등(idempotent)입니다, 여러 번 안전하게 실행할 수 있습니다. 이미 구성된 단계는 건너뜁니다.
-- 구성 파일이 이미 존재하는 경우 덮어쓰지 않습니다.
-- `include` 배열이 없는 TypeScript 구성 파일(예: references를 사용하는 솔루션 스타일 구성)은 건너뜁니다.
-- 프로젝트 루트에서 `package.json`을 찾을 수 없으면 명령은 오류와 함께 종료합니다.
+- 이 명령어는 멱등성(idempotent)이 있습니다. 여러 번 실행해도 안전하며 이미 구성된 단계는 건너뜁니다.
+- 설정 파일이 이미 존재하는 경우 덮어쓰지 않습니다.
+- `include` 배열이 없는 TypeScript 구성(예: 참조가 있는 솔루션 스타일 구성)은 건너뜁니다.
+- 프로젝트 루트에서 `package.json`을 찾을 수 없으면 명령어가 오류와 함께 종료됩니다.

package/docs/ko/cli/standalone.md

@@ -0,0 +1,91 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-03-31
+title: 독립 실행형 번들 (Standalone Bundle)
+description: 애플리케이션 콘텐츠의 독립 실행형 JavaScript 번들을 만드는 방법을 알아봅니다.
+keywords:
+  - Standalone
+  - Bundle
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - standalone
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "독립 실행형 명령어 문서 초기화"
+---
+
+# 독립 실행형 번들 (Standalone Bundle)
+
+`standalone` 명령어를 사용하면 Intlayer와 지정된 다른 패키지를 포함하는 독립 실행형 JavaScript 번들을 만들 수 있습니다. 이는 간단한 HTML/JS 애플리케이션과 같이 패키지 관리자나 번들러가 없는 환경에서 Intlayer를 사용하는 데 특히 유용합니다.
+
+번들은 [esbuild](https://esbuild.github.io/)를 사용하여 요청된 패키지와 그 종속성을 단일 파일로 결합하며, 이 파일은 모든 웹 프로젝트에서 쉽게 가져올 수 있습니다.
+
+## 사용법
+
+```bash
+npx intlayer standalone --packages [패키지...] [옵션]
+```
+
+## 옵션
+
+- `-o, --outfile [outfile]` - 선택 사항. 출력 파일 이름입니다. 기본값: `intlayer-bundle.js`.
+- `--packages [패키지...]` - 필수 사항. 번들에 포함할 패키지 목록입니다 (예: `intlayer`, `vanilla-intlayer`).
+- `--version [version]` - 선택 사항. 번들링할 패키지의 버전입니다. 지정하지 않으면 기본적으로 Intlayer CLI의 버전이 사용됩니다.
+- `--minify` - 선택 사항. 출력을 압축(minify)할지 여부입니다. 기본값: `true`.
+- `--platform [platform]` - 선택 사항. 번들의 대상 플랫폼입니다 (예: `browser`, `node`). 기본값: `browser`.
+- `--format [format]` - 선택 사항. 번들의 출력 형식입니다 (예: `esm`, `cjs`, `iife`). 기본값: `esm`.
+
+## 공통 옵션
+
+- `--env-file [envFile]` - 환경 파일입니다.
+- `-e, --env [env]` - 환경입니다.
+- `--base-dir [baseDir]` - 기본 디렉토리입니다.
+- `--no-cache` - 캐시를 비활성화합니다.
+- `--verbose` - 상세 출력을 표시합니다.
+
+## 예시:
+
+### Vanilla JS용 번들 생성:
+
+```bash
+npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js
+```
+
+이렇게 하면 `intlayer`와 `vanilla-intlayer` 패키지가 모두 포함된 `intlayer.js` 파일이 생성되며, 압축된 ESM 형식으로 브라우저에서 `<script>` 태그를 통해 사용할 준비가 됩니다.
+
+### 특정 버전 번들링:
+
+```bash
+npx intlayer standalone --packages intlayer --version 8.6.4
+```
+
+### 다른 형식으로 번들링:
+
+```bash
+npx intlayer standalone --packages intlayer --format iife
+```
+
+## 작동 원리:
+
+1. **임시 환경 생성** - 종속성을 관리하기 위한 임시 디렉토리를 설정합니다.
+2. **패키지 설치** - `npm` 또는 `bun`(사용 가능한 경우)을 사용하여 요청된 패키지와 그 종속성을 설치합니다.
+3. **진입점 생성** - 요청된 모든 패키지를 내보내고 브라우저에서 실행될 때 글로벌 변수로 노출하는 임시 진입점 파일을 만듭니다.
+4. **esbuild로 번들링** - esbuild를 사용하여 모든 것을 단일 파일로 결합하고, 요청에 따라 압축 및 서식 지정을 적용합니다.
+5. **파일 생성** - 결과물 번들을 지정된 출력 경로에 씁니다.
+
+## 글로벌 변수
+
+번들이 브라우저에 로드되면 요청된 패키지를 `window` 객체의 글로벌 변수로 노출합니다. 변수 이름은 패키지 이름에서 파생됩니다 (예: `intlayer`는 `Intlayer`, `vanilla-intlayer`는 `VanillaIntlayer`가 됨).
+
+```javascript
+// 번들에서 Intlayer에 액세스
+const { getLocaleName } = window.Intlayer;
+const { installIntlayer, useIntlayer } = window.VanillaIntlayer;
+```

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-20
+updatedAt: 2026-04-08
 title: 구성 (Configuration)
 description: 애플리케이션에 Intlayer를 구성하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤설정하는 데 사용할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.7.0
+    date: 2026-04-08
+    changes: "빌드 구성에 `prune` 및 `minify` 옵션 추가"
+  - version: 8.7.0
+    date: 2026-04-03
+    changes: "`currentDomain` 옵션 추가"
   - version: 8.4.0
     date: 2026-03-20
     changes: "'compiler.output' 및 'dictionary.fill'에 대해 로케일별 객체 표기법 지원 추가"
@@ -237,6 +243,17 @@ const config: IntlayerConfig = {
         fr: "/[locale]/a-propos",
       },
     }),
+
+    /**
+     * 도메인 기반 라우팅을 위해 로케일을 도메인 호스트 이름에 매핑합니다.
+     * 이 로케일의 URL은 절대 URL이 됩니다(예: https://intlayer.cn/).
+     * 도메인이 로케일을 의미하므로 경로에 로케일 접두사가 추가되지 않습니다.
+     * 기본값: undefined
+     */
+    domains: {
+      en: "intlayer.org",
+      zh: "intlayer.cn",
+    },
   },
 
   /**
@@ -388,6 +405,25 @@ const config: IntlayerConfig = {
      */
     optimize: true,
 
+    /**
+     * 번들 크기를 줄이기 위해 딕셔너리를 압축(Minify)합니다.
+     * 기본값: false
+     *
+     * 주의:
+     * - `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.
+     * - `editor.enabled`가 true인 경우 이 옵션은 무시됩니다.
+     */
+    minify: true,
+
+    /**
+     * 딕셔너리에서 사용하지 않는 키를 제거합니다.
+     * 기본값: false
+     *
+     * 주의:
+     * - `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.
+     */
+    purge: true,
+
     /**
      * 생성된 딕셔너리 파일의 출력 형식.
      * 기본값: ['cjs', 'esm']
@@ -597,12 +633,13 @@ export default config;
 
 URL 구조, 로케일 저장 및 미들웨어 처리를 포함하여 라우팅 동작을 제어하기 위한 설정입니다.
 
-| 필드       | 설명                                                                                                                          | 타입                                                                                                                                                                                                         | 기본값                 | 예시                                                                                                                                                                                         | 참고                                                                                                                                                                                                                                                                                          |
-| ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`     | 로케일 처리를 위한 URL 라우팅 모드.                                                                                           | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) 또는 `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: 로케일이 다른 수단으로 관리됨. `'search-params'`: `/dashboard?locale=fr` | 쿠키나 로컬 스토리지 관리에는 영향을 주지 않습니다.                                                                                                                                                                                                                                           |
-| `storage`  | 클라이언트에서 로케일을 저장하기 위한 구성.                                                                                   | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                           | 아래의 저장소 옵션 표를 참조하세요.                                                                                                                                                                                                                                                           |
-| `basePath` | 애플리케이션 URL의 기본 경로.                                                                                                 | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                  | 앱이 `https://example.com/my-app`에 있는 경우 basePath는 `'/my-app'`이며 URL은 `https://example.com/my-app/en`이 됩니다.                                                                                                                                                                      |
-| `rewrite`  | 특정 로케일 경로에 대해 기본 라우팅 모드를 재정의하기 위한 사용자 정의 URL 재작성 규칙. 동적 `[param]` 매개변수를 지원합니다. | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | 아래 예시 참조                                                                                                                                                                               | • Rewrite 규칙은 `mode`보다 우선순위가 높습니다.<br/>• Next.js 및 Vite와 함께 작동합니다.<br/>• `getLocalizedUrl()`은 일치하는 규칙을 자동으로 적용합니다.<br/>• [사용자 정의 URL 재작성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)을 참조하세요. |
+| 필드       | 설명                                                                                                                                                                               | 타입                                                                                                                                                                                                         | 기본값                 | 예시                                                                                                                                                                                         | 참고                                                                                                                                                                                                                                                                                          |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | 로케일 처리를 위한 URL 라우팅 모드.                                                                                                                                                | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) 또는 `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: 로케일이 다른 수단으로 관리됨. `'search-params'`: `/dashboard?locale=fr` | 쿠키나 로컬 스토리지 관리에는 영향을 주지 않습니다.                                                                                                                                                                                                                                           |
+| `storage`  | 클라이언트에서 로케일을 저장하기 위한 구성.                                                                                                                                        | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                           | 아래의 저장소 옵션 표를 참조하세요.                                                                                                                                                                                                                                                           |
+| `basePath` | 애플리케이션 URL의 기본 경로.                                                                                                                                                      | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                  | 앱이 `https://example.com/my-app`에 있는 경우 basePath는 `'/my-app'`이며 URL은 `https://example.com/my-app/en`이 됩니다.                                                                                                                                                                      |
+| `rewrite`  | 특정 로케일 경로에 대해 기본 라우팅 모드를 재정의하기 위한 사용자 정의 URL 재작성 규칙. 동적 `[param]` 매개변수를 지원합니다.                                                      | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | 아래 예시 참조                                                                                                                                                                               | • Rewrite 규칙은 `mode`보다 우선순위가 높습니다.<br/>• Next.js 및 Vite와 함께 작동합니다.<br/>• `getLocalizedUrl()`은 일치하는 규칙을 자동으로 적용합니다.<br/>• [사용자 정의 URL 재작성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)을 참조하세요. |
+| `domains`  | 도메인 기반 라우팅을 위해 로케일을 도메인 호스트 이름에 매핑합니다. 설정된 경우 로케일의 URL은 해당 도메인을 베이스(절대 URL)로 사용하며 경로에 로케일 접두사가 추가되지 않습니다. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                  | • 호스트 이름에 포함되지 않은 경우 기본 프로토콜은 `https://`입니다.<br/>• 도메인 자체가 로케일을 식별하므로 `/zh/` 접두사가 추가되지 않습니다.<br/>• `getLocalizedUrl('/', 'zh')`는 `https://intlayer.zh/`를 반환합니다.                                                                     |
 
 **`rewrite` 예시**:
 
@@ -905,7 +942,9 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 | 필드              | 설명                                                                       | 타입                             | 기본값                                                                                                                                                                            | 예시                                                                          | 참고                                                                                                                                                                                                                                                                                                    |
 | ----------------- | -------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`            | 빌드 실행 모드를 제어합니다.                                               | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: 애플리케이션 빌드 중 자동으로 빌드가 트리거됩니다.<br/>• `'manual'`: 명시적인 빌드 명령을 통해서만 실행됩니다.<br/>• 딕셔너리 빌드를 원치 않을 때 유용할 수 있습니다(예: Node.js 환경에서 실행하지 않으려는 경우).                                                                          |
-| `optimize`        | 빌드 최적화 수행 여부를 제어합니다.                                        | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 정의되지 않은 경우 프레임워크 빌드(Vite/Next.js) 중에 트리거됩니다.<br/>• `true`인 경우 개발 모드에서도 최적화를 강제합니다.<br/>• `false`인 경우 비활성화합니다.<br/>• 활성화된 경우 딕셔너리 호출을 chunking 최적화로 대체합니다.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플러그인이 필요합니다. |
+| `optimize`        | 빌드 최적화 수행 여부를 제어합니다.                                        | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 정의되지 않은 경우 프레임워크 빌드(Vite/Next.js) 중에 트리거됩니다.<br/>• `true`인 경우 개발 모드에서도 최적화를 강제합니다.<br/>• `false`인 경우 비활성화합니다.<br/>• 활성화된 경우 딕셔너리 호출을 chunking 최적화로 대체합니다.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플래그인이 필요합니다. |
+| `minify`          | 번들 크기를 줄이기 위해 딕셔너리를 압축(Minify)합니다.                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 압축할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.<br/>• `editor.enabled`가 true인 경우 이 옵션은 무시됩니다.                                                                                                        |
+| `purge`           | 딕셔너리에서 사용하지 않는 키를 제거합니다.                                | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 제거할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.                                                                                                                                                                   |
 | `checkTypes`      | 빌드 시 TypeScript 타입 체크를 수행하고 오류를 기록할지 여부를 지정합니다. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | 빌드 속도가 느려질 수 있습니다.                                                                                                                                                                                                                                                                         |
 | `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 패턴을 사용합니다.                                                                                                                                                                  |