@intlayer/docs 9.4.0-canary.0 → 9.4.0

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

@@ -0,0 +1,197 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayer 함수 문서 | intlayer
+description: intlayer 패키지를 위한 getIntlayer 함수 사용 방법을 알아봅니다
+keywords:
+  - getIntlayer
+  - dictionary
+  - content
+  - selector
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# Documentation: `intlayer`의 `getIntlayer` Function
+
+## Description
+
+`getIntlayer` 함수는 키로 하나의 딕셔너리를 선택하고 주어진 로케일에 대해 해석된 내용을 반환합니다. 이는 `useIntlayer` 훅의 프레임워크에 독립적인 대응물입니다: 동일한 내용, 동일한 선택자이지만 React 컨텍스트를 사용할 수 없는 곳(Node 스크립트, 서버 함수, 라우트 로더, 메타데이터 빌더, Express/Fastify 핸들러, 테스트)에서 사용 가능합니다.
+
+`.intlayer/`에서 Intlayer가 생성한 딕셔너리를 읽으므로, `key` 인자는 타입이 지정되고 자신의 콘텐츠 선언에서 자동 완성되며, 반환된 객체는 각 리프까지 완전히 타입이 지정됩니다.
+
+**주요 기능:**
+
+- 타입이 지정된 딕셔너리 키와 타입이 지정된 반환 콘텐츠
+- 모든 콘텐츠 노드 해석(`t()`, `enu()`, `cond()`, `insert()`, `nest()`, `md()`, `html()`, `file()`, `gender()`)
+- 로케일 또는 선택자 객체(컬렉션, 변형) 수용
+- 결과는 `key + locale + selector`당 메모이제이션됨
+- 개발 중 딕셔너리가 누락된 경우 충돌하는 대신 안전한 프록시로 폴백
+
+---
+
+## 함수 시그니처
+
+```typescript
+getIntlayer(
+  key: DictionaryKeys,                        // 필수
+  localeOrSelector?: LocalesValues | DictionarySelector, // 선택사항
+  plugins?: Plugins[]                         // 선택사항
+): DeepTransformContent<...>
+```
+
+---
+
+## Parameters
+
+- `key: DictionaryKeys`
+  - **Description**: 콘텐츠 파일에 선언된 대로 읽을 사전의 키입니다.
+  - **Type**: `DictionaryKeys` — 선언된 모든 사전 키의 합집합입니다.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: 콘텐츠를 해석할 locale이거나, [dynamic dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)용 selector 객체입니다.
+    - `'fr'` — a locale
+    - `{ item: 2 }` — a [collection](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/collections.md) item (omit `item` to get every item as an array)
+    - `{ variant: 'black-friday' }` — a named [variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/variants.md) (omit for the `default` one)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — a structured variant
+    - Any selector can carry a locale: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — 설정된 `defaultLocale`으로 기본 설정됩니다.
+
+- `plugins: Plugins[]`
+  - **Description**: 기본 interpreter plugins를 대체하는 커스텀 node transformers입니다. 고급 사용법이므로, 기본 동작을 유지하려면 생략하세요.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: 선언된 타입으로 입력된 사전의 해석된 콘텐츠.
+- **Description**: 사전의 `content` 필드를 반영하는 일반 객체로, 모든 Intlayer 노드가 요청된 로케일에 대한 최종 값으로 해석됩니다.
+
+---
+
+## 사용 예시
+
+### 기본 사용법
+
+```typescript fileName="src/app.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      ko: "안녕하세요",
+      en: "Hello",
+      fr: "Bonjour",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app", "fr"); // "Bonjour"
+```
+
+### 로케일 없이
+
+로케일을 생략하면 [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 선언된 `defaultLocale`로 콘텐츠를 해석합니다.
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer("app"); // 기본 로케일로 해석됨
+```
+
+### 서버 핸들러 내부
+
+```typescript fileName="src/routes/greeting.ts" codeFormat="typescript"
+import { getIntlayer, getLocale } from "intlayer";
+
+export const greetingHandler = async (request: Request) => {
+  const locale = await getLocale({
+    getHeader: (name) => request.headers.get(name) ?? undefined,
+  });
+
+  const { title } = getIntlayer("app", locale);
+
+  return Response.json({ title });
+};
+```
+
+### 선택자가 있는 경우 (컬렉션 및 변형)
+
+```typescript
+import { getIntlayer } from "intlayer";
+
+// 단일 컬렉션 항목
+const secondPost = getIntlayer("blog-post", { item: 2, locale: "fr" });
+
+// 컬렉션의 모든 항목, 정렬된 배열로
+const allPosts = getIntlayer("blog-post", { locale: "fr" });
+
+// 명명된 변형
+const banner = getIntlayer("banner", { variant: "black-friday", locale: "fr" });
+```
+
+---
+
+## 동작 참고 사항
+
+### Caching
+
+결과는 `key + locale + selector`를 키로 하는 모듈 레벨 캐시에 메모이제이션됩니다. `getIntlayer("app", "fr")`을 반복적으로 호출해도 dictionary는 한 번만 해석되고 그 이후로는 동일한 객체를 반환합니다.
+
+### 누락된 사전
+
+개발 중에 생성된 사전이 없는 키를 요청하면 경고가 한 번 기록되고 안전한 폴백 프록시가 반환됩니다. `content.title`을 읽으면 오류를 던지는 대신 `"app.title"` 문자열이 반환됩니다. 이를 통해 누락된 선언이 수정될 때까지 페이지를 사용할 수 있게 유지됩니다. Intlayer 빌드(또는 dev 서버)를 실행하여 사전이 생성되도록 하세요.
+
+### Bundle size
+
+`getIntlayer`는 **모든** locale을 포함하는 병합된 사전을 읽습니다. 클라이언트 번들에서 [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md)는 필요한 콘텐츠만 배송되도록 호출을 다시 작성합니다. 렌더링 외부에서 콘텐츠를 읽을 때(metadata, loaders, server functions) 단일 locale을 요청 시 로드하려면 [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayerAsync.md)를 대신 사용하세요.
+
+---
+
+## 관련 함수
+
+- [`getIntlayerAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayerAsync.md): 단일 locale 청크를 로드하는 비동기 counterpart입니다.
+- [`getDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getDictionary.md): 키로 조회되는 대신 직접 전달하는 dictionary 객체를 해석합니다.
+- [`useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/react-intlayer/useIntlayer.md): provider에서 locale을 읽는 React hook의 동등물입니다.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayer<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  DictionaryRegistryResult<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```

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

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getIntlayerAsync Function Documentation | intlayer
+description: intlayer package의 getIntlayerAsync 함수를 사용하는 방법을 알아보세요
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "초기 문서화"
+author: aymericzip
+---
+
+# Documentation: `intlayer`의 `getIntlayerAsync` 함수
+
+## Description
+
+`getIntlayerAsync` 함수는 키로 하나의 딕셔너리를 선택하고 주어진 로캘에 대한 콘텐츠를 해결하며, **해당 로캘만 로드합니다**.
+
+이는 [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayer.md)의 비동기 대응 함수로, 렌더링 외부에서 딕셔너리가 읽히는 곳 — 라우트 `head` / 메타데이터 빌더, 로더, 서버 함수를 위해 고안되었습니다.
+
+`getIntlayer`가 모든 로캘을 포함하는 병합된 딕셔너리를 가져오는 반면, [빌드 플러그인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`)은 이 호출을 `getDictionaryAsync(loaderMap, key, locale)`로 다시 쓰고, `.intlayer/dynamic_dictionaries/`의 로캘별 청크를 가리킵니다. 따라서 번들은 실제로 요청된 로캘만 포함합니다.
+
+이러한 플러그인 없이 — 최적화되지 않은 빌드 — 호출은 동기 딕셔너리 레지스트리를 통해 대신 해결됩니다: 로캘별 분할 없이 동일한 콘텐츠입니다.
+
+**주요 기능:**
+
+- `getIntlayer`와 동일한 타입 지정 키, 선택자 및 반환된 콘텐츠
+- 최적화된 빌드에서 요청된 로캘 청크만 로드
+- 동일한 청크에 대한 동시 호출은 단일 로드를 공유합니다
+- `async` 메타데이터 빌더, 로더 및 서버 함수에서 안전하게 사용 가능
+
+---
+
+## 함수 서명
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // 필수
+  localeOrSelector?: LocalesValues | DictionarySelector, // 선택사항
+  plugins?: Plugins[]                         // 선택사항
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## 매개변수
+
+- `key: DictionaryKeys`
+  - **Description**: 콘텐츠 파일에 선언된 대로 읽을 사전의 키입니다.
+  - **Type**: `DictionaryKeys` — 선언된 모든 사전 키의 합집합입니다.
+  - **Required**: Yes
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **Description**: 콘텐츠를 해석할 로케일 또는 [동적 사전](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)에 대한 선택자 객체입니다.
+    - `'fr'` — 로케일
+    - `{ item: 2 }` — [컬렉션](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/collections.md) 항목 (`item`을 생략하면 배열로 모든 항목을 얻습니다)
+    - `{ variant: 'black-friday' }` — 명명된 [변형](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/variants.md) (`default`를 원할 경우 생략)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — 구조화된 변형
+    - 모든 선택자는 로케일을 포함할 수 있습니다: `{ item: 2, locale: 'fr' }`
+  - **Type**: `LocalesValues | DictionarySelector`
+  - **Required**: No (Optional) — 기본값은 구성된 `defaultLocale`입니다.
+
+- `plugins: Plugins[]`
+  - **Description**: 기본 인터프리터 플러그인을 대체하는 커스텀 노드 변환기입니다. 고급 사용만 해당합니다.
+  - **Type**: `Plugins[]`
+  - **Required**: No (Optional)
+
+### Returns
+
+- **Type**: `Promise<Content>` — 선언에서 입력한 타입으로 지정된 dictionary의 해석된 내용으로 resolve되는 promise입니다.
+
+---
+
+## 사용 예시
+
+### 기본 사용법
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` vs `getIntlayerAsync`
+
+|                    | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                                |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
+| Returns            | 컨텐츠                                                                                                          | 컨텐츠의 Promise                                  |
+| Dictionary loaded  | 병합된 사전 (모든 로케일)                                                                                       | 요청된 로케일의 청크만                            |
+| Best suited for    | 렌더링, 동기 코드 경로                                                                                          | 메타데이터, 로더, 서버 함수                       |
+| Requires a plugin? | No                                                                                                              | No — per-locale 분할은 빌드 플러그인이 필요합니다 |
+
+둘 다 동일한 인수를 수용하고 동일한 컨텐츠를 반환합니다: 둘 중 하나에서 다른 하나로 전환하면 **언제**와 **얼마나 많은**이 로드되는지만 변경됩니다.
+
+---
+
+## 관련 함수
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getIntlayer.md): 병합된 딕셔너리를 읽는 동기 동등물.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getDictionaryAsync.md): 빌드 플러그인이 이 호출을 다시 작성하는 하위 수준 함수.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getLocale.md): 들어오는 요청의 로케일을 감지합니다.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

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

@@ -59,7 +59,5 @@ getLocaleLang(Locales.FRENCH); // 출력: "fr"
 
 - **로케일이 제공되지 않은 경우:**
 
-- `locale`가 `undefined`일 때 함수는 빈 문자열을 반환합니다.
-
 - **잘못된 형식의 로케일 문자열:**
   - `locale`이 `language-country` 형식을 따르지 않는 경우(예: `Locales.ENGLISH-US`), 함수는 `'-'` 이전 부분을 안전하게 반환하거나 `'-'`가 없으면 전체 문자열을 반환합니다.

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getLocalizedPath` 함수는 캐노니컬 경로(애플리케이션 내부 경로)를 제공된 로케일 및 리라이트 규칙에 따라 로컬라이즈된 등가 경로로 변환합니다. 언어별로 달라지는 SEO 친화적 URL을 생성할 때 특히 유용합니다.
 
+이것은 [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getLocalizedUrl.md)의 상대 경로 버전입니다 — 상대 입력의 경우 둘 다 같은 값을 반환합니다. `getLocalizedUrl`과 달리 절대 URL을 반환하지 않습니다: `domains` 설정이 무시되므로 자신의 도메인에서 제공되는 로케일도 경로를 반환합니다. 절대 입력은 허용되지만 원본은 제거됩니다 — 경로, 쿼리 문자열 및 해시만 유지됩니다.
+
 **주요 기능:**
 
 - `[param]` 구문을 사용한 동적 라우트 매개변수를 지원합니다.
@@ -60,11 +62,6 @@ getLocalizedPath(
   - **타입**: `string`
   - **필수**: 예
 
-- `locale: Locales`
-  - **설명**: 경로를 로컬라이즈할 대상 로케일입니다.
-  - **타입**: `Locales`
-  - **필수**: 예
-
 ### 선택적 매개변수
 
 - `rewriteRules?: RoutingConfig['rewrite']`
@@ -72,6 +69,15 @@ getLocalizedPath(
   - **타입**: `RoutingConfig['rewrite']`
   - **기본값**: `configuration.routing.rewrite`
 
+- `options?: object`
+  - **Description**: 라우팅 오버라이드. 모든 항목은 프로젝트의 구성으로 기본값이 설정됩니다.
+  - **Type**: `object`
+
+  - `options.locales?: Locales[]` — 지원하는 로케일. **기본값**: `configuration.internationalization.locales`
+  - `options.defaultLocale?: Locales` — 기본 로케일. **기본값**: `configuration.internationalization.defaultLocale`
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'` — 경로에 로케일이 표시되는 방식. **기본값**: `configuration.routing.mode`
+  - `options.rewrite?: RoutingConfig['rewrite']` — 사용자 정의 rewrite 규칙. **기본값**: `configuration.routing.rewrite`
+
 ---
 
 ## 반환값
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **타입**: `string`
 - **설명**: 지정된 로케일에 대한 로컬라이즈된 경로입니다.
 
+타입은 구성에서 선언된 재작성 규칙으로부터 좁혀지므로, 편집기는 단순 `string`이 아닌 확인된 경로를 표시합니다:
+
+```typescript codeFormat="typescript"
+// 설정: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (재작성 규칙이 일치하지 않음, 접두사만 적용됨)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+같은 좁혀진 범위가 [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getLocalizedUrl.md)으로 흐르며, 이는 locale을 prefixing하기 전에 rewrite 규칙을 적용합니다.
+
+두 가지 경우는 컴파일 타임에 해결할 수 없기 때문에 `string`으로 확대됩니다:
+
+- 문자열 리터럴이 아닌 경로 (예: 변수에서 생성된 경로);
+- 다중 세그먼트 또는 선택적 매개변수를 사용하는 규칙과 일치하는 경로 (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## 예시 사용법
@@ -126,8 +154,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // 출력: "/contactez-nous"
 ```
 
----
-
 ### 로케일 생략
 
 로케일이 주어지지 않으면 경로는 구성된 기본 로케일에 대해 로컬화됩니다:

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

@@ -34,6 +34,14 @@ author: aymericzip
 
 `getLocalizedUrl` 함수는 지정된 로케일을 URL 앞에 붙여서 지역화된 URL을 생성합니다. 절대 URL과 상대 URL 모두를 처리하며, 구성에 따라 올바른 로케일 접두사가 적용되도록 보장합니다.
 
+**주요 기능:**
+
+- 필수 매개변수는 `url`과 `currentLocale` 두 가지입니다
+- `locales`, `defaultLocale`, `mode`를 포함하는 선택적 `options` 객체
+- 프로젝트의 국제화 설정을 기본값으로 사용합니다
+- 간단한 경우에는 최소 매개변수로 사용하거나 복잡한 시나리오를 위해 완전히 사용자 정의할 수 있습니다
+- 여러 라우팅 모드를 지원합니다: `prefix-no-default`, `prefix-all`, `no-prefix`, `search-params`
+
 ---
 
 ## 함수 서명
@@ -138,36 +146,6 @@ getLocalizedUrl(
 // 출력: 기본(영어) 로케일의 경우 "/about"
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// 출력: 프랑스어 로케일의 경우 "/fr/about"
-// 출력: 기본(영어) 로케일의 경우 "/about"
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// 출력: 프랑스어 로케일의 경우 "/fr/about"
-// 출력: 기본(영어) 로케일의 경우 "/about"
-```
-
 ### 부분 Configuration Override
 
 선택적 매개변수 중 일부만 제공할 수도 있습니다. 함수는 지정하지 않은 매개변수에 대해 프로젝트 configuration을 사용합니다:
@@ -244,6 +222,12 @@ getLocalizedUrl(
 - **지원되지 않는 로케일:**
   - `locales` 목록에 없는 로케일에 대해서는 함수가 접두사를 적용하지 않습니다.
 
+- **라우팅 모드:**
+  - `'prefix-no-default'`: 기본 locale은 prefix가 없고, 다른 locale은 prefix가 있음 (예: `/about`, `/fr/about`)
+  - `'prefix-all'`: 모든 locale이 prefix를 가짐 (예: `/en/about`, `/fr/about`)
+  - `'no-prefix'`: URL에 locale prefix가 없음 (locale은 다른 곳에서 처리됨)
+  - `'search-params'`: Query parameter를 통해 locale이 지정됨 (예: `/about?locale=fr`)
+
 ---
 
 ## 애플리케이션에서의 사용

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

@@ -31,6 +31,14 @@ author: aymericzip
 
 `getMultilingualUrls` 함수는 주어진 URL에 각 지원되는 로케일을 접두사로 붙여 다국어 URL 매핑을 생성합니다. 절대 URL과 상대 URL 모두를 처리할 수 있으며, 제공된 구성이나 기본값에 따라 적절한 로케일 접두사를 적용합니다.
 
+**주요 특징:**
+
+- 필수 매개변수는 1개입니다: `url`
+- `locales`, `defaultLocale`, `mode`를 포함하는 선택적 `options` 객체
+- 프로젝트의 국제화 설정을 기본값으로 사용합니다
+- 여러 라우팅 모드를 지원합니다: `prefix-no-default`, `prefix-all`, `no-prefix`, `search-params`
+- 모든 로케일을 키로, 해당 URL을 값으로 하는 매핑 객체를 반환합니다
+
 ---
 
 ## 함수 서명
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### 다양한 라우팅 모드
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **지원되지 않는 로케일:**
   - `locales` 배열에 제공된 로케일만 URL 생성에 고려됩니다.
 
+- **라우팅 모드:**
+  - `'prefix-no-default'`: 기본 로케일은 접두사가 없고, 다른 로케일은 있음 (예: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: 모든 로케일에 접두사가 있음 (예: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: URL에 로케일 접두사가 없음 (모든 로케일이 동일한 URL 반환)
+  - `'search-params'`: 쿼리 파라미터를 통해 로케일 지정 (예: `/dashboard?locale=fr`)
+
 ---
 
 ## 애플리케이션에서의 사용법
@@ -226,39 +238,6 @@ export default {
 export default config;
 ```
 
-위의 구성은 애플리케이션이 `ENGLISH`, `FRENCH`, `SPANISH`를 지원 언어로 인식하고, `ENGLISH`를 기본 언어로 사용하도록 보장합니다.
-
-이 구성을 사용하면 `getMultilingualUrls` 함수가 애플리케이션에서 지원하는 로케일을 기반으로 다국어 URL 매핑을 동적으로 생성할 수 있습니다:
-
-```typescript
-getMultilingualUrls(
-  "/dashboard",
-  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-  Locales.ENGLISH
-);
-// 출력:
-// {
-//   en: "/dashboard",
-//   fr: "/fr/dashboard",
-//   es: "/es/dashboard"
-// }
-```
-
-```typescript
-getMultilingualUrls(
-  "https://example.com/dashboard",
-  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-  Locales.ENGLISH,
-  true
-);
-// 출력:
-// {
-//   en: "https://example.com/en/dashboard",
-//   fr: "https://example.com/fr/dashboard",
-//   es: "https://example.com/es/dashboard"
-// }
-```
-
 위 구성은 애플리케이션이 `ENGLISH`, `FRENCH`, `SPANISH`를 지원 언어로 인식하고 `ENGLISH`를 기본 언어로 사용하도록 보장합니다.
 
 이 구성을 사용하면 `getMultilingualUrls` 함수가 애플리케이션의 지원 로케일을 기반으로 다국어 URL 매핑을 동적으로 생성할 수 있습니다:

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

@@ -77,8 +77,6 @@ type GetPrefixResult = {
     - **타입**: `Locales`
     - **기본값**: [`프로젝트 구성`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)
 
-  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
-
 - **설명**: 로케일 처리를 위한 URL 라우팅 모드입니다. 제공되지 않으면 프로젝트 구성에서 설정된 모드를 사용합니다.
 - **타입**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
 - **기본값**: [`프로젝트 구성`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md#middleware)

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getTranslationContent` 함수는 사용자 정의 가능한 언어 콘텐츠 집합에서 특정 로케일에 해당하는 콘텐츠를 가져옵니다. 지정된 로케일을 찾을 수 없는 경우, 프로젝트에 설정된 기본 로케일의 콘텐츠를 반환합니다.
 
+번역 선언 방법에 대한 자세한 내용은 [번역 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md)를 참조하세요.
+
 ## 매개변수
 
 - `languageContent: CustomizableLanguageContent<Content>`

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

@@ -102,37 +102,6 @@ export const ServerComponentExample: FC = () => (
 );
 ```
 
-###속성 내 인라인 번역
-
-`t` 함수는 JSX 속성 내 인라인 번역에 특히 유용합니다.
-`alt`, `title`, `href`, `aria-label`과 같은 속성을 현지화할 때, 속성 내에서 직접 `t`를 사용할 수 있습니다.
-
-```jsx
-<button
-  aria-label={t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
->
-  {t({
-    en: "Submit",
-    fr: "Soumettre",
-    es: "Enviar",
-  })}
-  <img
-    src="/path/to/image"
-    alt={t({
-      en: "A beautiful scenery",
-      fr: "Un beau paysage",
-      es: "Un hermoso paisaje",
-    })}
-  />
-</button>
-```
-
----
-
 ### 속성의 인라인 번역
 
 `t` 함수는 JSX 속성의 인라인 번역에 특히 유용합니다.
@@ -192,6 +161,23 @@ const greeting = t(translations);
 
 #### 예시:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -207,6 +193,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## 일반적인 오류 및 문제 해결