@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

package/docs/ja/intlayer_with_vite+react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + React i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Reactアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:

package/docs/ja/intlayer_with_vite+react_compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + React i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Reactアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:

package/docs/ja/intlayer_with_vite+solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + Solid i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Solidアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -635,47 +635,6 @@ bun run build # Or bun run dev
 
 </Steps>
 
-### TypeScriptを設定する
-
-TypeScript設定に自動生成された型が含まれていることを確認してください。
-
-```json5 fileName="tsconfig.json"
-{
-  "compilerOptions": {
-    // ...
-  },
-  "include": ["src", ".intlayer/**/*.ts"],
-}
-```
-
-### Git設定
-
-Intlayerによって生成されたファイルは、Gitリポジトリにコミットしないように無視することを推奨します。
-
-これを行うには、`.gitignore`ファイルに以下の指示を追加してください。
-
-```bash
-#  Intlayerによって生成されたファイルを無視する
-.intlayer
-```
-
-### VS Code拡張機能
-
-Intlayerでの開発体験を向上させるために、公式の**Intlayer VS Code拡張機能**をインストールできます。
-
-[VS Codeマーケットプレイスからインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-この拡張機能は以下を提供します：
-
-- 翻訳キーの**オートコンプリート**。
-- 欠落している翻訳の**リアルタイムエラー検出**。
-- **翻訳されたコンテンツのインラインプレビュー**。
-- **翻訳を簡単に作成・更新するためのクイックアクション**。
-
-拡張機能の使い方の詳細については、[Intlayer VS Code 拡張機能のドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
-
----
-
 ### （任意）サイトマップと robots.txt（ビルド時生成）
 
 Intlayer は `generateSitemap` と `getMultilingualUrls` により、クローラ向けに整形した多言語の `sitemap.xml` と `robots.txt` を `public/` に自動で書き出せます。通常は Vite より**前**に小さな Node スクリプトを走らせます（例: npm の `predev` / `prebuild`）。
@@ -750,6 +709,38 @@ console.log("SEO files generated successfully.");
 
 pnpm や yarn を使う場合はコマンドを読み替えてください。CI から呼び出しても構いません。
 
+### TypeScript を設定する
+
+TypeScript 設定に自動生成される型が含まれていることを確認してください。
+
+```json5 fileName="tsconfig.json"
+{
+  "compilerOptions": {
+    // ...
+  },
+  "include": ["src", ".intlayer/**/*.ts"],
+}
+```
+
+### Git Configuration
+
+Intlayer によって生成されたファイルを無視することが推奨されます。これにより、Git リポジトリにコミットすることを避けることができます。
+
+これを行うには、`.gitignore` ファイルに次の指示を追加できます。
+
+```bash
+# Intlayer によって生成されたファイルを無視
+.intlayer
+```
+
+### VS Code Extension
+
+Intlayer での開発体験を向上させるために、公式の **Intlayer VS Code Extension** をインストールできます。
+
+[VS Code Marketplace からインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+---
+
 ### さらに進むために
 
 さらに進みたい場合は、[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を実装するか、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用してコンテンツを外部化することができます。

package/docs/ja/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + Svelte i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Svelteアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -599,34 +599,6 @@ bun run build # Or bun run dev
 
 </Steps>
 
-### Git 設定
-
-Intlayer によって生成されたファイルは無視することを推奨します。これにより、Git リポジトリへの不要なコミットを避けることができます。
-
-これを行うには、`.gitignore` ファイルに以下の指示を追加してください：
-
-```bash
-#  Intlayer によって生成されたファイルを無視する
-.intlayer
-```
-
-### VS Code 拡張機能
-
-Intlayerでの開発体験を向上させるために、公式の**Intlayer VS Code拡張機能**をインストールできます。
-
-[VS Codeマーケットプレイスからインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-この拡張機能は以下を提供します：
-
-- 翻訳キーの**オートコンプリート**。
-- 欠落している翻訳の**リアルタイムエラー検出**。
-- 翻訳されたコンテンツの**インラインプレビュー**。
-- 翻訳を簡単に作成・更新できる**クイックアクション**。
-
-拡張機能の使い方の詳細については、[Intlayer VS Code拡張機能のドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
-
----
-
 ### （任意）サイトマップと robots.txt（ビルド時生成）
 
 Intlayer は `generateSitemap` と `getMultilingualUrls` により、クローラ向けに整形した多言語の `sitemap.xml` と `robots.txt` を `public/` に自動で書き出せます。通常は Vite より**前**に小さな Node スクリプトを走らせます（例: npm の `predev` / `prebuild`）。
@@ -704,3 +676,31 @@ pnpm や yarn を使う場合はコマンドを読み替えてください。CI
 ### さらに進む
 
 さらに進めるために、[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を実装するか、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用してコンテンツを外部化することができます。
+
+### Git 設定
+
+Intlayer によって生成されたファイルは無視することを推奨します。これにより、Git リポジトリへの不要なコミットを避けることができます。
+
+これを行うには、`.gitignore` ファイルに以下の指示を追加してください：
+
+```bash
+#  Intlayer によって生成されたファイルを無視する
+.intlayer
+```
+
+### VS Code 拡張機能
+
+Intlayerでの開発体験を向上させるために、公式の**Intlayer VS Code拡張機能**をインストールできます。
+
+[VS Codeマーケットプレイスからインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+この拡張機能は以下を提供します：
+
+- 翻訳キーの**オートコンプリート**。
+- 欠落している翻訳の**リアルタイムエラー検出**。
+- 翻訳されたコンテンツの**インラインプレビュー**。
+- 翻訳を簡単に作成・更新できる**クイックアクション**。
+
+拡張機能の使い方の詳細については、[Intlayer VS Code拡張機能のドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
+
+---

package/docs/ja/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + Vanilla JS i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Vanilla JSアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:

package/docs/ja/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Vite + Vue i18n - あなたのアプリを翻訳する完全ガイド"
 description: "i18nextはもう不要。2026年に多言語（i18n）Vite + Vueアプリを構築するためのガイド。AIエージェントで翻訳し、バンドルサイズ、SEO、パフォーマンスを最適化します。"
 keywords:
@@ -34,6 +34,10 @@ author: aymericzip
 
 GitHub の [アプリケーションテンプレート](https://github.com/aymericzip/intlayer-vite-vue-template) を参照してください。
 
+## 目次
+
+<TOC/>
+
 ## 代替手段ではなく Interlayer を使用する理由
 
 「vue-i18n」や「i18next」などの主要なソリューションと比較して、Intlayer は次のような統合された最適化を備えたソリューションです。
@@ -889,69 +893,19 @@ import RouterLink from "@components/RouterLink.vue";
 
 </Step>
 
-<Step number={11} title="Markdownのレンダリング">
-
-Intlayerは、Vueアプリケーション内でMarkdownコンテンツを直接レンダリングすることをサポートしています。デフォルトでは、Markdownはプレーンテキストとして扱われます。MarkdownをリッチなHTMLに変換するには、Markdownパーサーである[markdown-it](https://github.com/markdown-it/markdown-it)を統合できます。
-
-これは、翻訳にリスト、リンク、強調などのフォーマットされたコンテンツが含まれる場合に特に便利です。
-
-デフォルトではIntlayerはMarkdownを文字列としてレンダリングしますが、`installIntlayerMarkdown`関数を使ってMarkdownをHTMLにレンダリングする方法も提供しています。
-
-> `intlayer`パッケージを使ってMarkdownコンテンツを宣言する方法については、[markdownドキュメント](https://github.com/aymericzip/intlayer/tree/main/docs/ja/dictionary/markdown.md)を参照してください。
-
-```ts fileName="main.ts"
-import MarkdownIt from "markdown-it";
-import { createApp, h } from "vue";
-import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";
-
-const app = createApp(App);
-
-app.use(intlayer);
-
-const md = new MarkdownIt({
-  html: true, // HTMLタグを許可
-  linkify: true, // URLを自動リンク化
-  typographer: true, // スマートクォートやダッシュなどを有効化
-});
-
-// IntlayerにmarkdownをHTMLに変換する際にmd.render()を使うよう指示
-installIntlayerMarkdown(app, (markdown) => {
-  const html = md.render(markdown);
-  return h("div", { innerHTML: html });
-});
-```
+<Step number={11} title="コンポーネントのコンテンツを抽出する" isOptional={true}>
 
-登録が完了すると、コンポーネントベースの構文を使ってMarkdownコンテンツを直接表示できます：
+既存のコードベースがある場合、数千ものファイルを変換するのは時間がかかる場合があります。
 
-```vue
-<template>
-  <div>
-    <myMarkdownContent />
-  </div>
-</template>
+このプロセスを容易にするために、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) を提供しています。
 
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { myMarkdownContent } = useIntlayer("my-component");
-</script>
-```
-
-</Step>
-
-<Step number={1} 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` セクションを追加します。
+セットアップするには、`intlayer.config.ts` ファイルに `compiler` セクションを追加できます。
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
-  // ... 他の構成
+  // ... その他の設定
   compiler: {
     /**
      * コンパイラを有効にするかどうかを指定します。
@@ -959,17 +913,21 @@ const config: IntlayerConfig = {
     enabled: true,
 
     /**
-     * 出力ファイルのパスを定義します。
+     * 出力ファイルのパスを定義します
      */
     output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * 変換後にコンポーネントを保存するかどうかを指定します。これにより、コンパイラを一度だけ実行してアプリを変換し、その後削除することができます。
+     * 変換後にコンポーネントを保存するかどうかを指定します。
+     *
+     * - `true` の場合、コンパイラはディスク上のコンポーネントファイルを書き換えます。これにより変換は永続的になり、次回のプロセスでは変換をスキップします。その方法で、コンパイラがアプリを変換した後に、コンパイラを削除することができます。
+     *
+     * - `false` の場合、コンパイラはビルド出力のコードにのみ `useIntlayer()` 関数の呼び出しを注入し、元のコードベースはそのまま維持します。変換はメモリ内でのみ行われます。
      */
     saveComponents: false,
 
     /**
-     * 辞書キーの接頭辞
+     * 辞書キーのプレフィックス
      */
     dictionaryKeyPrefix: "",
   },
@@ -979,9 +937,9 @@ export default config;
 ```
 
 <Tabs>
- <Tab value='抽出コマンド'>
+ <Tab value='Extract command'>
 
-コンポーネントを変換してコンテンツを抽出するためにエクストラクタを実行します
+エクストラクターを実行して、コンポーネントを変換しコンテンツを抽出します
 
 ```bash packageManager="npm"
 npx intlayer extract
@@ -1000,9 +958,9 @@ bun x intlayer extract
 ```
 
  </Tab>
- <Tab value='Babelコンパイラ'>
+ <Tab value='Babel compiler'>
 
-`vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます。
+`vite.config.ts` を更新して `intlayerCompiler` プラグインを含めます:
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
@@ -1029,7 +987,7 @@ yarn build # または yarn dev
 ```
 
 ```bash packageManager="bun"
-bun run build # Or bun run dev
+bun run build # または bun run dev
 ```
 
  </Tab>
@@ -1038,54 +996,6 @@ bun run build # Or bun run dev
 
 </Steps>
 
-### TypeScriptの設定
-
-Intlayerはモジュール拡張を利用して、TypeScriptの利点を活かし、コードベースをより強固にします。
-
-![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
-
-![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
-
-TypeScriptの設定に自動生成された型定義が含まれていることを確認してください。
-
-```json5 fileName="tsconfig.json"
-{
-  // ... 既存のTypeScript設定
-  "include": [
-    // ... 既存のTypeScript設定
-    ".intlayer/**/*.ts", // 自動生成された型定義を含める
-  ],
-}
-```
-
-### Gitの設定
-
-Intlayerによって生成されたファイルは無視することを推奨します。これにより、それらのファイルをGitリポジトリにコミットするのを避けることができます。
-
-これを行うには、以下の指示を`.gitignore`ファイルに追加してください。
-
-```bash
-#  Intlayerによって生成されたファイルを無視する
-.intlayer
-```
-
-### VS Code拡張機能
-
-Intlayerでの開発体験を向上させるために、公式の**Intlayer VS Code拡張機能**をインストールできます。
-
-[VS Codeマーケットプレイスからインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-この拡張機能は以下を提供します：
-
-- 翻訳キーの**オートコンプリート**。
-- 欠落している翻訳の**リアルタイムエラー検出**。
-- 翻訳されたコンテンツの**インラインプレビュー**。
-- 翻訳を簡単に作成・更新できる**クイックアクション**。
-
-拡張機能の使用方法の詳細については、[Intlayer VS Code Extension ドキュメント](https://intlayer.org/doc/vs-code-extension)を参照してください。
-
----
-
 ### （任意）サイトマップと robots.txt（ビルド時生成）
 
 Intlayer は `generateSitemap` と `getMultilingualUrls` により、クローラ向けに整形した多言語の `sitemap.xml` と `robots.txt` を `public/` に自動で書き出せます。通常は Vite より**前**に小さな Node スクリプトを走らせます（例: npm の `predev` / `prebuild`）。
@@ -1160,8 +1070,54 @@ console.log("SEO files generated successfully.");
 
 pnpm や yarn を使う場合はコマンドを読み替えてください。CI から呼び出しても構いません。
 
-### さらに進むために
+### TypeScriptの設定
 
-さらに進むには、[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を実装するか、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用してコンテンツを外部化することができます。
+Intlayerはモジュール拡張（module augmentation）を使用してTypeScriptの利点を活用し、コードベースをより強固にします。
+
+![オートコンプリート](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
+
+![翻訳エラー](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+
+TypeScriptの設定に、自動生成された型が含まれていることを確認してください。
+
+```json5 fileName="tsconfig.json"
+{
+  // ... 既存のTypeScript設定
+  "include": [
+    // ... 既存のTypeScript設定
+    ".intlayer/**/*.ts", // 自動生成された型を含める
+  ],
+}
+```
+
+### Gitの設定
+
+Intlayerによって生成されたファイルを無視することをお勧めします。これにより、それらをGitリポジトリにコミットすることを避けることができます。
+
+これを行うには、`.gitignore`ファイルに以下の指示を追加できます。
+
+```plaintext fileName=".gitignore"
+# Intlayerによって生成されたファイルを無視する
+.intlayer
+```
+
+### VS Code 拡張機能
+
+Intlayer での開発体験を向上させるために、公式の **Intlayer VS Code Extension** をインストールできます。
+
+[VS Code Marketplace からインストール](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+この拡張機能は以下の機能を提供します：
+
+- 翻訳キーの **オートコンプリート**。
+- 不足している翻訳の **リアルタイムエラー検出**。
+- 翻訳済みコンテンツの **インラインプレビュー**。
+- 翻訳を簡単に作成・更新するための **クイックアクション**。
+
+拡張機能の使用方法の詳細については、[Intlayer VS Code Extension ドキュメント](https://intlayer.org/ja/doc/vs-code-extension)を参照してください。
 
 ---
+
+### さらに進むために
+
+さらに進むには、[ビジュアルエディター](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)を実装するか、[CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を使用してコンテンツを外部化することができます。

package/docs/ja/mcp_server.md

@@ -248,6 +248,10 @@ ChatGPT で MCP サーバーを設定するには、[公式ドキュメント](h
 
 ---
 
+## Claude Code (CLI) でのセットアップ
+
+[公式ドキュメント](https://modelcontextprotocol.io/quickstart/user)に従って、Claude Code で MCP サーバーを設定してください。
+
 ## CLIを使ったMCPサーバーの利用
 
 Intlayer MCPサーバーは、テスト、デバッグ、または他のツールとの統合のために、コマンドラインから直接実行することもできます。
@@ -261,3 +265,25 @@ npx @intlayer/mcp
 ```
 
 ---
+
+### リモートサーバー (Streamable HTTP)
+
+Intlayer MCPサーバーをStreamable HTTP (SSE)を使用してClaude Codeに接続するには:
+
+```bash
+claude mcp add intlayer https://mcp.intlayer.org -t http
+```
+
+---
+
+## CLI 経由で MCP サーバーを使用する
+
+コマンドラインから Intlayer MCP サーバーを直接実行して、テスト、デバッグ、または他のツールとの統合を行うことができます。
+
+```bash
+# グローバルにインストール
+npm install -g @intlayer/mcp
+
+# または npx で直接使用（推奨）
+npx @intlayer/mcp
+```

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

@@ -269,15 +269,6 @@ app.get("/morning", (_req, res) => {
 
 ---
 
-## 効果的な使用のためのヒント
-
-1. **翻訳の集中管理**: 翻訳の保守性を向上させるために、翻訳を管理する集中モジュールやJSONファイルを使用してください。
-2. **翻訳の検証**: 不要なフォールバックを防ぐために、すべての言語バリアントに対応する翻訳があることを確認してください。
-3. **フロントエンドのi18nと連携**: アプリ全体でシームレスなユーザー体験を実現するために、フロントエンドの国際化と同期させてください。
-4. **パフォーマンスのベンチマーク**: 翻訳を追加した際のアプリの応答時間をテストし、影響が最小限であることを確認してください。
-
----
-
 ## 結論
 
 1. **翻訳の集中管理**: 翻訳を管理するために集中管理モジュールやJSONファイルを使用し、保守性を向上させましょう。

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

@@ -33,6 +33,36 @@ author: aymericzip
 
 ---
 
+## 関数署名
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // 必須
+  currentLocale: Locales,        // 必須
+  options?: {                    // オプション
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## パラメータ
+
+### 必須パラメータ
+
+- `url: string`
+  - **Description**: ロケールをプレフィックスとして付与する元のURL文字列。
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `currentLocale: Locales`
+  - **Description**: URLがローカライズされている現在のロケール。
+  - **Type**: `Locales`
+  - **Required**: Yes
+
 ## パラメーター
 
 - `url: string`
@@ -67,6 +97,25 @@ author: aymericzip
 
 ## 使用例
 
+### 基本的な使用方法（必須パラメータのみ）
+
+プロジェクトを国際化設定で構成した後、必須パラメータだけで関数を使用できます:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// プロジェクトの設定（locales、defaultLocale、mode）を使用します
+getLocalizedUrl("/about", Locales.FRENCH);
+// 出力: "/fr/about" (フランス語がサポートされており、modeが'prefix-no-default'の場合)
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// 出力: "/about" または "/en/about" (modeの設定に応じて異なります)
+```
+
+### Advanced Usage (With Optional Parameters)
+
+オプションの `options` パラメーターを提供することで、デフォルト設定をオーバーライドできます:
+
 ### 相対 URL
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +163,30 @@ getLocalizedUrl(
 // 出力: デフォルト（英語）ロケールの場合 "/about"
 ```
 
+### 部分的な設定のオーバーライド
+
+オプションパラメータの一部のみを指定することもできます。指定しないパラメータについては、関数はプロジェクト設定を使用します:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// localesのみをオーバーライドし、defaultLocaleとmodeはプロジェクト設定を使用
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// modeのみをオーバーライドし、localesとdefaultLocaleはプロジェクト設定を使用
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // デフォルトロケールを含むすべてのロケールにプリフィックスを強制
+});
+
+// 複数のオプションをオーバーライド
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // クエリパラメータを使用: /about?locale=fr
+});
+```
+
 ### 絶対URL
 
 ```typescript