@intlayer/docs 9.5.4 → 9.5.6

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)

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

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: useLocale 훅 문서 | astro-intlayer
+description: Astro 애플리케이션에서 useLocale 훅을 사용하여 현재 로케일에 액세스하고 관리하는 방법을 알아봅니다.
+keywords:
+  - useLocale
+  - locale
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - 국제화
+  - 문서
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# useLocale 훅 문서
+
+`astro-intlayer`의 `useLocale` 훅은 Astro 애플리케이션에서 현재 요청 로케일, 구성된 기본 로케일 및 사용 가능한 모든 로케일에 대한 액세스를 제공합니다.
+
+서버 렌더링된 `.astro` 프론트매터와 클라이언트 측 `<script>` 블록 전반에서 일관되게 동작합니다.
+
+## 사용법
+
+### 컴포넌트 프론트매터에서 (서버 렌더링)
+
+```astro fileName="src/layouts/Layout.astro"
+---
+import { useLocale } from "astro-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+const { locale, defaultLocale, availableLocales } = useLocale();
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<!DOCTYPE html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <title>Astro + Intlayer</title>
+  </head>
+  <body>
+    <header>
+      <span>현재: {locale}</span>
+      <span>기본값: {defaultLocale}</span>
+      <nav>
+        <ul>
+          {availableLocales.map((localeItem) => (
+            <li key={localeItem} className="p-1">
+              <a
+                href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                aria-current={localeItem === locale ? "page" : undefined}
+              >
+                {localeItem.toUpperCase()}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+    <slot />
+  </body>
+</html>
+```
+
+### 클라이언트 `<script>`에서 (인터랙티브)
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import { useLocale } from "astro-intlayer";
+
+const { locale, availableLocales } = useLocale();
+---
+
+<select id="locale-select">
+  {availableLocales.map((loc) => (
+    <option value={loc} selected={loc === locale}>
+      {loc.toUpperCase()}
+    </option>
+  ))}
+</select>
+
+<script>
+  import { useLocale, setLocaleInStorage } from "astro-intlayer";
+
+  const { setLocale } = useLocale();
+
+  document.getElementById("locale-select")?.addEventListener("change", (e) => {
+    const target = e.target as HTMLSelectElement;
+    setLocale(target.value);
+  });
+</script>
+```
+
+## 반환값
+
+이 훅은 `UseLocaleResult` 타입의 객체를 반환합니다:
+
+| 속성               | 타입                                   | 설명                                                                                          |
+| ------------------ | -------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`                      | 활성 로케일.                                                                                  |
+| `defaultLocale`    | `DeclaredLocales`                      | `intlayer.config.ts`에 구성된 기본 대체 로케일.                                               |
+| `availableLocales` | `DeclaredLocales[]`                    | 프로젝트에 구성된 지원되는 모든 로케일의 배열.                                                |
+| `setLocale`        | `(locale: LocalesValues) => void`      | 로케일을 업데이트하는 함수. (클라이언트 `<script>`에서 대화형으로 작동하며, SSR 중에는 경고). |
+| `subscribe`        | `(callback: () => void) => () => void` | 클라이언트 측 로케일 변경을 구독합니다.                                                       |
+
+## 서버 vs 클라이언트 동작
+
+- **SSR / 서버 렌더링 중**: 요청은 고정된 매개변수로 한 번 렌더링됩니다. 서버 렌더링 중에 `setLocale()`을 호출해도 효과가 없으며 경고가 발생합니다. 로케일 전환은 클라이언트에서 수행하거나 대상 로케일 URL로 이동하여 수행해야 합니다.
+- **클라이언트 스크립트에서**: `setLocale`은 클라이언트 스토어를 업데이트하고 Intlayer 구성에 따라 유지된 쿠키 또는 로컬 스토리지를 업데이트합니다.
+
+## 관련 문서
+
+- [`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)
+- [`useDictionary` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/astro-intlayer/useDictionary.md)

package/docs/ko/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Intlayer 컨텍스트 문서 | remix-intlayer
+description: Remix 3 애플리케이션의 Intlayer 요청 컨텍스트 스토리지 키에 대한 문서입니다.
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - 요청 컨텍스트
+  - 국제화
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Intlayer 컨텍스트 키 초기 문서"
+author: aymericzip
+---
+
+# Intlayer 요청 컨텍스트 키
+
+`Intlayer` 내보내기는 Remix 3에서 요청 컨텍스트 스토리지 식별자 역할을 합니다. 라우트 핸들러나 커스텀 미들웨어 내에서 Remix 컨텍스트 객체로부터 Intlayer 상태를 직접 검색할 수 있습니다.
+
+## 사용법
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/current-locale", (context) => {
+  const intlayerState = context.get(Intlayer);
+
+  return Response.json({
+    locale: intlayerState?.locale,
+  });
+});
+```
+
+## 설명
+
+`Intlayer`는 `intlayer()` 미들웨어가 현재 세션 상태를 Remix의 요청 컨텍스트(`RequestContext`)에 바인딩하는 데 사용됩니다. 일반적으로는 `useLocale()`이나 `useIntlayer()`와 같은 훅을 사용하는 것이 권장됩니다. `context.get(Intlayer)`를 통한 직접 접근은 저수준 미들웨어 핸들러나 컨텍스트 인스턴스가 명시적으로 전달되는 API 라우트에서 유용합니다.
+
+## 관련 문서
+
+- [`intlayer` 미들웨어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/intlayerMiddleware.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useLocale.md)

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

@@ -0,0 +1,80 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: remix-intlayer 패키지 문서
+description: Remix 3 애플리케이션에 국제화(i18n)를 제공하는 remix-intlayer 패키지의 내보내기 문서입니다.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - intlayer
+  - 국제화
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "remix-intlayer 내보내기 초기 문서"
+author: aymericzip
+---
+
+# remix-intlayer 패키지
+
+`remix-intlayer` 패키지는 Remix 3 애플리케이션에 Intlayer를 통합하기 위한 도구를 제공합니다. 요청 로케일 감지를 위한 미들웨어, 요청 컨텍스트 접근, 사전 조회 및 로케일 관리를 위한 훅을 포함합니다.
+
+## 설치
+
+```bash
+npm install remix-intlayer
+```
+
+## 패키지 내보내기
+
+### 미들웨어
+
+| 내보내기   | 타입          | 설명                                                                                          | 관련 문서                                                                                                                        |
+| ---------- | ------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | 미들웨어 함수 | 요청 로케일을 감지하고, 리다이렉션을 처리하며, 요청 컨텍스트를 채우는 Remix 3 미들웨어입니다. | [intlayer 미들웨어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### 컨텍스트 스토리지
+
+| 내보내기   | 타입                         | 설명                                                                                                            | 관련 문서                                                                                                              |
+| ---------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `Intlayer` | RequestContext 키 / 스토리지 | Remix 3 요청 컨텍스트(`context.get(Intlayer)`)에서 Intlayer 상태를 가져오는 데 사용되는 요청 컨텍스트 키입니다. | [Intlayer 컨텍스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/Intlayer.md) |
+
+### 훅
+
+| 내보내기        | 타입 | 설명                                                                                                 | 관련 문서                                                                                                                  |
+| --------------- | ---- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | 훅   | 현재 요청 로케일에 맞춰 키로 지정된 사전 콘텐츠를 조회하고 해결합니다.                               | [useIntlayer 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | 훅   | 사전에 가져온 사전 객체에서 현재 요청 로케일에 해당하는 콘텐츠를 반환합니다.                         | [useDictionary 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | 훅   | 현재 요청 로케일, 기본 로케일 및 프로젝트에서 사용 가능한 전체 로케일 목록에 대한 접근을 제공합니다. | [useLocale 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useLocale.md)         |
+
+## 빠른 시작
+
+### 라우터에서 미들웨어 구성
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+### 뷰 및 컴포넌트에서 콘텐츠 사용
+
+```ts fileName="src/views/home.ts"
+import { useIntlayer } from "remix-intlayer";
+
+export const HomeView = () => {
+  const content = useIntlayer("home");
+
+  return `<h1>${content.title}</h1><p>${content.description}</p>`;
+};
+```

package/docs/ko/packages/remix-intlayer/intlayerMiddleware.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: intlayer 미들웨어 문서 | remix-intlayer
+description: Remix 3에서 intlayer 미들웨어를 사용하여 로케일을 감지하고, 리다이렉션을 처리하며, 요청 컨텍스트에 Intlayer 상태를 주입하는 방법을 알아봅니다.
+keywords:
+  - intlayer
+  - middleware
+  - remix
+  - remix-3
+  - 국제화
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - intlayerMiddleware
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "intlayer 미들웨어 초기 문서"
+author: aymericzip
+---
+
+# intlayer 미들웨어
+
+`intlayer` 미들웨어 함수는 Remix 3 애플리케이션에서 요청별 국제화를 설정합니다. 들어오는 각 요청의 로케일을 감지하고, URL 리다이렉션 규칙을 적용하며, 로케일 상태를 요청 컨텍스트에 유지합니다.
+
+## 사용법
+
+Remix 라우터에 미들웨어를 등록합니다.
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer } from "remix-intlayer";
+
+export const router = createRouter({
+  middleware: [intlayer()],
+});
+```
+
+## 동작 방식
+
+미들웨어는 수신된 각 요청에 대해 다음 작업을 수행합니다.
+
+1. **로케일 감지**: Intlayer 설정에 따라 URL 경로 접두사(예: `/ko/about`), 쿠키 또는 `Accept-Language` 헤더에서 로케일을 추출합니다.
+2. **URL 리다이렉션**: 요청된 경로에 로케일 접두사가 없고 설정에서 접두사 라우팅이 필요한 경우, 접두사가 포함된 URL로의 리다이렉션 응답(302/307/308)을 반환합니다.
+3. **요청 컨텍스트 등록**: `Intlayer` 키를 사용하여 확인된 현재 로케일을 Remix 요청 컨텍스트에 저장하여, 훅(`useLocale`, `useIntlayer`, `useDictionary`)이 이를 투명하게 활용할 수 있도록 합니다.
+4. **쿠키 관리**: 사용자의 선호 로케일을 유지해야 하는 경우 `Set-Cookie` 헤더를 설정합니다.
+
+## 관련 문서
+
+- [`Intlayer` 요청 컨텍스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/Intlayer.md)
+- [`useLocale` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useLocale.md)
+- [`useIntlayer` 훅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/remix-intlayer/useIntlayer.md)