@intlayer/docs 8.7.7 → 8.7.8

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

@@ -66,7 +66,7 @@ t(translations: Record<string, string>): string;
 
 애플리케이션 내 모든 라우트가 국제화의 혜택을 받을 수 있도록 `app.use(intlayer())` 미들웨어를 **모든 라우트보다 먼저** 배치하세요:
 
-````typescript {7} fileName="src/index.ts" codeFormat="typescript"
+````typescript {7} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import express, { type Express } from "express";
 import { intlayer } from "express-intlayer";
 
@@ -103,48 +103,6 @@ app.get("/", (_req, res) => {
 });
 ````
 
-```javascript {7} fileName="src/index.mjs" codeFormat="esm"
-import express from "express";
-import { intlayer } from "express-intlayer";
-
-const app = express();
-
-// 국제화 요청 핸들러 로드
-app.use(intlayer());
-
-// 미들웨어 로드 후 라우트 정의
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-    })
-  );
-});
-```
-
-```javascript {7} fileName="src/index.cjs" codeFormat="commonjs"
-const express = require("express");
-const { intlayer } = require("express-intlayer");
-
-const app = express();
-
-// 국제화 요청 핸들러 로드
-app.use(intlayer());
-
-// 미들웨어 로드 후 라우트 정의
-app.get("/", (_req, res) => {
-  res.send(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-    })
-  );
-});
-```
-
 ### 이 작업이 필요한 이유
 
 - **로케일 감지**: `intlayer` 미들웨어는 요청 헤더, 쿠키 또는 기타 설정된 방법을 통해 사용자의 선호 로케일을 감지합니다.
@@ -230,19 +188,7 @@ app.get("/", (_req, res) => {
 
 여러 언어로 오류 메시지를 제공합니다:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
-app.get("/error", (_req, res) => {
-  res.status(500).send(
-    t({
-      en: "An unexpected error occurred.",
-      fr: "Une erreur inattendue s'est produite.",
-      es: "Ocurrió un error inesperado.",
-    })
-  );
-});
-```
-
-```javascript fileName="src/index.mjs" codeFormat="esm"
+```typescript fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 app.get("/error", (_req, res) => {
   res.status(500).send(
     t({
@@ -254,18 +200,6 @@ app.get("/error", (_req, res) => {
 });
 ```
 
-```javascript fileName="src/index.cjs" codeFormat="commonjs"
-app.get("/error", (_req, res) => {
-  res.status(500).send(
-    t({
-      en: "예기치 않은 오류가 발생했습니다.",
-      fr: "Une erreur inattendue s'est produite.",
-      es: "Ocurrió un error inesperado.",
-    })
-  );
-});
-```
-
 ---
 
 ### 로케일 변형 사용하기
@@ -322,7 +256,7 @@ app.get("/greet", (_req, res) => {
 
 선호하는 로케일을 사용할 수 없는 경우, `t` 함수는 구성에서 정의된 기본 로케일로 폴백합니다:
 
-```typescript {5-6} fileName="intlayer.config.ts" codeFormat="typescript"
+```typescript {5-6} fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { Locales, type IntlayerConfig } from "intlayer";
 
 const config = {
@@ -335,34 +269,6 @@ const config = {
 export default config;
 ```
 
-```javascript {5-6} fileName="intlayer.config.mjs" codeFormat="esm"
-import { Locales } from "intlayer";
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-export default config;
-```
-
-```javascript {5-6} fileName="intlayer.config.cjs" codeFormat="commonjs"
-const { Locales } = require("intlayer");
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-module.exports = config;
-```
-
 예를 들어:
 
 - `defaultLocale`가 `Locales.CHINESE`로 설정되어 있고 클라이언트가 `Locales.DUTCH`를 요청하면, 반환되는 번역은 `Locales.CHINESE` 값으로 기본 설정됩니다.
@@ -382,7 +288,7 @@ module.exports = config;
 
 구성 예시:
 
-```typescript {7} fileName="intlayer.config.ts" codeFormat="typescript"
+```typescript {7} fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type IntlayerConfig } from "intlayer";
 
 const config = {
@@ -396,40 +302,13 @@ const config = {
 export default config;
 ```
 
-```javascript {7} fileName="intlayer.config.mjs" codeFormat="esm"
-import { type IntlayerConfig } from "intlayer";
-
-const config = {
-  // ... 기존 구성 유지
-  internationalization: {
-    // ... 기존 국제화 설정
-    strictMode: "strict", // 엄격 모드 적용
-  },
-};
-
-export default config;
-```
-
-```javascript {7} fileName="intlayer.config.cjs" codeFormat="commonjs"
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  // ... 기존 설정
-  internationalization: {
-    // ... 기존 국제화 설정
-    strictMode: "strict", // 엄격 모드 적용
-  },
-};
-
-module.exports = config;
-```
-
 ---
 
 ### TypeScript 통합
 
 ` t` 함수는 TypeScript와 함께 사용할 때 타입 안전성을 제공합니다. 타입 안전한 번역 객체를 정의하세요:
 
-```typescript fileName="src/index.ts" codeFormat="typescript"
+```typescript fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type LanguageContent } from "express-intlayer";
 
 const translations: LanguageContent<string> = {
@@ -443,38 +322,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
-```javascript fileName="src/index.mjs" codeFormat="esm"
-import { type LanguageContent } from "express-intlayer";
-
-/** @type {import('express-intlayer').LanguageContent<string>} */
-// 다국어 번역 객체 정의
-const translations = {
-  en: "Good morning!",
-  fr: "Bonjour!",
-  es: "¡Buenos días!",
-};
-
-app.get("/morning", (_req, res) => {
-  res.send(t(translations));
-});
-```
-
-```javascript fileName="src/index.cjs" codeFormat="commonjs"
-const { type LanguageContent } = require("express-intlayer");
-
-/** @type {import('express-intlayer').LanguageContent<string>} */
-// 다국어 번역 객체 정의
-const translations = {
-  en: "Good morning!",
-  fr: "Bonjour!",
-  es: "¡Buenos días!",
-};
-
-app.get("/morning", (_req, res) => {
-  res.send(t(translations));
-});
-```
-
 ---
 
 ### 일반적인 오류 및 문제 해결

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

@@ -65,7 +65,7 @@ t(translations: Record<string, string>): string;
 
 애플리케이션의 **모든 라우트 앞**에 `app.use("*", intlayer())` 미들웨어를 배치하여 모든 라우트가 국제화의 이점을 누릴 수 있도록 하세요.
 
-```typescript {6} fileName="src/index.ts" codeFormat="typescript"
+```typescript {6} fileName="src/index.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { Hono } from "hono";
 import { intlayer } from "hono-intlayer";
 
@@ -87,50 +87,6 @@ app.get("/", (c) => {
 });
 ```
 
-```javascript {6} fileName="src/index.mjs" codeFormat="esm"
-import { Hono } from "hono";
-import { intlayer } from "hono-intlayer";
-
-const app = new Hono();
-
-// 국제화 요청 핸들러 로드
-app.use("*", intlayer());
-
-// 미들웨어 로드 후 라우트 정의
-app.get("/", (c) => {
-  return c.text(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-      ko: "안녕하세요, 세상!",
-    })
-  );
-});
-```
-
-```javascript {6} fileName="src/index.cjs" codeFormat="commonjs"
-const { Hono } = require("hono");
-const { intlayer, t } = require("hono-intlayer");
-
-const app = new Hono();
-
-// 국제화 요청 핸들러 로드
-app.use("*", intlayer());
-
-// 미들웨어 로드 후 라우트 정의
-app.get("/", (c) => {
-  return c.text(
-    t({
-      en: "Hello, World!",
-      fr: "Bonjour le monde!",
-      es: "¡Hola, Mundo!",
-      ko: "안녕하세요, 세상!",
-    })
-  );
-});
-```
-
 ### 이것이 필요한 이유
 
 - **로케일 감지**: `intlayer` 미들웨어는 헤더, 쿠키 또는 기타 구성된 방법을 기반으로 사용자의 선호 로케일을 감지하기 위해 들어오는 요청을 처리합니다.

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

@@ -53,7 +53,7 @@ history:
 
 ### 전체 구성 가져오기
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getConfiguration } from "intlayer";
 
 const config = getConfiguration();
@@ -67,39 +67,11 @@ console.log(config);
 // }
 ```
 
-```javascript codeFormat="esm"
-import { getConfiguration } from "intlayer";
-
-const config = getConfiguration();
-console.log(config);
-// 출력:
-// {
-//   internationalization: { ... },
-//   middleware: { ... },
-//   content: { ... },
-//   editor: { ... }
-// }
-```
-
-```javascript codeFormat="commonjs"
-const { getConfiguration } = require("intlayer");
-
-const config = getConfiguration();
-console.log(config);
-// 출력:
-// {
-//   internationalization: { ... },
-//   middleware: { ... },
-//   content: { ... },
-//   editor: { ... }
-// }
-```
-
 ### `availableLocales` 및 `defaultLocale` 추출하기
 
 설정의 `internationalization` 섹션은 `locales` (사용 가능한 로케일) 및 `defaultLocale` (기본 언어)과 같은 로케일 관련 설정을 제공합니다.
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getConfiguration } from "intlayer";
 
 const { internationalization, middleware } = getConfiguration();
@@ -111,30 +83,6 @@ console.log(defaultLocale); // 출력 예시: "en"
 console.log(cookieName); // 출력: "INTLAYER_LOCALE"
 ```
 
-```javascript codeFormat="esm"
-import { getConfiguration } from "intlayer";
-
-const { internationalization, middleware } = getConfiguration();
-const { locales: availableLocales, defaultLocale } = internationalization;
-const { cookieName } = middleware;
-
-console.log(availableLocales); // 출력 예시: ["en", "fr", "es"]
-console.log(defaultLocale); // 출력 예시: "en"
-console.log(cookieName); // 출력: "INTLAYER_LOCALE"
-```
-
-```javascript codeFormat="commonjs"
-const { getConfiguration } = require("intlayer");
-
-const { internationalization, middleware } = getConfiguration();
-const { locales: availableLocales, defaultLocale } = internationalization;
-const { cookieName } = middleware;
-
-console.log(availableLocales); // 출력 예시: ["en", "fr", "es"]
-console.log(defaultLocale); // 출력 예시: "en"
-console.log(cookieName); // 출력: "INTLAYER_LOCALE"
-```
-
 ## 주의 사항
 
 - 이 함수를 호출하기 전에 모든 필수 환경 변수가 올바르게 설정되어 있는지 확인하세요. 누락된 변수는 초기화 중 오류를 발생시킵니다.

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

@@ -50,7 +50,7 @@ history:
 
 ### 기본 사용법
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getEnumeration } from "intlayer";
 
 const content = getEnumeration(
@@ -66,53 +66,9 @@ const content = getEnumeration(
 console.log(content); // 출력: "2입니다"
 ```
 
-```javascript codeFormat="esm"
-import { getEnumeration } from "intlayer";
-
-const content = getEnumeration(
-  {
-    "<1": "1보다 작습니다",
-    "2": "2입니다",
-    ">=3": "3 이상입니다",
-  },
-  2
-);
-
-console.log(content); // 출력: "2입니다"
-```
-
-```javascript codeFormat="commonjs"
-const { getEnumeration } = require("intlayer");
-
-const content = getEnumeration(
-  {
-    "<1": "1보다 작습니다",
-    "2": "2입니다",
-    ">=3": "3 이상입니다",
-  },
-  2
-);
-
-console.log(content); // 출력: "2입니다"
-```
-
 ### 조건의 우선순위
 
-```typescript codeFormat="typescript"
-import { getEnumeration } from "intlayer";
-
-const content = getEnumeration(
-  {
-    "<4": "4보다 작습니다",
-    "2": "2입니다",
-  },
-  2
-);
-
-console.log(content); // 출력: "4보다 작습니다"
-```
-
-```javascript codeFormat="esm"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getEnumeration } from "intlayer";
 
 const content = getEnumeration(
@@ -126,20 +82,6 @@ const content = getEnumeration(
 console.log(content); // 출력: "4보다 작습니다"
 ```
 
-```javascript codeFormat="commonjs"
-const { getEnumeration } = require("intlayer");
-
-const content = getEnumeration(
-  {
-    "<4": "4보다 작습니다",
-    "2": "2입니다",
-  },
-  2
-);
-
-console.log(content); // 출력: "4보다 작습니다"
-```
-
 ## 예외 상황
 
 - **일치하는 조건 없음:**

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

@@ -48,7 +48,7 @@ history:
 
 ### 텍스트 방향 결정
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getHTMLTextDir } from "intlayer";
 
 getHTMLTextDir(Locales.ENGLISH); // 출력: "ltr"
@@ -56,22 +56,6 @@ getHTMLTextDir(Locales.FRENCH); // 출력: "ltr"
 getHTMLTextDir(Locales.ARABIC); // 출력: "rtl"
 ```
 
-```javascript codeFormat="esm"
-import { getHTMLTextDir } from "intlayer";
-
-getHTMLTextDir(Locales.ENGLISH); // 출력: "ltr"
-getHTMLTextDir(Locales.FRENCH); // 출력: "ltr"
-getHTMLTextDir(Locales.ARABIC); // 출력: "rtl"
-```
-
-```javascript codeFormat="commonjs"
-const { getHTMLTextDir } = require("intlayer");
-
-getHTMLTextDir(Locales.ENGLISH); // 출력: "ltr"
-getHTMLTextDir(Locales.FRENCH); // 출력: "ltr"
-getHTMLTextDir(Locales.ARABIC); // 출력: "rtl"
-```
-
 ## 예외 상황
 
 - **로케일이 제공되지 않은 경우:**
@@ -84,7 +68,7 @@ getHTMLTextDir(Locales.ARABIC); // 출력: "rtl"
 
 `getHTMLTextDir` 함수는 로케일에 따라 올바른 텍스트 렌더링을 위해 HTML 문서의 `dir` 속성을 동적으로 설정하는 데 사용할 수 있습니다.
 
-```tsx codeFormat="typescript"
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import { getHTMLTextDir, type Locales } from "intlayer";
 
@@ -98,24 +82,4 @@ export const HTMLLayout: FC<PropsWithChildren<{ locale: Locales }>> = ({
 );
 ```
 
-```jsx codeFormat="esm"
-import { getHTMLTextDir } from "intlayer";
-
-const HTMLLayout = ({ children, locale }) => (
-  <html dir={getHTMLTextDir(locale)} locale={locale}>
-    <body>{children}</body>
-  </html>
-);
-```
-
-```jsx codeFormat="commonjs"
-const { getHTMLTextDir } = require("intlayer");
-
-const HTMLLayout = ({ children, locale }) => (
-  <html dir={getHTMLTextDir(locale)} locale={locale}>
-    <body>{children}</body>
-  </html>
-);
-```
-
 위 예제에서 `dir` 속성은 로케일에 따라 동적으로 설정됩니다.

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

@@ -45,7 +45,7 @@ history:
 
 ### 언어 코드 추출:
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { getLocaleLang, Locales } from "intlayer";
 
 getLocaleLang(Locales.ENGLISH_UNITED_STATES); // 출력: "en"
@@ -54,24 +54,6 @@ getLocaleLang(Locales.FRENCH_CANADA); // 출력: "fr"
 getLocaleLang(Locales.FRENCH); // 출력: "fr"
 ```
 
-```javascript codeFormat="esm"
-import { getLocaleLang } from "intlayer";
-
-getLocaleLang(Locales.ENGLISH_UNITED_STATES); // 출력: "en"
-getLocaleLang(Locales.ENGLISH); // 출력: "en"
-getLocaleLang(Locales.FRENCH_CANADA); // 출력: "fr"
-getLocaleLang(Locales.FRENCH); // 출력: "fr"
-```
-
-```javascript codeFormat="commonjs"
-const { getLocaleLang } = require("intlayer");
-
-getLocaleLang(Locales.ENGLISH_UNITED_STATES); // 출력: "en"
-getLocaleLang(Locales.ENGLISH); // 출력: "en"
-getLocaleLang(Locales.FRENCH_CANADA); // 출력: "fr"
-getLocaleLang(Locales.FRENCH); // 출력: "fr"
-```
-
 ## 예외 상황
 
 - **로케일이 제공되지 않은 경우:**

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

@@ -50,7 +50,7 @@ history:
 
 ## 사용 예시
 
-```typescript codeFormat="typescript"
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
 import { Locales, getLocaleName } from "intlayer";
 
 getLocaleName(Locales.ENGLISH); // 출력: "English"
@@ -71,48 +71,6 @@ getLocaleName(Locales.CHINESE, Locales.ENGLISH); // 출력: "Chinese"
 getLocaleName("unknown-locale"); // 출력: "알 수 없는 로케일"
 ```
 
-```javascript codeFormat="esm"
-import { Locales, getLocaleName } from "intlayer";
-
-getLocaleName(Locales.ENGLISH); // 출력: "English"
-getLocaleName(Locales.ENGLISH, Locales.FRENCH); // 출력: "Anglais"
-getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // 출력: "Inglés"
-getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // 출력: "English"
-
-getLocaleName(Locales.FRENCH); // 출력: "Français"
-getLocaleName(Locales.FRENCH, Locales.FRENCH); // 출력: "Français"
-getLocaleName(Locales.FRENCH, Locales.ESPANOL); // 출력: "Francés"
-getLocaleName(Locales.FRENCH, Locales.ENGLISH); // 출력: "French"
-
-getLocaleName(Locales.CHINESE); // 출력: "中文"
-getLocaleName(Locales.CHINESE, Locales.FRENCH); // 출력: "Chinois"
-getLocaleName(Locales.CHINESE, Locales.ESPANOL); // 출력: "Chino"
-getLocaleName(Locales.CHINESE, Locales.ENGLISH); // 출력: "Chinese"
-
-getLocaleName("unknown-locale"); // 출력: "Unknown locale"
-```
-
-```javascript codeFormat="commonjs"
-const { Locales, getLocaleName } = require("intlayer");
-
-getLocaleName(Locales.ENGLISH); // 출력: "English"
-getLocaleName(Locales.ENGLISH, Locales.FRENCH); // 출력: "Anglais"
-getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // 출력: "Inglés"
-getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // 출력: "English"
-
-getLocaleName(Locales.FRENCH); // 출력: "Français"
-getLocaleName(Locales.FRENCH, Locales.FRENCH); // 출력: "Français"
-getLocaleName(Locales.FRENCH, Locales.ESPANOL); // 출력: "Francés"
-getLocaleName(Locales.FRENCH, Locales.ENGLISH); // 출력: "French"
-
-getLocaleName(Locales.CHINESE); // 출력: "中文"
-getLocaleName(Locales.CHINESE, Locales.FRENCH); // 출력: "Chinois"
-getLocaleName(Locales.CHINESE, Locales.ESPANOL); // 출력: "Chino"
-getLocaleName(Locales.CHINESE, Locales.ENGLISH); // 출력: "Chinese"
-
-getLocaleName("unknown-locale"); // 출력: "Unknown locale"
-```
-
 ## 예외 상황
 
 - **`targetLocale`가 제공되지 않은 경우:**

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

@@ -71,22 +71,7 @@ history:
 
 ### 상대 URL
 
-```typescript codeFormat="typescript"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// 출력: 프랑스어 로케일의 경우 "/fr/about"
-// 출력: 기본(영어) 로케일의 경우 "/about"
-```
-
-```javascript codeFormat="esm"
+```typescript codeFormat={["typescript", "esm"]}
 import { getLocalizedUrl, Locales } from "intlayer";
 
 getLocalizedUrl(
@@ -189,7 +174,7 @@ getLocalizedUrl(
 
 다국어 애플리케이션에서 `locales`와 `defaultLocale`로 국제화 설정을 구성하는 것은 올바른 언어가 표시되도록 하는 데 매우 중요합니다. 아래는 애플리케이션 설정에서 `getLocalizedUrl`을 사용하는 예시입니다:
 
-```tsx codeFormat="typescript"
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import { Locales, type IntlayerConfig } from "intlayer";
 
 // 지원되는 로케일과 기본 로케일 설정
@@ -203,34 +188,6 @@ export default {
 export default config;
 ```
 
-```javascript codeFormat="esm"
-import { Locales } from "intlayer";
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-export default config;
-```
-
-```javascript codeFormat="commonjs"
-const { Locales } = require("intlayer");
-
-/** @type {import('intlayer').IntlayerConfig} */
-const config = {
-  internationalization: {
-    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-    defaultLocale: Locales.ENGLISH,
-  },
-};
-
-module.exports = config;
-```
-
 위 설정은 애플리케이션이 `ENGLISH`, `FRENCH`, `SPANISH`를 지원 언어로 인식하고, `ENGLISH`를 기본 언어로 사용하도록 보장합니다.
 
 이 설정을 사용하면 `getLocalizedUrl` 함수가 사용자의 언어 선호도에 따라 동적으로 지역화된 URL을 생성할 수 있습니다: