@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

package/docs/ko/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "next-intl에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Next.js 애플리케이션을 next-intl에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# next-intl에서 Intlayer로 마이그레이션
+
+완전하고 상세한 단계별 튜토리얼을 보려면 전체 [next-intl 마이그레이션 가이드](../migration_from_next-intl_to_intlayer.md)를 참조하세요.
+
+`next-intl`에서 Intlayer로 마이그레이션하면 애플리케이션의 라우팅과 구문을 완전히 유지할 수 있습니다.
+
+## 해야 할 일
+
+리포지토리에서 다음 명령을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+이렇게 하면 `intlayer.config.ts`가 생성됩니다. `next.config.ts`에서 plugin wrapper를 사용하여 `next-intl` aliases를 `@intlayer/next-intl`로 완벽하게 주입합니다.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## 내부적으로 어떻게 작동하는지
+
+bundler wrapper는 번역을 교체하지만 **`next-intl/navigation` 기능은 그대로 유지합니다** (예: `Link`, `redirect`, `usePathname`).
+
+내부적으로:
+
+- **ICU runtime:** Plurals (`=0`, `one`, `other`), select/selectordinal, `#` arguments, formatted args (`{ts, date, long}`)는 공유 `resolveMessage(..., 'icu')` resolver를 사용하여 올바르게 실행됩니다.
+- **`useTranslations()` & `getTranslations()`:** bare scope 호출은 첫 번째 key segment를 올바른 dictionary identifier로 추출합니다. Nested namespaces는 dictionary paths와 prefixes로 우아하게 분할됩니다.
+- **Rich formatting:** `t.rich()`와 `t.markup()` 모두 완전히 네이티브로 구현되어 HTML 같은 노드를 렌더링된 React chunks로 변환합니다.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange`, 설정의 named formats는 core native `Intl` formatters로 연결됩니다.

package/docs/ko/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Next Translate에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Next.js 애플리케이션을 next-translate에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Next Translate에서 Intlayer로 마이그레이션
+
+`next-translate`에서 Intlayer로의 마이그레이션은 기존 구문과 tags를 유지하는 거의 drop-in 대체입니다.
+
+## 해야 할 일
+
+프로젝트에서 Intlayer를 초기화하세요:
+
+```bash
+npx intlayer init
+```
+
+CLI는 설정을 scaffold합니다. 그런 다음 Intlayer plugin을 `next.config.ts`에 적용할 수 있으며, 이는 `next-translate/useTranslation`을 `@intlayer/next-translate`로 매핑하는 build-time subpath aliases를 주입합니다.
+
+## 내부적으로 어떻게 작동하는지
+
+`next-translate`는 `useTranslation('ns')`, `t('ns:key.path')`, `<Trans>` 컴포넌트 같은 hooks를 제공합니다.
+
+내부적으로:
+
+- **Interpolation & Plurals:** `react-i18next` adapter 동작에 매우 유사합니다. 동적으로 처리되는 것은 `{{var}}` placeholders와 `key_0`, `key_one`, `key_other` 같은 suffixes로부터 매핑된 pluralization입니다.
+- **`<Trans>` component:** HTML 같은 tag parsing과 array 기반 `components` prop과 함께 직접 지원됩니다.
+- **Namespaces:** Subpath aliasing은 수동 수정 없이 `useTranslation` 참조가 올바른 내부 dictionary namespaces를 참조하도록 보장합니다.

package/docs/ko/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NGX-Translate에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Angular 애플리케이션을 ngx-translate에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NGX-Translate에서 Intlayer로 마이그레이션
+
+compat adapter를 사용하면 Angular 애플리케이션을 `ngx-translate`에서 Intlayer로 쉽게 마이그레이션할 수 있으며 모든 template을 다시 작성할 필요가 없습니다.
+
+## 해야 할 일
+
+다음을 실행하여 시작하세요:
+
+```bash
+npx intlayer init
+```
+
+`intlayer.config.ts`를 설정합니다. `TranslateModule.forRoot()` setups를 바꾸고 import aliases를 적절하게 업데이트하여 `@intlayer/ngx-translate`를 가리키도록 합니다.
+
+## 내부적으로 어떻게 작동하는지
+
+`ngx-translate`는 `TranslateService` (`instant`, `get`, `stream`)와 `{{ 'KEY' | translate:params }}` pipe, `[translate]` directive를 사용합니다.
+
+내부적으로:
+
+- **Services:** `TranslateService`는 `getIntlayer`와 locale observable을 래핑하여 정확히 동일한 methods를 제공합니다.
+- **Pipes & Directives:** Intlayer dictionaries에 대해 직접 resolve되도록 다시 구현됩니다.
+- **Loaders:** `TranslateHttpLoader` setups은 warning stubs로 변환됩니다. 왜냐하면 Intlayer는 본래적으로 build time에 dictionaries를 resolve하고 bundle합니다 (또는 표준 dynamic imports를 통해), HTTP loaders의 필요성을 완전히 제거합니다.

package/docs/ko/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "NuxtJS I18n에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Nuxt.js 애플리케이션을 @nuxtjs/i18n에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# NuxtJS I18n에서 Intlayer로 마이그레이션
+
+Nuxt 애플리케이션을 `@nuxtjs/i18n`에서 Intlayer로 마이그레이션하는 것은 Nuxt adapter module을 사용하여 매끄러운 프로세스입니다.
+
+## 해야 할 일
+
+프로젝트를 초기화하려면 다음을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+이렇게 하면 `intlayer.config.ts`가 설정됩니다. 그런 다음 `nuxt.config.ts` modules 배열에 Intlayer Nuxt module (예: `@intlayer/nuxt-i18n`)을 추가하세요. 이것은 애플리케이션에 compat 설정을 자동으로 적용합니다.
+
+## 내부적으로 어떻게 작동하는지
+
+`@nuxtjs/i18n`은 `vue-i18n`을 래핑하면서 Nuxt 특화 routing composables (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`)를 제공합니다.
+
+내부적으로:
+
+- **Translations:** 모든 문자열 translation 작업에 대해 네이티브로 `@intlayer/vue-i18n` compat layer를 사용합니다 (완벽하게 `vue-i18n` formats, pipe plurals, reactivity를 지원합니다).
+- **Routing:** Intlayer의 localized URL helpers를 사용하여 routing composables를 mirror합니다.
+- **Configuration:** `intlayer.config.ts`에서 `availableLocales`과 기본 설정을 직접 읽어 Nuxt pages를 자동으로 조정합니다.

package/docs/ko/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Polyglot.js에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Polyglot.js에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Polyglot.js에서 Intlayer로 마이그레이션
+
+Airbnb의 Polyglot.js를 사용 중이라면 compat layer를 사용하여 Intlayer로의 마이그레이션은 매우 간단합니다.
+
+## 해야 할 일
+
+프로젝트에서 initialization 명령을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+`intlayer.config.ts`가 생성됩니다. 그런 다음 bundler plugin alias를 사용하여 Polyglot imports를 `@intlayer/polyglot`으로 투명하게 리다이렉트할 수 있습니다.
+
+## 내부적으로 어떻게 작동하는지
+
+Polyglot.js 구문은 일반적으로 `polyglot.t('key', {name})`과 `%{name}` interpolations과 `"singular |||| plural"`로 구분된 `smart_count` plurals에 의존합니다.
+
+내부적으로:
+
+- **Interpolation:** compat layer는 `%{var}` placeholders를 네이티브로 처리합니다.
+- **Plurals:** 문자열은 `||||`에서 분할되어 active locale에 따라 native `Intl.PluralRules`에 대해 평가됩니다. 이는 locale당 Polyglot의 자신의 bucket 순서를 mirror합니다.
+- **Dictionaries:** `new Polyglot()`에 거대한 JSON 설정을 제공할 필요를 없앱니다. Intlayer는 dictionaries를 동적으로 처리하고 자동으로 prune합니다.

package/docs/ko/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "react-i18next에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 React 애플리케이션을 react-i18next에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - 마이그레이션
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# react-i18next에서 Intlayer로 마이그레이션
+
+완전하고 상세한 단계별 튜토리얼은 [react-i18next 마이그레이션 가이드](../migration_from_react-i18next_to_intlayer.md)를 참고하세요.
+
+Intlayer의 compat adapter를 사용하면 소스 코드 import에 변경 없이 `react-i18next`에서 마이그레이션할 수 있습니다.
+
+## 수행할 작업
+
+프로젝트를 초기화하려면 다음을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+초기화 중에 Intlayer는 `@intlayer/react-i18next`를 설치하고 `intlayer.config.ts`를 생성합니다. bundler(예: Vite)에서 Intlayer plugin을 적용하세요:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## 내부 동작 원리
+
+`reactI18nextVitePlugin`은 핵심 `vite-intlayer` plugin을 래핑하고 `react-i18next` 및 `i18next`에 대한 resolve alias를 주입하여 `@intlayer/react-i18next` 및 `@intlayer/i18next`로 리디렉션합니다.
+
+내부적으로:
+
+- **`useTranslation` & `withTranslation`:** Intlayer의 기본 hook을 사용하도록 다시 작성되어 dictionary key에 대한 자동 TypeScript 자동 완성을 제공합니다. namespace(예: `t('namespace:key')`)를 원활하게 지원합니다.
+- **복수형 & Context:** 네이티브 `Intl.PluralRules` 및 context 접미사(`key_male`)를 사용하여 i18next의 접미사 기반 복수화(`key_one`, `key_other`)를 처리합니다.
+- **`<Trans>` Component:** `components` prop, 객체 및 배열 형식, 그리고 번호가 매겨진 태그 `<1>...</1>`를 React 노드에 직접 매핑하도록 지원하도록 다시 구현되었습니다.
+- **`i18n` instance:** 대규모 JSON 파일을 가져오지 않고 Intlayer에서 직접 키를 해결하여 번들 크기를 훨씬 줄입니다.

package/docs/ko/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "React Intl에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 React 애플리케이션을 react-intl에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# React Intl에서 Intlayer로 마이그레이션
+
+React 애플리케이션이 `react-intl` (FormatJS)를 사용하는 경우 Intlayer로의 전환은 매우 쉽습니다. 우리의 compat layer는 ICU MessageFormat과 기존의 모든 `Formatted*` 컴포넌트를 완벽하게 처리합니다.
+
+## 해야 할 일
+
+프로젝트에서 initialization 명령을 실행하여 시작하세요:
+
+```bash
+npx intlayer init
+```
+
+그런 다음 설정에서 Intlayer Vite 또는 Next.js plugin을 설정하세요. 이 plugin은 `react-intl` imports를 `@intlayer/react-intl`로 리다이렉트할 수 있도록 빌드 타임 aliases를 주입합니다.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## 내부적으로 어떻게 작동하는지
+
+bundler plugin은 `react-intl`을 `@intlayer/react-intl`로 alias합니다. 큰 JSON 파일을 수동으로 파싱하고 앱을 `IntlProvider`로 감싸는 대신 Intlayer plugin은 빌드 타임에 keys를 정적으로 추출하고 런타임에 Intlayer dictionaries를 사용합니다.
+
+내부적으로:
+
+- **ICU MessageFormat:** Intlayer는 ICU pluralization, selection, date/number formatting, rich text tags를 네이티브로 완벽하게 지원하는 `resolveMessage(..., 'icu')` resolver를 사용합니다.
+- **Method & JSX callers:** `intl.formatMessage({ id: 'a.b' })`와 `<FormattedMessage id="a.b">`는 Intlayer compiler plugins (`@intlayer/babel` / `@intlayer/swc`)로 식별되어 flat dotted keys를 변환하므로 첫 번째 segment가 올바른 Intlayer dictionary key로 resolve됩니다.
+- **Formatters:** `<FormattedNumber>`, `<FormattedDate>` 등은 `Intl`을 사용하는 native `core/formatters`로 연결됩니다.

package/docs/ko/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Svelte I18n에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Svelte 애플리케이션을 svelte-i18n에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Svelte I18n에서 Intlayer로 마이그레이션
+
+compat adapter를 사용하여 Svelte 애플리케이션을 `svelte-i18n`에서 Intlayer로 이동하는 것은 매우 간단합니다.
+
+## 해야 할 일
+
+프로젝트에서 initialization 명령을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+이렇게 하면 `intlayer.config.ts`가 생성됩니다. SvelteKit / Vite plugins을 Intlayer의 alias plugin으로 래핑하여 `svelte-i18n`을 `@intlayer/svelte-i18n`으로 매끄럽게 매핑하는지 확인하세요.
+
+## 내부적으로 어떻게 작동하는지
+
+Svelte-i18n은 heavily used stores (`$_`, `$t`, `$format`, 등)와 ICU MessageFormat에 의존합니다.
+
+내부적으로:
+
+- **Stores:** Intlayer는 `svelte-i18n` stores를 proxy합니다. `$_`는 현재 locale을 반환하는 Intlayer resolver의 derived store가 됩니다.
+- **Keys:** flat keys (예: `$_('home.title')`)는 첫 번째 path segment가 Intlayer dictionary를 나타내도록 평가됩니다.
+- **ICU Syntax:** shared ICU resolver (`intl-messageformat` equivalent parsing)에 의해 완벽하게 처리됩니다.
+- **Formatters:** `$date`, `$time`, `$number` 호출은 Intlayer의 native core formatters로 안전하게 리다이렉트됩니다.
+- **Babel/SWC Analysis:** Intlayer analyzer는 compilation 전에 `.svelte` 소스 파일 내부의 Svelte store callers (`$_`)를 읽어 관련 dictionary chunks를 자동으로 빌드합니다.

package/docs/ko/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Transloco에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Angular 애플리케이션을 Transloco에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Transloco에서 Intlayer로 마이그레이션
+
+Angular 애플리케이션이 현재 `@jsverse/transloco`를 사용하는 경우 compat adapter를 사용하여 Intlayer로 마이그레이션할 수 있습니다. 이 전환을 통해 기존 template 구문을 유지하면서 Intlayer의 강력한 dictionary 구조를 활용할 수 있습니다.
+
+## 해야 할 일
+
+프로젝트에서 initialization 명령을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+필요한 `intlayer.config.ts` 설정이 생성됩니다. 그런 다음 Transloco imports를 `@intlayer/transloco` modules로 바꾸거나 build aliases에 의존할 수 있습니다.
+
+## 내부적으로 어떻게 작동하는지
+
+Transloco는 scopes와 `TranslocoService` (`translate`, `selectTranslate`), structural directives (`*transloco="let t"`), pipes (`| transloco`)를 사용합니다.
+
+내부적으로:
+
+- **Scopes:** Intlayer dictionary keys에 자연스럽게 매핑되어 bundle optimization을 위한 훌륭한 pruning 옵션을 제공합니다.
+- **Service & Directives:** Intlayer의 Angular adapter는 providers를 완벽하게 교체하여 기존 template pipes와 directives가 Intlayer dictionaries에 대해 strings를 resolve할 수 있게 합니다.
+- **Build time parsing:** TypeScript analyzer는 `instant/get` 호출을 인식하고 fallback pruning은 template 사용이 정적으로 추적 불가능한 경우에도 정확성을 보장합니다.

package/docs/ko/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Vue I18n에서 Intlayer로 마이그레이션"
+description: "compat adapter를 사용하여 Vue 애플리케이션을 vue-i18n에서 Intlayer로 마이그레이션하는 방법을 알아보세요."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migration
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Vue I18n에서 Intlayer로 마이그레이션
+
+Vue 애플리케이션이 현재 `vue-i18n`을 사용하고 있다면 컴포넌트나 translation hooks를 다시 작성하지 않고 Intlayer로 마이그레이션할 수 있습니다. Intlayer는 내부적으로 Intlayer의 강력한 기능을 활용하면서 `vue-i18n`의 API를 완벽하게 반영하는 compat adapter를 제공합니다.
+
+## 해야 할 일
+
+시작하려면 프로젝트에서 initialization 명령을 실행하세요:
+
+```bash
+npx intlayer init
+```
+
+Initialization 중에 Intlayer는 설정 파일 (`intlayer.config.ts`)을 설정하고 마이그레이션을 위해 프로젝트를 준비합니다. `vue-i18n` imports를 자동으로 alias하기 위해 Vite 설정에 Intlayer plugin을 추가하기만 하면 됩니다.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## 내부적으로 어떻게 작동하는지
+
+`vueI18nVitePlugin`은 bundler에 module alias를 주입합니다. 코드베이스의 `vue-i18n` import는 투명하게 `@intlayer/vue-i18n`으로 리다이렉트됩니다.
+
+**내부적으로 adapter는 복잡한 `vue-i18n` 구문을 네이티브로 처리합니다:**
+
+- **Interpolation & Plurals:** `{name}`과 list `{0}` interpolations을 resolve합니다. Pipe plurals (`"car | cars"`)은 위치 의미론에 따라 Intlayer enumeration/plural nodes로 변환됩니다.
+- **Formats:** `d()`와 `n()` 같은 함수는 내부적으로 `Intl`을 래핑하여 options에 정의된 `datetimeFormats`와 `numberFormats`를 지원합니다.
+- **Global & Local State:** `global.locale`은 Intlayer client에서 지원되는 `WritableComputedRef`로 매핑되므로 reactivity는 정확히 예상대로 작동합니다 (예: `locale.value = 'fr'`).
+- **Directives:** `v-t` directive는 등록되고 정상적으로 작동합니다.
+
+애플리케이션은 이전과 정확히 동일하게 계속 렌더링되지만 콘텐츠는 Intlayer dictionaries로 제공되어 type safety, 더 나은 bundle optimization, seamless CMS integration을 제공합니다.

package/docs/ko/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer 컴파일러 | i18n을 위한 자동화된 콘텐츠 추출
 description: Intlayer 컴파일러로 국제화 프로세스를 자동화하세요. Vite, Next.js 등에서 더 빠르고 효율적인 i18n을 위해 컴포넌트에서 직접 콘텐츠를 추출합니다.
 keywords:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## 사용법
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-06-23
 title: 구성 (Configuration)
 description: 애플리케이션에 Intlayer를 구성하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤설정하는 데 사용할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "사전 구성에 `format` 옵션 추가"
@@ -882,6 +885,21 @@ export default config;
 
 ---
 
+### 시스템 구성
+
+Intlayer의 내부 경로 및 출력 결과와 관련된 설정입니다. 이러한 설정은 일반적으로 내부용이며 사용자가 수정할 필요가 없습니다.
+
+| Field                     | Description                                                          | Type     | Default                           | Example              | Note                                                  |
+| ------------------------- | -------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | ----------------------------------------------------- |
+| `baseDir`                 | 프로젝트의 기본 디렉토리입니다.                                      | `string` | `process.cwd()`                   | `'/path/to/project'` | 모든 Intlayer 관련 디렉토리를 해석하는 데 사용됩니다. |
+| `dictionariesDir`         | 로컬라이제이션 딕셔너리를 저장할 디렉토리 경로입니다.                | `string` | `'.intlayer/dictionary'`          |                      |                                                       |
+| `moduleAugmentationDir`   | 모듈 확대용 디렉토리이며, IDE 제안 및 타입 검사 기능을 향상시킵니다. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | `tsconfig.json`에 포함되어 있는지 확인하세요.         |
+| `unmergedDictionariesDir` | 병합되지 않은 딕셔너리를 저장할 디렉토리입니다.                      | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                       |
+| `typesDir`                | 딕셔너리 타입을 저장할 디렉토리입니다.                               | `string` | `'.intlayer/types'`               |                      |                                                       |
+| `mainDir`                 | 주요 애플리케이션 파일이 저장된 디렉토리입니다.                      | `string` | `'.intlayer/main'`                |                      |                                                       |
+| `configDir`               | 구성 파일이 저장된 디렉토리입니다.                                   | `string` | `'.intlayer/config'`              |                      |                                                       |
+| `cacheDir`                | 캐시 파일이 저장된 디렉토리입니다.                                   | `string` | `'.intlayer/cache'`               |                      |                                                       |
+
 ### 딕셔너리 구성 (Dictionary)
 
 자동 채우기 동작 및 콘텐츠 생성을 포함하여 딕셔너리 작업을 제어하기 위한 옵션입니다.
@@ -990,22 +1008,6 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 
 ---
 
-### 시스템 구성 (System)
-
-이 설정은 고급 사용자와 Intlayer 내부 구성을 위한 것입니다.
-
-| 필드                      | 설명                                      | 타입     | 기본값                            | 예시 | 참고 |
-| ------------------------- | ----------------------------------------- | -------- | --------------------------------- | ---- | ---- |
-| `dictionariesDir`         | 컴파일된 딕셔너리의 위치.                 | `string` | `'.intlayer/dictionary'`          |      |      |
-| `moduleAugmentationDir`   | TypeScript 모듈 보강이 위치할 디렉토리.   | `string` | `'.intlayer/types'`               |      |      |
-| `unmergedDictionariesDir` | 병합되지 않은 딕셔너리가 위치할 디렉토리. | `string` | `'.intlayer/unmerged_dictionary'` |      |      |
-| `typesDir`                | 생선된 타입이 위치할 디렉토리.            | `string` | `'.intlayer/types'`               |      |      |
-| `mainDir`                 | Intlayer 메인 파일이 위치할 디렉토리.     | `string` | `'.intlayer/main'`                |      |      |
-| `configDir`               | 컴파일된 구성 파일이 위치할 디렉토리.     | `string` | `'.intlayer/config'`              |      |      |
-| `cacheDir`                | 캐시 파일이 위치할 디렉토리.              | `string` | `'.intlayer/cache'`               |      |      |
-
----
-
 ### 컴파일러 구성 (Compiler)
 
 컴포넌트에서 직접 딕셔너리를 수집하는 Intlayer 컴파일러의 설정을 제어합니다.

package/docs/ko/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: 사용자 정의 도메인
 description: 전용 호스트 이름에서 서로 다른 로케일을 제공하기 위해 Intlayer에서 도메인 기반 로케ール 라우팅을 구성하는 방법을 알아봅니다.
 keywords:

package/docs/ko/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: 맞춤형 URL 재작성
 description: Intlayer에서 로케일별 경로를 정의하기 위해 맞춤형 URL 재작성(custom URL rewrites)을 구성하고 사용하는 방법을 알아봅니다.
 keywords:

package/docs/ko/dictionary/content_file.md

@@ -347,26 +347,6 @@ content: { /* ... */ }
 }
 ```
 
-#### `format` ('intlayer' | 'icu' | 'i18next')
-
-사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
-
-- `'intlayer'`: 기본 Intlayer 포맷터.
-- `'icu'`: ICU 메시지 포맷팅을 사용합니다.
-- `'i18next'`: i18next 메시지 포맷팅을 사용합니다.
-
-**예시:**
-
-```typescript
-{
-  key: "my-dictionary",
-  format: "icu",
-  content: {
-    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
-  }
-}
-```
-
 #### `locale` (LocalesValues)
 
 사전을 각 로케일별 사전으로 변환하며, content에 선언된 각 필드는 자동으로 번역 노드로 변환됩니다. 이 속성이 설정되면:
@@ -599,6 +579,10 @@ export default aboutPageMetaContent;
 
 원격 사전의 경우, 원격 서버에서 사전을 고유하게 식별하는 식별자입니다. 원격 콘텐츠를 가져오고 관리하는 데 사용됩니다.
 
+##### `projectIds` (string[])
+
+원격 사전의 경우, 이 배열은 이 사전을 사용할 수 있는 프로젝트의 ID를 포함합니다. 원격 사전은 여러 프로젝트 간에 공유될 수 있습니다.
+
 ##### `localId` (LocalDictionaryId)
 
 로컬 사전의 고유 식별자입니다. Intlayer가 자동으로 생성하며, 사전이 로컬인지 원격인지 및 위치를 식별하는 데 도움을 줍니다.
@@ -619,13 +603,6 @@ export default aboutPageMetaContent;
 
 사전이 외부 소스에서 자동으로 채워졌는지 여부를 나타냅니다. 충돌이 발생할 경우, 기본 사전이 자동 채워진 사전을 덮어씁니다.
 
-##### `location` ('distant' | 'locale')
-
-사전의 위치를 나타냅니다:
-
-- `'locale'`: 로컬 사전 (콘텐츠 파일에서 가져옴)
-- `'distant'`: 원격 사전 (외부 소스에서 가져옴)
-
 ## 콘텐츠 노드 유형
 
 Intlayer는 기본 원시 값을 확장하는 여러 전문화된 콘텐츠 노드 유형을 제공합니다: