@intlayer/docs 8.12.4 → 9.0.0-canary.2

package/docs/ko/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: 구성 (Configuration)
 description: 애플리케이션에 Intlayer를 구성하는 방법을 알아보세요. 필요에 따라 Intlayer를 맞춤설정하는 데 사용할 수 있는 다양한 설정과 옵션을 이해하세요.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "사전 구성에 `format` 옵션 추가"
   - version: 8.9.4
     date: 2026-05-12
     changes: "LM Studio 공급자 지원 추가"
@@ -98,6 +101,7 @@ history:
   - version: 5.5.11
     date: 2025-06-29
     changes: "`docs` 명령 추가"
+author: aymericzip
 ---
 
 # Intlayer 구성 문서
@@ -134,6 +138,7 @@ Intlayer는 JSON, JS, MJS 및 TS 구성 파일 형식을 허용합니다:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -581,10 +586,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * 사전 구성.
+   */
+  dictionary: {
+    /**
+     * 사전 가져오기 방법을 제어합니다。
+     * - "static": 빌드 시 정적으로 가져옵니다。
+     * - "dynamic": Suspense를 사용하여 동적으로 가져옵니다。
+     * - "fetch": 라이브 동기화 API를 통해 동적으로 가져옵니다.
+     */
+    importMode: "static",
+
+    /**
+     * 프로젝트의 모든 사전에 대한 기본 메시지 형식입니다。
+     * - 'intlayer': 기본 intlayer 형식(기본값)。
+     * - 'icu': ICU 메시지 형식。
+     * - 'i18next': i18next 형식。
+     * - 'vue-i18n': Vue I18n 형식。
+     * - 'po': GNU Gettext PO 형식。
+     */
+    format: "icu",
+  },
+
   /**
    * 플러그인 구성.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -853,20 +886,21 @@ export default config;
 
 자동 채우기 동작 및 콘텐츠 생성을 포함하여 딕셔너리 작업을 제어하기 위한 옵션입니다.
 
-| 필드                        | 설명                                                                                                                                                   | 타입                                                                                                            | 기본값      | 예시                                                                                        | 참고                                                                                                                                                                                                                                                                                                                                                                           |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `fill`                      | 자동 채우기(AI 번역) 출력 파일 생성을 제어합니다.                                                                                                      | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`      | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: 기본 경로(소스와 동일한 파일).<br/>• `false`: 비활성화.<br/>• 문자열/함수 패턴은 로케일별 생성을 허용합니다.<br/>• 로케일별 객체: 각 로케일이 자체 패턴을 가지며 `false`는 해당 로케일을 제외합니다.<br/>• `{{locale}}`을 포함하면 로케일별 생성이 가능합니다.<br/>• 딕셔너리 수준의 `fill` 설정은 항상 이 글로벌 설정보다 우선합니다.                               |
-| `description`               | 에디터 및 CMS가 딕셔너리의 목적을 이해하는 데 도움이 됩니다. AI 번역 생성을 위한 컨텍스트로도 사용됩니다.                                              | `string`                                                                                                        | `undefined` | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                |
-| `locale`                    | 딕셔너리를 특정 로케일 전용 형식으로 전환합니다. 선언된 모든 필드가 번역 노드가 됩니다. 누락된 경우 딕셔너리는 다국어 번역을 포함할 것으로 간주됩니다. | `LocalesValues`                                                                                                 | `undefined` | `'en'`                                                                                      | 여러 번역이 포함된 형식이 아닌 특정 언어 전용 딕셔너리인 경우 사용하세요.                                                                                                                                                                                                                                                                                                      |
-| `contentAutoTransformation` | 콘텐츠 문자열을 타입화된 노드(Markdown, HTML 또는 삽입(insertion))로 자동 변환할지 여부.                                                               | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`     | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                |
-| `location`                  | 딕셔너리 파일이 저장되는 위치와 CMS와의 동기화 방식을 지정합니다.                                                                                      | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`   | `'hybrid'`                                                                                  | • `'local'`: 로컬 관리만 해당.<br/>• `'remote'`: 원격 관리(CMS)만 해당.<br/>• `'hybrid'`: 로컬 및 원격 관리 모두 해당.<br/>• `'plugin'` 또는 사용자 정의 문자열: 플러그인이나 사용자 정의 소스를 통해 관리.                                                                                                                                                                    |
-| `importMode`                | 딕셔너리 임포트 방법을 제어합니다.                                                                                                                     | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`  | `'dynamic'`                                                                                 | • `'static'`: 정적 임포트.<br/>• `'dynamic'`: Suspense를 통한 동적 임포트.<br/>• `'fetch'`: Live Sync API를 통한 페칭; 실패 시 `'dynamic'`으로 폴백.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플러그인이 필요합니다.<br/>• 키가 정적으로 선언되어야 합니다.<br/>• `optimize`가 비활성화된 경우 무시됩니다.<br/>• `getIntlayer`, `getDictionary` 등에는 영향을 주지 않습니다. |
-| `priority`                  | 딕셔너리의 우선순위. 딕셔너리 간의 충돌 해결 시 더 높은 값이 낮은 값보다 우선합니다.                                                                   | `number`                                                                                                        | `undefined` | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                |
-| `live`                      | DEPRECATED - `importMode: 'fetch'`를 사용하세요. 딕셔너리 콘텐츠를 Live Sync API를 통해 동적으로 가져올지 여부를 나타냈습니다.                         | `boolean`                                                                                                       | `undefined` |                                                                                             | v8.0.0에서 `importMode: 'fetch'`로 이름이 변경되었습니다.                                                                                                                                                                                                                                                                                                                      |
-| `schema`                    | JSON 스키마 검증을 위해 Intlayer에서 자동으로 생성합니다.                                                                                              | `'https://intlayer.org/schema.json'`                                                                            | 자동 생성됨 |                                                                                             | 수동으로 편집하지 마세요.                                                                                                                                                                                                                                                                                                                                                      |
-| `title`                     | 에디터 및 CMS에서 딕셔너리를 식별하는 데 도움이 됩니다.                                                                                                | `string`                                                                                                        | `undefined` | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                |
-| `tags`                      | 딕셔너리를 분류하고 에디터 및 AI에게 컨텍스트나 지침을 제공합니다.                                                                                     | `string[]`                                                                                                      | `undefined` | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                |
-| `version`                   | 원격 딕셔너리의 버전. 현재 사용 중인 버전을 추적하는 데 도움이 됩니다.                                                                                 | `string`                                                                                                        | `undefined` | `'1.0.0'`                                                                                   | • CMS에서 관리됩니다.<br/>• 로컬에서 편집하지 마세요.                                                                                                                                                                                                                                                                                                                          |
+| 필드                        | 설명                                                                                                                                                   | 타입                                                                                                            | 기본값       | 예시                                                                                        | 참고                                                                                                                                                                                                                                                                                                                                                                           |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `fill`                      | 자동 채우기(AI 번역) 출력 파일 생성을 제어합니다.                                                                                                      | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: 기본 경로(소스와 동일한 파일).<br/>• `false`: 비활성화.<br/>• 문자열/함수 패턴은 로케일별 생성을 허용합니다.<br/>• 로케일별 객체: 각 로케일이 자체 패턴을 가지며 `false`는 해당 로케일을 제외합니다.<br/>• `{{locale}}`을 포함하면 로케일별 생성이 가능합니다.<br/>• 딕셔너리 수준의 `fill` 설정은 항상 이 글로벌 설정보다 우선합니다.                               |
+| `description`               | 에디터 및 CMS가 딕셔너리의 목적을 이해하는 데 도움이 됩니다. AI 번역 생성을 위한 컨텍스트로도 사용됩니다.                                              | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                |
+| `locale`                    | 딕셔너리를 특정 로케일 전용 형식으로 전환합니다. 선언된 모든 필드가 번역 노드가 됩니다. 누락된 경우 딕셔너리는 다국어 번역을 포함할 것으로 간주됩니다. | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | 여러 번역이 포함된 형식이 아닌 특정 언어 전용 딕셔너리인 경우 사용하세요.                                                                                                                                                                                                                                                                                                      |
+| `contentAutoTransformation` | 콘텐츠 문자열을 타입화된 노드(Markdown, HTML 또는 삽입(insertion))로 자동 변환할지 여부.                                                               | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Insertion : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                |
+| `location`                  | 딕셔너리 파일이 저장되는 위치와 CMS와의 동기화 방식을 지정합니다.                                                                                      | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: 로컬 관리만 해당.<br/>• `'remote'`: 원격 관리(CMS)만 해당.<br/>• `'hybrid'`: 로컬 및 원격 관리 모두 해당.<br/>• `'plugin'` 또는 사용자 정의 문자열: 플러그인이나 사용자 정의 소스를 통해 관리.                                                                                                                                                                    |
+| `importMode`                | 딕셔너리 임포트 방법을 제어합니다.                                                                                                                     | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: 정적 임포트.<br/>• `'dynamic'`: Suspense를 통한 동적 임포트.<br/>• `'fetch'`: Live Sync API를 통한 페칭; 실패 시 `'dynamic'`으로 폴백.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플러그인이 필요합니다.<br/>• 키가 정적으로 선언되어야 합니다.<br/>• `optimize`가 비활성화된 경우 무시됩니다.<br/>• `getIntlayer`, `getDictionary` 등에는 영향을 주지 않습니다. |
+| `format`                    | 프로젝트의 모든 사전에 대한 기본 메시지 형식입니다.                                                                                                    | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: 기본 intlayer 형식.<br/>• `'icu'`: ICU 메시지 형식.<br/>• `'i18next'`: i18next 형식.<br/>• `'vue-i18n'`: Vue I18n 형식.<br/>• `'po'`: GNU Gettext PO 형식.                                                                                                                                                                                                     |
+| `priority`                  | 딕셔너리의 우선순위. 딕셔너리 간의 충돌 해결 시 더 높은 값이 낮은 값보다 우선합니다.                                                                   | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                |
+| `live`                      | DEPRECATED - `importMode: 'fetch'`를 사용하세요. 딕셔너리 콘텐츠를 Live Sync API를 통해 동적으로 가져올지 여부를 나타냈습니다.                         | `boolean`                                                                                                       | `undefined`  |                                                                                             | v8.0.0에서 `importMode: 'fetch'`로 이름이 변경되었습니다.                                                                                                                                                                                                                                                                                                                      |
+| `schema`                    | JSON 스키마 검증을 위해 Intlayer에서 자동으로 생성합니다.                                                                                              | `'https://intlayer.org/schema.json'`                                                                            | 자동 생성됨  |                                                                                             | 수동으로 편집하지 마세요.                                                                                                                                                                                                                                                                                                                                                      |
+| `title`                     | 에디터 및 CMS에서 딕셔너리를 식별하는 데 도움이 됩니다.                                                                                                | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                |
+| `tags`                      | 딕셔너리를 분류하고 에디터 및 AI에게 컨텍스트나 지침을 제공합니다.                                                                                     | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                |
+| `version`                   | 원격 딕셔너리의 버전. 현재 사용 중인 버전을 추적하는 데 도움이 됩니다.                                                                                 | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • CMS에서 관리됩니다.<br/>• 로컬에서 편집하지 마세요.                                                                                                                                                                                                                                                                                                                          |
 
 **`fill` 예시**:
 

package/docs/ko/custom_domains.md

@@ -17,6 +17,7 @@ history:
   - version: 8.5.0
     date: 2026-04-02
     changes: "routing.domains 구성을 통해 도메인 기반 로케일 라우팅을 추가했습니다."
+author: aymericzip
 ---
 
 # 사용자 정의 도메인

package/docs/ko/custom_url_rewrites.md

@@ -16,6 +16,7 @@ history:
   - version: 8.0.0
     date: 2026-01-25
     changes: "프레임워크별 포매터와 useRewriteURL 훅을 사용하여 중앙 집중식 URL 재작성을 구현합니다."
+author: aymericzip
 ---
 
 # 맞춤형 URL 재작성 구현

package/docs/ko/dictionary/condition.md

@@ -16,6 +16,7 @@ slugs:
   - concept
   - content
   - condition
+author: aymericzip
 ---
 
 # 조건부 콘텐츠 / Intlayer에서의 조건
@@ -66,7 +67,10 @@ export default myConditionalContent;
 
 ## React Intlayer와 조건부 콘텐츠 사용
 
-React 컴포넌트 내에서 조건부 콘텐츠를 사용하려면 `react-intlayer` 패키지에서 `useIntlayer` 훅을 가져와 사용하십시오. 이 훅은 지정된 키에 대한 콘텐츠를 가져오며, 조건을 전달하여 적절한 출력을 선택할 수 있습니다.
+<Tabs group="framework">
+  <Tab label="React" value="react">
+
+To utilize conditional content within a React component, import and use the `useIntlayer` hook from the `react-intlayer` package. This hook fetches the content for the specified key and allows you to pass in a condition to select the appropriate output.
 
 ```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
@@ -79,25 +83,25 @@ const ConditionalComponent: FC = () => {
     <div>
       <p>
         {
-          /* 출력: 조건이 참일 때의 콘텐츠 */
+          /* Output: my content when it's true */
           myCondition(true)
         }
       </p>
       <p>
         {
-          /* 출력: 조건이 거짓일 때의 콘텐츠 */
+          /* Output: my content when it's false */
           myCondition(false)
         }
       </p>
       <p>
         {
-          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          /* Output: my content when the condition fails */
           myCondition("")
         }
       </p>
       <p>
         {
-          /* 출력: 조건이 실패했을 때의 콘텐츠 */
+          /* Output: my content when the condition fails */
           myCondition(undefined)
         }
       </p>
@@ -108,6 +112,165 @@ const ConditionalComponent: FC = () => {
 export default ConditionalComponent;
 ```
 
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
+
+To utilize conditional content in Next.js Client Components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { useIntlayer } from "next-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Vue" value="vue">
+
+To utilize conditional content in Vue components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```vue fileName="**/*.vue"
+<script setup lang="ts">
+import { useIntlayer } from "vue-intlayer";
+
+const { myCondition } = useIntlayer("my_key");
+</script>
+
+<template>
+  <div>
+    <p>{{ myCondition(true) }}</p>
+    <p>{{ myCondition(false) }}</p>
+  </div>
+</template>
+```
+
+  </Tab>
+  <Tab label="Svelte" value="svelte">
+
+To utilize conditional content in Svelte components, retrieve it via the `useIntlayer` hook. The store is accessed with `$`. Here's an example:
+
+```svelte fileName="**/*.svelte"
+<script lang="ts">
+import { useIntlayer } from "svelte-intlayer";
+
+const content = useIntlayer("my_key");
+</script>
+
+<div>
+  <p>{$content.myCondition(true)}</p>
+  <p>{$content.myCondition(false)}</p>
+</div>
+```
+
+  </Tab>
+  <Tab label="Preact" value="preact">
+
+To utilize conditional content in Preact components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "preact";
+import { useIntlayer } from "preact-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Solid" value="solid">
+
+To utilize conditional content in SolidJS components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```tsx fileName="**/*.tsx" codeFormat={["typescript", "esm"]}
+import type { Component } from "solid-js";
+import { useIntlayer } from "solid-intlayer";
+
+const ConditionalComponent: Component = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>{myCondition(true)}</p>
+      <p>{myCondition(false)}</p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+  </Tab>
+  <Tab label="Angular" value="angular">
+
+To utilize conditional content in Angular components, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```typescript fileName="app.component.ts" codeFormat="typescript"
+import { Component } from "@angular/core";
+import { useIntlayer } from "angular-intlayer";
+
+@Component({
+  selector: "app-conditional",
+  template: `
+    <div>
+      <p>{{ content().myCondition(true) }}</p>
+      <p>{{ content().myCondition(false) }}</p>
+    </div>
+  `,
+})
+export class ConditionalComponent {
+  content = useIntlayer("my_key");
+}
+```
+
+  </Tab>
+  <Tab label="Vanilla JS" value="vanilla">
+
+To utilize conditional content with `vanilla-intlayer`, retrieve it via the `useIntlayer` hook. Here's an example:
+
+```typescript fileName="**/*.ts" codeFormat={["typescript", "esm"]}
+import { installIntlayer, useIntlayer } from "vanilla-intlayer";
+
+installIntlayer();
+
+const content = useIntlayer("my_key").onChange((newContent) => {
+  document.getElementById("true-content")!.textContent =
+    newContent.myCondition(true);
+  document.getElementById("false-content")!.textContent =
+    newContent.myCondition(false);
+});
+
+// Initial render
+document.getElementById("true-content")!.textContent =
+  content.myCondition(true);
+document.getElementById("false-content")!.textContent =
+  content.myCondition(false);
+```
+
+  </Tab>
+</Tabs>
+
 ## 추가 리소스
 
 구성 및 사용에 대한 자세한 정보는 다음 리소스를 참조하십시오:

package/docs/ko/dictionary/content_file.md

@@ -36,6 +36,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "이력 초기화"
+author: aymericzip
 ---
 
 # 콘텐츠 파일
@@ -510,6 +511,66 @@ export default aboutPageMetaContent;
 // 이것은 기본 사전을 덮어씁니다
 ```
 
+#### `item` (number)
+
+컬렉션(Collections)과 연동하여 사용되는 이 필드는 컬렉션 내 항목의 위치를 정의합니다. 실행 시 인덱스로 선택 가능한 로컬라이즈된 항목의 정렬된 컬렉션을 빌드할 수 있습니다.
+
+**예시:**
+
+```typescript
+{
+  key: "faq",
+  item: 1,
+  content: {
+    question: "What is Intlayer?",
+    answer: "An i18n toolkit."
+  }
+}
+```
+
+> 자세한 정보는 [컬렉션](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/collections.md)을 참조하세요.
+
+#### `variant` (string)
+
+변형(Variants)과 연동하여 사용되는 이 필드는 이름이 지정된 콘텐츠 대안을 정의합니다. 코드 변경 없이 실행 시 동일한 사전 키의 다양한 변형 간에 전환할 수 있습니다(예: A/B 테스트, 시즌별 배너). 제공되지 않는 경우 기본 변형으로 간주됩니다.
+
+**예시:**
+
+```typescript
+{
+  key: "hero-banner",
+  variant: "black_friday",
+  content: {
+    headline: "50 % off — today only",
+    cta: "Shop now"
+  }
+}
+```
+
+> 자세한 정보는 [변형](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/variants.md)을 참조하세요.
+
+#### `meta` (`Record<string, string | number | boolean>`)
+
+동적 레코드(Dynamic Records)와 연동하여 사용되는 이 필드는 CMS에서 관리되는 레코드나 불투명한 ID로 실행 시 가져오는 임의의 데이터를 선언할 수 있도록 합니다. 사전의 식별성은 이 `meta` 필드에 선언된 임의의 키-값 쌍 집합에 의해 정의됩니다.
+
+**예시:**
+
+```typescript
+{
+  key: "product-copy",
+  meta: {
+    id: "prod_abc",
+    userId: "user_123"
+  },
+  content: {
+    name: "Widget Pro",
+    description: "The best widget."
+  }
+}
+```
+
+> 자세한 정보는 [동적 레코드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/dynamic_content.md)를 참조하세요.
+
 ### CMS 속성
 
 ##### `version` (string)