@intlayer/docs 9.3.3 → 9.4.0

package/docs/ko/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-03-03
+updatedAt: 2026-08-21
 title: MCP 서버 문서
 description: MCP 서버의 기능과 설정을 탐색하여 서버 관리 및 운영을 최적화하세요.
 keywords:
@@ -15,6 +15,9 @@ slugs:
   - doc
   - mcp-server
 history:
+  - version: 9.3.3
+    date: 2026-08-21
+    changes: "Group the platform setup sections into tabs"
   - version: 5.5.12
     date: 2025-07-11
     changes: "ChatGPT 설정 추가"
@@ -113,13 +116,18 @@ bun x intlayer init mcp
 
 ---
 
-## Cursor에서 설정하기
+## 수동 설정
+
+<Tabs defaultTab="cursor">
+  <Tab label="Cursor" value="cursor">
+
+### Cursor에서 설정하기
 
 Cursor에서 MCP 서버를 구성하려면 [공식 문서](https://docs.cursor.com/context/mcp)를 참고하세요.
 
 프로젝트 루트에 다음과 같은 `.cursor/mcp.json` 구성 파일을 추가합니다:
 
-### 로컬 서버 (stdio) (권장)
+#### 로컬 서버 (stdio) (권장)
 
 ```json fileName=".cursor/mcp.json"
 {
@@ -132,7 +140,7 @@ Cursor에서 MCP 서버를 구성하려면 [공식 문서](https://docs.cursor.c
 }
 ```
 
-### 원격 서버 (Streamable HTTP)
+#### 원격 서버 (Streamable HTTP)
 
 Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버에 연결하려면, MCP 클라이언트를 호스팅된 서비스에 연결하도록 구성할 수 있습니다.
 
@@ -149,15 +157,16 @@ Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버
 
 이 설정은 IDE가 `npx`를 사용하여 Intlayer MCP 서버를 실행하도록 하여, 버전을 고정하지 않는 한 항상 최신 버전을 사용하도록 보장합니다.
 
----
+  </Tab>
+  <Tab label="VS Code" value="vscode">
 
-## VS Code에서 설정하기
+### VS Code에서 설정하기
 
 [공식 문서](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)를 참고하여 VS Code에서 MCP 서버를 구성하세요.
 
 VS Code에서 Intlayer MCP 서버를 사용하려면 작업 공간 또는 사용자 설정에서 구성해야 합니다.
 
-### 로컬 서버 (stdio) (권장)
+#### 로컬 서버 (stdio) (권장)
 
 프로젝트 루트에 `.vscode/mcp.json` 파일을 생성하세요:
 
@@ -173,7 +182,7 @@ VS Code에서 Intlayer MCP 서버를 사용하려면 작업 공간 또는 사용
 }
 ```
 
-### 원격 서버 (Streamable HTTP)
+#### 원격 서버 (Streamable HTTP)
 
 Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버에 연결하려면, MCP 클라이언트를 호스팅된 서비스에 연결하도록 구성할 수 있습니다.
 
@@ -188,11 +197,12 @@ Server-Sent Events (Streamable HTTP)를 사용하여 원격 Intlayer MCP 서버
 }
 ```
 
----
+  </Tab>
+  <Tab label="ChatGPT" value="chatgpt">
 
-## ChatGPT 설정
+### ChatGPT 설정
 
-### 원격 서버 (Streamable HTTP)
+#### 원격 서버 (Streamable HTTP)
 
 ChatGPT에서 MCP 서버를 구성하려면 [공식 문서](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server)를 참조하세요.
 
@@ -209,9 +219,10 @@ ChatGPT에서 MCP 서버를 구성하려면 [공식 문서](https://platform.ope
 
 7. `Save` 클릭
 
----
+  </Tab>
+  <Tab label="Claude Desktop" value="claude-desktop">
 
-## Claude Desktop 설정
+### Claude Desktop 설정
 
 [공식 문서](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)를 참고하여 Claude Desktop에서 MCP 서버를 설정하세요.
 
@@ -220,7 +231,7 @@ ChatGPT에서 MCP 서버를 구성하려면 [공식 문서](https://platform.ope
 - macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### 로컬 서버 (stdio) (권장)
+#### 로컬 서버 (stdio) (권장)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -233,7 +244,7 @@ ChatGPT에서 MCP 서버를 구성하려면 [공식 문서](https://platform.ope
 }
 ```
 
-### 원격 서버 (Streamable HTTP)
+#### 원격 서버 (Streamable HTTP)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -246,13 +257,14 @@ ChatGPT에서 MCP 서버를 구성하려면 [공식 문서](https://platform.ope
 }
 ```
 
----
+  </Tab>
+  <Tab label="Claude Code (CLI)" value="claude-code">
 
-## Claude Code (CLI)에서 설정
+### Claude Code (CLI)에서 설정
 
 Claude Code에서 MCP 서버를 구성하려면 [공식 문서](https://modelcontextprotocol.io/quickstart/user)를 따르세요.
 
-### Local server (stdio) (권장)
+#### Local server (stdio) (권장)
 
 Intlayer MCP 서버를 stdio를 사용하여 Claude Code에 연결하려면:
 
@@ -260,7 +272,7 @@ Intlayer MCP 서버를 stdio를 사용하여 Claude Code에 연결하려면:
 claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
-### 원격 서버 (Streamable HTTP)
+#### 원격 서버 (Streamable HTTP)
 
 Streamable HTTP (SSE)를 사용하여 Intlayer MCP 서버를 Claude Code에 연결하려면:
 
@@ -268,6 +280,9 @@ Streamable HTTP (SSE)를 사용하여 Intlayer MCP 서버를 Claude Code에 연
 claude mcp add intlayer https://mcp.intlayer.org -t http
 ```
 
+  </Tab>
+</Tabs>
+
 ---
 
 ## CLI를 통한 MCP 서버 사용
@@ -281,5 +296,3 @@ npm install -g @intlayer/mcp
 # 또는 npx로 직접 사용 (권장)
 npx @intlayer/mcp
 ```
-
----

package/docs/ko/migration_from_i18next_to_intlayer.md

@@ -44,7 +44,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/migration_from_next-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/migration_from_next-intl_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer는 i18n 생태계에서 **가장 활발하게 개발되는** 솔루션
 
 <Accordion header="AI 에이전트">
 
-콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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)** 및 **[에이전트 스킬](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/agent_skills.md)** 등 일련의 도구가 있어 AI 에이전트를 위한 개발자 경험(DX)이 훨씬 매끄러워집니다.
+콘텐츠의 위치를 통일(Colocation)하면 대규모 언어 모델(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>
 

package/docs/ko/packages/elysia-intlayer/exports.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: elysia-intlayer 패키지 문서
+description: Intlayer용 Elysia 플러그인으로 번역 함수와 로케일 감지 기능을 제공합니다.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "모든 exports에 대한 통합 문서"
+author: aymericzip
+---
+
+# elysia-intlayer 패키지
+
+`elysia-intlayer` 패키지는 Elysia 애플리케이션에서 국제화를 처리하기 위한 플러그인을 제공합니다. 사용자 로케일을 감지하고 라우트 컨텍스트에 `intlayer` 객체를 주입합니다.
+
+## 설치
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia`는 peer dependency입니다 (`>=1.0.0`). Elysia는 **Bun** 런타임을 대상으로 합니다.
+
+## 내보내기
+
+### 플러그인
+
+임포트:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| 함수       | 설명                                                                                                                                                                                                                                                                                             | 관련 문서                                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Intlayer를 Elysia 애플리케이션에 통합하는 Elysia 플러그인. 스토리지(쿠키, 헤더)에서, 이어서 `Accept-Language`에서 로케일 감지를 처리하고, `locale`, `t`, `getIntlayer`, `getDictionary`를 노출하는 `intlayer` 객체를 라우트 컨텍스트에 주입하며, `AsyncLocalStorage` 요청 컨텍스트를 설정합니다. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/elysia-intlayer/intlayer.md) |
+
+### 함수
+
+임포트:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| 함수            | 설명                                                                                                                                                                                                                               | 관련 문서                                                                                              |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Elysia에서 현재 로케일의 콘텐츠를 가져오는 전역 번역 함수. `AsyncLocalStorage`를 사용해 `intlayer` 플러그인이 설정한 요청 컨텍스트에 접근하며, 그 외부에서는 기본 로케일로 폴백합니다. `intlayer.t`를 통해서도 접근할 수 있습니다. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md) |
+| `getIntlayer`   | 생성된 선언에서 키로 사전을 가져와 현재 로케일의 콘텐츠를 반환합니다. `getDictionary`의 최적화 버전입니다. `AsyncLocalStorage`를 사용해 요청 컨텍스트에 접근합니다. `intlayer.getIntlayer`를 통해서도 접근할 수 있습니다.          | -                                                                                                      |
+| `getDictionary` | 사전 객체를 처리하여 현재 로케일의 콘텐츠를 반환합니다. `t()` 번역, 열거형, markdown, HTML 등을 처리합니다. `AsyncLocalStorage`를 사용해 요청 컨텍스트에 접근합니다. `intlayer.getDictionary`를 통해서도 접근할 수 있습니다.       | -                                                                                                      |
+
+### 타입
+
+임포트:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| 타입                | 설명                                                                                                                                                         |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `IntlayerContext`   | 모든 라우트 컨텍스트에 주입되는 `intlayer` 객체의 형태: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | 로케일 맵을 현재 요청 로케일에 해당하는 콘텐츠로 변환하는 번역 함수의 시그니처.                                                                              |
+
+## 사용법
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // 국제화 플러그인 로드
+  .use(intlayer())
+  // 라우트 컨텍스트에서 로케일과 헬퍼를 읽기
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      ko: "안녕하세요",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // 또는 현재 요청에 바인딩된 독립 헬퍼 사용하기
+  .get("/t_example", () =>
+    t({
+      ko: "영어로 반환된 콘텐츠의 예",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> 플러그인은 **전역** `derive`를 통해 컨텍스트를 등록하며, Elysia는 이를 `Partial<{ intlayer: IntlayerContext }>`로 타이핑합니다. `.use(intlayer())` 이후에 등록된 라우트에서는 런타임에 값이 항상 존재하므로, `strict` 모드의 TypeScript를 만족시키려면 non-null 어서션(`intlayer!.locale`) 또는 옵셔널 체이닝을 사용하세요.
+
+## 관련 문서
+
+- [Elysia i18n - 앱을 번역하기 위한 완벽한 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_elysia.md)
+- [설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)

package/docs/ko/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: intlayer Elysia 플러그인 문서 | elysia-intlayer
+description: elysia-intlayer 패키지의 intlayer 플러그인 사용법을 확인하세요
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "문서 초기화"
+author: aymericzip
+---
+
+# intlayer Elysia 플러그인 문서
+
+Elysia용 `intlayer` 플러그인은 사용자 로케일을 감지하고 라우트 컨텍스트에 `intlayer` 객체를 주입합니다. 또한 요청 컨텍스트 내에서 전역 번역 함수를 사용할 수 있게 합니다.
+
+## 사용법
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    ko: "안녕하세요",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> 플러그인은 **전역** `derive`를 통해 컨텍스트를 등록하며, Elysia는 이를 `Partial<{ intlayer: IntlayerContext }>`로 타이핑합니다. `.use(intlayer())` 이후에 등록된 라우트에서는 런타임에 값이 항상 존재하므로, `strict` 모드의 TypeScript를 만족시키려면 non-null 어서션(`intlayer!.t`) 또는 옵셔널 체이닝을 사용하세요.
+
+동일한 헬퍼는 독립 export로도 제공되므로, 라우트 컨텍스트를 구조 분해하지 않고도 호출할 수 있습니다:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    ko: "안녕하세요",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## 설명
+
+이 플러그인은 다음 작업을 수행합니다:
+
+1. **로케일 감지**: 클라이언트가 명시적으로 설정한 로케일을 스토리지(쿠키, 헤더)에서 읽고, 그다음 `Accept-Language` 헤더에서 협상된 로케일로 폴백합니다.
+2. **컨텍스트 주입**: Elysia 라우트 컨텍스트에 `intlayer` 속성을 추가합니다 (아래 라우트 컨텍스트 표 참조).
+3. **컨텍스트 관리**: 비동기 컨텍스트를 관리하기 위해 `AsyncLocalStorage`를 사용하여, 전역 Intlayer 함수(`t`, `getIntlayer`, `getDictionary`)가 컨텍스트 객체를 전달하지 않고도 요청별 로케일에 접근할 수 있도록 합니다.
+4. **사전 준비**: 플러그인이 생성될 때 `prepareIntlayer`를 호출하므로, 앱이 부팅될 때 사전이 빌드됩니다.
+
+### 라우트 컨텍스트
+
+| 속성              | 타입                   | 설명                                                                              |
+| ----------------- | ---------------------- | --------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | 이 요청에 사용할 로케일이며, `locale_storage`가 `locale_detected`보다 우선합니다. |
+| `locale_storage`  | `Locale` (선택)        | 쿠키 또는 헤더를 통해 클라이언트가 명시적으로 요청한 로케일.                      |
+| `locale_detected` | `Locale`               | 요청 헤더에서 협상된 로케일.                                                      |
+| `defaultLocale`   | `Locale`               | `intlayer.config.ts`에 폴백으로 설정된 로케일.                                    |
+| `t`               | `TranslateFunction`    | 번역 함수.                                                                        |
+| `getIntlayer`     | `typeof getIntlayer`   | 키로 사전을 가져오는 함수.                                                        |
+| `getDictionary`   | `typeof getDictionary` | 사전 객체를 처리하는 함수.                                                        |
+
+> Node 기반 Intlayer 플러그인과 달리, `elysia-intlayer`는 `cls-hooked` 대신 `AsyncLocalStorage`를 사용합니다. `cls-hooked`는 Bun이 구현하지 않는 `async_hooks.createHook`에 의존하기 때문입니다.
+
+요청 컨텍스트는 응답이 매핑되면 해제되므로, 독립 헬퍼가 이미 종료된 요청에 대해 해석되는 일은 없습니다. 플러그인이 처리하는 요청 외부에서 호출되면 설정된 기본 로케일로 폴백합니다.
+
+## 로케일 결정 순서
+
+기본적으로 플러그인은 다음 순서로 로케일을 결정합니다:
+
+1. `INTLAYER_LOCALE` 쿠키.
+2. `x-intlayer-locale` 헤더.
+3. `Accept-Language` 헤더 협상.
+4. 설정된 `defaultLocale`.
+
+```bash
+# `Accept-Language`에서 협상됨
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# 쿠키가 `Accept-Language`보다 우선합니다
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# 헤더가 `Accept-Language`보다 우선합니다
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## 설정
+
+플러그인은 `intlayer.config.ts` 파일을 읽습니다. 로케일 감지에 사용되는 쿠키와 헤더를 커스터마이즈할 수 있습니다:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> 설정에 대한 자세한 내용은 [설정 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참고하세요.
+
+## 관련 문서
+
+- [elysia-intlayer 패키지 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - 앱을 번역하기 위한 완벽한 가이드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_with_elysia.md)

package/docs/ko/packages/express-intlayer/t.md

@@ -84,51 +84,6 @@ app.get("/", (_req, res) => {
 애플리케이션의 모든 라우트가 국제화 기능을 활용할 수 있도록 `app.use(intlayer())` 미들웨어를 **모든 라우트보다 먼저** 배치하세요:
 
 ```typescript {7} fileName="src/index.ts" codeFormat="typescript"
-import express, { type Express } from "express";
-import { intlayer } from "express-intlayer";
-
-const app: Express = express();
-
-// 국제화 요청 핸들러 로드
-app.use(intlayer());
-
-// 미들웨어 로드 후 라우트 정의
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-    })
-  );
-});
-````
-
-### 이 작업이 필요한 이유
-
-- **로케일 감지**: `intlayer` 미들웨어는 요청 헤더, 쿠키 또는 기타 설정된 방법을 통해 사용자의 선호 로케일을 감지합니다.
-- **번역 컨텍스트 설정**: `t` 함수가 올바르게 작동할 수 있도록 필요한 컨텍스트를 설정하여 정확한 언어로 번역을 반환합니다.
-- **오류 방지**: 이 미들웨어가 없으면 `t` 함수를 사용할 때 필요한 로케일 정보가 없어 런타임 오류가 발생합니다.
-
----
-
-## 사용 예제
-
-### 기본 예제
-
-// 미들웨어를 로드한 후 라우트를 정의합니다
-app.get("/", (\_req, res) => {
-res.send(
-t({
-en: "Hello, World!",
-fr: "Bonjour le monde!",
-es: "¡Hola, Mundo!",
-})
-);
-});
-
-````
-
 ### 왜 이것이 필요한가
 
 - **로케일 감지**: `intlayer` 미들웨어는 헤더, 쿠키 또는 기타 구성된 방법을 기반으로 사용자의 선호 로케일을 감지하기 위해 들어오는 요청을 처리합니다.
@@ -143,30 +98,6 @@ es: "¡Hola, Mundo!",
 
 다양한 언어로 현지화된 콘텐츠 제공:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Welcome!",
-      fr: "Bienvenue!",
-      es: "¡Bienvenido!",
-    })
-  );
-});
-````
-
-```javascript fileName="src/index.mjs" codeFormat="esm"
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Welcome!",
-      fr: "Bienvenue!",
-      es: "¡Bienvenido!",
-    })
-  );
-});
-```
-
 ```javascript fileName="src/index.cjs" codeFormat="commonjs"
 app.get("/", (_req, res) => {
   res.send(
@@ -346,3 +277,4 @@ app.get("/morning", (_req, res) => {
 ## 결론
 
 `t` 함수는 백엔드 국제화를 위한 강력한 도구입니다. 이를 효과적으로 사용하면 전 세계 사용자를 위한 보다 포용적이고 사용자 친화적인 애플리케이션을 만들 수 있습니다. 고급 사용법과 상세한 구성 옵션은 [문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+````