soseki 0.0.1

package/src/core/expect-history-entry.ts

@@ -0,0 +1,95 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+import HistoryEntryIdSchema, { type HistoryEntryId } from "./history-entry-id-schema.js";
+import HistoryEntryUrlSchema, { type HistoryEntryUrl } from "./history-entry-url-schema.js";
+
+/**
+ * 履歴エントリーのバリデーションスキーマを生成、または取得します。
+ *
+ * 識別子、URL、および 0 以上の整数であるインデックスを持つオブジェクト構造を定義します。
+ *
+ * @returns 履歴エントリーのスキーマです。
+ */
+const HistoryEntrySchema = () => (singleton("HistoryEntrySchema", () => (
+  v.object({
+    id: HistoryEntryIdSchema(),
+    url: v.nullable(HistoryEntryUrlSchema()),
+    index: v.pipe(
+      v.number(),
+      v.safeInteger(),
+      v.minValue(0),
+    ),
+  })
+)));
+
+/**
+ * 履歴エントリーとして受け入れ可能な入力型の定義です。
+ */
+export type HistoryEntryLike = Readonly<v.InferInput<ReturnType<typeof HistoryEntrySchema>>>;
+
+/**
+ * バリデーション済みの履歴エントリーを表す型定義です。
+ */
+export type HistoryEntry = {
+  /**
+   * 履歴エントリーを一意に識別する ID です。
+   */
+  readonly id: HistoryEntryId;
+
+  /**
+   * 正規化済みの URL オブジェクトです。
+   */
+  readonly url: HistoryEntryUrl;
+
+  /**
+   * 0 以上の整数で表される履歴のインデックスです。
+   */
+  readonly index: number;
+};
+
+/**
+ * 入力値が履歴エントリーの形式を満たしているか検証します。
+ *
+ * @param entry 検証対象のオブジェクトです。
+ * @returns バリデーション済み、かつ URL が存在する履歴エントリーです。
+ */
+function expectHistoryEntry(entry: HistoryEntryLike): HistoryEntry;
+
+/**
+ * 入力値が履歴エントリーの形式を満たしているか検証します。
+ *
+ * @param entry 検証対象のオブジェクト、または null 系値です。
+ * @returns 検証に成功した場合は履歴エントリーを、入力が null もしくは URL が欠損している場合は null を返します。
+ */
+function expectHistoryEntry(entry: HistoryEntryLike | null | undefined): HistoryEntry | null;
+
+/**
+ * 入力値が履歴エントリーの形式を満たしているか検証します。
+ *
+ * @param entry 検証対象のデータです。
+ * @returns 検証結果に基づく履歴エントリー、または null です。
+ */
+function expectHistoryEntry(entry: HistoryEntryLike | null | undefined): HistoryEntry | null {
+  if (entry == null) {
+    return null;
+  }
+
+  const {
+    id,
+    url,
+    index,
+  } = v.expect(HistoryEntrySchema(), entry);
+
+  // URL が nullable として定義されていますが、この関数では URL が存在することを必須とします。
+  if (!url) {
+    return null;
+  }
+
+  return {
+    id,
+    url,
+    index,
+  };
+}
+
+export default expectHistoryEntry;

package/src/core/history-entry-id-schema.ts

@@ -0,0 +1,27 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+
+/**
+ * 履歴エントリー ID のバリデーションスキーマを作成、または取得します。
+ *
+ * @returns 履歴エントリー ID のスキーマです。
+ */
+const HistoryEntryIdSchema = () => (singleton("HistoryEntryIdSchema", () => (
+  v.pipe(
+    v.string(),
+    v.uuid(),
+    v.brand("HistoryEntryId"),
+  )
+)));
+
+/**
+ * 履歴エントリー ID として受け入れ可能な入力型の定義です（バリデーション前の文字列など）。
+ */
+export type HistoryEntryIdLike = v.InferInput<ReturnType<typeof HistoryEntryIdSchema>>;
+
+/**
+ * バリデーション済みでブランド化された、履歴エントリー ID の出力型の定義です。
+ */
+export type HistoryEntryId = v.InferOutput<ReturnType<typeof HistoryEntryIdSchema>>;
+
+export default HistoryEntryIdSchema;

package/src/core/history-entry-url-schema.ts

@@ -0,0 +1,35 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+import type { ReadonlyURL } from "./readonly-url.types.js";
+
+/**
+ * 履歴エントリー URL のバリデーションおよび変換スキーマを作成、または取得します。
+ *
+ * 文字列が有効な URL であるかを確認し、クエリーパラメーターをソートして正規化した `ReadonlyURL` オブジェクトを返します。
+ *
+ * @returns 履歴エントリー URL のスキーマです。
+ */
+const HistoryEntryUrlSchema = () => (singleton("HistoryEntryUrlSchema", () => (
+  v.pipe(
+    v.string(),
+    v.url(),
+    v.transform(function createNormalizedUrl(s): ReadonlyURL {
+      const u = new URL(s);
+      // 同一の URL として比較しやすくするため、クエリーパラメーターを昇順にソートします。
+      u.searchParams.sort();
+      return u;
+    }),
+  )
+)));
+
+/**
+ * 履歴エントリー URL として受け入れ可能な入力型の定義です（バリデーション前の文字列など）。
+ */
+export type HistoryEntryUrlLike = v.InferInput<ReturnType<typeof HistoryEntryUrlSchema>>;
+
+/**
+ * バリデーションおよび正規化が行われた後の、履歴エントリー URL の出力型の定義です。
+ */
+export type HistoryEntryUrl = v.InferOutput<ReturnType<typeof HistoryEntryUrlSchema>>;
+
+export default HistoryEntryUrlSchema;

package/src/core/init-loaders.ts

@@ -0,0 +1,79 @@
+import type { IDataMap } from "./data-map.types.js";
+import type { IDataStore } from "./data-store.types.js";
+import DeferredPromise from "./deferred-promise.js";
+import type { HistoryEntry } from "./expect-history-entry.js";
+import type { MatchedRoute } from "./match-routes.js";
+import RouteRequest from "./route-request.js";
+import type { ILoader } from "./route.types.js";
+
+/**
+ * ローダーの初期化に使用するパラメーターの型定義です。
+ */
+export type InitLoadersParams = {
+  /**
+   * マッチしたルート情報のリストです。パラメーターとデータ関数を含みます。
+   */
+  readonly routes: readonly Pick<MatchedRoute, "params" | "dataFuncs">[];
+
+  /**
+   * 履歴エントリーの情報です。 ID と URL を含みます。
+   */
+  readonly entry: Pick<HistoryEntry, "id" | "url">;
+
+  /**
+   * データを永続化するためのデータストアです。
+   */
+  readonly dataStore: IDataStore<ILoader>;
+
+  /**
+   * 非同期処理を中断するためのシグナルです。
+   */
+  readonly signal: AbortSignal;
+};
+
+/**
+ * ルートに定義されたローダーを初期化し、実行します。
+ *
+ * 各ローダーの実行結果はデータストアに格納され、すべての実行開始を待機します。
+ *
+ * @param params ローダーの初期化に必要なパラメーターオブジェクトです。
+ * @returns すべてのローダーの処理が開始（Settled）されるまで待機する Promise です。
+ */
+export default function initLoaders(params: InitLoadersParams): {
+  (): Promise<void>;
+} {
+  const {
+    entry,
+    routes,
+    signal,
+    dataStore,
+  } = params;
+  const dataMap: IDataMap<ILoader> = new Map();
+  const request = new RouteRequest("GET", entry.url, signal);
+  // 各ルートおよびそのデータ関数に含まれるローダーを走査します。
+  for (const route of routes) {
+    for (const { loader } of route.dataFuncs) {
+      if (!loader) {
+        continue;
+      }
+
+      // ローダーの実行を遅延評価としてラップします。
+      const data = DeferredPromise.try(function executeLoader() {
+        return loader({
+          params: route.params,
+          request,
+        });
+      });
+      // ローダーの結果を待機、エラーハンドリングする処理は、この結果を参照するコンポーネントに任せます。
+      dataMap.set(loader, data);
+    }
+  }
+
+  // 生成されたデータマップを履歴エントリーの ID に紐付けて保存します。
+  dataStore.set(entry.id, dataMap);
+
+  return async function waitForLoadersComplete() {
+    // すべてのローダーの Promise が確定するまで待機します。
+    await Promise.allSettled(dataMap.values());
+  };
+}

package/src/core/match-routes.ts

@@ -0,0 +1,91 @@
+import { inject } from "regexparam";
+import matchRoutePath from "./_match-route-path.js";
+import type { PathParams, Route } from "./route.types.js";
+
+/**
+ * マッチしたルートの情報に、抽出されたパスパラメーターを統合した型定義です。
+ */
+export type MatchedRoute = Pick<Route, "path" | "index" | "dataFuncs" | "component"> & {
+  /**
+   * パス名から抽出された動的なパラメーターのオブジェクトです。
+   */
+  readonly params: PathParams;
+
+  /**
+   * ルートのパスパターンに基づく URL のパスです。
+   *
+   * @example
+   * ```ts
+   * const route = matchRoutes(routes, "/user/123/setting");
+   * route.path;     // "/user/:id"
+   * route.params;   // { id: "123" }
+   * route.urlPath;  // "/user/123"
+   * ```
+   */
+  readonly urlPath: string;
+};
+
+/**
+ * 単一のルートとその子ルートに対して、再帰的にパスマッチングを試みます。
+ *
+ * @param route マッチングを確認する対象のルートオブジェクトです。
+ * @param pathname マッチング対象のパス名です。
+ * @returns マッチした場合は親から子への階層構造を保持した配列を返し、マッチしない場合は `null` を返します。
+ */
+function matchRoute(
+  route: Route,
+  pathname: string,
+): readonly [MatchedRoute, ...MatchedRoute[]] | null {
+  const result = matchRoutePath(route, pathname);
+  if (!result) {
+    return null;
+  }
+
+  const matched: MatchedRoute = {
+    path: route.path,
+    index: route.index,
+    params: result.params,
+    urlPath: inject(route.path, result.params),
+    dataFuncs: route.dataFuncs,
+    component: route.component,
+  };
+
+  // インデックスルート（末端）の場合は、現在のルートを配列に含めて返します。
+  if (route.index) {
+    return [matched];
+  }
+
+  // 子ルートの中にマッチするものがあるか探索します。
+  for (const childRoute of route.children) {
+    const childMathced = matchRoute(childRoute, pathname);
+    if (childMathced) {
+      return [
+        ...childMathced,
+        matched,
+      ];
+    }
+  }
+
+  return [matched];
+}
+
+/**
+ * ルート定義のリスト全体から、指定されたパス名にマッチするルートを探索します。
+ *
+ * @param routes 探索対象となるルートオブジェクトの配列です。
+ * @param pathname マッチング対象のパス名です。
+ * @returns 最初にマッチしたルートとその階層構造を返し、どのルートにもマッチしない場合は `null` を返します。
+ */
+export default function matchRoutes(
+  routes: readonly Route[],
+  pathname: string,
+): readonly [MatchedRoute, ...MatchedRoute[]] | null {
+  for (const route of routes) {
+    const matched = matchRoute(route, pathname);
+    if (matched) {
+      return matched;
+    }
+  }
+
+  return null;
+}

package/src/core/readonly-form-data.types.ts

@@ -0,0 +1,63 @@
+/**
+ * **`ReadonlyFormData`** インターフェースは、フォームフィールドとその値のセットをキーと値のペアで構築する方法を提供します。
+ *
+ * 構築したデータは、`fetch()`、`XMLHttpRequest.send()`、または `navigator.sendBeacon()` メソッドを使用して送信できます。
+ *
+ * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData)
+ */
+export interface ReadonlyFormData {
+  /**
+   * ReadonlyFormData インターフェースの **`get()`** メソッドは、`FormData` オブジェクト内にある指定したキーに関連付けられた最初の値を返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/get)
+   */
+  get(name: string): FormDataEntryValue | null;
+
+  /**
+   * ReadonlyFormData インターフェースの **`getAll()`** メソッドは、`FormData` オブジェクト内にある指定したキーに関連付けられたすべての値を返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
+   */
+  getAll(name: string): FormDataEntryValue[];
+
+  /**
+   * ReadonlyFormData インターフェースの **`has()`** メソッドは、`FormData` オブジェクトに特定のキーが含まれているかどうかを返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/has)
+   */
+  has(name: string): boolean;
+
+  /**
+   * FormData オブジェクトに含まれるすべてのキーと値のペアに対して、指定されたコールバック関数を一度ずつ実行します。
+   */
+  forEach(
+    callbackfn: (value: FormDataEntryValue, key: string, parent: ReadonlyFormData) => void,
+    thisArg?: any,
+  ): void;
+
+  // /**
+  //  * ReadonlyFormData インターフェースの **`entries()`** メソッドは、このオブジェクトに含まれるすべてのキーと値のペアを順に走査するためのイテレーターを返します。
+  //  *
+  //  * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/entries)
+  //  */
+  // entries(): IterableIterator<[string, FormDataEntryValue]>;
+
+  // /**
+  //  * ReadonlyFormData インターフェースの **`keys()`** メソッドは、このオブジェクトに含まれるすべてのキー（name）を順に走査するためのイテレーターを返します。
+  //  *
+  //  * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/keys)
+  //  */
+  // keys(): IterableIterator<string>;
+
+  // /**
+  //  * ReadonlyFormData インターフェースの **`values()`** メソッドは、このオブジェクトに含まれるすべての値を順に走査するためのイテレーターを返します。
+  //  *
+  //  * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/values)
+  //  */
+  // values(): IterableIterator<FormDataEntryValue>;
+
+  // /**
+  //  * FormData オブジェクトのデフォルトのイテレーターです。これにより `for...of` ループで直接 `entries()` と同様の挙動（キーと値のペアの取得）が可能になります。
+  //  */
+  // [Symbol.iterator](): IterableIterator<[string, FormDataEntryValue]>;
+}

package/src/core/readonly-url.types.ts

@@ -0,0 +1,156 @@
+/**
+ * **`ReadonlyURL`** インターフェースは、URL の解析、構築、正規化、およびエンコードを行うために使用されます。
+ *
+ * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL)
+ */
+export interface ReadonlyURL {
+  /**
+   * ReadonlyURL インターフェースの **`hash`** プロパティーは、"#" とそれに続く ReadonlyURL のフラグメント識別子を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/hash)
+   */
+  readonly hash: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`host`** プロパティーは、ホスト（`ReadonlyURL.hostname`）と、URL のポートが空でない場合は ":" に続くポート（`ReadonlyURL.port`）を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/host)
+   */
+  readonly host: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`hostname`** プロパティーは、URL のドメイン名または IP アドレスを含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/hostname)
+   */
+  readonly hostname: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`href`** プロパティーは、URL 全体を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/href)
+   */
+  readonly href: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`toString()`** メソッドは、URL をシリアライズした文字列を返します。実際には `ReadonlyURL.href` と同じ値を返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/toString)
+   */
+  toString(): string;
+
+  /**
+   * ReadonlyURL インターフェースの **`origin`** プロパティーは、対象となる ReadonlyURL のオリジンを Unicode 形式でシリアライズした文字列を返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/origin)
+   */
+  readonly origin: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`password`** プロパティーは、URL のパスワード成分を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/password)
+   */
+  readonly password: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`pathname`** プロパティーは、階層構造における場所を表します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/pathname)
+   */
+  readonly pathname: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`port`** プロパティーは、URL のポート番号を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/port)
+   */
+  readonly port: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`protocol`** プロパティーは、末尾の ":" を含む、URL のプロトコルまたはスキームを示す文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/protocol)
+   */
+  readonly protocol: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`search`** プロパティーは、検索文字列（またはクエリー文字列）です。これは、"?" とそれに続く ReadonlyURL のパラメーターを含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/search)
+   */
+  readonly search: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`searchParams`** プロパティーは、URL に含まれるクエリー引数をデコードして扱うための `ReadonlyURLSearchParams` オブジェクトへのアクセスを提供します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
+   */
+  readonly searchParams: ReadonlyURLSearchParams;
+
+  /**
+   * ReadonlyURL インターフェースの **`username`** プロパティーは、URL のユーザー名成分を含む文字列です。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/username)
+   */
+  readonly username: string;
+
+  /**
+   * ReadonlyURL インターフェースの **`toJSON()`** メソッドは、URL をシリアライズした文字列を返します。実際には `ReadonlyURL.href` と同じ値を返します。
+   *
+   * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
+   */
+  toJSON(): string;
+}
+
+/**
+ * **`ReadonlyURLSearchParams`** インターフェースは、URLのクエリー文字列を操作するための便利なメソッドを定義します。
+ *
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams)
+ */
+export interface ReadonlyURLSearchParams {
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`size`** プロパティーは、検索パラメーターのエントリーの総数を示します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size)
+   */
+  readonly size: number;
+
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`get()`** メソッドは、指定された検索パラメーターに関連付けられた最初の値を返します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/get)
+   */
+  get(name: string): string | null;
+
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`getAll()`** メソッドは、指定された検索パラメーターに関連付けられたすべての値を配列として返します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/getAll)
+   */
+  getAll(name: string): string[];
+
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`has()`** メソッドは、指定されたパラメーターが検索パラメーターに含まれているかどうかを示す論理値を返します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/has)
+   */
+  has(name: string, value?: string): boolean;
+
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`toString()`** メソッドは、URL で使用できるクエリー文字列（先頭の "?" を除く）を返します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/toString)
+   */
+  toString(): string;
+
+  /**
+   * ReadonlyURLSearchParams インターフェースの **`forEach()`** メソッドは、このオブジェクト内に存在する各値に対して、渡されたコールバック関数を一度ずつ実行します。
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/forEach)
+   */
+  forEach(
+    callbackfn: (value: string, key: string, parent: ReadonlyURLSearchParams) => void,
+    thisArg?: any,
+  ): void;
+}

package/src/core/redirect-response.ts

@@ -0,0 +1,36 @@
+import encodePathname from "./_encode-pathname.js";
+
+/**
+ * リダイレクトの識別子として使用されるユニークなシンボルです。
+ */
+declare const ID: unique symbol;
+
+/**
+ * リダイレクトレスポンスを表現するクラスです。
+ *
+ * 指定されたパス名をエンコードして保持します。
+ */
+export default class RedirectResponse {
+  /**
+   * クラスを識別するためのユニークな ID です。
+   *
+   * @internal
+   */
+  // @ts-expect-error
+  public readonly ID: typeof ID;
+
+  /**
+   * エンコード済みのリダイレクト先パス名です。
+   */
+  public readonly pathname: string;
+
+  /**
+   * RedirectResponse クラスの新しいインスタンスを初期化します。
+   *
+   * @param pathname リダイレクト先のパス名です。
+   */
+  public constructor(pathname: string) {
+    // パス名を適切な形式にエンコードして格納します。
+    this.pathname = encodePathname(pathname);
+  }
+}

package/src/core/route-request.ts

@@ -0,0 +1,92 @@
+import type { ReadonlyFormData } from "./readonly-form-data.types.js";
+import type { ReadonlyURL } from "./readonly-url.types.js";
+
+/**
+ * ルーティングのリクエスト情報を管理するクラスです。
+ */
+export default class RouteRequest {
+  /**
+   * HTTP メソッドです。 "GET" または "POST" のいずれかとなります。
+   */
+  public readonly method: "GET" | "POST";
+
+  /**
+   * リクエスト先の URL です。
+   *
+   * インスタンス化の際に検索パラメーターがソートされた状態で保持されます。
+   */
+  public readonly url: ReadonlyURL;
+
+  /**
+   * リクエストのキャンセルや中断を監視するための信号です。
+   */
+  public readonly signal: AbortSignal;
+
+  /**
+   * 送信されたフォームデータです。
+   *
+   * データが存在しない場合は `null` となります。
+   */
+  public readonly formData: ReadonlyFormData | null;
+
+  /**
+   * RouteRequest クラスの新しいインスタンスを初期化します。
+   *
+   * @param method 使用する HTTP メソッドです。
+   * @param url リクエスト対象の URL オブジェクトです。
+   * @param signal 処理を中断するための AbortSignal オブジェクトです。
+   */
+  public constructor(
+    method: "GET",
+    url: ReadonlyURL,
+    signal: AbortSignal,
+  );
+
+  /**
+   * RouteRequest クラスの新しいインスタンスを初期化します。
+   *
+   * @param method 使用する HTTP メソッドです。
+   * @param url リクエスト対象の URL オブジェクトです。
+   * @param signal 処理を中断するための AbortSignal オブジェクトです。
+   * @param formData 送信するフォームデータです。
+   */
+  public constructor(
+    method: "POST",
+    url: ReadonlyURL,
+    signal: AbortSignal,
+    formData: ReadonlyFormData,
+  );
+
+  public constructor(
+    method: "GET" | "POST",
+    url: ReadonlyURL,
+    signal: AbortSignal,
+    formData?: ReadonlyFormData,
+  ) {
+    this.url = url;
+    this.method = method;
+    this.signal = signal;
+    this.formData = formData || null;
+  }
+
+  /**
+   * 現在のプロパティーを基に、標準の Request オブジェクトを生成して返します。
+   *
+   * @param init リクエストに適用したいカスタム設定です。
+   * @returns fetch API などで使用可能な Request オブジェクトを返します。
+   */
+  public toRequest(init: RequestInit | undefined = {}): Request {
+    const {
+      body = this.formData as FormData | null,
+      method = this.method,
+      signal = this.signal,
+      ...other
+    } = init;
+    return new Request(this.url.href, {
+      body,
+      method,
+      signal,
+      ...other,
+    });
+  }
+}