@intlayer/docs 9.3.3 → 9.4.0

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,6 +154,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // 출력: "/contactez-nous"
 ```
 
+### 로케일 생략
+
+로케일이 주어지지 않으면 경로는 구성된 기본 로케일에 대해 로컬화됩니다:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Configuration: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// 출력: "/about"
+```
+
 ---
 
 ## 관련 함수

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>
+
 ---
 
 ## 일반적인 오류 및 문제 해결

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

@@ -79,6 +79,34 @@ Next.js 애플리케이션에서 클라이언트 측 또는 서버 측 컴포넌
 
 다음은 Next.js 페이지 내에서 `useIntlayer` 훅을 구현하여 애플리케이션의 현재 로케일에 따라 로컬라이즈된 콘텐츠를 동적으로 로드하는 방법입니다:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

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

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## 반환 값
 
+`useLocale` 훅을 호출하면 다음 속성을 포함하는 객체가 반환됩니다:
+
 - **`locale`**: React 컨텍스트에 설정된 현재 로케일입니다.
 - **`defaultLocale`**: 구성에서 정의된 기본 로케일입니다.
 - **`availableLocales`**: 구성에서 정의된 사용 가능한 모든 로케일 목록입니다.

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

@@ -134,7 +134,3 @@ export default Sidebar;
 
 - [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/next-intlayer/useLocale.md) — 현재 로케일 + 로케일 스위처 (`pathWithoutLocale`도 노출)
 - [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/intlayer/getPathWithoutLocale.md) — 이 훅에서 사용하는 기본 유틸리티
-
-```
-
-```

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

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## React에서의 사용 예제
 
-아래는 React 컴포넌트에서 `useDictionary` 훅을 사용하는 예제입니다:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/ko/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ author: aymericzip
 
 React 컴포넌트 내에서 `useI18n` 훅을 사용하는 예시:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

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

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## React에서 사용 예제
 
-React 컴포넌트 내에서 `useIntlayer` 훅을 사용하는 예제:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1> {/* 제목을 표시합니다 */}
-      <p>{content.description}</p> {/* 설명을 표시합니다 */}
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/ko/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize`가 `true`이거나 (빌드의 기본값인 `undefined`여서 `true`로 설정된 경우).
 3. Intlayer 설정에서 `build.minify`가 `true`인 경우.
 
-에디터는 완전하고 사람이 읽을 수 있는 사전 콘텐츠를 필요로 하므로 `editor.enabled`가 `true`이면 자동으로 **비활성화**됩니다.
+`editor.enabled`가 `true`이면 플러그인은 계속 실행되지만 **필드 이름 변경은 건너뜁니다**: 이름 변경은 인터프리터가 순회하는 콘텐츠 키를 다시 작성하므로, 비주얼 에디터가 받는 `keyPath`가 편집 대상인 병합되지 않은 사전과 더 이상 일치하지 않게 됩니다. 공백 압축과 최상위 메타데이터 제거는 계속 활성 상태로 유지됩니다.
 
 ## 압축 대상
 

package/docs/ko/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 `intlayerPrune` Vite 플러그인은 애플리케이션 번들에서 사용되지 않는 사전(dictionary)을 트리 쉐이킹하고 제거(prune)하는 데 사용됩니다. 이를 통해 필요한 다국어 콘텐츠만 포함되어 최종 번들 크기를 줄일 수 있습니다.
 
+> 플러그인은 [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/vite-intlayer/intlayer.md)를 사용할 때 이미 자동으로 포함되고 구성됩니다. 플러그인 스택을 직접 구성하는 경우에만 수동으로 등록하면 됩니다.
+
 ## 사용법
 
 ### `intlayer()`의 일부로 (권장)
@@ -115,4 +117,4 @@ pruning이 성공하면, `intlayerPrune`은 `pruneContext.dictionaryKeyToFieldRe
 2. `build.optimize`가 `true`입니다 (또는 `undefined`인 경우, 빌드에 대해 기본값이 `true`입니다).
 3. Intlayer 구성에서 `build.purge`가 `true`입니다.
 
-`editor.enabled`가 `true`일 때는 편집기가 전체 사전 콘텐츠를 필요로 하기 때문에 자동으로 **비활성화**됩니다.
+`editor.enabled`가 `true`일 때도 활성 상태를 유지합니다. 비주얼 에디터는 병합되지 않은 사전에 대해 `dictionaryKey`와 `keyPath`를 통해 모든 편집을 해석하며, 이 플러그인은 해당 사전을 전혀 건드리지 않습니다. 정리된 필드는 어떤 컴포넌트도 읽지 않는 필드이므로, 렌더링되지도 페이지에서 선택되지도 않습니다.

package/docs/ko/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.ko.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "ko", // 중요
+  "content": {
+    "multilingualContent": "내 컴포넌트의 제목",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > 권장: 이 형식은 Intlayer의 시각적 편집기를 사용하거나 코드 내에서 직접 번역을 관리할 때 가장 적합합니다.
 
+> 참고: 두 경우 모두 콘텐츠 선언 파일은 Intlayer에서 인식되도록 `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` 명명 패턴을 따라야 합니다. `.[locale]` 접미사는 선택 사항이며 명명 규칙으로만 사용됩니다.
+
 ### 로케일별 파일에 대한 전역 설정
 
 `intlayer.config.ts` 파일에 다음을 추가하여 로케일별 파일에 대한 전역 설정을 구성할 수 있습니다:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // 중요
-  "content": {
-    "multilingualContent": "내 컴포넌트의 제목",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > 중요: locale 필드가 정의되어 있는지 반드시 확인하세요. 이 필드는 Intlayer에 해당 파일이 어떤 언어를 나타내는지 알려줍니다.
 
-> 참고: 두 경우 모두, 콘텐츠 선언 파일은 Intlayer에서 인식되기 위해 `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` 명명 패턴을 따라야 합니다. `.[locale]` 접미사는 선택 사항이며 명명 규칙으로만 사용됩니다.
-
 ## 형식 혼합
 
 동일한 콘텐츠 키에 대해 두 가지 선언 방식을 결합할 수 있습니다. 예를 들어:

package/docs/ko/readme.md

@@ -225,8 +225,8 @@ Intlayer를 시작하고 프로젝트에 통합하는 방법을 배우려면 종
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>백엔드</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Intlayer를 시작하고 프로젝트에 통합하는 방법을 배우려면 종
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/ko/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 콘텐츠 파일 내 `autoFill` 필드를 사용하여 사전별로 세부 조정을 계속할 수 있습니다. 전체 참조는 `doc/autoFill` 및 `doc/dictionary/content_file`에서 확인하세요.
 
+`autoFill` 필드를 사용하여 사전별로 세부 조정할 수 있습니다. Intlayer는 먼저 사전별 구성을 고려한 후 전역 구성으로 폴백됩니다. [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/autoFill.md) 및 [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)에서 전체 참고자료를 확인하세요.
+
 ---
 
 ## fill 명령어: 더 안전한 기본값
@@ -175,6 +177,20 @@ CI 예제는 [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
 ---
 
+MCP server를 새로운 기능을 지원하도록 업데이트했습니다.
+
+- 자동 채우기
+- 누락된 번역 테스트
+- 실시간 업데이트
+- 로깅
+- 유효성 검사
+- 마이그레이션 노트
+- 문서
+
+> MCP server는 Intlayer를 사용하는 프로젝트의 자동화를 지원합니다. 자동 생성된 코드에서 누락된 번역을 테스트합니다. 설정을 이해하는 데 도움이 되며 IDE에 Intlayer 문서를 포함시킵니다.
+
+---
+
 ## 성능: 10배 빠름
 
 - 로컬 및 원격 사전의 병렬 해석
@@ -296,8 +312,6 @@ bun x intlayer live --with 'vite preview'
 
 [CMS 및 라이브 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)와 [구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)을 참조하여 완전한 안내를 확인하세요.
 
----
-
 ## Turbopack에서 파일을 감시하기 위한 병렬 프로세스
 
 `next dev --turbopack` 명령으로 Next.js 14 이상에서 Turbopack을 개발 서버로 사용할 때, 기본적으로 사전 변경 사항이 자동으로 감지되지 않습니다.

package/docs/ko/releases/v8.md

@@ -763,8 +763,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## Unicode CLDR 복수형 규칙 (v8.8.0)
 
 Unicode CLDR 프로젝트에서 정의한 복수형 규칙을 기반으로 하는 새로운 `plural` 노드 헬퍼가 도입되어 복잡한 언어에 대한 지원이 향상되었습니다.
@@ -1114,7 +1112,7 @@ Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1136,7 +1134,7 @@ Intlayer v8에는 Markdown 및 HTML 컴파일러를 위한 새로운 캐싱 레
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";