@intlayer/docs 9.3.1 → 9.3.3

package/docs/ja/eslint.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2026-08-12
+updatedAt: 2026-08-13
+title: ESLint プラグイン | Intlayer 用 Lint ルール
+description: eslint-plugin-intlayer を使用して、ハードコードされた文字列、Intlayer コンパイラが最適化できない動的呼び出し、未使用の辞書コンテンツを検出します。React、Vue、Svelte、Angular、Astro に対応し、ESLint および oxlint で動作します。
+keywords:
+  - Intlayer
+  - ESLint
+  - oxlint
+  - リント
+  - i18n
+  - 国際化
+  - no-raw-text
+  - ハードコードされた文字列
+  - 未使用の翻訳
+  - デッドコンテンツ
+  - React
+  - Vue
+  - Svelte
+  - Angular
+slugs:
+  - doc
+  - eslint
+history:
+  - version: 9.3.1
+    date: 2026-08-12
+    changes: "初期履歴"
+author: aymericzip
+---
+
+# ESLint x OXLint プラグイン
+
+`eslint-plugin-intlayer` は、TypeScript では捕捉できない i18n の間違いを検出します:
+
+1. 辞書に登録されていない**ハードコードされたテキスト**。
+2. 型チェックを通過して実行できるものの、Intlayer コンパイラが最適化できない**動的な呼び出し**。
+3. **デッドコンテンツ** — プロジェクト内のどこからも読み取られていない辞書やフィールド（オプトイン）。
+
+不明な辞書キー、不明なフィールドパス、欠落しているロケールは既にコンパイルエラーとなるため、プラグインはそれらを重複して指摘しません。
+
+## インストール
+
+```bash packageManager="npm"
+npm install --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev eslint-plugin-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add --dev eslint-plugin-intlayer
+```
+
+ESLint 9 以降（Flat Config）が必要です。ESLint 10 に対応しています。
+
+## 使い方
+
+このプラグインは ESLint と [oxlint](https://oxc.rs) の両方で動作します — 同じルール、同じオプションです。
+
+<Tabs defaultTab="eslint">
+  <Tab label="ESLint" value="eslint">
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [...intlayer.configs.recommended];
+```
+
+または設定を展開し、重大度を自分で指定します:
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+
+export default [
+  ...intlayer.configs.recommended,
+  {
+    rules: {
+      "intlayer/no-raw-text": "warn",
+      "intlayer/static-dictionary-key": "error",
+      "intlayer/no-dynamic-field-access": "error",
+      "intlayer/enforce-adapter-import": "warn",
+      "intlayer/no-unused-content": "warn",
+    },
+  },
+];
+```
+
+  </Tab>
+  <Tab label="oxlint" value="oxlint">
+
+```json fileName=".oxlintrc.json"
+{
+  "jsPlugins": ["eslint-plugin-intlayer"],
+  "rules": {
+    "intlayer/no-raw-text": "warn",
+    "intlayer/static-dictionary-key": "error",
+    "intlayer/no-dynamic-field-access": "error",
+    "intlayer/enforce-adapter-import": "warn"
+  }
+}
+```
+
+注意点が2つあります: oxlint の JS プラグインサポートはまだアルファ版であり、カスタムパーサーをサポートしていません。そのため、`.vue`、`.svelte`、`.astro` および Angular テンプレートはそこではリントされません。JS/TS/JSX ファイルには oxlint を実行し、それ以外には ESLint を維持してください。
+
+`no-unused-content` は上記で意図的に除外されています: ルールコンテキストから作業ディレクトリとリント対象ファイルのパスが必要ですが、アルファ版の JS プラグインブリッジではこれが保証されません。ESLint 配下で実行してください。
+
+  </Tab>
+</Tabs>
+
+### プリセット設定
+
+| 設定            | `no-raw-text`           | `static-dictionary-key` | `no-dynamic-field-access` | `enforce-adapter-import` | `no-unused-content` |
+| --------------- | ----------------------- | ----------------------- | ------------------------- | ------------------------ | ------------------- |
+| `recommended`   | warn                    | error                   | error                     | off                      | off                 |
+| `strict`        | error (+ 非JSXリテラル) | error                   | error                     | error                    | off                 |
+| `contract-only` | off                     | error                   | error                     | off                      | off                 |
+
+`recommended` では意図的に `no-raw-text` を `warn` に設定しています: 既存のコードベースに適用した際にすべての未翻訳文字列が一斉に検出され、初日からビルドが失敗するのを防ぐためです。
+
+`enforce-adapter-import` はデフォルトでオフになっています — 必要な場合は明示的に有効にしてください。
+
+`no-unused-content` は `strict` を含むすべての設定でオフになっています。これは Intlayer 設定を読み込んでディスクからソースファイルを走査する唯一のルールであるため、プリセットによって自動で有効化されるのではなく、意図的な選択として有効化するべきです。
+
+## ルール
+
+### `no-raw-text`
+
+辞書で宣言されていないユーザー向けテキストを報告します。`intlayer extract` と同じ検出ロジックを使用するため、ブランド名、CSS クラス、技術的識別子は無視されます。
+
+```jsx
+// ✗ 報告される
+<h1>Welcome to our documentation</h1>
+<input placeholder="Enter your email address" />
+
+// ✓ 正常
+const { title } = useIntlayer("home");
+<h1>{title}</h1>
+```
+
+コンテンツ宣言ファイル（`*.content.ts` など）はスキップされます。
+
+ファイル全体を一度に修正するには、`npx intlayer extract` を実行して、コンパイラに文字列を辞書へ移動させてください。
+
+**オプション**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-raw-text": [
+    "warn",
+    {
+      // 値がユーザー向けテキストである属性
+      // デフォルト: title, placeholder, alt, aria-label, label
+      attributes: ["title", "placeholder", "alt", "aria-label", "label"],
+
+      // コンテンツがユーザー向けテキストではない要素
+      // デフォルト: code, pre, script, style
+      ignoreElements: ["code", "pre", "script", "style"],
+
+      // 報告対象外とするテキストの正規表現
+      ignorePatterns: ["^Powered by"],
+
+      // マークアップ外の文字列リテラルも報告するかどうか。デフォルト: false
+      includeStringLiterals: false,
+    },
+  ],
+}
+```
+
+### `static-dictionary-key`
+
+辞書キーが文字列リテラルであることを要求します。
+
+コンパイラは呼び出し箇所でキーを直接読み取れる場合にのみ辞書を事前読み込みできます。計算されたキーを使用すると最適化が暗黙的にスキップされ、代わりにすべての辞書がバンドルされます。
+
+```typescript
+// ✗ 報告される
+useIntlayer(dictionaryKey);
+useIntlayer(`home-${suffix}`);
+getTranslations({ namespace: page });
+
+// ✗ 変数はリテラルではありません
+const key = "home";
+useIntlayer(key);
+
+// ✓ 正常
+useIntlayer("home");
+getTranslations({ namespace: "home" });
+```
+
+これは `useIntlayer`、`getIntlayer` およびすべての互換アダプター（`useTranslation`、`useTranslations`、`formatMessage`、`<FormattedMessage id>`、`<Trans i18nKey>` など）に適用されます。
+
+### `no-dynamic-field-access`
+
+辞書から読み取るフィールドが静的に判明していることを要求します。
+
+コンパイラは使用されていることが確認できないフィールドを削除します。動的なアクセスはコンパイラから見えないため、実行時に読み取りが `undefined` を返す可能性があります。
+
+```typescript
+// ✗ 報告される
+const content = useIntlayer("home");
+content[fieldName];
+
+const t = useTranslations("home");
+t(messageKey);
+
+// ✓ 正常
+content.title;
+content["title"];
+content.items[0];
+t("hero.title");
+```
+
+### `enforce-adapter-import`
+
+元のパッケージよりも `@intlayer/*` 互換アダプターを優先します。元のパッケージはバンドラーのエイリアスが設定されている場合にのみ Intlayer に解決されますが、アダプターは常に解決されます。`--fix` で自動修正可能です。
+
+```typescript
+// ✗ 報告される
+import { useTranslation } from "react-i18next";
+import { getTranslations } from "next-intl/server";
+
+// ✓ 正常
+import { useTranslation } from "@intlayer/react-i18next";
+import { getTranslations } from "@intlayer/next-intl/server";
+```
+
+### `no-unused-content`
+
+**デフォルトではオフです。** プロジェクト内のどこからも読み取られていないコンテンツ、および複数箇所で宣言されている辞書キーを報告します。
+
+```typescript fileName="src/home.content.ts"
+export default {
+  key: "home", // ✗ プロジェクト内の呼び出し元がどこからも "home" を要求していない場合に報告
+  content: {
+    title: t({ ja: "タイトル", en: "Title" }),
+
+    // ✗ `hero` を読み取るものが存在しない場合に報告
+    hero: {
+      subtitle: t({ ja: "サブタイトル", en: "Subtitle" }),
+    },
+  },
+};
+```
+
+他のルールとは異なり、このルールは対象のファイル単体から判断することはできません。フィールドが未使用かどうかはプロジェクト全体との相対関係で決まります。リント実行の最初のコンテンツ宣言時に Intlayer 設定を読み込み、その設定で宣言されているソースファイル（`build.traversePattern`、`compiler.transformPattern`）を走査して、`@intlayer/lsp` や VS Code 拡張機能の「未使用」取り消し線を駆動しているのと同じ使用状況アナライザーを実行します。結果は `cacheTtl` ミリ秒間キャッシュされるため、ファイルごとではなく1回の実行につき1回のスキャンが行われます。
+
+**オプション**
+
+```javascript fileName="eslint.config.mjs"
+{
+  "intlayer/no-unused-content": [
+    "warn",
+    {
+      // どこからも参照されていない辞書キーを報告。デフォルト: true
+      reportUnusedDictionaries: true,
+
+      // 何からも読み取られていないコンテンツフィールドを報告。デフォルト: true
+      reportUnusedFields: true,
+
+      // 複数箇所で宣言されている重複キーを報告。デフォルト: true
+      reportDuplicateKeys: true,
+
+      // 報告対象外とするフィールドパスの正規表現
+      ignoreFields: ["^meta"],
+
+      // スキャンを開始するプロジェクトルート。デフォルト: ESLint の作業ディレクトリ
+      baseDir: process.cwd(),
+
+      // プロジェクトスキャンの再利用期間 (ミリ秒)。デフォルト: 30000
+      cacheTtl: 30000,
+    },
+  ],
+}
+```
+
+長時間実行されるエディタサーバーからリントを実行し、編集をすばやく反映させたい場合は `cacheTtl` を低く設定します。モノレポで1回のリント実行が複数の Intlayer プロジェクトにまたがる場合は `baseDir` を設定します。
+
+> **誤検知を防ぐため静かに動作します。** ここでの誤検知は翻訳の削除につながる可能性があるため、解析が追跡できない方法で辞書が使用されている場合は何も報告されません: コンテンツオブジェクト全体をそのまま渡す、そこからバインドされた翻訳関数（`const t = useTranslations("home")`）、直接インポートによって到達した宣言（`useDictionary(myDictionary)`）、他の辞書からの `nest()`、またはスプレッド構文によって網羅的でなくなったフィールドリストなどです。単一ファイルコンポーネント（`.vue`、`.svelte`、`.astro`）は、ここではスクリプトブロックが解析されないため、言及されている辞書のすべてのフィールドを使用しているものとしてカウントされます。
+
+`reportDuplicateKeys` はビルドによって `.intlayer/` 配下に書き出された未マージの辞書を読み取るため、プロジェクトが少なくとも1回ビルドされるまでは動作しません。同じキーを共有する2つの宣言はマージされますが、これは正当なパターンです — 両側で定義されたフィールドが暗黙的にどちらか一方の値のみを保持してしまうため、この報告が存在します。
+
+アナライザーは ESM として提供されている `@intlayer/lsp` から読み込まれます。そのため、このルールには ES モジュールを `require()` できる Node バージョン（Node 20.19+ または 22.12+）が必要です。それより古い環境では、リント実行を失敗させるのではなく何も報告しません。
+
+## フレームワーク
+
+すべてのルールは、Vue、Svelte、Angular テンプレート内を含め、すべての Intlayer 統合で動作します。各ファイルタイプをどのパーサーが読み取るかを ESLint に指定するだけです。
+
+| フレームワーク            | ファイル          | パーサー                          |
+| ------------------------- | ----------------- | --------------------------------- |
+| React, Preact, Solid, Lit | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Next.js                   | `.jsx` `.tsx`     | `typescript-eslint`               |
+| Vue, Nuxt                 | `.vue`            | `vue-eslint-parser`               |
+| Svelte, SvelteKit         | `.svelte`         | `svelte-eslint-parser`            |
+| Angular                   | `.ts`             | `typescript-eslint`               |
+| Angular テンプレート      | `.component.html` | `@angular-eslint/template-parser` |
+| Astro                     | `.astro`          | `astro-eslint-parser`             |
+
+```javascript fileName="eslint.config.mjs"
+import intlayer from "eslint-plugin-intlayer";
+import tseslint from "typescript-eslint";
+import vueParser from "vue-eslint-parser";
+import svelteParser from "svelte-eslint-parser";
+import angularTemplateParser from "@angular-eslint/template-parser";
+
+export default [
+  ...intlayer.configs.recommended,
+
+  {
+    files: ["**/*.{ts,tsx,jsx}"],
+    languageOptions: { parser: tseslint.parser },
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.svelte"],
+    languageOptions: {
+      parser: svelteParser,
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  {
+    files: ["**/*.component.html"],
+    languageOptions: { parser: angularTemplateParser },
+  },
+];
+```
+
+プロジェクトに必要なパーサーのみをインストールしてください。
+
+> **既知の制限事項。** Vue および Angular テンプレートでは、`{{ content[key] }}` のような式は `no-dynamic-field-access` によってチェックされません。スクリプトブロック内に書かれた動的アクセスは通常どおり検出されます。

package/docs/ja/intlayer_with_react_router_v7.md

@@ -141,152 +141,7 @@ This comprehensive guide provides everything you need to integrate Intlayer with
 
 <Steps>
 
-<Step number={11} title="ミドルウェアを追加する（オプション）">
-
-`intlayerProxy` を使用して、アプリケーションにサーバーサイドルーティングを追加することもできます。このプラグインは、URL に基づいて現在のロケールを自動的に検出し、適切なロケールクッキーを設定します。ロケールが指定されていない場合、プラグインはユーザーのブラウザの言語設定に基づいて最も適切なロケールを判断します。ロケールが検出されない場合は、デフォルトのロケールにリダイレクトします。
-
-> `intlayerProxy` を本番環境で使用するには、`vite-intlayer` パッケージを `devDependencies` から `dependencies` に切り替える必要があることに注意してください。
-
-```typescript {3,7} fileName="vite.config.ts"
-import { reactRouter } from "@react-router/dev/vite";
-import { defineConfig } from "vite";
-import { intlayer } from "vite-intlayer";
-
-export default defineConfig({
-  plugins: [
-    reactRouter(),
-
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
-});
-```
-
-</Step>
-
-<Step number={12} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
-
-既存のコードベースがある場合、数千のファイルを変換するのは時間がかかることがあります。
-
-このプロセスを容易にするために、Intlayerは、コンポーネントを変換しコンテンツを抽出するための [コンパイラ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compiler.md) / [エクストラクタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/extract.md) を提案しています。
-
-セットアップするには、`intlayer.config.ts` ファイルに `compiler` セクションを追加します。
-
-```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
-import { type IntlayerConfig } from "intlayer";
-
-const config: IntlayerConfig = {
-  // ... 他の構成
-  compiler: {
-    /**
-     * コンパイラを有効にするかどうかを指定します。
-     */
-    enabled: true,
-
-    /**
-     * 出力ファイルのパスを定義します。
-     */
-    output: ({ fileName, extension }) => `./${fileName}${extension}`,
-
-    /**
-     * 変換後にコンポーネントを保存するかどうかを指定します。これにより、コンパイラを一度だけ実行してアプリを変換し、その後削除することができます。
-     */
-    saveComponents: false,
-
-    /**
-     * 辞書キーの接頭辞
-     */
-    dictionaryKeyPrefix: "",
-  },
-};
-
-export default config;
-```
-
-<Tabs>
- <Tab value='抽出コマンド'>
-
-コンポーネントを変換してコンテンツを抽出するためにエクストラクタを実行します
-
-```bash packageManager="npm"
-npx intlayer extract
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer extract
-```
-
-```bash packageManager="yarn"
-yarn intlayer extract
-```
-
-```bash packageManager="bun"
-bun x intlayer extract
-```
-
- </Tab>
- <Tab value='Babelコンパイラ'>
-
-> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
-
-```bash packageManager="npm"
-npm install @intlayer/babel --save-dev
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/babel --save-dev
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/babel --save-dev
-```
-
-```bash packageManager="bun"
-bun add @intlayer/babel --dev
-```
-
-```js fileName="babel.config.js"
-const {
-  intlayerExtractBabelPlugin,
-  getExtractPluginOptions,
-} = require("@intlayer/babel");
-
-module.exports = {
-  presets: ["next/babel"],
-  plugins: [
-    // コンポーネントから辞書へコンテンツを抽出する
-    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
-  ],
-};
-```
-
-```bash packageManager="npm"
-npm run build # または npm run dev
-```
-
-```bash packageManager="pnpm"
-pnpm run build # または pnpm run dev
-```
-
-```bash packageManager="yarn"
-yarn build # または yarn dev
-```
-
-```bash packageManager="bun"
-bun run build # Or bun run dev
-```
-
- </Tab>
-</Tabs>
-
----
-
-</Step>
-
-</Steps>
+<Step number={5} title="ルートレイアウトの作成">
 
 #### Root Layout
 

package/docs/ja/intlayer_with_vite+react.md

@@ -75,7 +75,7 @@ Intlayer は単なる i18n ソリューションではなく、**自己ホスト
 
 <Tabs defaultTab="video">
   <Tab label="ビデオ" value="video">
-  
+
 <iframe title="ViteとReactに最適なi18nソリューション？Intlayerを発見" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?si=VaKmrYMmXjo3xpk2"/>
 
   </Tab>
@@ -105,6 +105,10 @@ Intlayer は単なる i18n ソリューションではなく、**自己ホスト
 
 GitHubの[Application Template](https://github.com/aymericzip/intlayer-vite-react-template)を参照してください。
 
+<Steps>
+
+<Step number={9} title="HTMLの言語属性と方向属性を切り替える" isOptional={true}>
+
 #### フックの実装
 
 HTML属性を管理するためのカスタムフックを作成します。このフックはロケールの変更を監視し、それに応じて属性を更新します:

package/docs/ko/configuration.md

@@ -478,6 +478,26 @@ const config: IntlayerConfig = {
      */
     purge: true,
 
+    /**
+     * 로케일별 사전 청크를 해당 청크를 사용하는 코드 분할 경계 단위로 그룹화하여, 지연 로딩된 페이지가 한 번의 요청으로 콘텐츠를 가져오도록
+     * 합니다.
+     * 기본값: true
+     *
+     * 주의:
+     * - `importMode: 'dynamic'`을 사용하는 사전에만 적용됩니다.
+     */
+    chunkGrouping: true,
+
+    /**
+     * 청크가 렌더링된 후 가져오는 대신, 해당 청크를 사용하는 사전을 함께 로드합니다. 읽기는 지연되지 않고 동기적으로 렌더링되므로 탐색 시
+     * 로딩 상태가 더 이상 깜박이지 않습니다.
+     * 기본값: true
+     *
+     * 주의:
+     * - 해결된 로케일만 대기하므로 페이지는 표시하는 언어만 다운로드합니다.
+     */
+    dictionariesPreload: true,
+
     /**
      * 생성된 딕셔너리 파일의 출력 형식.
      * 기본값: ['cjs', 'esm']
@@ -1054,15 +1074,17 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 컴파일하는
 
 > 최적화 시 Intlayer는 딕셔너리 호출을 코드 분할(chunking) 최적화로 대체하여 실제 사용되는 딕셔너리만 임포트되도록 합니다.
 
-| 필드              | 설명                                                                       | 타입                             | 기본값                                                                                                                                                                            | 예시                                                                          | 참고                                                                                                                                                                                                                                                                                                    |
-| ----------------- | -------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | 빌드 실행 모드를 제어합니다.                                               | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: 애플리케이션 빌드 중 자동으로 빌드가 트리거됩니다.<br/>• `'manual'`: 명시적인 빌드 명령을 통해서만 실행됩니다.<br/>• 딕셔너리 빌드를 원치 않을 때 유용할 수 있습니다(예: Node.js 환경에서 실행하지 않으려는 경우).                                                                          |
-| `optimize`        | 빌드 최적화 수행 여부를 제어합니다.                                        | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 정의되지 않은 경우 프레임워크 빌드(Vite/Next.js) 중에 트리거됩니다.<br/>• `true`인 경우 개발 모드에서도 최적화를 강제합니다.<br/>• `false`인 경우 비활성화합니다.<br/>• 활성화된 경우 딕셔너리 호출을 chunking 최적화로 대체합니다.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플래그인이 필요합니다. |
-| `minify`          | 번들 크기를 줄이기 위해 딕셔너리를 압축(Minify)합니다.                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 압축할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.<br/>• `editor.enabled`가 true인 경우 이 옵션은 무시됩니다.                                                                                                        |
-| `purge`           | 딕셔너리에서 사용하지 않는 키를 제거합니다.                                | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 제거할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.                                                                                                                                                                   |
-| `checkTypes`      | 빌드 시 TypeScript 타입 체크를 수행하고 오류를 기록할지 여부를 지정합니다. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | 빌드 속도가 느려질 수 있습니다.                                                                                                                                                                                                                                                                         |
-| `outputFormat`    | 딕셔너리 출력 형식을 제어합니다.                                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                         |
-| `traversePattern` | 최적화 중에 스캔할 파일 패턴.                                              | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 최적화를 관련 파일로 제한하여 빌드 성능을 향상시킵니다.<br/>• `optimize`가 비활성화된 경우 무시됩니다.<br/>• glob 패턴을 사용합니다.                                                                                                                                                                  |
+| 필드                  | 설명                                                                                          | 타입                             | 기본값                                                                                                                                                                            | 예시                                                                          | 참고                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| --------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | 빌드 실행 모드를 제어합니다.                                                                  | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: 애플리케이션 빌드 중 자동으로 빌드가 트리거됩니다.<br/>• `'manual'`: 명시적인 빌드 명령을 통해서만 실행됩니다.<br/>• 딕셔너리 빌드를 원치 않을 때 유용할 수 있습니다(예: Node.js 환경에서 실행하지 않으려는 경우).                                                                                                                                                                                                                                          |
+| `optimize`            | 빌드 최적화 수행 여부를 제어합니다.                                                           | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • 정의되지 않은 경우 프레임워크 빌드(Vite/Next.js) 중에 트리거됩니다.<br/>• `true`인 경우 개발 모드에서도 최적화를 강제합니다.<br/>• `false`인 경우 비활성화합니다.<br/>• 활성화된 경우 딕셔너리 호출을 chunking 최적화로 대체합니다.<br/>• `@intlayer/babel` 및 `@intlayer/swc` 플래그인이 필요합니다.                                                                                                                                                                 |
+| `minify`              | 번들 크기를 줄이기 위해 딕셔너리를 압축(Minify)합니다.                                        | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 압축할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.<br/>• `editor.enabled`가 true인 경우 이 옵션은 무시됩니다.                                                                                                                                                                                                                                                                        |
+| `purge`               | 딕셔너리에서 사용하지 않는 키를 제거합니다.                                                   | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • 최종 번들을 제거할지 여부를 지정합니다.<br/>• 기본값: 프로덕션에서 `true`.<br/>• `optimize`가 비활성화된 경우 이 옵션은 무시됩니다.                                                                                                                                                                                                                                                                                                                                   |
+| `checkTypes`          | 빌드 시 TypeScript 타입 체크를 수행하고 오류를 기록할지 여부를 지정합니다.                    | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | 빌드 속도가 느려질 수 있습니다.                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `chunkGrouping`       | 로케일별 사전 청크를 해당 청크를 사용하는 코드 분할 경계 단위로 그룹화할지 여부를 지정합니다. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • 그룹화하지 않으면 여러 컴포넌트로 구성된 페이지가 사전마다 하나씩 요청을 보냅니다.<br/>• 여러 경계에서 도달하는 사전은 공유 청크로 이동하므로 어떤 페이지도 다른 페이지의 콘텐츠를 포함하지 않습니다.<br/>• `importMode: 'dynamic'`을 사용하는 사전에만 적용됩니다.<br/>• 클라이언트 빌드에만, 그리고 번들링 시에만 적용됩니다(개발 모드 제외).                                                                                                                       |
+| `dictionariesPreload` | 사전을 해당 청크가 렌더링된 후 가져오는 대신, 그 청크와 함께 로드할지 여부를 지정합니다.      | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • 생성된 진입점이 최상위에서 브라우징 로케일을 대기하므로, 지연 로딩된 라우트는 콘텐츠가 준비될 때까지 로드된 것으로 간주되지 않습니다.<br/>• 읽기는 지연되지 않고 동기적으로 렌더링되므로 탐색 시 로딩 상태가 더 이상 깜박이지 않습니다.<br/>• 해결된 로케일만 대기하므로 페이지는 표시하는 언어만 다운로드합니다.<br/>• 클라이언트 빌드에서 `importMode: 'dynamic'`을 사용하는 사전에만 적용됩니다.<br/>• 최상위 await를 지원하는 번들러(Vite, esbuild)가 필요합니다. |
+| `outputFormat`        | 딕셔너리 출력 형식을 제어합니다.                                                              | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `traversePattern`     | 최적화 중에 스캔할 파일 패턴.                                                                 | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 최적화를 관련 파일로 제한하여 빌드 성능을 향상시킵니다.<br/>• `optimize`가 비활성화된 경우 무시됩니다.<br/>• glob 패턴을 사용합니다.                                                                                                                                                                                                                                                                                                                                  |
 
 ---
 

package/docs/ko/dictionary/content_file.md

@@ -533,28 +533,6 @@ export default aboutPageMetaContent;
 
 > 자세한 정보는 [변형](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)

package/docs/ko/dictionary/function_fetching.md

@@ -87,6 +87,29 @@ JSON 파일에서 콘텐츠를 가져올 수 없습니다. 대신 .ts 또는 .js
 
 이 경우, `fakeFetch` 함수는 서버 응답 시간을 시뮬레이션하기 위해 지연을 모방합니다. Intlayer는 비동기 함수를 실행하고 그 결과를 `text` 키의 콘텐츠로 사용합니다.
 
+## 원격 콘텐츠 가져오기
+
+콘텐츠 필드에 프로미스를 직접 할당할 수도 있습니다. Intlayer는 사전을 빌드할 때 이를 기다린 후 해결된 값을 삽입합니다:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+JSON 파일에서 콘텐츠를 가져올 수 없습니다. 대신 .ts 또는 .js 파일을 사용하세요.
+```
+
+> 요청은 빌드 시점에 실행되므로 가져온 데이터는 사전에 포함된 스냅샷입니다. 갱신하려면 사전을 다시 빌드하세요.
+
 ## React 컴포넌트에서 함수 기반 콘텐츠 사용하기
 
 React 컴포넌트에서 함수 기반 콘텐츠를 사용하려면, `react-intlayer`에서 `useIntlayer`를 가져와서 콘텐츠 ID로 호출하여 콘텐츠를 가져와야 합니다. 다음은 예시입니다: