@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.10

package/docs/ko/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: 새로운 Intlayer v8 - 무엇이 새로워졌나요?
 description: Intlayer v8의 신규 기능을 확인하세요. 이번 릴리스는 developer experience 향상, schema validation을 통한 데이터 무결성 보장, 그리고 dictionary management에 대한 제어 강화에 중점을 둡니다.
 keywords:
@@ -409,6 +409,16 @@ v7에서는 Provider가 정의되지 않은 경우 Markdown 노드가 원시 문
 
 ---
 
+## YAML 및 Markdown 콘텐츠 파일 (v8.10.0)
+
+이제 `.content.md` 및 `.content.yaml` 파일 확장자를 사용하여 콘텐츠를 직접 선언할 수 있습니다. 이는 긴 형식의 콘텐츠, 블로그, 문서 및 개인정보 처리방침에 적합합니다.
+
+이 파일들은 Visual Editor에서 완전히 편집할 수 있어, 비기술 팀원들에게 간소화된 워크플로우를 제공합니다.
+
+자세한 내용은 [YAML 콘텐츠 파일 문서](https://intlayer.org/doc/concept/content#yaml-content-file) 및 [Markdown 콘텐츠 파일 문서](https://intlayer.org/doc/concept/content/markdown)를 참조하세요.
+
+---
+
 ## 사용자 정의 URL 재작성
 
 Intlayer v8은 **사용자 정의 URL 재작성(Custom URL Rewrites)** 을 도입하여 표준 `/locale/path` 구조와 다른 로케일별 경로를 정의할 수 있게 합니다. 이는 로컬 SEO를 개선하고 영어가 아닌 사용자에게 보다 자연스러운 사용자 경험을 제공하는 강력한 기능입니다.
@@ -753,6 +763,63 @@ export default {
   </Tab>
 </Tabs>
 
+---
+
+## Unicode CLDR 복수형 규칙 (v8.8.0)
+
+Unicode CLDR 프로젝트에서 정의한 복수형 규칙을 기반으로 하는 새로운 `plural` 노드 헬퍼가 도입되어 복잡한 언어에 대한 지원이 향상되었습니다.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      ko: plural({
+        other: "{{count}}개의 채용 공고",
+      }),
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+이후 프레임워크 컴포넌트에서 동적으로 count를 전달할 수 있습니다:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* 영어 기준:                                    */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+자세한 내용은 [복수형 문서](https://intlayer.org/doc/concept/content/plural)를 참조하세요.
+
+---
+
 ## 콘텐츠 스키마 검증
 
 Intlayer v8에서는 딕셔너리에 대한 스키마 검증을 도입합니다. 이제 Zod를 사용해 구성 파일에 재사용 가능한 검증 스키마를 정의하고 이를 콘텐츠 파일에 적용할 수 있습니다. 이를 통해 콘텐츠가 항상 예상된 구조를 따르도록 보장하여 빌드 시점에 오류를 포착할 수 있습니다.
@@ -797,6 +864,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: IntlayerNode 기본형 접근자 (Primitive Accessors)
+
+`IntlayerNode` 타입이 업데이트되어 콘텐츠 노드에서 직접 JavaScript 기본형(primitive) 메서드를 호출할 수 있게 되었습니다. 이를 통해 지역화된 콘텐츠를 표준 string, number, boolean 또는 array 기본형인 것처럼 직접 상호작용할 수 있습니다.
+
+React, Preact, Solid, Svelte, Vue 및 Angular에서 지원됩니다.
+
+### String 예제
+
+```typescript
+content.placeholder; // IntlayerNode<string> 반환
+content.placeholder.value; // string 반환
+content.placeholder.toString(); // string 반환
+content.placeholder.toLowerCase(); // string 반환
+String(content.placeholder); // string 반환
+content.placeholder.toUpperCase(); // 대문자로 변환된 string 반환
+content.placeholder.replace("a", "b"); // 수정된 string 반환
+```
+
+### Array 예제
+
+```typescript
+content.myArrayOfString             // IntlayerNode<Array<string>> 반환
+content.myArrayOfString.find(...)   // 요소 반환
+content.myArrayOfString.join(', ')  // 결합된 string 반환
+```
+
+---
+
 ### 향상된 자동 콘텐츠 감지
 
 v8에서 Intlayer는 콘텐츠 문자열에서 Markdown 문법, HTML 태그 및 변수 삽입을 지능적으로 감지합니다. 이는 `md()`, `html()`, 또는 `insert()`와 같은 헬퍼 함수를 종종 생략할 수 있음을 의미합니다.
@@ -1002,6 +1097,17 @@ Intlayer VSCode 확장 기능은 v8에서 국제화 워크플로우를 간소화
 
 ---
 
+## 도구: C++ Watcher 및 OXC 기반 LSP (v8.12.0)
+
+Intlayer v8.12.0은 developer experience에 큰 개선을 가져왔습니다:
+
+- **Parcel Watcher**: 콘텐츠 감시자(watcher)가 `chokidar`에서 `@parcel/watcher`로 마이그레이션되어, 네이티브 C++ 파일 감시를 활용해 더 빠른 업데이트와 현저히 낮은 메모리 소비를 제공합니다.
+- **새로운 언어 서버 프로토콜 (LSP)**: 완전히 새로운 LSP를 이제 사용할 수 있습니다. OXC 기반 파싱으로 구축되어, IDE 및 AI 에이전트가 `useIntlayer('my-key')` 호출을 해당하는 `.content` 파일과 원활하게 연결할 수 있도록 돕습니다.
+
+자세한 내용은 [LSP 문서](https://intlayer.org/doc/lsp)를 참조하세요.
+
+---
+
 ## 컴파일러 최적화
 
 Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레이어가 포함되어 있습니다. 이는 동일한 설정을 가진 동일한 콘텐츠 문자열을 한 번만 파싱하도록 하여, 재렌더링 시나 동일한 콘텐츠를 여러 곳에서 사용할 때 발생하는 오버헤드를 크게 줄여줍니다.
@@ -1057,6 +1163,48 @@ Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레
 
 ---
 
+## 실험적 빌드 최적화: Minify 및 Purge (v8.7.0)
+
+Intlayer v8.7.0은 프로덕션 번들을 최적화하기 위해 설계된 새로운 실험적 빌드 기능을 `intlayer.config.ts`에 도입합니다:
+
+- **딕셔너리 경량화 (Minification)**: 크기를 줄이기 위해 딕셔너리 파일을 압축합니다.
+- **사용되지 않는 키 제거 (Unused Key Purging)**: 딕셔너리에서 사용되지 않는 번역 키를 스캔하여 제거하고, 활성 키의 이름을 짧은 문자(예: `"products" -> "a"`, `"pricing" -> "b"`)로 변경합니다. 이를 통해 번들 크기를 최대 5%까지 줄일 수 있습니다.
+- **TypeScript 검사 비활성화**: 컴파일 단계에서 TypeScript 타입 검사를 비활성화하여 빌드 속도를 높입니다.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * 번들 크기를 줄이기 위해 딕셔너리를 경량화(minify)합니다.
+     */
+    minify: true,
+
+    /**
+     * 딕셔너리에서 사용되지 않는 키를 제거(purge)합니다.
+     */
+    purge: true,
+
+    /**
+     * 빌드 시 TypeScript 타입을 확인할지 여부를 나타냅니다.
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## 유연성: 통합된 Import 모드
 
 `live` boolean 속성은 더 포괄적인 `importMode` 속성으로 대체(deprecated)되었습니다. 이를 통해 딕셔너리를 정적(static), 동적(dynamic), 또는 라이브 동기화 방식으로 어떻게 로드할지 명시적으로 정의할 수 있습니다.
@@ -1204,6 +1352,49 @@ Svelte에서의 Markdown 및 HTML 콘텐츠는 이제 문자열화될 때 자동
 
 ---
 
+## Angular 지원: Vite 번들러 (v8.11.0)
+
+Angular 사용자를 위해, Intlayer는 이제 새로운 커스텀 esbuild 플러그인을 통해 Vite 번들러를 기본적으로 지원하여 개발 및 빌드 시간을 단축합니다.
+
+구성에 대한 자세한 내용은 [Angular 환경 문서](https://intlayer.org/doc/environment/angular)를 참조하세요.
+
+---
+
+## 사이트맵 생성 (v8.6.0)
+
+Intlayer는 이제 로케일 및 라우팅 모드를 기반으로 사이트맵을 자동으로 생성합니다. 이는 TanStack Router와 같은 라우터 아키텍처에서 SEO 최적화에 특히 유용합니다:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## v7에서의 마이그레이션 노트
 
 ### 구성 변경사항

package/docs/ko/releases/v9.md

@@ -0,0 +1,316 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: 새로운 Intlayer v9 - 무엇이 달라졌나요?
+description: Intlayer v9의 새로운 기능을 알아보세요. 인기 있는 i18n 라이브러리를 위한 드롭인 호환성 패키지와 컬렉션(Collections), 베리언트(Variants) 지원을 소개합니다.
+keywords:
+  - Intlayer
+  - 호환성
+  - 마이그레이션
+  - 컬렉션
+  - 베리언트
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# 새로운 Intlayer v9 - 무엇이 달라졌나요?
+
+Intlayer v9에 오신 것을 환영합니다! 이번 메이저 릴리스는 주요 i18n 라이브러리(`react-i18next`, `next-intl`, `vue-i18n` 등)를 위한 **호환 어댑터 패키지(Compat Adapter Packages)**를 통해 Intlayer로의 마이그레이션 경로를 획기적으로 단순화하고, **컬렉션(Collections)** 및 **베리언트(Variants)**와 같은 풍부한 콘텐츠 구조 지원을 추가하는 큰 이정표를 세웠습니다.
+
+## 목차
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## 호환 어댑터 패키지 (Compat Adapter Packages)
+
+인기 있는 i18n 라이브러리에서 Intlayer로 마이그레이션하는 것이 그 어느 때보다 쉬워졌습니다. 표준 i18n 라이브러리와 **완전히 동일한 공개 API**를 노출하면서 런타임 시 모든 번역 작업을 Intlayer에 위임하는 5개의 호환 패키지를 출시했습니다.
+
+### 엄격한 타입 지정을 통한 동일한 공개 API 노출
+
+임포트(import) 경로를 바꾸는 것만으로, 최소한의 코드 변경을 통해 실제 딕셔너리에 대한 컴파일 타임 타입 안전성을 포함한 Intlayer의 모든 이점을 누릴 수 있습니다:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+예를 들어, 다음과 같이 간단히 변경하면 됩니다:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+을 다음과 같이 변경합니다:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+이제 키는 Intlayer 딕셔너리에 대해 **엄격하게 타입 지정(strictly typed)**되어 IDE에서 완전한 점 표기법(dot-path) 자동 완성을 제공합니다!
+
+### 번들러 에일리어스 플러그인 (Vite, Next.js, Turbopack)
+
+모든 임포트 문을 수동으로 다시 작성하지 않고도 마이그레이션할 수 있도록, 각 호환 어댑터 패키지에는 `/plugin` 서브패스 아래에 **커스텀 번들러 플러그인**(Vite 또는 Next.js)이 포함되어 있습니다.
+
+이 플러그인들은 빌드 타임에 기존 임포트(예: `react-i18next` 또는 `next-intl`)를 그에 해당하는 `@intlayer/*` 패키지로 자동 변환합니다.
+
+#### Next.js (Webpack / Turbopack) 예시
+
+`withIntlayer` 대신, Next.js 설정을 호환 플러그인으로 감싸세요:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Vite (React, Vue, Solid, Svelte) 예시
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## 통합 런타임 리졸버 (Mutualized Runtime Resolver)
+
+모든 호환 어댑터는 이제 고도로 최적화된 단일 런타임 파서인 `@intlayer/core/messageFormat`을 통해 번역 해석을 라우팅합니다.
+
+- **메시지 보간 (Interpolate Message)**: 표준 `{{var}}` (공백 및 점 표기법 경로), ICU 포맷 인수 (`{v, number, percent}` 등), 그리고 기본 `{var}` 템플릿을 해석합니다.
+- **메시지 노드 리졸버 (Message Node Resolver)**: 중첩된 노드들을 해석합니다: `insert()`, `plural()` (CLDR 복수형 규칙), `enu()` (열거형), `gender()`, HTML 태그, 배열, 그리고 호출 가능한 함수 노드.
+- **토큰화된 태그 파서 (Tokenized Tag Parser)**: 인라인 XML/HTML 태그 및 번호가 매겨진 태그(예: `<1>children</1>`)를 지원하여 서식 있는 텍스트(rich-text) 렌더링을 기본적으로 지원합니다.
+
+---
+
+## 기능 사양: 컬렉션 및 베리언트
+
+Intlayer v9은 정적인 키-값 객체를 넘어, 딕셔너리가 처음부터 끝까지 완전히 타입 지정된 동적 레이아웃 구조를 선언할 수 있도록 확장되었습니다.
+
+### 1. 컬렉션 (Collections)
+
+CMS에서 관리하는 순서가 있는 아이템 목록(예: FAQ, 제품 또는 블로그 목록)을 정의합니다:
+
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  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 }[]
+
+// 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";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ ko: "환영합니다", en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({
+      ko: "지금 쇼핑하기",
+      en: "Shop now",
+      fr: "Acheter maintenant",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+#### 사용법:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### 객체 베리언트 (예: 동적 레코드)
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ ko: "클린 코드", en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### 사용법:
+
+```ts
+// 요청된 아이템만 동적으로 가져옵니다 (Suspense 필요)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## 동적 로딩 및 번들 크기 최적화
+
+번들 크기를 극도로 작게 유지하기 위해, Intlayer v9은 동적 지연 로딩(dynamic lazy loading)을 지원합니다.
+
+설정에서 `importMode`를 `'dynamic'` 또는 `'fetch'`로 설정하세요:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+빌드 타임에 `@intlayer/swc` 및 `@intlayer/babel`이 파일을 스캔하여 `useIntlayer` / `getIntlayer` 호출을 트리 쉐이킹(tree-shaking)이 가능한 래퍼(`useDictionary` / `useDictionaryDynamic`)로 대체합니다. 선택한 컬렉션 아이템, 베리언트 또는 로케일에 필요한 콘텐츠만 로드되므로, 프로덕션 번들에 사용되지 않는 번역이 포함되는 것을 방지합니다.
+
+---
+
+## 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"
+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` 프로바이더에는 없는 폴리필을 제공합니다.
+
+---
+
+## v8에서의 마이그레이션 노트
+
+v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는 변경 사항(breaking changes)이 포함되어 있지 않습니다. 하지만 다음과 같은 주요 변경 사항이 있습니다:
+
+- **컴파일러는 기본적으로 비활성화**: `compiler.enabled`의 기본값이 이제 `false`입니다. `.content.ts` 파일의 빌드 타임 추출에 의존하는 경우 `intlayer.config.ts`에서 `compiler.enabled: true`를 설정하세요.
+- **로케일 및 다이얼렉트 (Locales & Dialects)**: 외부 i18n 의존성을 사용하는 경우, 설정 또는 번들러 구성에 해당 호환 어댑터 플러그인을 추가하여 임포트를 자동으로 변환하세요.
+- **커스텀 셀렉터 (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/configuration.md)

package/docs/ko/roadmap.md

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

package/docs/nl/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Scan commando toegevoegd"
   - version: 8.6.4

package/docs/nl/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Scan commando toegevoegd"
 author: aymericzip

package/docs/nl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: Configuratie (Configuration)
 description: Leer hoe u Intlayer configureert voor uw applicatie. Begrijp de verschillende instellingen en opties die beschikbaar zijn om Intlayer aan uw behoeften aan te passen.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Optie `format` toegevoegd aan de woordenboekconfiguratie"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Ondersteuning voor LM Studio-provider toegevoegd"
@@ -135,6 +138,7 @@ Intlayer accepteert JSON-, JS-, MJS- en TS-configuratiebestandsformaten:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -583,9 +587,37 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Configuratie van plugins.
+   * Woordenboekconfiguratie.
    */
-  plugins: [],
+  dictionary: {
+    /**
+     * Bepaalt hoe woordenboeken worden geïmporteerd.
+     * - "static": Statisch geïmporteerd tijdens de build.
+     * - "dynamic": Dynamisch geïmporteerd via Suspense.
+     * - "fetch": Dynamisch opgehaald via de live sync API.
+     */
+    importMode: "static",
+
+    /**
+     * Het standaard berichtformaat voor alle woordenboeken in het project.
+     * - 'intlayer': Native intlayer-formaat (standaard).
+     * - 'icu': ICU-berichtformaat.
+     * - 'i18next': i18next-formaat.
+     * - 'vue-i18n': Vue I18n-formaat.
+     * - 'po': GNU Gettext PO-formaat.
+     */
+    format: "icu",
+  },
+
+  /**
+   * Plugin-configuratie.
+   */
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -862,6 +894,7 @@ Parameters die operaties met woordenboeken regelen, inclusief het gedrag bij aut
 | `contentAutoTransformation` | Transformeert de contentstrings automatisch naar getypeerde nodes (markdown, HTML of invoeging).                                                                                       | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`        | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Invoeging : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                   |
 | `location`                  | Geeft aan waar de woordenboekbestanden worden bewaard en hoe ze worden gesynchroniseerd met de CMS.                                                                                    | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`      | `'hybrid'`                                                                                  | • `'local'`: alleen lokaal beheer.<br/>• `'remote'`: alleen extern beheer (CMS).<br/>• `'hybrid'`: zowel lokaal als extern beheer.<br/>• `'plugin'` of een aangepaste string: beheer door een plugin of aangepaste bron.                                                                                                                                                                                       |
 | `importMode`                | Beheert de manier waarop woordenboeken worden geimporteerd.                                                                                                                            | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`     | `'dynamic'`                                                                                 | • `'static'`: statische import.<br/>• `'dynamic'`: dynamische import via Suspense.<br/>• `'fetch'`: ophalen via Live Sync API; uitstel tot `'dynamic'` bij mislukking.<br/>• Vereist plug-ins `@intlayer/babel` en `@intlayer/swc`.<br/>• Sleutels moeten statisch worden gedeclareerd.<br/>• Wordt genegeerd als `optimize` is uitgeschakeld.<br/>• Heeft geen invloed op `getIntlayer`, `getDictionary` enz. |
+| `format`                    | Het standaard berichtformaat voor alle woordenboeken in het project.                                                                                                                   | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'`   | `'icu'`                                                                                     | • `'intlayer'`: Native intlayer-formaat.<br/>• `'icu'`: ICU-berichtformaat.<br/>• `'i18next'`: i18next-formaat.<br/>• `'vue-i18n'`: Vue I18n-formaat.<br/>• `'po'`: GNU Gettext PO-formaat.                                                                                                                                                                                                                    |
 | `priority`                  | Prioriteit van het woordenboek. Hogere waarden winnen van lagere bij het oplossen van conflicten tussen woordenboeken.                                                                 | `number`                                                                                                        | `undefined`    | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                |
 | `live`                      | Verouderd - gebruik `importMode: 'fetch'`. Geeft aan of de inhoud van het woordenboek dynamisch via de Live Sync API moet worden opgehaald.                                            | `boolean`                                                                                                       | `undefined`    |                                                                                             | Hernoemd naar `importMode: 'fetch'` in v8.0.0.                                                                                                                                                                                                                                                                                                                                                                 |
 | `schema`                    | Automatisch gegenereerd door Intlayer voor validatie van het JSON-schema.                                                                                                              | `'https://intlayer.org/schema.json'`                                                                            | auto-generatie |                                                                                             | Niet handmatig bewerken.                                                                                                                                                                                                                                                                                                                                                                                       |