@intlayer/docs 9.5.4-canary.0 → 9.5.5

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: astro-intlayer 패키지 문서
-description: Intlayer용 Astro 통합으로 로케일 기반 라우팅 및 사전 관리를 설정합니다.
+description: 로케일 기반 라우팅, 미들웨어, 훅, 클라이언트 스토어 및 사전 관리를 위한 설정을 제공하는 Intlayer의 Astro 통합.
 keywords:
   - astro-intlayer
   - astro
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "useIntlayer, useDictionary, useLocale 훅, 미들웨어 및 포맷터 문서 추가"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "모든 내보내기에 대한 문서 통합"
+    changes: "모든 내보내기에 대한 통합 문서"
 author: aymericzip
 ---
 
 # astro-intlayer 패키지
 
-`astro-intlayer` 패키지는 Intlayer를 Astro 애플리케이션에 통합하기 위한 필수 도구를 제공합니다. 로케일 기반 라우팅 및 사전 관리(딕셔너리 관리를) 구성합니다.
+`astro-intlayer` 패키지는 Astro 애플리케이션에 Intlayer를 통합하는 데 필요한 도구를 제공합니다. 로케일 기반 라우팅, 사전 관리, 빌드 타임 페이지 재작성, 요청 미들웨어, 그리고 서버 렌더링된 `.astro` 컴포넌트와 클라이언트 사이드 스크립트 모두에서 다국어 콘텐츠에 접근하기 위한 훅을 구성합니다.
 
 ## 설치
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### 통합
 
-The `astro-intlayer` 패키지는 프로젝트에서 Intlayer를 설정하기 위한 Astro 통합을 제공합니다.
+`astro-intlayer` 패키지는 프로젝트에 Intlayer를 설정하는 Astro 통합을 제공합니다.
 
-Import:
+가져오기:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-or adding to `astro.config.mjs`:
+또는 `astro.config.mjs`에서의 기본 가져오기:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| 함수       | 설명                                               |
-| ---------- | -------------------------------------------------- |
-| `intlayer` | 프로젝트에서 Intlayer를 설정하는 Astro 통합입니다. |
+| 함수       | 설명                                                                                                                                                                            | 관련 문서                                                                                                     |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | 사전을 준비하고, Vite 플러그인(별칭, 라우팅 프록시, 가지치기)을 구성하며, 요청 미들웨어를 자동 등록하고 재작성된 로케일 URL로 사전 렌더링된 페이지를 출력하는 Astro 통합입니다. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/intlayer.md) |
+
+### 훅 (서버 및 클라이언트)
+
+가져오기:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| 훅              | 설명                                                                                                                                                                        | 관련 문서                                                                                                               |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | 키로 하나의 사전을 선택하고 현지화된 콘텐츠를 반환합니다. `.astro` 프론트매터에서는 `Astro.locals`에서 요청 로케일을 읽고, `<script>`에서는 클라이언트 스토어에서 읽습니다. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | 사전 객체를 변환하고 해결된 로케일에 맞는 콘텐츠를 반환합니다. 프론트매터 및 클라이언트 스크립트에서 작동합니다.                                                            | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | 현재 로케일, 기본 로케일, 사용 가능한 로케일 목록 및 로케일 업데이트 함수를 반환합니다.                                                                                     | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useLocale.md)         |
+
+### 미들웨어 (astro-intlayer/middleware)
+
+가져오기:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| 내보내기    | 타입                | 설명                                                                                                                                                    | 관련 문서                                                                                                       |
+| ----------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | 요청 로케일을 감지하고 `Astro.locals.intlayer`를 연결하는 Astro 미들웨어입니다. `intlayer()`에 의해 자동 등록되거나, 수동으로 구성하기 위해 가져옵니다. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/onRequest.md) |
+
+### 유틸리티
+
+가져오기:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| 함수                | 설명                                                                                                  | 관련 문서 |
+| ------------------- | ----------------------------------------------------------------------------------------------------- | --------- |
+| `getIntlayerLocals` | `Astro.locals` 외부의 요청 저장소 스코프에서 현재 `IntlayerLocals` 객체를 검색하는 도우미 함수입니다. | -         |
+
+### 클라이언트 유틸리티 (astro-intlayer/client)
+
+가져오기:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+브라우저 또는 클라이언트 `<script>` 태그 내에서 가져올 때 `astro-intlayer`는 자동으로 `astro-intlayer/client`(`vanilla-intlayer` 기반)로 매핑되어 클라이언트 측 사전 게터, 스토어 구독자 및 로케일 지속성 도구를 제공합니다.
+
+### 포맷터 (astro-intlayer/format)
+
+가져오기:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| 훅                | 설명                                                                                        |
+| ----------------- | ------------------------------------------------------------------------------------------- |
+| `useIntl`         | 캐싱 및 구독 기능과 함께 요청 또는 클라이언트 로케일에 바인딩된 Intl 인스턴스를 반환합니다. |
+| `useDate`         | 현재 로케일에 미리 바인딩된 날짜 형식화 함수를 반환합니다 (`Intl.DateTimeFormat`).          |
+| `useNumber`       | 현재 로케일에 미리 바인딩된 숫자 형식화 함수를 반환합니다 (`Intl.NumberFormat`).            |
+| `useCurrency`     | 현재 로케일에 미리 바인딩된 통화 형식화 함수를 반환합니다.                                  |
+| `usePercentage`   | 현재 로케일에 미리 바인딩된 백분율 형식화 함수를 반환합니다.                                |
+| `useRelativeTime` | 현재 로케일에 미리 바인딩된 상대 시간 형식화 함수를 반환합니다 (`Intl.RelativeTimeFormat`). |
+| `useList`         | 현재 로케일에 미리 바인딩된 목록 형식화 함수를 반환합니다 (`Intl.ListFormat`).              |
+| `useUnit`         | 현재 로케일에 미리 바인딩된 단위 형식화 함수를 반환합니다.                                  |
+| `useCompact`      | 현재 로케일에 미리 바인딩된 컴팩트 숫자 형식화 함수를 반환합니다 (예: `1.5K`).              |
+
+### HTML 유틸리티 (astro-intlayer/html)
+
+가져오기:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| 내보내기          | 타입       | 설명                                                         |
+| ----------------- | ---------- | ------------------------------------------------------------ |
+| `renderHTML`      | `Function` | HTML 노드를 렌더링하기 위한 독립 실행형 유틸리티 함수입니다. |
+| `useHTML`         | `Hook`     | HTML 프로바이더 컨텍스트 및 구성을 가져오는 훅입니다.        |
+| `useHTMLRenderer` | `Hook`     | 사전 구성된 HTML 렌더러 함수를 가져오는 훅입니다.            |
+
+### Markdown 유틸리티 (astro-intlayer/markdown)
+
+가져오기:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| 내보내기              | 타입       | 설명                                                  |
+| --------------------- | ---------- | ----------------------------------------------------- |
+| `compileMarkdown`     | `Function` | 마크다운 문자열을 구조화된 표현으로 컴파일합니다.     |
+| `renderMarkdown`      | `Function` | 마크다운 콘텐츠를 출력 노드로 렌더링합니다.           |
+| `parseMarkdown`       | `Function` | 원시 마크다운 콘텐츠를 AST로 구문 분석합니다.         |
+| `useMarkdown`         | `Hook`     | 마크다운 프로바이더 컨텍스트를 가져오는 훅입니다.     |
+| `useMarkdownRenderer` | `Hook`     | 사전 구성된 Markdown 렌더러 함수를 가져오는 훅입니다. |
+
+### 타입
+
+가져오기:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| 타입              | 설명                                                                                                  |
+| ----------------- | ----------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | `locale`, `defaultLocale`, `availableLocales`를 포함하여 `Astro.locals.intlayer`에 연결된 객체입니다. |
+| `UseLocaleProps`  | `useLocale()`에서 허용하는 선택적 구성 속성입니다.                                                    |
+| `UseLocaleResult` | 로케일 속성 및 업데이트 메서드를 제공하는 `useLocale()`의 반환 타입입니다.                            |

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: intlayer 통합 문서 | astro-intlayer
+description: astro.config.mjs에서 intlayer Astro 통합을 구성하고 사용하는 방법을 살펴봅니다.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - 통합
+  - i18n
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "미들웨어 및 훅 세부 정보로 통합 문서 업데이트"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# intlayer Astro 통합 문서
+
+Astro용 `intlayer` 통합은 다국어 국제화(i18n)를 위해 프로젝트를 구성합니다. 빌드 타임 사전 준비, Vite 플러그인 주입, 요청 미들웨어 자동 등록 및 현지화된 사전 렌더링 페이지 출력을 처리합니다.
+
+## 사용법
+
+`astro.config.mjs`에 `intlayer()`를 추가합니다:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Astro CLI의 codemod(`astro add astro-intlayer`)에서도 지원되는 기본 가져오기를 생성합니다:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## 설명
+
+이 통합은 Astro의 빌드 및 런타임 수명 주기에 연결됩니다:
+
+1. **구성 설정 (`astro:config:setup`)**:
+   - **사전 준비**: 빌드가 실행되기 전에 Intlayer 사전과 생성된 타입을 준비합니다.
+   - **Vite 플러그인**: Vite 별칭(원활한 사전 가져오기 지원), 로케일 라우팅 프록시 및 빌드 가지치기를 위한 플러그인을 주입합니다.
+   - **미들웨어 등록**: 프로젝트의 미들웨어 체인에 `astro-intlayer/middleware`를 자동으로 주입하여 들어오는 모든 요청에 대해 `Astro.locals.intlayer`를 채웁니다.
+2. **빌드 완료 (`astro:build:done`)**:
+   - **페이지 재작성**: 현지화된 URL 재작성 규칙을 검사하고 해당 현지화 경로에 사전 렌더링된 HTML 페이지를 출력합니다.
+
+## 기본 제공 기능
+
+구성되면 Astro 애플리케이션은 즉시 다음을 사용할 수 있습니다:
+
+- `.astro` 컴포넌트 프론트매터 내의 `useIntlayer`, `useDictionary`, `useLocale` 훅.
+- Astro 엔드포인트 및 페이지의 `Astro.locals.intlayer` 객체.
+- 반응형 업데이트를 지원하며 동일한 API를 반영하는 `<script>` 블록의 클라이언트 측 가져오기.
+- `astro-intlayer/format`의 내장 포맷터 (`useDate`, `useNumber`, `useCurrency` 등).
+
+## 관련 문서
+
+- [`useIntlayer` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useLocale.md)
+- [`onRequest` 미들웨어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/onRequest.md)

package/docs/ko/packages/astro-intlayer/onRequest.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: onRequest 미들웨어 문서 | astro-intlayer
+description: Astro 애플리케이션에서 onRequest 미들웨어를 사용하여 요청 로케일을 확인하고 Astro.locals.intlayer를 채우는 방법을 알아봅니다.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# onRequest Astro 미들웨어 문서
+
+`astro-intlayer/middleware`의 `onRequest` 미들웨어는 들어오는 각 HTTP 요청의 로케일을 확인하고 `Astro.locals.intlayer`를 채웁니다.
+
+`astro.config.mjs`에 `intlayer()` 통합을 등록하면 이 미들웨어가 자동으로 주입됩니다. `sequence(...)`를 사용하여 Astro 미들웨어를 수동으로 구성하는 경우에만 직접 가져오면 됩니다.
+
+## 사용법
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // 사용자 정의 미들웨어에서 확인된 로케일에 액세스
+  const { locale } = context.locals.intlayer;
+  console.log(`로케일 요청 처리 중: ${locale}`);
+
+  return next();
+});
+```
+
+## 설명
+
+미들웨어는 다음 작업을 수행합니다:
+
+1. **로케일 감지**:
+   - **URL**: URL 경로 접두사 또는 `?locale=` 검색 매개변수를 분석합니다(`routing.mode`가 `no-prefix`로 설정되지 않은 경우).
+   - **쿠키 / 헤더**: 유지된 로케일 쿠키 또는 사용자 지정 헤더 값을 확인합니다.
+   - **Accept-Language**: 브라우저의 기본 언어 협상으로 대체됩니다.
+   - 사전 렌더링된 페이지(`context.isPrerendered`)의 경우 Astro 빌드 경고를 방지하기 위해 URL에서 엄격하게 로케일을 추출합니다.
+2. **컨텍스트 채우기**: `Astro.locals.intlayer`를 다음으로 채웁니다:
+   - `locale`: 확인된 로케일.
+   - `defaultLocale`: 기본 대체 로케일.
+   - `availableLocales`: 구성된 로케일 배열.
+3. **AsyncLocalStorage 스코프**: 다운스트림 요청 처리를 `AsyncLocalStorage` 스코프 내에 래핑하여 `useIntlayer()`, `useDictionary()` 및 `useLocale()`이 인수를 전달하지 않고도 요청 상태에 액세스할 수 있도록 합니다.
+
+## `IntlayerLocals` 타입
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## 관련 문서
+
+- [`intlayer` 통합](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/intlayer.md)
+- [`useIntlayer` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useLocale.md)

package/docs/ko/packages/astro-intlayer/useDictionary.md

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useDictionary 훅 문서 | astro-intlayer
+description: Astro 컴포넌트 및 스크립트에서 useDictionary 훅을 사용하여 사전 객체를 확인하는 방법을 알아봅니다.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# useDictionary 훅 문서
+
+`useDictionary` 훅은 가져온 사전 객체 또는 인라인 사전 객체를 확인하고 Astro 애플리케이션에서 현재 로케일에 맞는 콘텐츠를 반환합니다.
+
+전역 사전 레지스트리에서 키로 사전을 검색하는 `useIntlayer`와 달리, `useDictionary`는 사전 객체와 직접 작동합니다.
+
+## 사용법
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+`t()`로 정의된 인라인 사전을 전달할 수도 있습니다:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      ko: "모든 권리 보유.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## 매개변수
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: 사전 객체 또는 정규화된 사전 그룹.
+2. **`localeOrSelector`**(선택 사항): 특정 로케일 또는 선택기 객체(`{ item }`, `{ variant }`, 필요한 경우 `locale`).
+
+## 설명
+
+이 훅은 다음 작업을 수행합니다:
+
+1. **로케일 감지**: 서버에서는 `Astro.locals.intlayer`에서 로케일을 가져옵니다. 브라우저에서는 클라이언트 측 스토어 로케일을 사용합니다.
+2. **콘텐츠 처리**: 확인된 로케일에 따라 번역(`t()`), 열거형, 조건 및 중첩 구조를 확인합니다.
+3. **선택기**: 인수에 제공된 항목 또는 변형 선택기를 적용합니다.
+
+## 관련 문서
+
+- [`intlayer` 통합](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/intlayer.md)
+- [`useIntlayer` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useLocale.md)

package/docs/ko/packages/astro-intlayer/useIntlayer.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useIntlayer 훅 문서 | astro-intlayer
+description: Astro 컴포넌트 및 클라이언트 스크립트에서 useIntlayer 훅을 사용하여 현지화된 콘텐츠에 액세스하는 방법을 알아봅니다.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# useIntlayer 훅 문서
+
+`useIntlayer` 훅을 사용하면 Astro 애플리케이션에서 키를 통해 현지화된 사전 콘텐츠를 검색할 수 있습니다.
+
+동일한 가져오기 경로를 사용하여 두 가지 고유한 컨텍스트에서 호출할 수 있습니다:
+
+1. **서버 / 프론트매터**: `.astro` 파일 내에서 `Astro.locals.intlayer`에 저장된 요청 로케일을 사용하여 콘텐츠를 자동으로 해결합니다.
+2. **브라우저 / 클라이언트 `<script>`**: 클라이언트 스크립트 또는 UI 프레임워크 컴포넌트 내에서 클라이언트 측 스토어 구현(`vanilla-intlayer`)으로 해결됩니다.
+
+## 사용법
+
+### Astro 컴포넌트 프론트매터에서
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### 클라이언트 `<script>` 블록에서
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## 매개변수
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: 사전의 고유 키(`.content.ts` 선언 파일에 정의된 키).
+2. **`localeOrSelector`**(선택 사항): 특정 로케일 또는 선택기 객체(`{ item }`, `{ variant }`, 필요한 경우 `locale`). 제공되면 요청 컨텍스트 또는 클라이언트 스토어에서 감지된 로케일을 재정의합니다.
+
+## 설명
+
+이 훅은 다음 작업을 수행합니다:
+
+1. **로케일 해결**:
+   - 서버에서 `astro-intlayer/middleware`에 의해 초기화된 `AsyncLocalStorage` 범위를 통해 `Astro.locals.intlayer`의 활성 로케일을 읽습니다.
+   - 브라우저에서 클라이언트 스토리지/스토어의 활성 로케일을 읽습니다.
+2. **사전 검색**: 지정된 키와 일치하는 사전 콘텐츠를 주입합니다.
+3. **번역 처리**: 번역(`t()`), 열거형, 조건 및 마크다운을 렌더링 준비가 된 콘텐츠로 해결합니다.
+
+## 관련 문서
+
+- [`intlayer` 통합](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/intlayer.md)
+- [`useDictionary` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useDictionary.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useLocale.md)