Add documentation for prompt types and validators in English and Japanese

docs/.vitepress/config.mts

@@ -8,40 +8,89 @@ export default defineConfig({
   head: [
     ['link', { rel: 'icon', href: '/Sharprompt/icon.png' }]
   ],
-  themeConfig: {
-    logo: '/icon.png',
-    nav: [
-      { text: 'Guide', link: '/getting-started' },
-      { text: 'NuGet', link: 'https://www.nuget.org/packages/Sharprompt/' }
-    ],
-    sidebar: [
-      {
-        text: 'Introduction',
-        items: [
-          { text: 'Getting Started', link: '/getting-started' }
+  rewrites: {
+    'en/:rest*': ':rest*'
+  },
+  locales: {
+    root: {
+      label: 'English',
+      lang: 'en',
+      themeConfig: {
+        nav: [
+          { text: 'Guide', link: '/getting-started' },
+          { text: 'NuGet', link: 'https://www.nuget.org/packages/Sharprompt/' }
+        ],
+        sidebar: [
+          {
+            text: 'Introduction',
+            items: [
+              { text: 'Getting Started', link: '/getting-started' }
+            ]
+          },
+          {
+            text: 'Prompt Types',
+            items: [
+              { text: 'Input', link: '/prompt-types/input' },
+              { text: 'Confirm', link: '/prompt-types/confirm' },
+              { text: 'Password', link: '/prompt-types/password' },
+              { text: 'Select', link: '/prompt-types/select' },
+              { text: 'MultiSelect', link: '/prompt-types/multi-select' },
+              { text: 'List', link: '/prompt-types/list' },
+              { text: 'Bind', link: '/prompt-types/bind' }
+            ]
+          },
+          {
+            text: 'Reference',
+            items: [
+              { text: 'Validators', link: '/validators' },
+              { text: 'Configuration', link: '/configuration' },
+              { text: 'Advanced Features', link: '/advanced' }
+            ]
+          }
         ]
-      },
-      {
-        text: 'Prompt Types',
-        items: [
-          { text: 'Input', link: '/prompt-types/input' },
-          { text: 'Confirm', link: '/prompt-types/confirm' },
-          { text: 'Password', link: '/prompt-types/password' },
-          { text: 'Select', link: '/prompt-types/select' },
-          { text: 'MultiSelect', link: '/prompt-types/multi-select' },
-          { text: 'List', link: '/prompt-types/list' },
-          { text: 'Bind', link: '/prompt-types/bind' }
-        ]
-      },
-      {
-        text: 'Reference',
-        items: [
-          { text: 'Validators', link: '/validators' },
-          { text: 'Configuration', link: '/configuration' },
-          { text: 'Advanced Features', link: '/advanced' }
+      }
+    },
+    ja: {
+      label: '日本語',
+      lang: 'ja',
+      themeConfig: {
+        nav: [
+          { text: 'ガイド', link: '/ja/getting-started' },
+          { text: 'NuGet', link: 'https://www.nuget.org/packages/Sharprompt/' }
+        ],
+        sidebar: [
+          {
+            text: 'Introduction',
+            items: [
+              { text: 'Getting Started', link: '/ja/getting-started' }
+            ]
+          },
+          {
+            text: 'Prompt Types',
+            items: [
+              { text: 'Input', link: '/ja/prompt-types/input' },
+              { text: 'Confirm', link: '/ja/prompt-types/confirm' },
+              { text: 'Password', link: '/ja/prompt-types/password' },
+              { text: 'Select', link: '/ja/prompt-types/select' },
+              { text: 'MultiSelect', link: '/ja/prompt-types/multi-select' },
+              { text: 'List', link: '/ja/prompt-types/list' },
+              { text: 'Bind', link: '/ja/prompt-types/bind' }
+            ]
+          },
+          {
+            text: 'Reference',
+            items: [
+              { text: 'Validators', link: '/ja/validators' },
+              { text: 'Configuration', link: '/ja/configuration' },
+              { text: 'Advanced Features', link: '/ja/advanced' }
+            ]
+          }
         ]
       }
-    ],
+    }
+  },
+  themeConfig: {
+    logo: '/icon.png',
     socialLinks: [
       { icon: 'github', link: 'https://github.com/shibayan/Sharprompt' }
     ],

docs/ja/advanced.md

@@ -0,0 +1,85 @@
+# 高度な機能
+
+## Enum 型のサポート
+
+`Select` や `MultiSelect` で Enum 型を使用すると、Enum の値から自動的に項目が生成されます。`[Display]` 属性を使って表示名をカスタマイズできます:
+
+```csharp
+using System.ComponentModel.DataAnnotations;
+
+public enum MyEnum
+{
+    [Display(Name = "First value")]
+    First,
+    [Display(Name = "Second value")]
+    Second,
+    [Display(Name = "Third value")]
+    Third
+}
+
+var value = Prompt.Select<MyEnum>("Select enum value");
+Console.WriteLine($"You selected {value}");
+```
+
+`MultiSelect` の場合:
+
+```csharp
+var values = Prompt.MultiSelect<MyEnum>("Select enum values");
+Console.WriteLine($"You picked {string.Join(", ", values)}");
+```
+
+## Unicode サポート
+
+Sharprompt はマルチバイト文字と絵文字をサポートしています。最良の結果を得るには、出力エンコーディングを UTF-8 に設定してください:
+
+```csharp
+Console.OutputEncoding = Encoding.UTF8;
+
+var name = Prompt.Input<string>("What's your name?");
+Console.WriteLine($"Hello, {name}!");
+```
+
+## Fluent インターフェース
+
+すべてのプロンプトタイプは `Sharprompt.Fluent` 名前空間を通じて Fluent インターフェースをサポートしています:
+
+```csharp
+using Sharprompt.Fluent;
+
+var city = Prompt.Select<string>(o => o.WithMessage("Select your city")
+                                       .WithItems(new[] { "Seattle", "London", "Tokyo" })
+                                       .WithDefaultValue("Seattle"));
+```
+
+Fluent API はプロパティを設定するための `With*` メソッドと、コレクション（バリデータなど）に追加するための `Add*` メソッドを提供しています。
+
+## テキストセレクタ
+
+`Select` と `MultiSelect` では、項目の表示方法を制御するカスタム関数を提供できます:
+
+```csharp
+var user = Prompt.Select("Select user", users, textSelector: u => u.Name);
+```
+
+## ページネーション
+
+`Select` と `MultiSelect` は `pageSize` パラメータによるページネーションをサポートしています:
+
+```csharp
+var city = Prompt.Select("Select your city",
+    new[] { "Seattle", "London", "Tokyo", "New York", "Singapore", "Shanghai" },
+    pageSize: 3);
+```
+
+## ループ選択
+
+デフォルトでは、選択リストは先頭または末尾に到達するとループします。これはオプションクラスで無効にできます:
+
+```csharp
+var city = Prompt.Select(new SelectOptions<string>
+{
+    Message = "Select your city",
+    Items = new[] { "Seattle", "London", "Tokyo" },
+    LoopingSelection = false
+});
+```

docs/ja/configuration.md

@@ -0,0 +1,85 @@
+# 設定
+
+Sharprompt では、プロンプトの外観と動作をグローバルにカスタマイズできます。
+
+## シンボル
+
+プロンプトで使用されるシンボルをカスタマイズできます:
+
+```csharp
+Prompt.Symbols.Prompt = new Symbol("🤔", "?");
+Prompt.Symbols.Done = new Symbol("😎", "V");
+Prompt.Symbols.Error = new Symbol("😱", ">>");
+
+var name = Prompt.Input<string>("What's your name?");
+```
+
+`Symbol` クラスは 2 つの引数を取ります: Unicode 値と、Unicode をサポートしないターミナル用のフォールバック値です。
+
+### 利用可能なシンボル
+
+| シンボル | デフォルト (Unicode) | デフォルト (フォールバック) | 説明 |
+|--------|-------------------|-------------------|-------------|
+| `Prompt` | `?` | `?` | プロンプトメッセージの前に表示 |
+| `Done` | `✔` | `V` | プロンプト完了時に表示 |
+| `Error` | `»` | `>>` | バリデーション失敗時に表示 |
+| `Selector` | `›` | `>` | 現在ハイライトされている項目を指す |
+| `Selected` | `◉` | `(*)` | MultiSelect で選択済みの項目を示す |
+| `NotSelect` | `◯` | `( )` | MultiSelect で未選択の項目を示す |
+
+## カラースキーマ
+
+プロンプトで使用される色をカスタマイズできます:
+
+```csharp
+Prompt.ColorSchema.Answer = ConsoleColor.DarkRed;
+Prompt.ColorSchema.Select = ConsoleColor.DarkCyan;
+
+var name = Prompt.Input<string>("What's your name?");
+```
+
+### 利用可能な色
+
+| プロパティ | デフォルト | 説明 |
+|----------|---------|-------------|
+| `DoneSymbol` | `Green` | 完了シンボルの色 |
+| `PromptSymbol` | `Green` | プロンプトシンボルの色 |
+| `Answer` | `Cyan` | ユーザーの回答の色 |
+| `Select` | `Green` | 選択項目の色 |
+| `Error` | `Red` | エラーメッセージの色 |
+| `Hint` | `DarkGray` | ヒントとプレースホルダーの色 |
+| `DisabledOption` | `DarkCyan` | 無効な選択肢の色 |
+
+## キャンセルのサポート
+
+デフォルトでは、`Ctrl+C` を押すとデフォルト値が返されます。この動作を変更して例外をスローさせることができます:
+
+```csharp
+Prompt.ThrowExceptionOnCancel = true;
+
+try
+{
+    var name = Prompt.Input<string>("What's your name?");
+    Console.WriteLine($"Hello, {name}!");
+}
+catch (PromptCanceledException ex)
+{
+    Console.WriteLine("Prompt canceled");
+}
+```
+
+## カルチャ
+
+ローカライズされたメッセージのカルチャを設定します:
+
+```csharp
+Prompt.Culture = new CultureInfo("ja");
+```
+
+## コンソールドライバー
+
+カスタムコンソールドライバーファクトリを提供できます:
+
+```csharp
+Prompt.ConsoleDriverFactory = () => new MyCustomConsoleDriver();
+```

docs/ja/getting-started.md

@@ -0,0 +1,52 @@
+# はじめに
+
+## インストール
+
+NuGet から Sharprompt をインストールします:
+
+::: code-group
+
+```powershell [Package Manager]
+Install-Package Sharprompt
+```
+
+```sh [.NET CLI]
+dotnet add package Sharprompt
+```
+
+:::
+
+## クイックスタート
+
+```csharp
+using Sharprompt;
+
+// シンプルな入力
+var name = Prompt.Input<string>("What's your name?");
+Console.WriteLine($"Hello, {name}!");
+
+// パスワード入力
+var secret = Prompt.Password("Type new password",
+    validators: new[] { Validators.Required(), Validators.MinLength(8) });
+Console.WriteLine("Password OK");
+
+// 確認
+var answer = Prompt.Confirm("Are you ready?", defaultValue: true);
+Console.WriteLine($"Your answer is {answer}");
+```
+
+## サンプルの実行
+
+リポジトリには全プロンプトタイプのサンプルプロジェクトが含まれています:
+
+```sh
+dotnet run --project samples/Sharprompt.Example
+```
+
+## サポートされているプラットフォーム
+
+| プラットフォーム | ターミナル |
+|----------|----------|
+| Windows | コマンドプロンプト、PowerShell、Windows Terminal |
+| Linux | Windows Terminal (WSL 2)、各種ターミナルエミュレータ |
+| macOS | Terminal.app、iTerm2 など |

docs/ja/index.md

@@ -0,0 +1,32 @@
+---
+layout: home
+
+hero:
+  name: Sharprompt
+  text: C# 向けの対話型コマンドラインプロンプト
+  tagline: 対話型 CLI アプリケーションを構築するためのシンプルでクロスプラットフォームなフレームワーク
+  image:
+    src: /icon.png
+    alt: Sharprompt
+  actions:
+    - theme: brand
+      text: はじめに
+      link: /ja/getting-started
+    - theme: alt
+      text: GitHub で見る
+      link: https://github.com/shibayan/Sharprompt
+
+features:
+  - title: マルチプラットフォーム
+    details: Windows、Linux、macOS の様々なターミナルエミュレータで動作します。
+  - title: 豊富なプロンプトタイプ
+    details: Input、Password、Select、MultiSelect、List、Confirm、モデルベースの Bind プロンプトをサポートしています。
+  - title: バリデーション
+    details: 必須フィールド、最小/最大文字数、正規表現の組み込みバリデータを提供しています。
+  - title: Unicode サポート
+    details: マルチバイト文字と絵文字を完全にサポートしています 😀🎉
+  - title: カスタマイズ可能
+    details: シンボル、カラースキーマ、キャンセル動作を自由に設定できます。
+  - title: Fluent API
+    details: 可読性の高いクリーンな Fluent インターフェースでプロンプトを構築できます。
+---