@intlayer/docs 9.4.0-canary.0 → 9.4.1

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)를 참조하세요.
+````

package/docs/ko/packages/intlayer/getDictionary.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionary 함수 문서 | intlayer
+description: intlayer 패키지의 getDictionary 함수를 사용하는 방법을 참조하세요
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "초기 문서"
+author: aymericzip
+---
+
+# `intlayer`의 `getDictionary` 함수 문서
+
+## 설명
+
+`getDictionary` 함수는 **직접 전달한 dictionary 객체**를 해석하고 주어진 로케일에 대해 해결된 콘텐츠를 반환합니다. 콘텐츠를 한 번에 순회하면서 필요에 따라 각 interpreter 플러그인을 적용하여 `t()` 번역, 열거형, 조건, 삽입, 중첩, markdown, HTML 및 파일 노드를 해결합니다.
+
+생성된 레지스트리에서 키로 dictionary를 조회하는 [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayer.md)와 달리, `getDictionary`는 dictionary 자체를 받습니다. 이것이 런타임에 구축된 콘텐츠, API 또는 CMS에서 가져온 콘텐츠 또는 테스트에서 인라인으로 선언된 콘텐츠에 적합한 도구입니다.
+
+**주요 기능:**
+
+- dictionary 구조(`{ key, content }`)를 따르는 모든 객체와 함께 작동
+- 선택자와 함께 정규화된 dictionary 그룹(컬렉션, 변형)도 수락
+- 완전히 타입됨: 반환된 객체는 전달한 `content`를 미러링
+- 사용자 정의 interpreter 플러그인 수락
+
+---
+
+## 함수 서명
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // 필수
+  localeOrSelector?: LocalesValues | DictionarySelector, // 선택사항
+  plugins?: Plugins[]                                // 선택사항
+): DeepTransformContent<...>
+```
+
+---
+
+## 매개변수
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **설명**: 해석할 dictionary (또는 qualified dictionary group).
+  - **타입**: `Dictionary | QualifiedDictionaryGroup`
+  - **필수**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **설명**: 콘텐츠를 해석할 locale, 또는 selector 객체 (`{ item }`, `{ variant }`, 선택적으로 `locale` 포함). [동적 dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)를 참조하세요.
+  - **타입**: `LocalesValues | DictionarySelector`
+  - **필수**: No (선택사항) — 설정된 `defaultLocale`로 기본값 설정.
+
+- `plugins: Plugins[]`
+  - **설명**: 인식된 노드가 어떻게 해석되는지를 정의하는 node transformer 배열. 생략되면 기본 interpreter plugin 세트가 사용됩니다.
+  - **타입**: `Plugins[]`
+  - **필수**: No (선택사항)
+
+### Returns
+
+- **Type**: 해석된 딕셔너리의 콘텐츠.
+- **Description**: 전달한 `content`에서 요청된 로케일에 대해 모든 Intlayer 노드가 해석됩니다. `item` 선택자가 없는 컬렉션 그룹의 경우 해석된 항목의 정렬된 배열이 반환되며, 선택자가 아무것도 대상으로 하지 않으면 `null`이 반환됩니다.
+
+---
+
+## 예제 사용법
+
+### 기본 사용법
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        ko: "안녕하세요",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "fr"
+);
+
+console.log(content.greeting); // "Bonjour"
+```
+
+### 런타임에 가져온 콘텐츠 해석
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### 선택자 사용
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// 한정된 dictionary group은 단일 entry로 해결됩니다…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …또는 `item`이 주어지지 않으면 정렬된 배열로 해결됩니다
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## 관련 함수
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayer.md): 동일한 해석이지만, 생성된 registry에서 key로 dictionary를 조회합니다.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getDictionaryAsync.md): locale별 loader maps의 대응 함수입니다.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/useDictionary.md): React hook 동등물로, provider에서 locale을 읽습니다.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

package/docs/ko/packages/intlayer/getDictionaryAsync.md

@@ -0,0 +1,166 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionaryAsync 함수 문서 | intlayer
+description: intlayer 패키지의 getDictionaryAsync 함수 사용 방법 알아보기
+keywords:
+  - getDictionaryAsync
+  - dictionary
+  - dynamic dictionaries
+  - loader map
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionaryAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: `getDictionaryAsync` Function in `intlayer`
+
+## 설명
+
+`getDictionaryAsync` 함수는 딕셔너리의 **단일 로케일 청크**를 로드하고 해석된 콘텐츠를 반환합니다.
+
+이는 `.intlayer/dynamic_dictionaries/`에서 내보낸 로케일별 로더 맵에 대한 [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getDictionary.md)의 대응물입니다: 모든 로케일을 포함하는 딕셔너리를 받는 대신, 로더 맵을 받고 요청된 로케일이 필요로 하는 청크만 기다립니다.
+
+> 애플리케이션 코드에서는 일반적으로 이 함수가 아닌 [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayerAsync.md)를 호출합니다. [빌드 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)은 모든 `getIntlayerAsync('key', locale)` 호출을 `getDictionaryAsync(loaderMap, 'key', locale)` 호출로 다시 쓰습니다. `getDictionaryAsync`는 커스텀 로더와 자체 로더 맵을 빌드하는 도구를 위해 내보내집니다.
+
+**주요 기능:**
+
+- 요청된 로케일 청크만 로드합니다
+- 일반 (`locale → loader`) 및 한정된 (`locale → qualifierId → loader`) 로더 맵을 지원합니다
+- 동일한 청크의 동시 로드를 중복 제거하고 해석된 콘텐츠를 캐시합니다
+- 실패한 로드는 캐시에서 제거되므로 이후 호출이 청크를 재시도합니다
+
+---
+
+## 함수 시그니처
+
+```typescript
+getDictionaryAsync(
+  dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap, // 필수
+  key: string,                                           // 필수
+  localeOrSelector?: LocalesValues | DictionarySelector, // 선택사항
+  plugins?: Plugins[]                                    // 선택사항
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## 매개변수
+
+- `dictionaryLoaders: PlainDynamicLoaderMap | QualifiedDynamicLoaderMap`
+  - **설명**: 로케일별 로더 맵입니다. 일반 맵은 로케일을 로더와 연결하고, 정규화된 맵(컬렉션 및 변형에서 사용됨)은 로케일을 정규화 id와 연결한 후 로더와 연결합니다. 정규화된 맵의 경우, 선택자가 대상으로 하는 청크만 로드됩니다.
+  - **타입**: `PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap`
+  - **필수**: Yes
+
+- `key: string`
+  - **설명**: 청크 캐시의 네임스페이스에 사용되는 딕셔너리 키입니다.
+  - **타입**: `string`
+  - **필수**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **설명**: 콘텐츠를 해석할 로케일이거나, 선택자 객체(`{ item }`, `{ variant }`, 선택적으로 `locale` 포함)입니다. [동적 딕셔너리](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)를 참조하세요.
+  - **타입**: `LocalesValues | DictionarySelector`
+  - **필수**: No (선택사항) — 구성된 `defaultLocale`로 기본 설정됩니다.
+
+- `plugins: Plugins[]`
+  - **설명**: Node 변환기입니다. 기본 인터프리터 세트로 기본 설정됩니다.
+  - **타입**: `Plugins[]`
+  - **필수**: No (선택사항)
+
+### Returns
+
+- **Type**: `Promise<Content>` — loaded chunk의 interpreted content로 resolve되는 promise입니다.
+- **Description**: 요청된 locale에 대해 map이 chunk를 emit하지 않고 그 fallback 중 어느 것도 emit하지 않을 때 `null`로 resolve됩니다. 이는 missing qualified coordinate가 resolve되는 방식을 반영합니다.
+
+---
+
+## 사용 예시
+
+### 생성된 로더 맵 사용
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionaryAsync } from "intlayer";
+import appLoaderMap from "../.intlayer/dynamic_dictionaries/app";
+
+const { title } = await getDictionaryAsync(appLoaderMap, "app", "fr");
+```
+
+### 사용자 정의 로더 맵으로
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const loaderMap = {
+  en: () => import("./banner.en.json").then((mod) => mod.default),
+  fr: () => import("./banner.fr.json").then((mod) => mod.default),
+};
+
+const banner = await getDictionaryAsync(loaderMap, "banner", "fr");
+```
+
+### 정규화된 맵에서 선택자 사용
+
+```typescript
+import { getDictionaryAsync } from "intlayer";
+
+const promoBanner = await getDictionaryAsync(bannerLoaderMap, "banner", {
+  variant: "black-friday",
+  locale: "fr",
+});
+```
+
+---
+
+## 동작 주의사항
+
+### 캐싱 및 중복 제거
+
+캐시는 각 `key + locale + selector` 조합의 **promise**를 저장하므로, 동일한 청크에 대한 동시 호출은 단일 로드를 기다립니다. 거부된 로드는 캐시에서 제거되므로, 실패한 청크는 동일한 실패를 계속 반복하는 대신 다음 호출 시 재시도됩니다.
+
+### 로캘 폴백
+
+일반 로더 맵은 동기 모드와 동일한 폴백 체인을 따라 탐색됩니다: 먼저 요청된 로캘, 그 다음 폴백, 마지막으로 어떤 청크도 방출되지 않은 경우 `null`입니다.
+
+---
+
+## 관련 함수
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayerAsync.md): 애플리케이션이 호출하는 함수이며, 빌드 플러그인이 이를 `getDictionaryAsync`로 다시 작성합니다.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getDictionary.md): 전체 사전을 받는 동기 대응 함수입니다.
+- [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md): 컬렉션과 변형, 그리고 이들이 생성하는 로더 맵입니다.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionaryAsync<
+  const T extends Dictionary,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionaryLoaders: PlainDynamicLoaderMap<T> | QualifiedDynamicLoaderMap,
+  key: string,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    T["content"],
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

package/docs/ko/packages/intlayer/getEnumeration.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getEnumeration` 함수는 열거형 객체에 미리 정의된 조건에 따라 특정 수량에 해당하는 콘텐츠를 가져옵니다. 조건은 키로 정의되며, 우선순위는 객체 내 키의 순서에 의해 결정됩니다.
 
+열거형 선언 방법에 대한 자세한 내용은 [Enumeration 설명서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/enumeration.md)를 참조하세요.
+
 ## 매개변수
 
 - `enumerationContent: QuantityContent<Content>`