@intlayer/docs 9.4.4 → 9.5.0

package/docs/ko/releases/v7.md

@@ -45,8 +45,6 @@ Intlayer v7에 오신 것을 환영합니다! 이번 주요 릴리스에서는
 - 더 빠른 번역 처리를 위한 병렬화
 - AI 컨텍스트 제한 내에서 대용량 파일 처리를 위한 스마트 청킹
 
----
-
 ## 성능: 더 빠른 빌드를 위한 캐싱
 
 esbuild로 매 빌드마다 콘텐츠 선언을 다시 빌드하는 대신, v7에서는 빌드 프로세스를 가속화하는 캐싱 전략을 구현했습니다.
@@ -73,8 +71,6 @@ bun x intlayer build
 - 변경 사항을 감지하고 수정된 파일만 다시 빌드합니다.
 - 대규모 프로젝트의 빌드 시간을 크게 단축합니다.
 
----
-
 ## TypeScript: 로케일별 타입 생성
 
 TypeScript 타입이 이제 로케일별로 생성되어 더 강력한 타입 검사를 제공하며 모든 로케일에 걸친 유니언 타입을 제거합니다.
@@ -99,8 +95,6 @@ const content = getIntlayer("my-title-content", "en");
 - 교차 로케일 타입 오염 없이 더 나은 타입 안전성
 - 타입 복잡성 감소로 성능 향상
 
----
-
 ## 번들 최적화: 문자열로서의 로케일
 
 `Locales` 타입이 더 이상 enum이 아니므로, 완전히 트리 쉐이커블(tree-shakeable)하며 수천 개의 사용하지 않는 로케일 레코드로 번들이 부풀려지지 않습니다.
@@ -127,8 +121,6 @@ const locale: Locale = Locales.ENGLISH;
 
 자세한 내용은 [구현 세부사항](https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/types/src/index.ts)을 참조하세요.
 
----
-
 ## 더 큰 유연성을 위한 새로운 라우팅 모드
 
 v7에서는 이전의 `prefixDefault`와 `noPrefix` 옵션을 대체하는 통합된 `routing.mode` 구성을 도입하여 URL 구조에 대해 더 세밀한 제어가 가능합니다.
@@ -159,8 +151,6 @@ export default {
 };
 ```
 
----
-
 ## GDPR 준수: localStorage / 쿠키 저장
 
 v7은 쿠키 대신 `localStorage`를 기본 저장 메커니즘으로 사용하여 사용자 개인정보 보호를 우선시합니다. 이 변경은 로케일 선호도에 대한 쿠키 동의 요구를 피함으로써 GDPR 준수를 돕습니다.
@@ -251,8 +241,6 @@ setLocale("en");
 **참고:** 쿠키는 기본적으로 활성화되어 있습니다.
 **참고:** 특정 사용 사례에 대한 [GDPR 쿠키 요구 사항](https://gdpr.eu/cookies/)을 확인하세요.
 
----
-
 ## 비주얼 에디터: 30% 더 작아진 패키지
 
 비주얼 에디터 패키지는 다음 덕분에 이전 버전보다 30% 더 작아지도록 최적화되었습니다:
@@ -263,8 +251,6 @@ setLocale("en");
 
 이로 인해 애플리케이션의 다운로드 시간이 빨라지고 런타임 성능이 향상됩니다.
 
----
-
 ## 자동 코드 포맷팅: formatCommand 구성
 
 v7은 편집기 구성에서 `formatCommand` 옵션을 도입하여, Intlayer에 의해 작성될 때 콘텐츠 파일을 자동으로 포맷할 수 있도록 합니다. 이를 통해 콘텐츠 선언 파일 전체에서 일관된 코드 스타일과 포맷팅을 보장합니다.
@@ -322,8 +308,6 @@ formatCommand: 'bun format "{{file}}"';
 
 Intlayer가 content declaration 파일(`.content.ts`, `.content.js` 등)을 작성하거나 업데이트할 때, 지정된 format 명령을 파일에 대해 자동으로 실행합니다. `{{file}}` placeholder는 실제 파일 경로로 대체되며, 명령은 프로젝트의 base directory에서 실행됩니다.
 
----
-
 ## Dictionary Configuration: 더 나은 구성과 구조
 
 v7은 dictionary 관련 설정에 대한 더 나은 조직화와 개선된 컨텐츠 관리를 제공하는 새로운 전용 `dictionary` 설정 섹션을 도입합니다.
@@ -383,8 +367,6 @@ dictionary 섹션에는 dictionary 관리를 위한 포괄적인 속성이 포
 
 콘텐츠 선언 파일 및 구성 값이 적용되는 방법에 대한 자세한 정보는 [Content File Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)을 참조하세요.
 
----
-
 ## fill 명령어: 더 나은 콘텐츠 관리를 위한 동작 업데이트
 
 v7에서는 `fill` 명령어의 동작이 개선되어 더 예측 가능하고 유연한 콘텐츠 관리를 제공합니다:
@@ -470,8 +452,6 @@ const content = {
 };
 ```
 
----
-
 ## 향상된 안정성과 번역 관리
 
 v7은 콘텐츠 번역을 보다 신뢰성 있고 효율적으로 만들기 위해 여러 개선 사항을 도입했습니다:
@@ -521,8 +501,6 @@ const content = {
 4. 필요 시 검증하고 재시도합니다.
 5. 완전한 파일을 재구성합니다.
 
----
-
 ## v6에서의 마이그레이션 노트
 
 ### 제거된 설정
@@ -611,14 +589,10 @@ const content = {
 };
 ```
 
----
-
 ## v5에서 v6로의 마이그레이션 노트
 
 자세한 내용은 [v5에서 v6로의 마이그레이션 노트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/releases/v6.md)를 확인하세요.
 
----
-
 ## 유용한 링크
 
 - [설정 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)

package/docs/ko/releases/v8.md

@@ -36,8 +36,6 @@ Intlayer v8에 오신 것을 환영합니다! 이번 릴리스는 자동 콘텐
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## 리치 콘텐츠의 진화: Markdown & HTML
 
 Intlayer v8는 리치 콘텐츠를 처리하는 방식에 큰 개선을 가져왔으며, **HTML 노드**(v7에는 존재하지 않았음)를 도입하고 **Markdown 노드**(v7에 존재했지만 향상됨)와 API를 통합했습니다.
@@ -407,8 +405,6 @@ v7에서는 Provider가 정의되지 않은 경우 Markdown 노드가 원시 문
 
 더 자세한 내용은 [HTML Content Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/html.md) 및 [Markdown Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md)를 참조하세요.
 
----
-
 ## YAML 및 Markdown 콘텐츠 파일 (v8.10.0)
 
 이제 `.content.md` 및 `.content.yaml` 파일 확장자를 사용하여 콘텐츠를 직접 선언할 수 있습니다. 이는 긴 형식의 콘텐츠, 블로그, 문서 및 개인정보 처리방침에 적합합니다.
@@ -417,8 +413,6 @@ v7에서는 Provider가 정의되지 않은 경우 Markdown 노드가 원시 문
 
 자세한 내용은 [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를 개선하고 영어가 아닌 사용자에게 보다 자연스러운 사용자 경험을 제공하는 강력한 기능입니다.
@@ -462,7 +456,7 @@ Intlayer v8은 **사용자 정의 URL 재작성(Custom URL Rewrites)** 을 도
     ```
 
   </Tab>
-    <Tab label="React Router" value="reactrouter">
+  <Tab label="React Router" value="reactrouter">
 
     ```typescript fileName="intlayer.config.ts"
     import { Locales, type IntlayerConfig } from "intlayer";
@@ -588,8 +582,6 @@ Intlayer v8은 **사용자 정의 URL 재작성(Custom URL Rewrites)** 을 도
 
 자세한 정보와 통합 가이드는 [Custom URL Rewrites Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/custom_url_rewrites.md)를 참조하세요.
 
----
-
 ### 향상된 삽입 값
 
 v8에서는 삽입 값이 이제 문자열과 숫자 외에 **React 요소(또는 Vue 노드)** 를 허용할 수 있습니다. 이를 통해 삽입 템플릿에 풍부하고 상호작용 가능한 컴포넌트를 직접 주입할 수 있습니다.
@@ -816,8 +808,6 @@ const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
 
 자세한 내용은 [복수형 문서](https://intlayer.org/doc/concept/content/plural)를 참조하세요.
 
----
-
 ## 콘텐츠 스키마 검증
 
 Intlayer v8에서는 딕셔너리에 대한 스키마 검증을 도입합니다. 이제 Zod를 사용해 구성 파일에 재사용 가능한 검증 스키마를 정의하고 이를 콘텐츠 파일에 적용할 수 있습니다. 이를 통해 콘텐츠가 항상 예상된 구조를 따르도록 보장하여 빌드 시점에 오류를 포착할 수 있습니다.
@@ -860,8 +850,6 @@ export default aboutPageMetaContent;
 
 콘텐츠가 스키마와 일치하지 않으면(예: title이 너무 짧은 경우) 빌드 프로세스가 오류를 발생시킵니다.
 
----
-
 ## TypeScript: IntlayerNode 기본형 접근자 (Primitive Accessors)
 
 `IntlayerNode` 타입이 업데이트되어 콘텐츠 노드에서 직접 JavaScript 기본형(primitive) 메서드를 호출할 수 있게 되었습니다. 이를 통해 지역화된 콘텐츠를 표준 string, number, boolean 또는 array 기본형인 것처럼 직접 상호작용할 수 있습니다.
@@ -888,8 +876,6 @@ content.myArrayOfString.find(...)   // 요소 반환
 content.myArrayOfString.join(', ')  // 결합된 string 반환
 ```
 
----
-
 ### 향상된 자동 콘텐츠 감지
 
 v8에서 Intlayer는 콘텐츠 문자열에서 Markdown 문법, HTML 태그 및 변수 삽입을 지능적으로 감지합니다. 이는 `md()`, `html()`, 또는 `insert()`와 같은 헬퍼 함수를 종종 생략할 수 있음을 의미합니다.
@@ -963,8 +949,6 @@ export default {
 }
 ```
 
----
-
 ## 현지화: 새로운 `useIntl` 훅
 
 React, Next.js 및 Vue에서 새로운 `useIntl()` 훅이 사용할 수 있게 되었습니다. 이 훅은 현재 언어에 바인딩된 `Intl` 객체를 제공하여, 로케일을 수동으로 전달할 필요 없이 숫자, 날짜 등 형식을 자동으로 현재 언어에 맞춰 처리합니다.
@@ -1083,8 +1067,6 @@ React, Next.js 및 Vue에서 새로운 `useIntl()` 훅이 사용할 수 있게
   </Tab>
 </Tabs>
 
----
-
 ## 도구: VSCode 확장 기능 향상
 
 Intlayer VSCode 확장 기능은 v8에서 국제화 워크플로우를 간소화하기 위해 주요 업데이트를 받았습니다:
@@ -1093,8 +1075,6 @@ Intlayer VSCode 확장 기능은 v8에서 국제화 워크플로우를 간소화
 - **캐싱**: 거의 즉시 검증 및 자동완성을 제공하는 향상된 캐싱 레이어.
 - **사용되지 않는 키 및 중복 키 감지**: 사전 전체에서 **사용되지 않는 키**와 **중복 키**를 자동으로 감지하는 새 기능으로, 콘텐츠를 깔끔하고 효율적으로 유지하는 데 도움을 줍니다.
 
----
-
 ## 도구: C++ Watcher 및 OXC 기반 LSP (v8.12.0)
 
 Intlayer v8.12.0은 developer experience에 큰 개선을 가져왔습니다:
@@ -1104,8 +1084,6 @@ Intlayer v8.12.0은 developer experience에 큰 개선을 가져왔습니다:
 
 자세한 내용은 [LSP 문서](https://intlayer.org/doc/lsp)를 참조하세요.
 
----
-
 ## 컴파일러 최적화
 
 Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레이어가 포함되어 있습니다. 이는 동일한 설정을 가진 동일한 콘텐츠 문자열을 한 번만 파싱하도록 하여, 재렌더링 시나 동일한 콘텐츠를 여러 곳에서 사용할 때 발생하는 오버헤드를 크게 줄여줍니다.
@@ -1159,8 +1137,6 @@ Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레
   </Tab>
 </Tabs>
 
----
-
 ## 실험적 빌드 최적화: Minify 및 Purge (v8.7.0)
 
 Intlayer v8.7.0은 프로덕션 번들을 최적화하기 위해 설계된 새로운 실험적 빌드 기능을 `intlayer.config.ts`에 도입합니다:
@@ -1201,8 +1177,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ## 유연성: 통합된 Import 모드
 
 `live` boolean 속성은 더 포괄적인 `importMode` 속성으로 대체(deprecated)되었습니다. 이를 통해 딕셔너리를 정적(static), 동적(dynamic), 또는 라이브 동기화 방식으로 어떻게 로드할지 명시적으로 정의할 수 있습니다.
@@ -1243,8 +1217,6 @@ export default {
 }
 ```
 
----
-
 ## 사전 위치 제어
 
 v8에서는 사전이 위치하는 곳과 동기화 방식을 명시적으로 관리할 수 있도록 `location` 속성이 도입되었습니다. 이는 로컬 파일과 원격 CMS 콘텐츠를 함께 사용하는 하이브리드 워크플로에 특히 유용합니다.
@@ -1265,8 +1237,6 @@ export default {
 }
 ```
 
----
-
 ## 시스템 구성 분리
 
 Intlayer v8은 콘텐츠 소스 구성과 내부 시스템 및 출력 경로 구성을 분리합니다. 이는 `content` 속성을 정리하고 어떤 설정이 사용자 관리용인지, 어떤 설정이 Intlayer 시스템에서 관리하는지 명확히 합니다.
@@ -1306,8 +1276,6 @@ export default {
 };
 ```
 
----
-
 ## 콘텐츠 및 코드 디렉토리 분리
 
 Intlayer v8는 콘텐츠 정의 파일에 대한 설정을 코드 변환 설정과 분리합니다. 이를 통해 watching과 scanning을 보다 정확하게 수행할 수 있어 빌드 성능이 향상됩니다.
@@ -1342,22 +1310,16 @@ export default {
 };
 ```
 
----
-
 ## 프레임워크: Svelte 개선사항
 
 Svelte에서의 Markdown 및 HTML 콘텐츠는 이제 문자열화될 때 자동으로 HTML로 파싱됩니다. 이로 인해 Svelte의 `{@html}` 구문과 함께 사용하기가 훨씬 쉬워졌으며, 이제 콘텐츠 노드를 직접 전달하기만 하면 됩니다.
 
----
-
 ## Angular 지원: Vite 번들러 (v8.11.0)
 
 Angular 사용자를 위해, Intlayer는 이제 새로운 커스텀 esbuild 플러그인을 통해 Vite 번들러를 기본적으로 지원하여 개발 및 빌드 시간을 단축합니다.
 
 구성에 대한 자세한 내용은 [Angular 환경 문서](https://intlayer.org/doc/environment/angular)를 참조하세요.
 
----
-
 ## 사이트맵 생성 (v8.6.0)
 
 Intlayer는 이제 로케일 및 라우팅 모드를 기반으로 사이트맵을 자동으로 생성합니다. 이는 TanStack Router와 같은 라우터 아키텍처에서 SEO 최적화에 특히 유용합니다:
@@ -1391,8 +1353,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 });
 ```
 
----
-
 ## v7에서의 마이그레이션 노트
 
 ### 구성 변경사항
@@ -1402,8 +1362,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 - **`contentDir` and `codeDir`**: `contentDir`는 이제 콘텐츠 파일 전용입니다. 코드 변환을 위한 새로운 `codeDir` 속성이 추가되었습니다. `codeDir`가 설정되어 있지 않으면 Intlayer는 `contentDir`로 폴백(fallback)하고 경고를 기록합니다.
 - **스키마 검증**: 새로운 `schema` 기능을 사용하려면 프로젝트에 `zod`가 설치되어 있는지 확인하세요.
 
----
-
 ## 유용한 링크
 
 - [구성 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)

package/docs/ko/releases/v9.md

@@ -36,8 +36,6 @@ Intlayer v9에 오신 것을 환영합니다! 이번 메이저 릴리스는 주
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## 호환 어댑터 패키지 (Compat Adapter Packages)
 
 인기 있는 i18n 라이브러리에서 Intlayer로 마이그레이션하는 것이 그 어느 때보다 쉬워졌습니다. 표준 i18n 라이브러리와 **완전히 동일한 공개 API**를 노출하면서 런타임 시 모든 번역 작업을 Intlayer에 위임하는 5개의 호환 패키지를 출시했습니다.
@@ -98,8 +96,6 @@ export default defineConfig({
 });
 ```
 
----
-
 ## 통합 런타임 리졸버 (Mutualized Runtime Resolver)
 
 모든 호환 어댑터는 이제 고도로 최적화된 단일 런타임 파서인 `@intlayer/core/messageFormat`을 통해 번역 해석을 라우팅합니다.
@@ -108,8 +104,6 @@ export default defineConfig({
 - **메시지 노드 리졸버 (Message Node Resolver)**: 중첩된 노드들을 해석합니다: `insert()`, `plural()` (CLDR 복수형 규칙), `enu()` (열거형), `gender()`, HTML 태그, 배열, 그리고 호출 가능한 함수 노드.
 - **토큰화된 태그 파서 (Tokenized Tag Parser)**: 인라인 XML/HTML 태그 및 번호가 매겨진 태그(예: `<1>children</1>`)를 지원하여 서식 있는 텍스트(rich-text) 렌더링을 기본적으로 지원합니다.
 
----
-
 ## 기능 사양: 컬렉션 및 베리언트
 
 Intlayer v9은 정적인 키-값 객체를 넘어, 딕셔너리가 처음부터 끝까지 완전히 타입 지정된 동적 레이아웃 구조를 선언할 수 있도록 확장되었습니다.
@@ -209,8 +203,6 @@ const product = useIntlayer("product-copy", {
 });
 ```
 
----
-
 ## `@intlayer/analytics`: 콘텐츠 노출 추적 및 A/B 테스트
 
 새로운 선택적 패키지 [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)는 방문자에게 실제로 어떤 콘텐츠가 표시되는지 알려주며, **Collections & Variants**의 마지막 퍼즐을 완성하여 콘텐츠 A/B 테스트와 변형별 전환 측정을 가능하게 합니다.
@@ -252,8 +244,6 @@ npm install @intlayer/analytics
 
 현재 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`에서 단일 플러그인만 필요합니다:
@@ -288,8 +278,6 @@ export default config;
 
 독립형 `intlayerCompiler()` 및 `intlayerProxy()` 플러그인은 고급 설정을 위해 계속 내보내집니다. 이들을 `intlayer()`와 함께 등록하는 것은 안전합니다 — 각 플러그인은 자동으로 중복을 제거하고 한 번만 실행됩니다.
 
----
-
 ## 컴파일러는 기본적으로 비활성화
 
 Intlayer v9부터 **컴파일러는 기본적으로 비활성화됩니다**(`compiler.enabled`의 기본값이 이제 `false`입니다). `.content.ts` 파일의 빌드 타임 추출을 활성화하려면 구성에서 `compiler.enabled: true`를 설정하세요:
@@ -309,8 +297,6 @@ 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 폴리필을 자동으로 적용합니다.
@@ -331,8 +317,6 @@ 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`)은 자동으로 처리되고 갱신됩니다.
@@ -359,8 +343,6 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 > 보안: CMS 자격 증명은 콘텐츠에 대한 쓰기 권한을 부여합니다. 인증기는 항상 **서버 측**에서만 생성하고, `clientId` / `clientSecret`을 브라우저로 절대 보내지 마세요.
 
----
-
 ## Self-Hosting
 
 Intlayer v9는 단일 명령으로 자신의 Intlayer 인스턴스를 실행할 수 있는 일급 지원을 제공합니다. Intlayer Cloud 계정이 필요하지 않습니다.
@@ -371,8 +353,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 설치 프로그램은 `docker-compose.yml` 및 `.env`를 다운로드하고, 필요한 시크릿을 자동으로 생성하며, `docker compose up -d`를 실행합니다. 대시보드, API, 데이터베이스, 객체 스토리지, 트랜잭션 이메일 등 모든 것이 컨테이너에서 로컬로 실행됩니다.
 
----
-
 ## v8에서의 마이그레이션 노트
 
 v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는 변경 사항(breaking changes)이 포함되어 있지 않습니다. 하지만 다음과 같은 주요 변경 사항이 있습니다:
@@ -381,8 +361,6 @@ v8에서 업그레이드하는 경우, v9에는 하위 호환성을 깨뜨리는
 - **로케일 및 다이얼렉트 (Locales & Dialects)**: 외부 i18n 의존성을 사용하는 경우, 설정 또는 번들러 구성에 해당 호환 어댑터 플러그인을 추가하여 임포트를 자동으로 변환하세요.
 - **커스텀 셀렉터 (Custom Selectors)**: `useIntlayer`를 호출할 때 두 번째 매개변수는 이제 `{ locale, item, variant }`를 포함하는 옵션 객체 전용으로 예약됩니다. 이전에 로케일 문자열을 직접 전달했다면 여전히 그렇게 사용할 수 있지만, 고급 선택을 위해서는 옵션 객체를 사용하는 것을 권장합니다.
 
----
-
 ## 유용한 링크
 
 - [호환 어댑터 패키지 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/compat/index.md)

package/docs/ko/roadmap.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 Intlayer는 애플리케이션 전반에서 콘텐츠를 선언, 관리 및 업데이트하는 방식을 간소화하도록 설계된 콘텐츠 관리 및 국제화 솔루션입니다. 중앙 집중식 또는 분산식 콘텐츠 선언, 광범위한 국제화 옵션, Markdown 지원, 조건부 렌더링, TypeScript/JavaScript/JSON 통합 등 강력한 기능을 제공합니다. 아래는 Intlayer가 현재 제공하는 기능에 대한 종합적인 개요와 앞으로의 로드맵 기능입니다.
 
----
-
 ## 목차
 
 <TOC/>
 
----
-
 ## 현재 기능
 
 ### 1. 콘텐츠 선언
@@ -146,8 +142,6 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 >
 > - [빌드 구성](https://intlayer.org/doc/concept/configuration#build-configuration)
 
----
-
 ## 프레임워크 및 환경과의 통합
 
 ### 1. Next.js
@@ -234,8 +228,6 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 >
 > - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_preact.md)
 
----
-
 ## 비주얼 에디터 및 CMS
 
 ### 1. 로컬 비주얼 에디터
@@ -261,21 +253,15 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 >
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)
 
----
-
 ## IDE 확장 기능
 
 - 주요 IDE용 확장 기능으로, 로컬 및 원격 번역을 관리할 수 있는 **그래픽 인터페이스**를 제공합니다.
 - 기능에는 컴포넌트용 콘텐츠 선언 파일 자동 생성, Intlayer CMS와의 직접 통합, 실시간 검증 등이 포함될 수 있습니다.
 
----
-
 ## MCP 서버
 
 - IDE 내 통합 도구를 사용하여 콘텐츠와 번역을 관리할 수 있는 **MCP 서버**입니다.
 
----
-
 ## Intlayer CLI
 
 - **번역 및 파일 생성**: 콘텐츠 파일에 대한 감사를 실행하여 누락된 번역을 생성하고 불일치를 검토합니다.
@@ -286,15 +272,11 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 >
 > - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/index.md)
 
----
-
 ## 환경
 
 - **환경 변수**를 사용하여 프로덕션, 테스트, 로컬 환경에서 Intlayer를 다르게 구성합니다.
 - 환경에 따라 대상 시각 편집기 또는 원격 CMS 프로젝트를 정의합니다.
 
----
-
 ## 핫 콘텐츠 업데이트
 
 - 원격 사전과 Intlayer CMS를 사용할 때, **애플리케이션의 콘텐츠를 즉시 업데이트**할 수 있으며, 재배포가 필요 없습니다.
@@ -303,8 +285,6 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 >
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)
 
----
-
 ## 향후 기능
 
 ### 1. A/B 테스트 및 개인화
@@ -333,8 +313,6 @@ Intlayer는 콘텐츠 선언을 위해 **TypeScript**(및 JavaScript)와 **JSON*
 - **Solid, Svelte, Angular** 등 지원을 위한 노력이 진행 중입니다.
 - Intlayer를 **모든 자바스크립트 기반 애플리케이션**과 호환되도록 하는 것이 목표입니다.
 
----
-
 ## 결론
 
 Intlayer는 콘텐츠 관리 및 국제화를 위한 원스톱 솔루션이 되는 것을 목표로 합니다. 중앙 집중식 또는 분산식 파일 관리의 유연성, 광범위한 언어 지원, 최신 프레임워크 및 번들러와의 쉬운 통합, 그리고 강력한 AI 기반 기능에 중점을 둡니다. A/B 테스트, 버전 관리, 자동 번역과 같은 새로운 기능이 추가됨에 따라 Intlayer는 콘텐츠 워크플로우를 지속적으로 간소화하고 다양한 플랫폼에서 사용자 경험을 향상시킬 것입니다.

package/docs/ko/self_hosting.md

@@ -35,8 +35,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 <TOC/>
 
----
-
 ## 아키텍처
 
 ```
@@ -56,8 +54,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Chromium (Puppeteer 스크린샷 생성에 사용됨)은 백엔드 이미지 내부에 번들로 제공되므로 별도의 컨테이너가 필요하지 않습니다.
 
----
-
 ## 사전 요구 사항
 
 - **Docker** ≥ 24 및 **Docker Compose** ≥ v2. 둘 중 하나라도 없으면 설치 프로그램이 설치 링크를 출력하고 종료됩니다.
@@ -66,8 +62,6 @@ Chromium (Puppeteer 스크린샷 생성에 사용됨)은 백엔드 이미지 내
 
 나머지 모든 것 — Bun, Redis, MinIO, Chromium — 은 이미지 내에 포함되어 있습니다.
 
----
-
 ## 빠른 시작
 
 ### 1. 설치 프로그램 실행
@@ -136,8 +130,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > 네 개의 포트 변수는 `docker run` 명령에 인쇄된 매핑의 **호스트** 측만 변경합니다. 발행된 이미지는 빌드 시간에 `http://localhost:3000`, `http://localhost:3100` 및 `http://localhost:9000`이 대시보드 번들에 컴파일되어 있으므로, 이들을 다시 매핑하면 브라우저가 이전 포트를 가리키게 됩니다. 자신의 이미지를 빌드하지 않는 한 기본값을 유지하세요 — [제한 사항](#limitations)을 참조하세요.
 
----
-
 ## 빠른 시작
 
 설치 프로그램의 기능:
@@ -150,8 +142,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 스택이 실행되면 **http://localhost:3000**을 열고 첫 번째 계정을 생성하세요.
 
----
-
 ## 서비스
 
 | 서비스      | 이미지                             | 호스트 포트                   | 목적                                            |
@@ -165,8 +155,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > MinIO 포트 `9000`은 브라우저에서 접근할 수 있어야 합니다. 업로드된 자산(아바타, 스크린샷)은 `S3_PUBLIC_URL=http://localhost:9000/intlayer`에서 직접 로드되기 때문입니다.
 
----
-
 ## 환경 변수
 
 ### 필수
@@ -236,8 +224,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > Precedence: 조직의 자체 mailer (**Organization** dashboard에서 구성)가 global mailer보다 우선하며, global mailer는 기본 Resend key보다 우선합니다.
 
----
-
 ## Intlayer 프로젝트 연결하기
 
 스택이 실행되면 프로젝트가 `intlayer.org` 대신 자체 호스팅된 백엔드 및 대시보드를 가리키도록 설정하세요.
@@ -299,8 +285,6 @@ const cms = createIntlayerCMS({
 const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 ```
 
----
-
 ## 업그레이드
 
 이는 최신 이미지를 가져오고 `docker compose pull && docker compose up -d`를 사용하여 컨테이너를 다시 시작합니다. 기존 볼륨(`mongo-data`, `redis-data`, `minio-data`)은 보존되므로 데이터 손실이 없습니다.
@@ -310,8 +294,6 @@ docker compose pull
 docker compose up -d
 ```
 
----
-
 ## 백업 및 복원
 
 모든 영구 데이터는 세 개의 명명된 Docker 볼륨에 저장됩니다.
@@ -346,16 +328,12 @@ docker run --rm \
 # redis-data 및 minio-data에 대해서도 반복합니다.
 ```
 
----
-
 ## 제한 사항
 
 - **MongoDB는 외부(Atlas)여야 합니다.** 백엔드는 `mongodb+srv://`로만 연결되며(`DB_ID` / `DB_MDP` / `DB_CLUSTER`로 구성됨), 일반 `mongodb://host:27017` — 컨테이너의 자체 번들 `mongod` 포함 — 은 사용할 수 없습니다. MongoDB Atlas 클러스터를 제공하세요.
 - **사용자 정의 도메인 없음.** 모든 브라우저 대면 `VITE_*` URL은 빌드 시 앱에 인라인되며, 게시된 이미지는 `localhost` 값으로 제공됩니다. 대시보드는 `http://localhost:3000`에서 액세스해야 합니다. 공개 도메인에서 제공하려면 대상 URL을 포함하여 이미지를 다시 빌드해야 하며 기본적으로 지원되지 않습니다.
 - **이메일에는 작동하는 메일러가 필요합니다.** 초기 실행 설정은 이메일 확인을 강제하므로 `RESEND_API_KEY` 또는 [글로벌 SMTP 메일러](#global-mailer)(`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`)를 구성해야 합니다. 첫 번째 관리자가 로그인한 후 각 조직은 대시보드에서 자신의 SMTP 또는 Resend 메일러를 구성할 수도 있습니다.
 
----
-
 ## 문제 해결
 
 ### 첫 시작 시 백엔드 충돌 반복
@@ -382,8 +360,6 @@ docker compose logs redis
 docker compose run --rm minio-init
 ```
 
----
-
 ## 유용한 링크
 
 - [Intlayer CMS 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)

package/docs/ko/testing.md

@@ -24,16 +24,12 @@ author: aymericzip
 
 이 가이드는 사전이 완전한지 자동으로 확인하고, 배포 전에 누락된 번역을 잡아내며, 앱에서 현지화된 UI를 테스트하는 방법을 보여줍니다.
 
----
-
 ## 테스트할 수 있는 항목
 
 - **누락된 번역**: 필수 로케일이 사전에서 누락된 경우 CI 실패 처리.
 - **현지화된 UI 렌더링**: 특정 로케일 제공자와 함께 컴포넌트를 렌더링하고, 표시된 텍스트/속성을 검증.
 - **빌드 시 감사**: CLI를 통해 로컬에서 빠른 감사를 실행.
 
----
-
 ## 빠른 시작: CLI를 통한 감사
 
 프로젝트 루트에서 감사를 실행하세요:
@@ -64,8 +60,6 @@ bun x intlayer content test
 
 참고: CLI는 상세 보고서를 출력하지만 실패 시 비영(0이 아닌) 종료 코드를 반환하지 않습니다. CI 게이팅을 위해, 아래 단위 테스트를 추가하여 필수 로케일 누락이 0임을 확인하세요.
 
----
-
 ## 프로그래밍 방식 테스트 (Vitest/Jest)
 
 Intlayer CLI API를 사용하여 필수 로케일에 누락된 번역이 없는지 확인하세요.
@@ -112,8 +106,6 @@ test("필수 로케일이 누락되지 않음", () => {
   - `missingLocales`: 누락된 모든 로케일의 합집합.
   - `missingRequiredLocales`: `requiredLocales`로 제한된 부분집합 (또는 `requiredLocales`가 설정되지 않은 경우 모든 로케일).
 
----
-
 ## 지역화된 UI 테스트 (React / Next.js)
 
 Intlayer 프로바이더 하에 컴포넌트를 렌더링하고 화면에 보이는 내용을 검증합니다.
@@ -160,8 +152,6 @@ test("프랑스어로 현지화된 제목을 렌더링합니다", () => {
 - 속성(예: `aria-label`)에 대한 원시 문자열 값이 필요할 때는 React에서 `useIntlayer`가 반환하는 `.value` 필드에 접근하세요.
 - 단위 테스트 및 정리를 쉽게 하기 위해 사전을 컴포넌트와 함께 배치하세요.
 
----
-
 ## 지속적 통합
 
 필수 번역이 누락되었을 때 빌드를 실패하게 하는 테스트를 추가하세요.
@@ -211,8 +201,6 @@ pnpm intlayer content test --verbose
 bun x intlayer content test --verbose
 ```
 
----
-
 ## 문제 해결
 
 - Intlayer 구성에 `locales` 및 (선택적으로) `requiredLocales`가 정의되어 있는지 확인하세요.

package/docs/nl/bundle_optimization.md

@@ -133,8 +133,6 @@ Tijdens `next build` analyseert `withIntlayer` je bronnen, herschrijft het de ge
 
 > Purge en minify draaien alleen bij `next build` — de optimalisatiepipeline staat uit tijdens `next dev`.
 
-> Ze worden ook uitgeschakeld wanneer compat-adapter-aanroepers geconfigureerd zijn (`swcExtraCallers`, ingesteld door de compat-pakketten zoals `@intlayer/next-intl` of `@intlayer/react-i18next`): die aanroeppunten zijn onzichtbaar voor de gebruiksanalysator, dus purgen zou velden verwijderen die de code nog leest. Het herschrijven van imports blijft actief.
-
 **Eerdere versies (vóór 9.2.1)** vereisten `@intlayer/babel` en een `babel.config.js` die `intlayerPurgeBabelPlugin` en `intlayerMinifyBabelPlugin` declareert. Dat bestand is niet langer nodig en kan verwijderd worden.
 
  </Tab>

package/docs/nl/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # Intlayer CLI - Alle Intlayer CLI-commando's voor uw meertalige website
 
----
-
 ## Inhoudsopgave
 
 <TOC/>
 
----
-
 ## Pakket installeren
 
 Installeer de benodigde pakketten met npm: