@intlayer/docs 9.1.3 → 9.2.0

package/docs/ko/intlayer_with_vite+preact.md

@@ -715,41 +715,71 @@ export const Link = forwardRef<HTMLAnchorElement, LinkProps>(
 Link.displayName = "Link";
 ```
 
-### VS Code 확장 프로그램
+#### 작동 방식
 
-Intlayer 개발 경험을 향상시키기 위해 공식 **Intlayer VS Code 확장 프로그램**을 설치할 수 있습니다.
+- **외부 링크 감지**:  
+  헬퍼 함수 `checkIsExternalLink`는 URL이 외부 링크인지 여부를 결정합니다. 외부 링크는 로컬라이제이션이 필요하지 않기 때문에 변경되지 않습니다.
+- **현재 로케일 검색**:  
+  `useLocale` 훅은 현재 로케일(예: 프랑스어의 경우 `fr`)을 제공합니다.
+- **URL 로컬라이징**:  
+  내부 링크(즉, 외부가 아닌)의 경우, `getLocalizedUrl`을 사용하여 자동으로 URL에 현재 로케일을 접두사로 추가합니다. 이는 사용자가 프랑스어를 사용 중인 경우 `href`로 `/about`을 전달하면 `/fr/about`으로 변환된다는 의미입니다.
+- **링크 반환**:  
+  컴포넌트는 로컬라이징된 URL과 함께 `<a>` 요소를 반환하여 네비게이션이 로케일과 일치하도록 보장합니다.
 
-[VS Code 마켓플레이스에서 설치](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+</Step>
 
-이 확장 프로그램은 다음을 제공합니다:
+<Step number={11} title="Markdown 및 HTML 렌더링" isOptional={true}>
 
-- 번역 키에 대한 **자동 완성**.
-- 누락된 번역에 대한 **실시간 오류 감지**.
-- 번역된 콘텐츠의 **인라인 미리보기**.
-- 번역을 쉽게 생성하고 업데이트할 수 있는 **빠른 작업**.
+Intlayer는 Preact에서 Markdown 및 HTML 콘텐츠 렌더링을 지원합니다.
 
-확장 프로그램 사용법에 대한 자세한 내용은 [Intlayer VS Code 확장 프로그램 문서](https://intlayer.org/doc/vs-code-extension)를 참조하세요.
+`.use()` 메서드를 사용하여 Markdown 및 HTML 콘텐츠의 렌더링을 커스터마이징할 수 있습니다. 이 메서드를 사용하면 특정 태그의 기본 렌더링을 재정의할 수 있습니다.
 
----
+```tsx
+import { useIntlayer } from "preact-intlayer";
 
-<Steps>
+const { myMarkdownContent, myHtmlContent } = useIntlayer("my-component");
+
+// ...
+
+return (
+  <div>
+    {/* 기본 렌더링 */}
+    {myMarkdownContent}
+
+    {/* Markdown에 대한 커스텀 렌더링 */}
+    {myMarkdownContent.use({
+      h1: (props) => <h1 style={{ color: "red" }} {...props} />,
+    })}
+
+    {/* HTML에 대한 기본 렌더링 */}
+    {myHtmlContent}
+
+    {/* HTML에 대한 커스텀 렌더링 */}
+    {myHtmlContent.use({
+      b: (props) => <strong style={{ color: "blue" }} {...props} />,
+    })}
+  </div>
+);
+```
+
+</Step>
 
-<Step number={1} title="컴포넌트 콘텐츠 추출" isOptional={true}>
+<Step number={12} title="컴포넌트의 콘텐츠 추출" isOptional={true}>
 
-기존 코드베이스가 있는 경우 수천 개의 파일을 변환하는 데 시간이 많이 걸릴 수 있습니다.
+기존 codebase가 있는 경우 수천 개의 파일을 변환하는 것은 시간이 많이 걸릴 수 있습니다.
 
-이 프로세스를 용이하게 하기 위해 Intlayer는 컴포넌트를 변환하고 콘텐츠를 추출하기 위한 [컴파일러](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md) / [추출기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)를 제안합니다.
+이 프로세스를 용이하게 하기 위해 Intlayer는 컴포넌트를 변환하고 콘텐츠를 추출할 수 있는 [compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compiler.md) / [extractor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/extract.md)를 제공합니다.
 
-설정하려면 `intlayer.config.ts` 파일에 `compiler` 섹션을 추가할 수 있습니다.
+이를 설정하려면 `intlayer.config.ts` 파일에 `compiler` 섹션을 추가할 수 있습니다:
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
-  // ... 나머지 구성
+  // ... 나머지 설정
   compiler: {
     /**
-     * 컴파일러 활성화 여부를 나타냅니다.
+     * 컴파일러를 활성화할지 여부를 나타냅니다.
      */
     enabled: true,
 
@@ -759,7 +789,11 @@ const config: IntlayerConfig = {
     output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * 변환 후 컴포넌트를 저장할지 여부를 나타냅니다. 그렇게 하면 컴파일러를 한 번만 실행하여 앱을 변환한 다음 제거할 수 있습니다.
+     * 변환 후 컴포넌트를 저장할지 여부를 나타냅니다.
+     *
+     * - `true`인 경우, 컴파일러는 컴포넌트 파일을 디스크에 다시 작성합니다. 따라서 변환이 영구적이고 컴파일러는 다음 프로세스에서 변환을 건너뜁니다. 이렇게 하면 컴파일러가 앱을 변환한 후 제거할 수 있습니다.
+     *
+     * - `false`인 경우, 컴파일러는 빌드 출력에만 `useIntlayer()` 함수 호출을 주입하고 기본 codebase를 그대로 유지합니다. 변환은 메모리에서만 수행됩니다.
      */
     saveComponents: false,
 
@@ -776,7 +810,7 @@ export default config;
 <Tabs>
  <Tab value='추출 명령'>
 
-컴포넌트를 변환하고 콘텐츠를 추출하기 위해 추출기를 실행합니다
+추출기를 실행하여 컴포넌트를 변환하고 콘텐츠를 추출합니다.
 
 ```bash packageManager="npm"
 npx intlayer extract
@@ -797,9 +831,9 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel 컴파일러'>
 
-> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+> v9부터 `intlayerCompiler`는 `intlayer` 플러그인에 포함되어 있습니다. 따라서 수동으로 추가할 필요가 없습니다.
 
-`vite.config.ts`를 업데이트하여 `intlayerCompiler` 플러그인을 포함합니다.
+`intlayerCompiler` 플러그인을 포함하도록 `vite.config.ts`를 업데이트합니다:
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
@@ -808,7 +842,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Adds the compiler plugin
+    intlayerCompiler(), // 컴파일러 플러그인 추가
   ],
 });
 ```
@@ -826,7 +860,7 @@ yarn build # 또는 yarn dev
 ```
 
 ```bash packageManager="bun"
-bun run build # Or bun run dev
+bun run build # 또는 bun run dev
 ```
 
  </Tab>

package/docs/ko/intlayer_with_vite+vue.md

@@ -30,9 +30,7 @@ history:
 author: aymericzip
 ---
 
-# Intlayer로 Vite and Vue 번역하기 | 국제화(i18n)
-
-GitHub에서 [애플리케이션 템플릿](https://github.com/aymericzip/intlayer-vite-vue-template)을 확인하세요.
+# Intlayer를 사용하여 Vite 및 Vue 웹사이트 번역 | 국제화 (i18n)
 
 ## 목차
 

package/docs/ko/packages/intlayer/getLocalizedUrl.md

@@ -66,30 +66,32 @@ getLocalizedUrl(
   - **Type**: `Locales`
   - **Required**: Yes
 
-## 매개변수
-
-- `url: string`
-  - **설명**: 로케일 접두사가 붙을 원본 URL 문자열입니다.
-  - **타입**: `string`
-
-- `currentLocale: Locales`
-  - **설명**: URL이 지역화되는 현재 로케일입니다.
-  - **타입**: `Locales`
-
-- `locales: Locales[]`
-  - **설명**: 지원되는 로케일의 선택적 배열입니다. 기본적으로 프로젝트에 구성된 로케일이 제공됩니다.
-  - **타입**: `Locales[]`
-  - **기본값**: [`프로젝트 구성`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
-
-- `defaultLocale: Locales`
-  - **설명**: 애플리케이션의 기본 로케일입니다. 기본적으로 프로젝트에 구성된 기본 로케일이 제공됩니다.
-  - **타입**: `Locales`
-  - **기본값**: [`프로젝트 구성`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
-
-- `prefixDefault: boolean`
-  - **설명**: 기본 로케일에 대해 URL에 접두사를 붙일지 여부입니다. 기본적으로 프로젝트에 구성된 값이 제공됩니다.
-  - **타입**: `boolean`
-  - **기본값**: [`프로젝트 구성`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+### 선택적 매개변수
+
+- `options?: object`
+  - **설명**: URL 로컬라이제이션 동작을 위한 구성 객체입니다.
+  - **타입**: `object`
+  - **필수**: 아니오 (선택적)
+
+  - `options.locales?: Locales[]`
+    - **설명**: 지원되는 로컬의 배열입니다. 제공되지 않으면 프로젝트 구성에서 구성된 로컬을 사용합니다.
+    - **타입**: `Locales[]`
+    - **기본값**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **설명**: 애플리케이션의 기본 로컬입니다. 제공되지 않으면 프로젝트 구성에서 구성된 기본 로컬을 사용합니다.
+    - **타입**: `Locales`
+    - **기본값**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **설명**: 로컬 처리를 위한 URL 라우팅 모드입니다. 제공되지 않으면 프로젝트 구성에서 구성된 모드를 사용합니다.
+    - **타입**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **기본값**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
+    - **모드**:
+      - `prefix-no-default`: 기본 로컬에는 접두사 없음, 다른 모든 로컬에는 접두사 사용
+      - `prefix-all`: 기본 로컬을 포함한 모든 로컬에 접두사 사용
+      - `no-prefix`: URL에 로컬 접두사 없음
+      - `search-params`: 로컬에 쿼리 매개변수 사용 (예: `?locale=fr`)
 
 ### 반환값
 

package/docs/ko/packages/intlayer/getMultilingualUrls.md

@@ -50,26 +50,12 @@ getMultilingualUrls(
 
 ## 매개변수
 
-## 매개변수
+### 필수 매개변수
 
 - `url: string`
-  - **설명**: 로케일 접두사를 붙일 원본 URL 문자열입니다.
-  - **타입**: `string`
-
-- `locales: Locales[]`
-  - **설명**: 선택적 지원 로케일 배열입니다. 프로젝트에 구성된 로케일이 기본값입니다.
-  - **타입**: `Locales[]`
-  - **기본값**: `localesDefault`
-
-- `defaultLocale: Locales`
-  - **설명**: 애플리케이션의 기본 로케일입니다. 프로젝트에 구성된 기본 로케일이 기본값입니다.
-  - **타입**: `Locales`
-  - **기본값**: `defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **설명**: 기본 로케일에 접두사를 붙일지 여부입니다. 프로젝트에 구성된 값이 기본값입니다.
-  - **타입**: `boolean`
-  - **기본값**: `prefixDefaultDefault`
+  - **Description**: 로케일로 접두어가 붙을 원본 URL 문자열입니다.
+  - **Type**: `string`
+  - **Required**: Yes
 
 ### 선택적 매개변수
 

package/docs/ko/packages/vite-intlayer/exports.md

@@ -48,3 +48,18 @@ import "vite-intlayer";
 | `intlayerProxy`      | 로케일 감지와 라우팅을 처리하는 개발용 미들웨어 플러그인.                 | -                                                                                                                      |
 | `intlayerMiddleware` | (**사용 중단**) `intlayerProxy`의 별칭.                                   | -                                                                                                                      |
 | `intlayerPrune`      | 빌드 시 사용되지 않는 사전(딕셔너리)을 트리 쉐이킹하여 제거하는 플러그인. | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/intlayerPrune.md) |
+
+### 유틸리티
+
+| Export                       | Description                                                                                             | Related Doc                                                                                                            |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `createIntlayerProxyHandler` | 프레임워크에 독립적인 Node.js `(req, res, next)` 미들웨어를 반환하며, locale-routing 로직을 포함합니다. | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/intlayerProxy.md) |
+
+### 타입
+
+| Export                       | Description                                                                                                            |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | `intlayer()`에서 허용하는 옵션입니다. `GetConfigurationOptions`를 `compatCallers` 및 `proxy`로 확장합니다.             |
+| `IntlayerProxyPluginOptions` | `intlayerProxy()` 및 `createIntlayerProxyHandler()`에서 허용하는 옵션입니다. `ignore` 및 `configOptions`를 포함합니다. |
+| `IntlayerCompilerOptions`    | `intlayerCompiler()`에서 허용하는 옵션입니다. `configOptions` 및 `compilerConfig`를 포함합니다.                        |
+| `CompatCallerConfig`         | `@intlayer/babel`에서 재내보내기됩니다. 필드 사용 분석을 위한 compat-adapter 호출자 패턴을 설명합니다.                 |

package/docs/ko/packages/vite-intlayer/intlayer.md

@@ -39,11 +39,126 @@ export default defineConfig({
 });
 ```
 
-## 설명
+## 옵션
 
-이 플러그인은 다음 작업을 수행합니다:
+```ts
+import type { IntlayerPluginOptions } from "vite-intlayer";
+```
+
+`IntlayerPluginOptions`는 `GetConfigurationOptions` (참고: `@intlayer/config`)를 확장하며 다음의 추가 필드를 포함합니다:
+
+| 옵션            | 타입                            | 기본값      | 설명                                                                                                                        |
+| --------------- | ------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `compatCallers` | `CompatCallerConfig[]`          | `[]`        | compat-adapter 패키지(예: `@intlayer/react-i18next`)에 대한 추가 caller 패턴. 빌드 시간에 field-usage 분석기에 전달됩니다.  |
+| `proxy`         | `{ ignore?: (req) => boolean }` | `undefined` | bundled locale-routing proxy로 전달되는 옵션. `ignore`를 사용하여 특정 경로(예: API 라우트)를 locale 라우팅에서 제외합니다. |
+
+다른 모든 옵션(`override`, `configFile`, …)은 `getConfiguration()`으로 직접 전달됩니다.
+
+### 예시
+
+#### 로케일 라우팅에서 API 경로 무시하기
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+#### 커스텀 설정 파일 경로 포함
+
+```ts
+export default defineConfig({
+  plugins: [
+    intlayer({
+      configFile: "./config/intlayer.config.ts",
+    }),
+  ],
+});
+```
+
+#### compat-adapter callers와 함께
+
+```ts
+import { intlayer } from "vite-intlayer";
+import { reactI18nextCallerConfig } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      compatCallers: [reactI18nextCallerConfig],
+    }),
+  ],
+});
+```
+
+## 플러그인의 역할
+
+### 1. Dictionary preparation
+
+빌드가 시작되기 전에(그리고 dev에서는 한 시간에 한 번), `intlayer`는 `prepareIntlayer`를 호출하여 모든 `.content.ts` 파일을 `.intlayer/`에 저장된 최적화된 JSON 딕셔너리로 컴파일합니다.
+
+### 2. Module aliases
+
+플러그인은 Vite resolve aliases를 추가하여 `import { myDict } from 'intlayer/dictionaries/my-dict'`가 디스크의 컴파일된 JSON 파일로 해석되도록 합니다. SSR 빌드는 `ssr.noExternal`을 사용하여 모든 `@intlayer/*` 패키지가 aliases와 함께 번들링되도록 합니다.
+
+### 3. Dev-server watcher
+
+개발 모드에서 `chokidar` watcher가 시작됩니다. `.content.ts` 파일이 변경되면 dictionaries가 다시 컴파일되고 Vite의 HMR이 브라우저에 업데이트를 전파합니다.
+
+### 4. 번들된 locale-routing proxy (v9+)
+
+Intlayer v9 이후로 `intlayerProxy` 미들웨어는 `intlayer()` 내부에 자동으로 등록됩니다. 다음을 처리합니다:
+
+- URL 접두사, 쿠키 및 `Accept-Language` 헤더에서 locale 감지.
+- 감지된 locale이 현재 URL과 일치하지 않을 때 301 리다이렉트.
+- 프레임워크가 올바른 `[locale]` 경로 매개변수를 인식하도록 하는 내부 URL 재작성.
+
+프록시는 Intlayer 구성의 `routing.enableProxy`(기본값 `true`)로 제어됩니다. 완전히 비활성화하려면:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  routing: { enableProxy: false },
+});
+```
+
+별도의 `intlayerProxy()` 호출 없이 프록시 동작을 사용자 정의하려면 메인 플러그인에 `proxy` 옵션을 전달하세요:
+
+```ts
+intlayer({ proxy: { ignore: (req) => req.url?.startsWith("/api") } });
+```
+
+전체 라우팅 동작 참조는 [intlayerProxy documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/intlayerProxy.md)를 참조하세요.
+
+### 5. Bundled compiler (v9+)
+
+`compiler.enabled`가 `true`이고 **그리고** Intlayer 설정에서 `compiler.output`이 설정되어 있으면, `intlayer()`는 `intlayerCompiler`을 자동으로 등록합니다. 컴파일러는 component 파일 내에 직접 작성된 인라인 content 선언을 추출하고 변환 시간에 dictionaries에 작성합니다. [intlayerCompiler documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/intlayerCompiler.md)을 참조하세요.
+
+### 6. Build optimisations
+
+프로덕션 빌드 중에 플러그인은 다음을 추가합니다:
+
+- **intlayerOptimize** – `useIntlayer('key')` → `useDictionary(hash)`를 다시 작성하고 직접 JSON 임포트를 주입하는 Babel transform입니다.
+- **intlayerPrune** – dictionary JSON에서 사용하지 않는 content 필드를 제거합니다.
+- **intlayerMinify** – dictionary JSON을 압축하고 선택적으로 필드 이름을 난독화합니다.
+
+이들은 development 모드에서는 비활성화됩니다.
+
+## 더 이상 사용되지 않는 별칭
 
-1. **딕셔너리 준비(Prepare Dictionaries)**: 빌드 또는 개발(dev) 프로세스 시작 시 딕셔너리를 최적화된 파일로 컴파일합니다.
-2. **감시 모드(Watch Mode)**: 개발 모드에서 딕셔너리 파일의 변경을 감시하여 자동으로 재컴파일합니다.
-3. **별칭(Aliases)**: 애플리케이션에서 딕셔너리에 접근할 수 있도록 별칭을 제공합니다.
-4. **트리-쉐이킹(Tree-shaking)**: `intlayerPrune` 플러그인을 통해 사용되지 않는 번역을 트리-쉐이킹으로 제거하는 것을 지원합니다.
+| 더 이상 사용되지 않는 export | 대체 항목  |
+| ---------------------------- | ---------- |
+| `intlayerPlugin`             | `intlayer` |
+| `intLayerPlugin`             | `intlayer` |

package/docs/ko/packages/vite-intlayer/intlayerPrune.md

@@ -28,18 +28,91 @@ author: aymericzip
 
 `intlayerPrune` Vite 플러그인은 애플리케이션 번들에서 사용되지 않는 사전(dictionary)을 트리 쉐이킹하고 제거(prune)하는 데 사용됩니다. 이를 통해 필요한 다국어 콘텐츠만 포함되어 최종 번들 크기를 줄일 수 있습니다.
 
-## 사용
+## 사용법
+
+### `intlayer()`의 일부로 (권장)
+
+Intlayer config를 통해 pruning을 활성화하면 main plugin이 모든 것을 처리합니다:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  build: {
+    optimize: true, // prune과 minify를 모두 활성화합니다
+  },
+});
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Standalone
+
+플러그인 스택을 수동으로 구성하는 경우, `intlayerPrune`과 `intlayerMinify`는 한 번 생성하고 둘 다에 전달해야 하는 `PruneContext` 객체를 공유합니다:
 
 ```ts
-// vite.config.ts (Vite 설정 파일)
+// vite.config.ts
 import { defineConfig } from "vite";
-import { intlayer, intlayerPrune } from "vite-intlayer";
+import { intlayerPrune, intlayerMinify } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+import { getConfiguration } from "@intlayer/config/node";
+
+const intlayerConfig = getConfiguration();
+const pruneContext = createPruneContext();
 
 export default defineConfig({
-  plugins: [intlayer(), intlayerPrune()],
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext), // 선택사항, 동일한 context에서 읽음
+  ],
 });
 ```
 
-## 설명
+## 어떻게 작동하는가
+
+### 1. Usage analysis (buildStart)
+
+`buildStart` 중에 `intlayerOptimize` 플러그인(`intlayer()`의 일부)은 `build.filesList`에 나열된 모든 component 소스 파일을 스캔합니다. 각 `useIntlayer('key')` 또는 `getIntlayer('key')` 호출에 대해, 정확히 어떤 필드가 액세스되는지 기록합니다. 예를 들어:
+
+```ts
+const { title, description } = useIntlayer("myDict");
+// records: myDict → { title, description }
+```
+
+이는 모든 `transform` 호출이 실행되기 전에 `pruneContext.fieldUsageMap`을 구성합니다.
+
+### 2. JSON pruning (transform, enforce: 'pre')
+
+Vite가 컴파일된 dictionary JSON 파일을 처리할 때, `intlayerPrune`은 Vite의 built-in JSON → ESM 변환 전에 이를 가로챕니다. `pruneContext`에서 field-usage map을 읽고 기록된 usage set에 없는 모든 content field를 제거합니다.
+
+두 가지 content shape이 지원됩니다:
+
+- **Static dictionaries** — `{ nodeType: "translation", translation: { en: {...}, fr: {...} } }`. Fields는 `translation` 내에서 per-locale별로 pruned됩니다.
+- **Dynamic (per-locale) dictionaries** — flat `{ fieldA: ..., fieldB: ... }`. Fields는 top level에서 pruned됩니다.
+
+### 3. Edge cases
+
+사전의 콘텐츠 구조를 인식할 수 없는 경우(예: 비정상적인 중첩된 형태), 이는 `pruneContext.dictionariesWithEdgeCases`에 추가되고 **변경되지 않은 상태로 유지**됩니다. 경고가 기록됩니다. `intlayerMinify`도 이러한 사전을 건너뜁니다.
+
+### 4. Field-rename map
+
+pruning이 성공하면, `intlayerPrune`은 `pruneContext.dictionaryKeyToFieldRenameMap`도 작성합니다. 이는 원본 필드 이름을 짧은 별칭으로 매핑합니다. `intlayerMinify`는 이 맵을 읽어 출력 JSON의 필드 이름을 변경하고, `intlayerOptimize`의 Babel rename pass는 소스 파일의 property 접근을 그에 따라 업데이트합니다.
+
+## 활성화 조건
+
+`intlayerPrune`은 다음의 모든 조건이 참일 때**만** 활성화됩니다:
+
+1. Vite 명령이 `build`입니다.
+2. `build.optimize`가 `true`입니다 (또는 `undefined`인 경우, 빌드에 대해 기본값이 `true`입니다).
+3. Intlayer 구성에서 `build.purge`가 `true`입니다.
 
-플러그인은 소스 코드를 분석하여 실제로 사용되는 사전 키를 식별합니다. 그런 다음 번들된 사전 파일에서 사용되지 않는 내용을 제거합니다. 이는 특정 페이지나 컴포넌트에서 일부만 사용되는 다수의 사전을 포함한 대형 프로젝트에서 특히 유용합니다.
+`editor.enabled`가 `true`일 때는 편집기가 전체 사전 콘텐츠를 필요로 하기 때문에 자동으로 **비활성화**됩니다.

package/docs/ko/releases/v9.md

@@ -361,6 +361,18 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 ---
 
+## Self-Hosting
+
+Intlayer v9는 단일 명령으로 자신의 Intlayer 인스턴스를 실행할 수 있는 일급 지원을 제공합니다. Intlayer Cloud 계정이 필요하지 않습니다.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+설치 프로그램은 `docker-compose.yml` 및 `.env`를 다운로드하고, 필요한 시크릿을 자동으로 생성하며, `docker compose up -d`를 실행합니다. 대시보드, API, 데이터베이스, 객체 스토리지, 트랜잭션 이메일 등 모든 것이 컨테이너에서 로컬로 실행됩니다.
+
+---
+
 ## v8에서의 마이그레이션 노트
 
 v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는 변경 사항(breaking changes)이 포함되어 있지 않습니다. 하지만 다음과 같은 주요 변경 사항이 있습니다: