@intlayer/docs 5.5.8

package/ja/packages/@intlayer/webpack/index.md

@@ -0,0 +1,35 @@
+# @intlayer/webpack: アプリケーションで Intlayer Webpack プラグインを使用するための NPM パッケージ
+
+**Intlayer** は、JavaScript 開発者向けに特別に設計されたパッケージ群です。React、Next.js、Express.js などのフレームワークと互換性があります。
+
+**`@intlayer/webpack`** パッケージは、Intlayer を使用した Webpack ベースのアプリケーションを簡単に構成するための Webpack 設定を提供します。このパッケージは、既存の Webpack アプリケーションに追加できるプラグインも提供します。
+
+## 使用方法
+
+```ts
+import { IntlayerPlugin } from "@intlayer/webpack";
+
+export default {
+  plugins: [
+    new IntlayerPlugin({
+      // オプション
+    }),
+  ],
+};
+```
+
+## インストール
+
+お好みのパッケージマネージャーを使用して必要なパッケージをインストールしてください:
+
+```bash packageManager="npm"
+npm install @intlayer/webpack
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/webpack
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/webpack
+```

package/ja/packages/angular-intlayer/index.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/packages/angular-intlayer/index.md

package/ja/packages/express-intlayer/index.md

@@ -0,0 +1,229 @@
+# express-intlayer: Express.jsアプリケーションを国際化（i18n）するためのJavaScriptパッケージ
+
+**Intlayer**は、JavaScript開発者向けに特化して設計されたパッケージ群です。React、Next.js、Express.jsなどのフレームワークと互換性があります。
+
+**`express-intlayer`パッケージ**は、Express.jsアプリケーションを国際化するためのものです。ユーザーの優先ロケールを検出し、適切な辞書を返すミドルウェアを提供します。
+
+## なぜバックエンドを国際化するのか？
+
+バックエンドを国際化することは、グローバルなオーディエンスに効果的に対応するために不可欠です。これにより、アプリケーションは各ユーザーの好みの言語でコンテンツやメッセージを提供できます。この機能はユーザーエクスペリエンスを向上させ、異なる言語背景を持つ人々にとってよりアクセスしやすく、関連性の高いものにすることで、アプリケーションのリーチを広げます。
+
+### 実用的なユースケース
+
+- **ユーザーの言語でバックエンドエラーを表示**: エラーが発生した際に、ユーザーの母国語でメッセージを表示することで、理解を深め、フラストレーションを軽減します。これは、トーストやモーダルなどのフロントエンドコンポーネントに表示される動的なエラーメッセージに特に有用です。
+
+- **多言語コンテンツの取得**: データベースからコンテンツを取得するアプリケーションでは、国際化によりこのコンテンツを複数の言語で提供できます。これは、ユーザーが好む言語で商品説明や記事などのコンテンツを表示する必要があるeコマースサイトやコンテンツ管理システムなどのプラットフォームにとって重要です。
+
+- **多言語メールの送信**: トランザクションメール、マーケティングキャンペーン、通知など、受信者の言語でメールを送信することで、エンゲージメントと効果を大幅に向上させることができます。
+
+- **多言語プッシュ通知**: モバイルアプリケーションでは、ユーザーの好みの言語でプッシュ通知を送信することで、インタラクションとリテンションを向上させることができます。このパーソナルなタッチにより、通知がより関連性が高く、実行可能に感じられます。
+
+- **その他のコミュニケーション**: SMSメッセージ、システムアラート、ユーザーインターフェースの更新など、バックエンドからのあらゆる形式のコミュニケーションは、ユーザーの言語で行うことで明確さが向上し、全体的なユーザーエクスペリエンスが向上します。
+
+バックエンドを国際化することで、アプリケーションは文化的な違いを尊重するだけでなく、グローバル市場のニーズにより適合し、サービスを世界規模で拡大するための重要なステップとなります。
+
+## なぜIntlayerを統合するのか？
+
+- **型安全な環境**: TypeScriptを活用して、すべてのコンテンツ定義を正確かつエラーのないものにします。
+
+## インストール
+
+お好みのパッケージマネージャーを使用して必要なパッケージをインストールします:
+
+```bash
+npm install express-intlayer
+```
+
+```bash
+yarn add express-intlayer
+```
+
+```bash
+pnpm add express-intlayer
+```
+
+### Intlayerの設定
+
+Intlayerは、プロジェクトを設定するための設定ファイルを提供します。このファイルをプロジェクトのルートに配置してください。
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+> 利用可能なパラメーターの完全なリストについては、[設定ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/configuration.md)を参照してください。
+
+## 使用例
+
+`express-intlayer`を使用するようにExpressアプリケーションを設定します:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import express, { type Express } from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app: Express = express();
+
+// 国際化リクエストハンドラーをロード
+app.use(intlayer());
+
+// ルート
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+    })
+  );
+});
+
+// サーバーを起動
+app.listen(3000, () => console.log(`Listening on port 3000`));
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import express from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app = express();
+
+// 国際化リクエストハンドラーをロード
+app.use(intlayer());
+
+// ルート
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    })
+  );
+});
+
+// サーバーを起動
+app.listen(3000, () => console.log(`Listening on port 3000`));
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+const express = require("express");
+const { intlayer, t } = require("express-intlayer");
+
+const app = express();
+
+// 国際化リクエストハンドラーをロード
+app.use(intlayer());
+
+// ルート
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    })
+  );
+});
+
+// サーバーを起動
+app.listen(3000, () => console.log(`Listening on port 3000`));
+```
+
+### 互換性
+
+`express-intlayer`は以下と完全に互換性があります:
+
+- [Reactアプリケーション用の`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/ja/packages/react-intlayer/index.md)
+- [Next.jsアプリケーション用の`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/ja/packages/next-intlayer/index.md)
+- [Viteアプリケーション用の`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/ja/packages/vite-intlayer/index.md)
+
+また、ブラウザやAPIリクエストを含むさまざまな環境で、あらゆる国際化ソリューションとシームレスに動作します。ミドルウェアをカスタマイズして、ヘッダーやクッキーを介してロケールを検出することもできます:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... その他の設定オプション
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... その他の設定オプション
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... その他の設定オプション
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+module.exports = config;
+```
+
+デフォルトでは、`express-intlayer`は`Accept-Language`ヘッダーを解釈してクライアントの優先言語を判断します。
+
+## `express-intlayer`パッケージが提供する関数
+
+- [`t()`](https://github.com/aymericzip/intlayer/blob/main/docs/ja-GB/packages/express-intlayer/t.md)

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

@@ -0,0 +1,432 @@
+# ドキュメント: `express-intlayer` の `t` 関数
+
+`express-intlayer` パッケージの `t` 関数は、Express アプリケーションでローカライズされたレスポンスを提供するための主要なユーティリティです。ユーザーの希望する言語に基づいてコンテンツを動的に選択することで、国際化 (i18n) を簡素化します。
+
+---
+
+## 概要
+
+`t` 関数は、特定の言語セットに対する翻訳を定義および取得するために使用されます。クライアントのリクエスト設定（例えば、`Accept-Language` ヘッダー）に基づいて適切な言語を自動的に決定します。希望する言語が利用できない場合、設定で指定されたデフォルトのロケールにフォールバックします。
+
+---
+
+## 主な特徴
+
+- **動的ローカリゼーション**: クライアントに最も適した翻訳を自動的に選択します。
+- **デフォルトロケールへのフォールバック**: クライアントの希望する言語が利用できない場合、デフォルトロケールにフォールバックし、ユーザー体験の継続性を確保します。
+- **軽量かつ高速**: 高性能アプリケーション向けに設計されており、オーバーヘッドを最小限に抑えます。
+- **厳密モードのサポート**: 宣言されたロケールへの厳密な準拠を強制し、信頼性のある動作を保証します。
+
+---
+
+## 関数シグネチャ
+
+```typescript
+t(translations: Record<string, string>): string;
+```
+
+### パラメータ
+
+- `translations`: キーがロケールコード（例: `en`, `fr`, `es-MX`）、値が対応する翻訳文字列であるオブジェクト。
+
+### 戻り値
+
+- クライアントの希望する言語でのコンテンツを表す文字列。
+
+---
+
+## 国際化リクエストハンドラーの読み込み
+
+`express-intlayer` が提供する国際化機能が正しく動作するようにするには、Express アプリケーションの最初に国際化ミドルウェアを読み込む必要があります。これにより、`t` 関数が有効になり、ロケールの検出と翻訳が適切に処理されます。
+
+アプリケーション内の **すべてのルートの前に** `app.use(intlayer())` ミドルウェアを配置してください。これにより、すべてのルートが国際化の恩恵を受けられるようになります。
+
+```typescript {7} fileName="src/index.ts" codeFormat="typescript"
+import express, { type Express } from "express";
+import { intlayer } from "express-intlayer";
+
+const app: Express = express();
+
+// 国際化リクエストハンドラーを読み込む
+app.use(intlayer());
+
+// ミドルウェアを読み込んだ後にルートを定義する
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+```javascript {7} fileName="src/index.mjs" codeFormat="esm"
+import express from "express";
+import { intlayer } from "express-intlayer";
+
+const app = express();
+
+// 国際化リクエストハンドラーを読み込む
+app.use(intlayer());
+
+// ミドルウェアを読み込んだ後にルートを定義する
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+```javascript {7} fileName="src/index.cjs" codeFormat="commonjs"
+const express = require("express");
+const { intlayer } = require("express-intlayer");
+
+const app = express();
+
+// 国際化リクエストハンドラーを読み込む
+app.use(intlayer());
+
+// ミドルウェアを読み込んだ後にルートを定義する
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello, World!",
+      fr: "Bonjour le monde!",
+      es: "¡Hola, Mundo!",
+    })
+  );
+});
+```
+
+### なぜ必要なのか
+
+- **ロケール検出**: `intlayer` ミドルウェアは、ヘッダー、クッキー、またはその他の設定された方法に基づいてユーザーの希望するロケールを検出します。
+- **翻訳コンテキスト**: `t` 関数が正しく動作するために必要なコンテキストを設定し、翻訳が正しい言語で返されるようにします。
+- **エラー防止**: このミドルウェアがないと、`t` 関数を使用する際にランタイムエラーが発生します。これは必要なロケール情報が利用できないためです。
+
+---
+
+## 使用例
+
+### 基本的な例
+
+異なる言語でローカライズされたコンテンツを提供する:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Welcome!",
+      fr: "Bienvenue!",
+      es: "¡Bienvenido!",
+    })
+  );
+});
+```
+
+**クライアントリクエスト:**
+
+- `Accept-Language: fr` を持つクライアントは `Bienvenue!` を受け取ります。
+- `Accept-Language: es` を持つクライアントは `¡Bienvenido!` を受け取ります。
+- `Accept-Language: de` を持つクライアントは `Welcome!`（デフォルトロケール）を受け取ります。
+
+### エラーの処理
+
+複数の言語でエラーメッセージを提供する:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/error", (_req, res) => {
+  res.status(500).send(
+    t({
+      en: "An unexpected error occurred.",
+      fr: "Une erreur inattendue s'est produite.",
+      es: "Ocurrió un error inesperado.",
+    })
+  );
+});
+```
+
+---
+
+### ロケールバリアントの使用
+
+ロケール固有のバリアントの翻訳を指定する:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+app.get("/greet", (_req, res) => {
+  res.send(
+    t({
+      en: "Hello!",
+      "en-GB": "Hello, mate!",
+      fr: "Bonjour!",
+      "es-MX": "¡Hola, amigo!",
+      "es-ES": "¡Hola!",
+    })
+  );
+});
+```
+
+---
+
+## 高度なトピック
+
+### フォールバックメカニズム
+
+希望するロケールが利用できない場合、`t` 関数は設定で定義されたデフォルトロケールにフォールバックします:
+
+```typescript {5-6} fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+} satisfies IntlayerConfig;
+
+export default config;
+```
+
+```javascript {5-6} fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript {5-6} fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+例えば:
+
+- `defaultLocale` が `Locales.CHINESE` に設定されており、クライアントが `Locales.DUTCH` をリクエストした場合、返される翻訳は `Locales.CHINESE` の値になります。
+- `defaultLocale` が定義されていない場合、`t` 関数は `Locales.ENGLISH` の値にフォールバックします。
+
+---
+
+### 厳密モードの適用
+
+`t` 関数が宣言されたロケールへの厳密な準拠を強制するように設定します:
+
+| モード      | 動作                                                                                                         |
+| ----------- | ------------------------------------------------------------------------------------------------------------ |
+| `strict`    | すべての宣言されたロケールに翻訳が提供されている必要があります。欠落しているロケールはエラーをスローします。 |
+| `inclusive` | 宣言されたロケールに翻訳が必要です。欠落しているロケールは警告をトリガーしますが、許容されます。             |
+| `loose`     | 宣言されていないロケールでも受け入れられます。                                                               |
+
+設定例:
+
+```typescript {7} fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config = {
+  // ... 既存の設定
+  internationalization: {
+    // ... 既存の国際化設定
+    strictMode: "strict", // 厳密モードを適用
+  },
+} satisfies IntlayerConfig;
+
+export default config;
+```
+
+```javascript {7} fileName="intlayer.config.mjs" codeFormat="esm"
+import { type IntlayerConfig } from "intlayer";
+
+const config = {
+  // ... 既存の設定
+  internationalization: {
+    // ... 既存の国際化設定
+    strictMode: "strict", // 厳密モードを適用
+  },
+};
+
+export default config;
+```
+
+```javascript {7} fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... 既存の設定
+  internationalization: {
+    // ... 既存の国際化設定
+    strictMode: "strict", // 厳密モードを適用
+  },
+};
+
+module.exports = config;
+```
+
+---
+
+### TypeScript との統合
+
+`t` 関数は TypeScript と一緒に使用する場合、型安全です。型安全な翻訳オブジェクトを定義します:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import { type LanguageContent } from "express-intlayer";
+
+const translations: LanguageContent<string> = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import { type LanguageContent } from "express-intlayer";
+
+/** @type {import('express-intlayer').LanguageContent<string>} */
+const translations = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+const { type LanguageContent } = require("express-intlayer");
+
+/** @type {import('express-intlayer').LanguageContent<string>} */
+const translations = {
+  en: "Good morning!",
+  fr: "Bonjour!",
+  es: "¡Buenos días!",
+};
+
+app.get("/morning", (_req, res) => {
+  res.send(t(translations));
+});
+```
+
+---
+
+### 一般的なエラーとトラブルシューティング
+
+| 問題                 | 原因                                                   | 解決策                                                                     |
+| -------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------- |
+| `t` 関数が動作しない | ミドルウェアが読み込まれていない                       | `app.use(intlayer())` がルートの前に追加されていることを確認してください。 |
+| 翻訳の欠落エラー     | 厳密モードが有効で、すべてのロケールが提供されていない | 必要なすべての翻訳を提供してください。                                     |
+
+---
+
+## 効果的な使用のためのヒント
+
+1. **翻訳を集中管理する**: 翻訳の管理を改善するために、集中化されたモジュールや JSON ファイルを使用してください。
+2. **翻訳を検証する**: すべての言語バリアントに対応する翻訳があることを確認し、不必要なフォールバックを防ぎます。
+3. **フロントエンドの i18n と組み合わせる**: アプリ全体でシームレスなユーザー体験を提供するために、フロントエンドの国際化と同期します。
+4. **パフォーマンスをベンチマークする**: 翻訳を追加する際にアプリの応答時間をテストし、影響を最小限に抑えます。
+
+---
+
+## 結論
+
+`t` 関数は、バックエンドの国際化において強力なツールです。これを効果的に使用することで、グローバルなオーディエンスに対してより包括的でユーザーフレンドリーなアプリケーションを作成できます。高度な使用法や詳細な設定オプションについては、[ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/configuration.md) を参照してください。