@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.21

package/docs/ko/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v6에 오신 것을 환영합니다! 이번 릴리스는 성능, 개발자 경험, 그리고 안정성에 중점을 두고 있습니다. 아래는 주요 내용과 마이그레이션 노트, 복사하여 붙여넣을 수 있는 예제들입니다.
 
+## 목차
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## 주요 내용
 
 - 누락된 번역을 감지하는 새로운 명령어: `npx intlayer content test`
@@ -294,6 +298,24 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Turbopack에서 파일을 감시하기 위한 병렬 프로세스
+
+`next dev --turbopack` 명령으로 Next.js 14 이상에서 Turbopack을 개발 서버로 사용할 때, 기본적으로 사전 변경 사항이 자동으로 감지되지 않습니다.
+
+이러한 제한은 Turbopack이 콘텐츠 파일의 변경 사항을 모니터링하기 위해 웹팩 플러그인을 병렬로 실행할 수 없기 때문입니다.
+
+이를 해결하기 위해 개발 서버와 Intlayer 빌드 감시기를 동시에 실행하기 위해 `--with` 옵션을 사용하여 `intlayer watch` 명령을 제공합니다.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## 마이그레이션 노트
 
 - 제거됨: `dictionaryOutput` (이전에는 `i18next` 또는 `next-intl`). 향후 버전에서 플러그형 어댑터로 다시 제공될 예정입니다. 구성에서 해당 필드를 제거하세요.
@@ -312,6 +334,12 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## v6에서 v7로의 마이그레이션 노트
+
+자세한 내용은 [v6에서 v7로의 마이그레이션 노트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/releases/v7.md)를 확인하세요.
+
+---
+
 ## 유용한 링크
 
 - [CLI 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/index.md)

package/docs/ko/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Intlayer v7에 오신 것을 환영합니다! 이번 주요 릴리스에서는 성능, 타입 안정성, 그리고 개발자 경험에서 큰 개선이 이루어졌습니다. 아래는 주요 내용과 마이그레이션 노트, 실용적인 예제들입니다.
 
+## 목차
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## 주요 내용
 
 - 더 빠른 빌드를 위한 캐싱 전략
@@ -261,6 +265,126 @@ setLocale("en");
 
 ---
 
+## 자동 코드 포맷팅: formatCommand 구성
+
+v7은 편집기 구성에서 `formatCommand` 옵션을 도입하여, Intlayer에 의해 작성될 때 콘텐츠 파일을 자동으로 포맷할 수 있도록 합니다. 이를 통해 콘텐츠 선언 파일 전체에서 일관된 코드 스타일과 포맷팅을 보장합니다.
+
+설정되지 않은 경우, Intlayer는 포맷 명령을 자동으로 감지하려고 시도합니다. prettier, biome, eslint의 다음 명령들을 해석하려고 시도합니다.
+
+### 설정
+
+`formatCommand` 옵션은 `{{file}}`이 실제 파일 경로로 대체되는 문자열 템플릿을 허용합니다:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### 지원되는 포매터
+
+파일 경로를 인수로 받는 모든 코드 포매터를 사용할 수 있습니다:
+
+**Biome 사용:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Prettier 사용:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**ESLint 사용:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Bun의 내장 포매터 사용:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### 이점
+
+- **일관된 형식 지정**: 모든 콘텐츠 파일이 프로젝트의 스타일 가이드라인에 따라 자동으로 형식이 지정됩니다
+- **개발자 경험**: Intlayer가 파일을 작성한 후 수동으로 형식을 지정할 필요가 없습니다
+- **팀 일관성**: 모든 팀 멤버가 동일한 형식을 콘텐츠 파일에 적용하도록 보장합니다
+- **CI/CD 통합**: 콘텐츠 파일이 자동화된 워크플로우에서 일관된 형식을 유지합니다
+
+### 작동 원리
+
+Intlayer가 content declaration 파일(`.content.ts`, `.content.js` 등)을 작성하거나 업데이트할 때, 지정된 format 명령을 파일에 대해 자동으로 실행합니다. `{{file}}` placeholder는 실제 파일 경로로 대체되며, 명령은 프로젝트의 base directory에서 실행됩니다.
+
+---
+
+## Dictionary Configuration: 더 나은 구성과 구조
+
+v7은 dictionary 관련 설정에 대한 더 나은 조직화와 개선된 컨텐츠 관리를 제공하는 새로운 전용 `dictionary` 설정 섹션을 도입합니다.
+
+### 새로운 dictionary 구성 구조
+
+`fill` 속성이 `content` 섹션에서 새로운 `dictionary` 섹션으로 이동되어 더 명확한 관심사의 분리를 제공합니다:
+
+**v6 configuration:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**v7 configuration:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### 새로운 구조의 이점
+
+- **더 명확한 구성**: 사전 관련 설정이 이제 함께 그룹화되어 있습니다
+- **더 나은 관심사의 분리**: 콘텐츠 발견과 사전 작업이 명확하게 분리됩니다
+- **향상된 유지보수성**: 사전 관련 구성을 더 쉽게 이해하고 수정할 수 있습니다
+- **향후 확장성**: 사전 섹션은 추가 사전 관련 설정을 수용할 수 있습니다
+- **포괄적인 사전 관리**: 새로운 사전을 만들고 관리하기 위한 `title`, `live`, `priority`, `tags`, `version`, `description`과 같은 속성을 포함합니다
+
+### 구성 사용
+
+dictionary 구성은 두 가지 주요 목적을 수행합니다:
+
+1. **기본값**: 콘텐츠 선언 파일을 생성할 때 기본값 정의
+2. **Fallback 동작**: 특정 필드가 정의되지 않았을 때 fallback 값을 제공하여 dictionary 작동 동작을 전역적으로 정의 가능
+
+dictionary 섹션에는 dictionary 관리를 위한 포괄적인 속성이 포함됩니다:
+
+- **`fill`**: 콘텐츠 생성을 위한 자동 채우기 동작
+- **`title`**: 새 dictionary의 기본 제목
+- **`live`**: 실시간 업데이트를 위한 라이브 동기화 구성
+- **`priority`**: dictionary 해석 우선순위 설정
+- **`tags`**: 콘텐츠 조직화를 위한 기본 태그
+- **`version`**: dictionary 업데이트를 위한 버전 관리
+- **`description`**: 새 콘텐츠의 기본 설명
+
+콘텐츠 선언 파일 및 구성 값이 적용되는 방법에 대한 자세한 정보는 [Content File Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)을 참조하세요.
+
+---
+
 ## fill 명령어: 더 나은 콘텐츠 관리를 위한 동작 업데이트
 
 v7에서는 `fill` 명령어의 동작이 개선되어 더 예측 가능하고 유연한 콘텐츠 관리를 제공합니다:
@@ -408,6 +532,10 @@ const content = {
 - **`middleware.prefixDefault`**: `routing.mode`로 대체됨
 - **`middleware.noPrefix`**: `routing.mode`로 대체됨
 
+### 새로운 설정
+
+- **`editor.formatCommand`**: 콘텐츠 파일의 자동 코드 포맷팅을 위한 새로운 옵션
+
 ### 마이그레이션 매핑
 
 #### 구성 매핑

package/docs/ko/releases/v9.md

@@ -1,15 +1,14 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-07-08
 title: 새로운 Intlayer v9 - 무엇이 달라졌나요?
-description: Intlayer v9의 새로운 기능을 알아보세요. 인기 있는 i18n 라이브러리를 위한 드롭인 호환성 패키지와 컬렉션(Collections), 베리언트(Variants), 동적 레코드(Dynamic Records) 지원을 소개합니다.
+description: Intlayer v9의 새로운 기능을 알아보세요. 인기 있는 i18n 라이브러리를 위한 드롭인 호환성 패키지와 컬렉션(Collections), 베리언트(Variants) 지원을 소개합니다.
 keywords:
   - Intlayer
   - 호환성
   - 마이그레이션
   - 컬렉션
   - 베리언트
-  - 동적 레코드
   - i18next
   - next-intl
   - vue-i18n
@@ -22,7 +21,7 @@ author: aymericzip
 
 # 새로운 Intlayer v9 - 무엇이 달라졌나요?
 
-Intlayer v9에 오신 것을 환영합니다! 이번 메이저 릴리스는 주요 i18n 라이브러리(`react-i18next`, `next-intl`, `vue-i18n` 등)를 위한 **호환 어댑터 패키지(Compat Adapter Packages)**를 통해 Intlayer로의 마이그레이션 경로를 획기적으로 단순화하고, **컬렉션(Collections)**, **베리언트(Variants)**, **동적 레코드(Dynamic Records)**와 같은 풍부한 콘텐츠 구조 지원을 추가하는 큰 이정표를 세웠습니다.
+Intlayer v9에 오신 것을 환영합니다! 이번 메이저 릴리스는 주요 i18n 라이브러리(`react-i18next`, `next-intl`, `vue-i18n` 등)를 위한 **호환 어댑터 패키지(Compat Adapter Packages)**를 통해 Intlayer로의 마이그레이션 경로를 획기적으로 단순화하고, **컬렉션(Collections)** 및 **베리언트(Variants)**와 같은 풍부한 콘텐츠 구조 지원을 추가하는 큰 이정표를 세웠습니다.
 
 ## 목차
 
@@ -41,8 +40,10 @@ Intlayer v9에 오신 것을 환영합니다! 이번 메이저 릴리스는 주
 - `@intlayer/i18next`
 - `@intlayer/react-i18next`
 - `@intlayer/next-intl`
+- `@intlayer/react-intl`
 - `@intlayer/next-i18next`
 - `@intlayer/vue-i18n`
+- `@intlayer/lingui`
 
 예를 들어, 다음과 같이 간단히 변경하면 됩니다:
 
@@ -100,7 +101,7 @@ export default defineConfig({
 
 ---
 
-## 기능 사양: 컬렉션, 베리언트 및 동적 레코드
+## 기능 사양: 컬렉션 및 베리언트
 
 Intlayer v9은 정적인 키-값 객체를 넘어, 딕셔너리가 처음부터 끝까지 완전히 타입 지정된 동적 레이아웃 구조를 선언할 수 있도록 확장되었습니다.
 
@@ -108,42 +109,48 @@ Intlayer v9은 정적인 키-값 객체를 넘어, 딕셔너리가 처음부터
 
 CMS에서 관리하는 순서가 있는 아이템 목록(예: FAQ, 제품 또는 블로그 목록)을 정의합니다:
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        ko: "Intlayer가 무엇인가요?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        ko: "i18n 툴킷입니다.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### 사용법:
 
 ```ts
-// 모든 아이템 가져오기
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// 인덱스로 단일 아이템 가져오기
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. 베리언트 (Variants)
 
 A/B 테스트, 시즌별 헤더, 피처 플래그(feature flags) 또는 커스텀 랜딩 페이지를 제공합니다:
 
+#### 문자열 베리언트 (예: A/B 테스트)
+
 ```ts fileName="hero.content.ts"
 import { t, type Dictionary } from "intlayer";
 
@@ -167,16 +174,14 @@ export default {
 const banner = useIntlayer("hero-banner", { variant: "black_friday" });
 ```
 
-### 3. 동적 레코드 (Dynamic Records)
-
-쿼리 ID를 통해 런타임에 동적으로 로드되는 항목을 가진 딕셔너리를 정의합니다:
+#### 객체 베리언트 (예: 동적 레코드)
 
 ```ts fileName="product.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "product-copy",
-  meta: {
+  variant: {
     id: "prod_123",
     category: "books",
   },
@@ -191,28 +196,159 @@ export default {
 ```ts
 // 요청된 아이템만 동적으로 가져옵니다 (Suspense 필요)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## 동적 로딩 및 번들 크기 최적화
+## `@intlayer/analytics`: 콘텐츠 노출 추적 및 A/B 테스트
+
+새로운 선택적 패키지 [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)는 방문자에게 실제로 어떤 콘텐츠가 표시되는지 알려주며, **Collections & Variants**의 마지막 퍼즐을 완성하여 콘텐츠 A/B 테스트와 변형별 전환 측정을 가능하게 합니다.
+
+- **프로바이더 수준 추적**: `IntlayerProvider`(React / Next.js / React Native)는 로드, 라우트 변경, 로케일 변경 시 `page_view` 이벤트를 자동으로 기록합니다.
+- **노드 수준 추적**: `useIntlayer`가 해석될 때마다 `content_exposure` 이벤트가 전송됩니다 — 어떤 딕셔너리 키, 키 경로, 로케일, 그리고 (해당하는 경우) 어떤 A/B **변형**이 표시되었는지. 플러시 창 내에서 동일 노드에 대한 반복 노출은 하나의 이벤트로 병합됩니다.
+- **결정론적 A/B 할당**: `getVariant(experimentKey, variants)`는 서버 왕복 없이 각 세션에 변형을 할당하므로 첫 렌더링 전 깜빡임이 없습니다.
+- **`useConversion()`**: 세션이 노출된 변형에 목표(가입, 클릭, 구매 등)를 귀속시킵니다.
+- **설치하지 않으면 비용 없음**: `@intlayer/editor`와 동일한 tree-shakeable 패턴 — `try/catch`로 감싼 동적 `import()`와, 이를 사용하지 않는 앱에서 전체 통합을 데드 코드로 제거하는 빌드 타임 환경 변수(`INTLAYER_ANALYTICS_ENABLED`).
+- **새로운 설정 스키마 없음**: 기존 `editor.backendURL`(수집 엔드포인트 / 셀프 호스팅)과 `editor.clientId`(프로젝트 키이자 활성화 스위치)를 재사용합니다.
+- **개인정보 보호**: 세션 익명 해시화(SHA-256, 원본 ID 미저장), IP 미저장, 국가 단위의 대략적인 위치 정보만 사용, 약 20초마다 배치로 요청 전송.
+- **대시보드**: 새로운 **Analytics** 페이지(프로젝트 선택 시 사이드바에 표시)에서 활성 사용자, 오늘의 사용자, 지난 7/30/90일 사용자, 방문자 추이 그래프, 로케일 및 위치별 분석을 확인할 수 있습니다.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
+};
+```
 
-번들 크기를 극도로 작게 유지하기 위해, Intlayer v9은 동적 지연 로딩(dynamic lazy loading)을 지원합니다.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
 
-설정에서 `importMode`를 `'dynamic'` 또는 `'fetch'`로 설정하세요:
+현재 React, Next.js, React Native(`react-intlayer` 경유)에서 사용할 수 있습니다. 다른 프레임워크 바인딩(Vue, Svelte, Angular 등)은 `@intlayer/editor`와 동일한 배포 방식으로 계획되어 있습니다. 전체 가이드는 [Analytics 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)를 참조하세요.
+
+---
+
+## Vite Plugin: 번들된 컴파일러 & 프록시
+
+`intlayer()` Vite 플러그인은 이제 **컴파일러**와 **로케일 라우팅 프록시**를 직접 번들로 제공하므로, 대부분의 프로젝트는 `vite.config.ts`에서 단일 플러그인만 필요합니다:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: `compiler.enabled`가 `true`로 설정되고 `compiler.output` 경로가 구성되면 자동으로 활성화됩니다. 더 이상 `intlayerCompiler()`를 별도로 등록할 필요가 없습니다.
+- **Proxy**: 새로운 `routing.enableProxy` 옵션(`기본값: true`)을 기반으로 자동으로 활성화됩니다. 개발, 미리보기 및 프로덕션 SSR에서 로케일 감지 / 리다이렉트 / 재작성 미들웨어를 연결합니다. 더 이상 `intlayerProxy()`를 별도로 등록할 필요가 없습니다.
+
+### `routing.enableProxy` 옵션
+
+새로운 `routing.enableProxy` 옵션은 locale-routing proxy가 연결되는지 여부를 제어합니다. 기본값은 `true`입니다. locale routing을 직접 처리하고 싶을 때 비활성화하세요:
 
 ```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // 기본값: true
+  },
+};
+
+export default config;
+```
+
+독립형 `intlayerCompiler()` 및 `intlayerProxy()` 플러그인은 고급 설정을 위해 계속 내보내집니다. 이들을 `intlayer()`와 함께 등록하는 것은 안전합니다 — 각 플러그인은 자동으로 중복을 제거하고 한 번만 실행됩니다.
+
+---
+
+## 컴파일러는 기본적으로 비활성화
+
+Intlayer v9부터 **컴파일러는 기본적으로 비활성화됩니다**(`compiler.enabled`의 기본값이 이제 `false`입니다). `.content.ts` 파일의 빌드 타임 추출을 활성화하려면 구성에서 `compiler.enabled: true`를 설정하세요:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // 기본값: false — v9부터 컴파일러를 활성화하는 데 필요
+    output: ({ fileName }) => `./${fileName}.content.ts`,
   },
 };
+
+export default config;
+```
+
+컴파일러가 비활성화되면 Intlayer는 빌드 타임 추출 단계를 건너뛰고 이미 선언한 딕셔너리에 의존합니다. 번들러 플러그인(`@intlayer/swc`, `@intlayer/babel` 또는 `intlayer()` Vite 플러그인)이 콘텐츠를 자동으로 추출하기를 원할 때만 활성화하세요.
+
+---
+
+## React Native: 단일 패키지 임포트
+
+React Native 또는 Expo 앱에서는 더 이상 `react-intlayer`와 `react-native-intlayer`를 번갈아 사용할 필요가 없습니다. `react-native-intlayer` 패키지는 이제 **`react-intlayer`의 전체 API를 다시 내보내며** (훅, 유틸리티 및 `/format`, `/html`, `/markdown` 하위 경로), `IntlayerProvider`는 React Native 폴리필을 자동으로 적용합니다.
+
+단일 `react-native-intlayer` 패키지에서 모든 것을 임포트하세요:
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> `react-intlayer`에서 임포트하는 것도 계속 작동하지만, 이제 React Native에 권장되는 단일 진입점은 `react-native-intlayer`입니다. 이 패키지의 프로바이더는 웹 지향적인 `react-intlayer` 프로바이더에는 없는 폴리필을 제공합니다.
+
+---
+
+## CMS SDK: Intlayer를 헤드리스 콘텐츠 데이터베이스로 사용하기
+
+Intlayer v9는 CMS를 프로그래밍 방식으로 다루기 위한 깔끔하고 자동 인증되는 SDK를 `@intlayer/api`에 포함합니다. 프로젝트 가져오기, 사전 가져오기, 그리고 자체 서버·스크립트·CI에서의 푸시 또는 업데이트가 가능합니다. 인증(OAuth2 `client_credentials`)은 자동으로 처리되고 갱신됩니다.
+
+SDK는 **두 개의 분리된 import**로 나뉘어, 실제로 사용하는 도메인만 번들에 포함됩니다:
+
+1. `createIntlayerCMS` — 자격 증명과 관리되는 토큰을 보유하는 가벼운 **인증기**(도메인 클라이언트는 번들되지 않음).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — 도메인별 **엔드포인트 바인더**로, 각각 자체 서브패스에서 가져옵니다.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// 구성은 선택 사항입니다: 자격 증명은 INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET(`@intlayer/config/built`로 해석됨)로 폴백됩니다.
+const cms = createIntlayerCMS();
+
+// 읽기
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// 쓰기 — CMS를 데이터베이스처럼 사용
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 ```
 
-빌드 타임에 `@intlayer/swc` 및 `@intlayer/babel`이 파일을 스캔하여 `useIntlayer` / `getIntlayer` 호출을 트리 쉐이킹(tree-shaking)이 가능한 래퍼(`useDictionary` / `useDictionaryDynamic`)로 대체합니다. 선택한 컬렉션 아이템, 베리언트 또는 로케일에 필요한 콘텐츠만 로드되므로, 프로덕션 번들에 사용되지 않는 번역이 포함되는 것을 방지합니다.
+> 보안: CMS 자격 증명은 콘텐츠에 대한 쓰기 권한을 부여합니다. 인증기는 항상 **서버 측**에서만 생성하고, `clientId` / `clientSecret`을 브라우저로 절대 보내지 마세요.
 
 ---
 
@@ -220,13 +356,16 @@ export default {
 
 v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는 변경 사항(breaking changes)이 포함되어 있지 않습니다. 하지만 다음과 같은 주요 변경 사항이 있습니다:
 
+- **컴파일러는 기본적으로 비활성화**: `compiler.enabled`의 기본값이 이제 `false`입니다. `.content.ts` 파일의 빌드 타임 추출에 의존하는 경우 `intlayer.config.ts`에서 `compiler.enabled: true`를 설정하세요.
 - **로케일 및 다이얼렉트 (Locales & Dialects)**: 외부 i18n 의존성을 사용하는 경우, 설정 또는 번들러 구성에 해당 호환 어댑터 플러그인을 추가하여 임포트를 자동으로 변환하세요.
-- **커스텀 셀렉터 (Custom Selectors)**: `useIntlayer`를 호출할 때 두 번째 매개변수는 이제 `{ locale, item, variant, id }`를 포함하는 옵션 객체 전용으로 예약됩니다. 이전에 로케일 문자열을 직접 전달했다면 여전히 그렇게 사용할 수 있지만, 고급 선택을 위해서는 옵션 객체를 사용하는 것을 권장합니다.
+- **커스텀 셀렉터 (Custom Selectors)**: `useIntlayer`를 호출할 때 두 번째 매개변수는 이제 `{ locale, item, variant }`를 포함하는 옵션 객체 전용으로 예약됩니다. 이전에 로케일 문자열을 직접 전달했다면 여전히 그렇게 사용할 수 있지만, 고급 선택을 위해서는 옵션 객체를 사용하는 것을 권장합니다.
 
 ---
 
 ## 유용한 링크
 
 - [호환 어댑터 패키지 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)
-- [동적 딕셔너리 - 컬렉션, 베리언트 및 동적 레코드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)
+- [동적 딕셔너리 - 컬렉션 및 베리언트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)
+- [Analytics - 콘텐츠 노출 추적 및 A/B 테스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [설정 레퍼런스](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)
+- [CMS SDK - @intlayer/api를 통한 프로그래밍 방식 접근](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)

package/docs/ko/roadmap.md

@@ -29,6 +29,12 @@ Intlayer는 애플리케이션 전반에서 콘텐츠를 선언, 관리 및 업
 
 ---
 
+## 목차
+
+<TOC/>
+
+---
+
 ## 현재 기능
 
 ### 1. 콘텐츠 선언