@intlayer/docs 8.11.2 → 8.12.0-canary.0

package/docs/ko/introduction.md

@@ -1,8 +1,8 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: 소개
-description: Intlayer가 어떻게 작동하는지 알아보세요. 애플리케이션에서 Intlayer가 사용하는 단계들을 확인하세요. 다양한 패키지들이 하는 일을 살펴보세요.
+description: Intlayer의 작동 방식을 알아보세요. Intlayer가 애플리케이션에서 사용하는 단계를 확인하세요. 다양한 패키지가 어떤 역할을 하는지 알아보세요.
 keywords:
   - 소개
   - 시작하기
@@ -15,20 +15,20 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "초기 이력"
+    changes: "Init history"
 ---
 
 # Intlayer 문서
 
-공식 Intlayer 문서에 오신 것을 환영합니다! 여기에서는 Next.js, React, Vite, Express 또는 기타 자바스크립트 환경에서 작업하든, 모든 국제화(i18n) 요구 사항을 위해 Intlayer를 통합, 구성 및 마스터하는 데 필요한 모든 정보를 찾을 수 있습니다.
+공식 Intlayer 문서에 오신 것을 환영합니다! 이곳에서 Next.js, React, Vite, Express 또는 기타 JavaScript 환경 등 어디에서 작업하든 모든 국제화(i18n) 요구 사항을 위해 Intlayer를 통합, 구성 및 마스터하는 데 필요한 모든 것을 찾을 수 있습니다.
 
 ## 소개
 
 ### Intlayer란 무엇인가요?
 
-**Intlayer**는 자바스크립트 개발자를 위해 특별히 설계된 국제화 라이브러리입니다. 코드 어디에서나 콘텐츠를 선언할 수 있도록 허용합니다. 다국어 콘텐츠 선언을 구조화된 사전(dictionary)으로 변환하여 코드에 쉽게 통합할 수 있게 합니다. TypeScript를 사용하여, **Intlayer**는 개발을 더욱 견고하고 효율적으로 만듭니다.
+**Intlayer**는 JavaScript 개발자를 위해 특별히 설계된 국제화 라이브러리입니다. 코드 내 어디에서나 콘텐츠를 선언할 수 있도록 해줍니다. 다국어 콘텐츠 선언을 구조화된 사전으로 변환하여 코드에 쉽게 통합할 수 있게 합니다. TypeScript를 사용하여 **Intlayer**는 개발을 더욱 강력하고 효율적으로 만들어 줍니다.
 
-Intlayer는 또한 콘텐츠를 쉽게 편집하고 관리할 수 있는 선택적 시각적 편집기를 제공합니다. 이 편집기는 콘텐츠 관리를 위한 시각적 인터페이스를 선호하는 개발자나, 코드를 신경 쓰지 않고 콘텐츠를 생성하는 팀에게 특히 유용합니다.
+Intlayer는 또한 콘텐츠를 쉽게 편집하고 관리할 수 있도록 해주는 선택적인 시각적 편집기(visual editor)를 제공합니다. 이 편집기는 콘텐츠 관리에 시각적 인터페이스를 선호하는 개발자나 코드에 대해 걱정하지 않고 콘텐츠를 생성하는 팀에 특히 유용합니다.
 
 ### 사용 예시
 
@@ -50,6 +50,7 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      ko: "안녕 세상",
     }),
   },
 } satisfies Dictionary;
@@ -67,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "ko": "안녕 세상"
       }
     }
   }
@@ -85,67 +87,119 @@ export const MyComponent: FC = () => {
 };
 ```
 
+### 왜 대안들보다 Intlayer인가요?
+
+`next-intl`이나 `i18next`와 같은 주요 솔루션과 비교하여 Intlayer는 다음과 같은 통합된 최적화를 제공하는 솔루션입니다:
+
+<AccordionGroup>
+
+<Accordion header="번들 크기 (Bundle size)">
+
+거대한 JSON 파일을 페이지에 로드하는 대신 필요한 콘텐츠만 로드하세요. Intlayer는 **번들 및 페이지 크기를 최대 50%까지 줄여줍니다**.
+
+</Accordion>
+
+<Accordion header="유지 보수성 (Maintainability)">
+
+애플리케이션 콘텐츠의 범위를 제한하는 것은 대규모 애플리케이션의 **유지 보수를 용이하게 합니다**. 전체 콘텐츠 코드베이스를 검토해야 하는 정신적 부담 없이 단일 기능(feature) 폴더를 복제하거나 삭제할 수 있습니다. 또한 Intlayer는 콘텐츠의 정확성을 보장하기 위해 **완전히 타입화(fully typed)**되어 있습니다.
+
+</Accordion>
+
+<Accordion header="AI 에이전트 (AI Agent)">
+
+콘텐츠를 코드와 같은 위치에 두면 대규모 언어 모델(LLM)이 **필요로 하는 컨텍스트가 줄어듭니다**. Intlayer에는 누락된 번역을 테스트하기 위한 **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/mcp_server.md)** 및 **[에이전트 스킬(agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등과 같은 일련의 도구가 함께 제공되어 AI 에이전트의 개발자 경험(DX)을 훨씬 더 매끄럽게 만듭니다.
+
+</Accordion>
+
+<Accordion header="자동화 (Automation)">
+
+원하는 LLM과 AI 제공자의 비용으로 CI/CD 파이프라인에서 번역을 자동화하세요. Intlayer는 콘텐츠 추출을 자동화하는 **컴파일러(compiler)**를 제공할 뿐만 아니라 **백그라운드에서 번역**할 수 있도록 돕는 [웹 플랫폼](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)도 제공합니다.
+
+</Accordion>
+
+<Accordion header="성능 (Performance)">
+
+거대한 JSON 파일을 컴포넌트에 연결하면 성능 및 반응성(reactivity) 문제가 발생할 수 있습니다. Intlayer는 빌드 시(build time) 콘텐츠 로딩을 최적화합니다.
+
+</Accordion>
+
+<Accordion header="비개발자와의 협업 및 확장 (Scaling with non-dev)">
+
+단순한 i18n 솔루션을 넘어, Intlayer는 **자체 호스팅 가능한 [시각적 편집기(visual editor)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)**와 **[완전한 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)**를 제공하여 다국어 콘텐츠를 **실시간**으로 관리할 수 있도록 지원하며, 번역가, 카피라이터 및 기타 팀원과의 협업을 원활하게 합니다. 콘텐츠는 로컬 및/또는 원격에 저장될 수 있습니다.
+
+</Accordion>
+</AccordionGroup>
+
 ## 주요 기능
 
-Intlayer는 현대 웹 개발의 요구에 맞춘 다양한 기능을 제공합니다. 아래는 주요 기능과 각 기능에 대한 자세한 문서 링크입니다:
+Intlayer는 현대 웹 개발의 요구를 충족하도록 설계된 다양한 기능을 제공합니다. 다음은 각 기능에 대한 자세한 문서로의 링크가 포함된 주요 기능입니다:
 
-- **국제화 지원**: 내장된 국제화 지원으로 애플리케이션의 글로벌 도달 범위를 확장하세요.
-- **비주얼 에디터**: Intlayer를 위해 설계된 에디터 플러그인으로 개발 워크플로우를 향상시키세요. [비주얼 에디터 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)를 확인하세요.
-- **구성 유연성**: [구성 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에 자세히 설명된 광범위한 구성 옵션으로 설정을 맞춤화하세요.
-- **고급 CLI 도구**: Intlayer의 명령줄 인터페이스를 사용하여 프로젝트를 효율적으로 관리하세요. [CLI 도구 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/index.md)에서 기능을 탐색할 수 있습니다.
+- **국제화 지원**: 내장된 국제화 지원으로 애플리케이션의 글로벌 도달 범위를 넓힙니다.
+- **시각적 편집기(Visual Editor)**: Intlayer를 위해 설계된 편집기 플러그인으로 개발 워크플로우를 개선하세요. [시각적 편집기 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)를 확인하세요.
+- **구성의 유연성**: [구성 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에 자세히 설명된 포괄적인 구성 옵션으로 설정을 맞춤화하세요.
+- **고급 CLI 도구**: Intlayer의 명령줄 인터페이스(CLI)를 사용하여 프로젝트를 효율적으로 관리하세요. [CLI 도구 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/index.md)에서 기능을 탐색해 보세요.
 
 ## 핵심 개념
 
 ### 사전(Dictionary)
 
-다국어 콘텐츠를 코드 가까이에 정리하여 모든 것을 일관되고 유지 관리하기 쉽게 만드세요.
+다국어 콘텐츠를 코드 근처에 배치하여 모든 것을 일관되고 유지 관리하기 쉽게 구성하세요.
 
 - **[시작하기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)**  
-  Intlayer에서 콘텐츠를 선언하는 기본 사항을 배우세요.
+  Intlayer에서 콘텐츠를 선언하는 기본 사항을 배웁니다.
 
-- **[번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md)**  
-  번역이 어떻게 생성되고 저장되며 애플리케이션에서 활용되는지 이해하세요.
+- **[번역(Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md)**  
+  번역이 애플리케이션에서 어떻게 생성, 저장, 활용되는지 이해합니다.
 
-- **[열거](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md)**  
-  여러 언어에 걸쳐 반복되거나 고정된 데이터 집합을 쉽게 관리하세요.
+- **[열거(Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md)**  
+  여러 언어에 걸쳐 반복되거나 고정된 데이터 세트를 쉽게 관리합니다.
 
-- **[조건](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/condition.md)**  
-  Intlayer에서 조건 논리를 사용하여 동적 콘텐츠를 만드는 방법을 배우세요.
+- **[조건(Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/condition.md)**  
+  Intlayer에서 조건부 논리를 사용하여 동적 콘텐츠를 만드는 방법을 배웁니다.
 
-- **[삽입](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/insertion.md)**  
-  삽입 자리 표시자를 사용하여 문자열에 값을 삽입하는 방법을 알아보세요.
+- **[삽입(Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/insertion.md)**  
+  삽입 자리 표시자를 사용하여 문자열에 값을 삽입하는 방법을 발견하세요.
 
-- **[함수 페칭](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md)**  
-  프로젝트 워크플로우에 맞게 맞춤 로직으로 동적으로 콘텐츠를 가져오는 방법을 확인하세요.
+- **[함수 페칭(Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/function_fetching.md)**  
+  프로젝트의 워크플로우와 일치하도록 사용자 정의 논리로 콘텐츠를 동적으로 가져오는(fetch) 방법을 확인합니다.
 
-- **[마크다운](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md)**  
-  Intlayer에서 마크다운을 사용하여 풍부한 콘텐츠를 만드는 방법을 배우세요.
+- **[마크다운(Markdown)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/markdown.md)**  
+  Intlayer에서 마크다운을 사용하여 풍부한 콘텐츠를 작성하는 방법을 배웁니다.
 
-- **[파일 임베딩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md)**  
-  Intlayer에서 외부 파일을 임베딩하여 콘텐츠 편집기에서 사용하는 방법을 알아보세요.
+- **[파일 임베딩(File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/file.md)**  
+  외부 파일을 Intlayer에 임베드하여 콘텐츠 편집기에서 사용하는 방법을 발견하세요.
 
-- **[중첩](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/nesting.md)**  
-  Intlayer에서 콘텐츠를 중첩하여 복잡한 구조를 만드는 방법을 이해하세요.
+- **[중첩(Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/nesting.md)**  
+  Intlayer에서 콘텐츠를 중첩하여 복잡한 구조를 만드는 방법을 이해합니다.
 
 ### 환경 및 통합
 
-Intlayer는 유연성을 염두에 두고 설계되어, 인기 있는 프레임워크와 빌드 도구와의 원활한 통합을 제공합니다:
-
-- **[Next.js 15와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_15.md)**
-- **[Next.js 14 (앱 라우터)와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_14.md)**
-- **[Next.js 페이지 라우터와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_page_router.md)**
-- **[React CRA와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_create_react_app.md)**
-- **[Vite + React와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+react.md)**
-- **[React Native와 Expo와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_react_native+expo.md)**
-- **[Lynx와 React와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_lynx+react.md)**
-- **[Express와 함께 사용하는 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_express.md)**
-
-각 통합 가이드에는 **서버 사이드 렌더링**, **동적 라우팅**, 또는 **클라이언트 사이드 렌더링**과 같은 Intlayer 기능을 사용하는 모범 사례가 포함되어 있어, 빠르고 SEO 친화적이며 매우 확장 가능한 애플리케이션을 유지할 수 있습니다.
+저희는 유연성을 염두에 두고 Intlayer를 구축하여 인기 있는 프레임워크와 빌드 도구 전반에서 원활한 통합을 제공합니다:
+
+- **[Intlayer와 Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_16.md)**
+- **[Intlayer와 Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_15.md)**
+- **[Intlayer와 Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_14.md)**
+- **[Intlayer와 Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer와 React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_create_react_app.md)**
+- **[Intlayer와 Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+react.md)**
+- **[Intlayer와 React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_react_router_v7.md)**
+- **[Intlayer와 Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_tanstack.md)**
+- **[Intlayer와 React Native 및 Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_react_native+expo.md)**
+- **[Intlayer와 Lynx 및 React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_lynx+react.md)**
+- **[Intlayer와 Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+preact.md)**
+- **[Intlayer와 Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+vue.md)**
+- **[Intlayer와 Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nuxt.md)**
+- **[Intlayer와 Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_vite+svelte.md)**
+- **[Intlayer와 SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_svelte_kit.md)**
+- **[Intlayer와 Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_express.md)**
+- **[Intlayer와 NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_nestjs.md)**
+- **[Intlayer와 Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_hono.md)**
+- **[Intlayer와 Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_angular_21.md)**
+
+각 통합 가이드에는 **서버 사이드 렌더링(SSR)**, **동적 라우팅**, **클라이언트 사이드 렌더링**과 같은 Intlayer의 기능을 사용하기 위한 모범 사례가 포함되어 있어 빠르고 SEO 친화적이며 확장성이 높은 애플리케이션을 유지할 수 있습니다.
 
 ## 기여 및 피드백
 
-우리는 오픈 소스와 커뮤니티 주도 개발의 힘을 소중히 여깁니다. 개선 사항을 제안하거나, 새로운 가이드를 추가하거나, 문서의 문제를 수정하고 싶다면 언제든지 Pull Request를 제출하거나 [GitHub 저장소](https://github.com/aymericzip/intlayer/blob/main/docs/docs)에서 이슈를 열어 주세요.
-
-**더 빠르고 효율적으로 애플리케이션을 번역할 준비가 되셨나요?** 지금 바로 문서를 탐색하여 Intlayer를 사용해 보세요. 콘텐츠를 체계적으로 관리하고 팀의 생산성을 높이는 강력하고 간소화된 국제화 방식을 경험할 수 있습니다.
+저희는 오픈 소스와 커뮤니티 주도 개발의 힘을 소중히 여깁니다. 개선 사항을 제안하거나 새로운 가이드를 추가하거나 문서의 문제를 수정하려면 [GitHub 리포지토리](https://github.com/aymericzip/intlayer/blob/main/docs/docs)에서 Pull Request를 제출하거나 Issue를 열어주시기 바랍니다.
 
----
+**애플리케이션을 더 빠르고 효율적으로 번역할 준비가 되셨나요?** 오늘 바로 문서를 살펴보고 Intlayer 사용을 시작하세요. 콘텐츠를 체계적으로 유지하고 팀의 생산성을 높이는 강력하고 간소화된 국제화 접근 방식을 경험해 보세요.

package/docs/ko/lsp.md

@@ -0,0 +1,351 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2026-05-31
+title: Intlayer LSP 서버
+description: Intlayer 언어 서버가 지원되는 모든 에디터에서 useIntlayer, getIntlayer 및 관련 호출에 대해 정의로 이동(Go-to-Definition) 및 기타 IDE 기능을 제공하는 방법을 알아봅니다.
+keywords:
+  - LSP
+  - 언어 서버
+  - 정의로 이동
+  - IDE
+  - Intlayer
+  - VS Code
+  - Neovim
+  - TypeScript
+slugs:
+  - doc
+  - lsp
+history:
+  - version: 8.12.0
+    date: 2026-06-01
+    changes: "Release LSP"
+---
+
+# Intlayer LSP 서버
+
+**Intlayer 언어 서버(LSP)**는 Intlayer를 인식하는 지능형 기능으로 IDE를 향상시키는 [Language Server Protocol(LSP)](https://microsoft.github.io/language-server-protocol/) 구현체입니다. 현재 사전 키 호출에 대한 **정의로 이동(Go to Definition)** 기능을 제공하여, 컴포넌트의 `useIntlayer("my-key")`에서 선언된 `.content.ts` 파일로 즉시 이동할 수 있습니다.
+
+---
+
+## LSP를 사용하는 이유는 무엇인가요?
+
+Intlayer를 사용할 때 `useIntlayer("homepage")`와 같은 호출과 `src/homepage.content.ts` 내의 선언 사이의 연결은 암시적입니다. 도구가 없다면 수동으로 파일을 찾아야 합니다. LSP는 이 연결을 명시적으로 만듭니다.
+
+**AI 에이전트 인식**
+
+AI 코딩 에이전트(Cursor, Windsurf, GitHub Copilot, Claude Code, Codex)는 기호를 해석하고 파일 간의 관계를 이해하기 위해 언어 서버에 의존합니다. Intlayer LSP가 실행 중이면 에이전트는 `useIntlayer("key")`를 선언된 곳까지 추적할 수 있으므로, 사용 가능한 콘텐츠 키, 각 사전의 구조, 읽거나 편집해야 하는 파일에 대한 정확한 컨텍스트를 얻을 수 있습니다.
+
+**정의로 이동**
+
+지원되는 게터 호출 내부의 사전 키 문자열에 커서를 놓고 `F12` 키(또는 `Cmd/Ctrl+클릭`)를 누릅니다. 에디터가 콘텐츠 선언 파일을 열고 커서를 `key:` 행에 배치합니다.
+
+**병합된 사전 지원**
+
+하나의 키가 여러 콘텐츠 파일에 분산되어 있을 수 있습니다(Intlayer가 이를 병합함). 서버는 소스 파일당 하나의 `Location`을 반환하므로 모든 선언으로 이동할 수 있습니다.
+
+**모든 환경에서 작동**
+
+모든 `*-intlayer` 패키지를 지원합니다 (`next-intlayer`, `react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `angular-intlayer`, `lit-intlayer`, `express-intlayer`, `hono-intlayer`, `fastify-intlayer`, `adonis-intlayer`, `intlayer`).
+
+### 지원되는 게터 호출
+
+서버는 다음과 같은 함수 호출을 감지하고 첫 번째 문자열 리터럴 인수를 사전 키로 추출합니다.
+
+| 함수          | 예시                          |
+| ------------- | ----------------------------- |
+| `useIntlayer` | `useIntlayer("hero")`         |
+| `getIntlayer` | `getIntlayer("hero", locale)` |
+
+TypeScript 제네릭 및 추가 인수는 무시되며 오직 키 문자열만 중요합니다.
+
+> `useDictionary` 및 `getDictionary`는 문자열 키 대신 이미 가져온 `Dictionary` 객체를 첫 번째 인수로 받으므로 정의로 이동의 이점을 누리지 못하며 서버에서 추적되지 않습니다.
+
+---
+
+## 설치
+
+LSP 서버는 `@intlayer/lsp` 패키지의 일부로 배포됩니다.
+
+```bash packageManager="npm"
+npm install --save-dev @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn add --dev @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev @intlayer/lsp
+```
+
+```bash packageManager="bun"
+bun add --dev @intlayer/lsp
+```
+
+이 패키지는 에디터가 서버 실행 파일로 사용하는 `intlayer-lsp` 바이너리를 노출합니다.
+
+---
+
+## Claude Code 플러그인으로 설정
+
+Intlayer LSP는 Intlayer GitHub 리포지토리에 직접 호스팅되는 **Claude Code 플러그인**으로 사용할 수 있습니다. 이를 설치하면 Claude Code가 모든 `useIntlayer` / `getIntlayer` 호출에 대해 네이티브 정의로 이동 기능을 인식하게 됩니다.
+
+### 1. 언어 서버 바이너리 설치
+
+```bash packageManager="npm"
+npm install -g @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn global add @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add -g @intlayer/lsp
+```
+
+이 명령은 플러그인의 `lspServers` 항목이 호출하는 `intlayer-lsp` 바이너리를 PATH에 배치합니다.
+
+### 2. Intlayer 마켓플레이스 등록 및 플러그인 설치
+
+```bash
+claude plugin marketplace add intlayer@github:aymericzip/intlayer
+claude plugin install intlayer-lsp@intlayer
+claude plugin enable intlayer-lsp@intlayer
+```
+
+Claude Code는 `enabledPlugins`에 `"intlayer-lsp@intlayer": true`를 추가하고 지원되는 파일 형식(`.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`)에서 언어 서버를 자동으로 시작합니다.
+
+### 3. LSP 도구 활성화 (아직 활성화되지 않은 경우)
+
+일부 Claude Code 버전에서는 LSP 기능 플래그를 설정해야 합니다. 설치 후 정의로 이동이 작동하지 않으면 `~/.claude/settings.json`에 다음을 추가하십시오.
+
+```json fileName="~/.claude/settings.json"
+{
+  "env": {
+    "ENABLE_LSP_TOOL": "1"
+  }
+}
+```
+
+Claude Code를 다시 시작하십시오. 이제 Intlayer 코드베이스를 탐색할 때 `grep`으로 대체하는 대신 `goToDefinition`, `findReferences` 및 기타 LSP 작업을 사용합니다.
+
+---
+
+## VS Code에서 설정 (확장 프로그램 권장)
+
+[Intlayer VS Code 확장 프로그램](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)이 설치되어 있다면 언어 서버가 자동으로 시작됩니다. 추가 설정은 필요하지 않습니다.
+
+> 설치 및 기타 기능에 대해서는 [VS Code 확장 프로그램 설명서](https://intlayer.org/doc/vs-code-extension)를 참조하십시오.
+
+---
+
+## VS Code에서 수동 설정
+
+Intlayer 확장 프로그램을 사용하지 않는 경우, [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter)와 같은 범용 LSP 클라이언트 확장 프로그램을 사용하거나 직접 작은 확장 프로그램을 작성하여 언어 서버를 수동으로 연결할 수 있습니다. 권장하는 방법은 Intlayer 확장 프로그램을 사용하는 것입니다.
+
+참고로, 서버는 stdio를 통해 `intlayer-lsp` 바이너리를 실행합니다.
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+Intlayer 확장 프로그램은 이러한 설정을 읽어 서버를 시작합니다. 확장 프로그램에만 의존하는 경우 수동 설정은 필요하지 않습니다.
+
+---
+
+## Cursor에서 설정
+
+[Cursor](https://www.cursor.com/)는 AI 기능이 내장된 VS Code 포크입니다. 동일한 확장 프로그램 생태계를 사용하므로 **Intlayer VS Code 확장 프로그램**이 추가 설정 없이 작동합니다. 한 번 설치하면 Cursor가 자동으로 이를 감지합니다.
+
+수동 설정을 선호하는 경우 Cursor도 작업 영역 루트에서 `.vscode/settings.json`을 읽으므로 위의 VS Code 스니펫이 그대로 적용됩니다.
+
+---
+
+## Windsurf에서 설정
+
+[Windsurf](https://windsurf.com/)(Codeium 제공)는 또 다른 VS Code 기반 에디터입니다. VS Code 마켓플레이스에서 Intlayer 확장 프로그램을 설치하면 VS Code 및 Cursor에서와 마찬가지로 언어 서버가 자동으로 활성화됩니다.
+
+수동 설정의 경우 프로젝트 루트에 `.vscode/settings.json`을 생성하십시오.
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+---
+
+## Zed에서 설정
+
+[Zed](https://zed.dev/)는 언어 설정을 통해 네이티브 LSP 지원을 제공합니다. Zed 사용자 설정(`~/.config/zed/settings.json`)에 항목을 추가합니다.
+
+```json fileName="~/.config/zed/settings.json"
+{
+  "lsp": {
+    "intlayer-lsp": {
+      "binary": {
+        "path": "npx",
+        "arguments": ["--yes", "@intlayer/lsp"]
+      }
+    }
+  },
+  "languages": {
+    "TypeScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "TSX": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "JavaScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Vue.js": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Svelte": {
+      "language_servers": ["intlayer-lsp", "..."]
+    }
+  }
+}
+```
+
+`"..."` 자리 표시자는 Zed에 Intlayer 서버와 함께 기본 언어 서버를 유지하도록 지시합니다.
+
+---
+
+## AI 에이전트 CLI (Claude Code, Codex 등) 설정
+
+**Claude Code**는 뛰어난 LSP 플러그인 지원을 제공합니다. 위의 [Claude Code 플러그인으로 설정](#claude-code-플러그인으로-설정)에 따라 터미널 세션에서 직접 정의로 이동 기능을 완전히 경험해 보십시오.
+
+**OpenAI Codex** 및 기타 터미널 기반 도구는 아직 LSP 클라이언트로 작동하지 않으며, 지속적인 언어 서버 세션을 유지하는 대신 파일을 직접 읽고 씁니다. 이러한 도구들의 경우 LSP를 실행하는 이점은 간접적으로 발생합니다. 동반 에디터(VS Code, Cursor, Windsurf 등)에서 서버가 활성화되면 에디터의 라이브 인덱스가 에디터 제공 컨텍스트(예: Cursor Composer, Windsurf Cascade, GitHub Copilot Chat)를 통해 쿼리할 수 있는 모든 AI 에이전트에 제공됩니다.
+
+에디터를 열지 않고 터미널에서만 작업하는 경우 백그라운드에서 언어 서버를 시작하여 나중에 동일한 작업 영역에 연결하는 에디터에 대비할 수 있습니다.
+
+```bash
+# 백그라운드에서 서버 실행 상태 유지
+npx @intlayer/lsp &
+```
+
+---
+
+## Neovim에서 수동 설정
+
+[nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)를 사용하여 사용자 정의 서버 설정을 등록합니다.
+
+```lua fileName="~/.config/nvim/init.lua"
+local lspconfig = require('lspconfig')
+local configs = require('lspconfig.configs')
+
+if not configs.intlayer_lsp then
+  configs.intlayer_lsp = {
+    default_config = {
+      -- 전역 설치를 피하기 위해 npx로 서버를 시작
+      cmd = { 'npx', '--yes', '@intlayer/lsp' },
+      filetypes = {
+        'typescript',
+        'typescriptreact',
+        'javascript',
+        'javascriptreact',
+        'vue',
+        'svelte',
+      },
+      root_dir = lspconfig.util.root_pattern(
+        'intlayer.config.ts',
+        'intlayer.config.js',
+        'package.json'
+      ),
+    },
+  }
+end
+
+lspconfig.intlayer_lsp.setup({})
+```
+
+Neovim을 다시 시작한 후 Intlayer 키 위에서 `gd`를 누르면 정의로 이동이 호출됩니다.
+
+---
+
+## 기타 에디터에서 수동 설정
+
+Language Server Protocol을 지원하는 모든 에디터에서 `@intlayer/lsp`를 사용할 수 있습니다. 서버 사양은 다음과 같습니다.
+
+- **전송** – Node.js IPC / stdio (표준)
+- **실행 파일** – `npx @intlayer/lsp` (또는 로컬에 설치된 `intlayer-lsp` 바이너리)
+- **기능** – `definitionProvider: true`, `textDocumentSync: Incremental`
+
+에디터의 정확한 설정 형식(예: [coc.nvim](https://github.com/neoclide/coc.nvim)의 `languageserver.json` 또는 [Helix](https://helix-editor.com)의 LSP 클라이언트 설정)은 에디터 설명서를 참조하십시오.
+
+### 예시: coc.nvim
+
+```json fileName="~/.config/nvim/coc-settings.json"
+{
+  "languageserver": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["@intlayer/lsp"],
+      "filetypes": [
+        "typescript",
+        "typescriptreact",
+        "javascript",
+        "javascriptreact",
+        "vue",
+        "svelte"
+      ],
+      "rootPatterns": [
+        "intlayer.config.ts",
+        "intlayer.config.js",
+        "package.json"
+      ]
+    }
+  }
+}
+```
+
+### 예시: Helix
+
+```toml fileName="~/.config/helix/languages.toml"
+[[language]]
+name = "typescript"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[[language]]
+name = "tsx"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+```
+
+---
+
+## 작동 원리
+
+서버가 시작되면 `getConfiguration()`을 사용하여 작업 영역 루트에서 Intlayer 설정을 해제합니다. 이를 통해 컴파일된 사전을 찾는 데 필요한 `build` 및 `system` 경로를 얻습니다.
+
+각 **정의로 이동** 요청 시:
+
+1. 서버는 열려 있는 문서의 전체 텍스트를 읽습니다.
+2. 정규 표현식을 사용하여 게터 호출(`useIntlayer`, `getIntlayer` 등)을 검색합니다.
+3. 커서 위치가 이러한 호출 중 하나 내부인지 확인합니다.
+4. 만약 그렇다면 사전 키(정규식 캡처 그룹 3)를 추출하고 `getUnmergedDictionaries()`를 호출하여 해당 키를 선언하는 각 콘텐츠 파일의 위치를 찾습니다.
+5. 일치하는 각 파일을 읽고 `key: "<key>"`를 포함하는 정확한 행을 찾아 커서를 정확하게 배치합니다.
+6. `Location` 객체 배열(소스 파일당 하나)을 반환합니다.
+
+설정은 세션마다 캐시되고 지연 해제되며, 새로운 작업 영역 폴더를 열 때 등 매 `initialize` 요청 시 재설정됩니다.
+
+---
+
+## 문제 해결
+
+| 증상                        | 예상 원인                  | 해결 방법                                                                    |
+| --------------------------- | -------------------------- | ---------------------------------------------------------------------------- |
+| 정의로 이동이 작동하지 않음 | 서버가 실행 중이 아님      | `@intlayer/lsp`가 설치되어 있고 에디터가 이를 실행하고 있는지 확인하십시오   |
+| 잘못된 작업 영역 루트 감지  | 여러 작업 영역 폴더        | `intlayer.config.ts`가 포함된 폴더가 첫 번째 작업 영역 폴더인지 확인하십시오 |
+| 키 정의를 찾을 수 없음      | 설정이 해제되지 않음       | 작업 영역 루트에 `intlayer.config.ts`(또는 `.js`)가 존재하는지 확인하십시오  |
+| 시작 시 서버 작동 중단      | Node.js 버전이 너무 오래됨 | Node.js ≥ 14.18이 필요합니다                                                 |

package/docs/nl/cli/index.md

@@ -100,7 +100,7 @@ bun add intlayer-cli -g
 
 Het `intlayer-cli` pakket is bedoeld om uw [intlayer declaraties](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/content_file.md) te transpileren naar woordenboeken.
 
-Dit pakket transpileert alle intlayer bestanden, zoals `src/**/*.content.{ts|js|mjs|cjs|json}`. [Bekijk hoe u uw Intlayer declaratiebestanden declareert](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+Dit pakket transpileert alle intlayer bestanden, zoals `src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}`. [Bekijk hoe u uw Intlayer declaratiebestanden declareert](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
 Om intlayer woordenboeken te interpreteren kunt u interpreters gebruiken, zoals [react-intlayer](https://www.npmjs.com/package/react-intlayer) of [next-intlayer](https://www.npmjs.com/package/next-intlayer)