soseki 0.0.5 → 0.0.7

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

@@ -0,0 +1,18 @@
+import * as v from "./_valibot.js";
+import type { ReadonlyURL } from "./readonly-url.types.js";
+/**
+ * 履歴エントリーで使用される URL 文字列を検証、正規化、およびブランド化するためのスキーマを作成する関数です。
+ *
+ * スキーマの構築処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+declare const HistoryEntryUrlSchema: () => import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").UrlAction<string, undefined>, import("@tai-kun/valibot-extra-lab").TransformAction<string, ReadonlyURL>, import("valibot").BrandAction<ReadonlyURL, "HistoryEntryUrl">]>;
+/**
+ * `HistoryEntryUrlSchema` による検証と変換を行う前の、入力値に対応する型定義です。
+ */
+export type HistoryEntryUrlLike = v.InferInput<ReturnType<typeof HistoryEntryUrlSchema>>;
+/**
+ * `HistoryEntryUrlSchema` による検証、並び替え、および変換が正常に完了した、安全な出力値の型定義です。
+ */
+export type HistoryEntryUrl = v.InferOutput<ReturnType<typeof HistoryEntryUrlSchema>>;
+export default HistoryEntryUrlSchema;
+//# sourceMappingURL=history-entry-url-schema.d.ts.map

package/dist/src/core/history-entry-url-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-entry-url-schema.d.ts","sourceRoot":"","sources":["../../../src/core/history-entry-url-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D;;;;GAIG;AACH,QAAA,MAAM,qBAAqB,wRAmBxB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAEtF,eAAe,qBAAqB,CAAC"}

package/dist/src/core/history-entry-url-schema.js

@@ -0,0 +1,20 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+import RoutePath from "./route-path.js";
+/**
+ * 履歴エントリーで使用される URL 文字列を検証、正規化、およびブランド化するためのスキーマを作成する関数です。
+ *
+ * スキーマの構築処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+const HistoryEntryUrlSchema = () => singleton("HistoryEntryUrlSchema", () => v.pipe(v.string(), v.url(), 
+// 検証を通過した URL 文字列を、読み取り専用の ReadonlyURL オブジェクトへと構造変換および正規化します。
+v.transform(function toNormalizedReadonlyURL(s) {
+    const u = new URL(s);
+    // 正規化します。
+    const { hash, search, pathname } = new RoutePath(u);
+    u.hash = hash;
+    u.search = search;
+    u.pathname = pathname;
+    return u;
+}), v.brand("HistoryEntryUrl")));
+export default HistoryEntryUrlSchema;

package/dist/src/core/init-loaders.d.ts

@@ -0,0 +1,28 @@
+import { NinjaPromise } from "ninja-promise";
+import type { HistoryEntryUrl } from "./history-entry-url-schema.js";
+import type { MatchedRoute } from "./match-routes.js";
+import type { LoaderFunction } from "./route.types.js";
+/**
+ * 各ローダー関数を初期化する際に必要となるリクエスト情報の型定義です。
+ */
+export type LoaderInitRequest = {
+    /**
+     * 読み込み対象となる現在の履歴エントリーの正規化済み URL オブジェクトです。
+     */
+    readonly url: HistoryEntryUrl;
+    /**
+     * 進行中の非同期データ取得処理を外部から中断するための中断シグナルです。
+     */
+    readonly signal: AbortSignal;
+};
+/**
+ * マッチしたすべてのルートに紐づくデータ取得用のローダー関数を一斉に起動し、その実行コンテキストと遅延非同期状態を管理するためのマップを作成して返す関数です。
+ *
+ * 階層的な並行データフェッチをサポートするために、各ローダーの実行結果を個別のプロミスとしてラップします。
+ *
+ * @param routes 現在の URL にマッチしたルート情報の配列です。各ルートから `loader` 関数と解析済みの `params` のみを抽出して利用します。
+ * @param request 各ローダー関数を初期化する際に必要となるリクエスト情報です。
+ * @returns 各ローダー関数をキーとし、その実行結果または進行状態を表す `NinjaPromise` を値としたマップです。
+ */
+export default function initLoaders(routes: readonly Pick<MatchedRoute, "loader" | "params">[], request: LoaderInitRequest): Map<LoaderFunction, NinjaPromise<unknown>>;
+//# sourceMappingURL=init-loaders.d.ts.map

package/dist/src/core/init-loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-loaders.d.ts","sourceRoot":"","sources":["../../../src/core/init-loaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,MAAM,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAC1D,OAAO,EAAE,iBAAiB,GACzB,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAsB5C"}

package/dist/src/core/init-loaders.js

@@ -0,0 +1,30 @@
+import { NinjaPromise } from "ninja-promise";
+import RouteRequest from "./route-request.js";
+/**
+ * マッチしたすべてのルートに紐づくデータ取得用のローダー関数を一斉に起動し、その実行コンテキストと遅延非同期状態を管理するためのマップを作成して返す関数です。
+ *
+ * 階層的な並行データフェッチをサポートするために、各ローダーの実行結果を個別のプロミスとしてラップします。
+ *
+ * @param routes 現在の URL にマッチしたルート情報の配列です。各ルートから `loader` 関数と解析済みの `params` のみを抽出して利用します。
+ * @param request 各ローダー関数を初期化する際に必要となるリクエスト情報です。
+ * @returns 各ローダー関数をキーとし、その実行結果または進行状態を表す `NinjaPromise` を値としたマップです。
+ */
+export default function initLoaders(routes, request) {
+    const dataMap = new Map();
+    // マッチしたすべてのローダーで共有可能なリクエストオブジェクトを 1 つだけ作成します。
+    // すべてのプロパティーが読み取り専用なので、ローダー間で共有できます。
+    const req = RouteRequest.new("GET", request.url, request.signal);
+    for (const { loader, params } of routes) {
+        if (typeof loader !== "function") {
+            continue;
+        }
+        const data = NinjaPromise.try(function executeLoader() {
+            return loader({
+                params,
+                request: req,
+            });
+        });
+        dataMap.set(loader, data);
+    }
+    return dataMap;
+}

package/dist/src/core/match-routes.d.ts

@@ -0,0 +1,28 @@
+import type { ReadonlyURL } from "./readonly-url.types.js";
+import type { Route, RoutePathParams } from "./route.types.js";
+/**
+ * URL とのマッチングが確認されたルート情報を表す型定義です。
+ *
+ * 基本となる `Route` オブジェクトの構造を引き継ぎつつ、抽出された動的パラメーターと、それらを埋め戻して構築された具体的な URL パス文字列が追加されています。
+ */
+export type MatchedRoute = Route & {
+    /**
+     * 現在の URL パスから抽出された、このルート固有の動的パスパラメーターです。
+     */
+    readonly params: RoutePathParams;
+    /**
+     * ルートの定義パターン（例: `/users/:id`）に抽出したパラメーター（例: `{ id: "42" }`）を流し込み、具現化されたリクエストパス（例: `/users/42`）です。
+     */
+    readonly urlPath: string;
+};
+/**
+ * 事前に詳細度順でソートされたルート定義の配列から、指定された URL に適合するすべてのルートを探索・抽出し、マッチした順に正規化して返す関数です。
+ *
+ * ネストされた階層的なルーティング構造において、親ルートから子ルートまで、現在の URL に部分一致または完全一致するルートの連鎖を構成する目的で使用します。
+ *
+ * @param routes あらかじめ正規化およびソートが完了しているルートオブジェクトの読み取り専用配列です。
+ * @param url マッチングの判定元となる、読み取り専用の URL オブジェクトです。
+ * @returns マッチしたルートが 1 つ以上存在する場合は、最低 1 つの要素を持つことが保証された `MatchedRoute` の読み取り専用タプル配列を返します。1 つもマッチしなかった場合は `null` を返します。
+ */
+export default function matchRoutes(routes: readonly Route[], url: ReadonlyURL): readonly [MatchedRoute, ...MatchedRoute[]] | null;
+//# sourceMappingURL=match-routes.d.ts.map

package/dist/src/core/match-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-routes.d.ts","sourceRoot":"","sources":["../../../src/core/match-routes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG;IACjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,GAAG,EAAE,WAAW,GACf,SAAS,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC,GAAG,IAAI,CAuBnD"}

package/dist/src/core/match-routes.js

@@ -0,0 +1,31 @@
+import { inject } from "regexparam";
+import matchRoutePath from "./_match-route-path.js";
+/**
+ * 事前に詳細度順でソートされたルート定義の配列から、指定された URL に適合するすべてのルートを探索・抽出し、マッチした順に正規化して返す関数です。
+ *
+ * ネストされた階層的なルーティング構造において、親ルートから子ルートまで、現在の URL に部分一致または完全一致するルートの連鎖を構成する目的で使用します。
+ *
+ * @param routes あらかじめ正規化およびソートが完了しているルートオブジェクトの読み取り専用配列です。
+ * @param url マッチングの判定元となる、読み取り専用の URL オブジェクトです。
+ * @returns マッチしたルートが 1 つ以上存在する場合は、最低 1 つの要素を持つことが保証された `MatchedRoute` の読み取り専用タプル配列を返します。1 つもマッチしなかった場合は `null` を返します。
+ */
+export default function matchRoutes(routes, url) {
+    const matched = [];
+    // 登録されているすべてのルートを前方から順番に走査します。
+    // routes 配列は詳細度が高い順に並んでいることが前提となります。
+    for (const route of routes) {
+        const result = matchRoutePath(route, url);
+        if (!result) {
+            continue;
+        }
+        matched.push({
+            ...route,
+            params: result.params,
+            urlPath: inject(route.path, result.params),
+        });
+    }
+    if (matched.length > 0) {
+        return matched;
+    }
+    return null;
+}

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

@@ -0,0 +1,74 @@
+/**
+ * フォームデータを読み取り専用で操作するためのインターフェースです。
+ *
+ * データの追加、削除、更新といった変更処理を禁止し、データの参照や走査のみを許可する目的で使用します。
+ *
+ * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData)
+ */
+export interface ReadonlyFormData {
+    /**
+     * 指定された名前に一致する最初のフォームデータの値を取得します。
+     *
+     * @param name 検索するフォームコントロールのキー名です。
+     * @returns 一致したデータを返します。データは文字列または `File` オブジェクトのいずれかです。指定された名前のキーが存在しない場合は `null` を返します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/get)
+     */
+    get(name: string): FormDataEntryValue | null;
+    /**
+     * 指定された名前に一致するすべてのフォームデータの値を配列として取得します。
+     *
+     * @param name 検索するフォームコントロールのキー名です。
+     * @returns 一致したすべてのデータを含む配列です。キーが存在しない場合は空の配列を返します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
+     */
+    getAll(name: string): FormDataEntryValue[];
+    /**
+     * 指定された名前を持つフォームデータが存在するかどうかを判定します。
+     *
+     * @param name 検証するフォームコントロールのキー名です。
+     * @returns 指定されたキーが存在する場合は `true` を、存在しない場合は `false` を返します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/has)
+     */
+    has(name: string): boolean;
+    /**
+     * コールバック関数を使用して、格納されているすべてのフォームデータに対して反復処理を実行します。
+     *
+     * @param callbackfn 各データに対して実行するコールバック関数です。
+     * @param thisArg コールバック関数を実行する際に `this` として使用する値です。
+     */
+    forEach(callbackfn: (value: FormDataEntryValue, key: string, parent: ReadonlyFormData) => void, thisArg?: any): void;
+    /**
+     * 格納されているすべてのキーと値のペアを順に処理するための反復子（イテレーター）を返します。
+     *
+     * @returns キーと値のペアを要素とする `IterableIterator` オブジェクトです。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/entries)
+     */
+    entries(): IterableIterator<[string, FormDataEntryValue]>;
+    /**
+     * 格納されているすべてのキー名を順に処理するための反復子を返します。
+     *
+     * @returns 各データのキー名を要素とする `IterableIterator` オブジェクトです。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/keys)
+     */
+    keys(): IterableIterator<string>;
+    /**
+     * 格納されているすべての値のみを順に処理するための反復子を返します。
+     *
+     * @returns 各データの値（文字列または `File` オブジェクト）を要素とする `IterableIterator` オブジェクトです。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/FormData/values)
+     */
+    values(): IterableIterator<FormDataEntryValue>;
+    /**
+     * オブジェクトの既定の反復子を定義します。 `for...of` 構文などで直接オブジェクトを走査することを可能にします。
+     *
+     * @returns `entries` メソッドと同様に、キーと値のペアを要素とする `IterableIterator` オブジェクトです。
+     */
+    [Symbol.iterator](): IterableIterator<[string, FormDataEntryValue]>;
+}
+//# sourceMappingURL=readonly-form-data.types.d.ts.map

package/dist/src/core/readonly-form-data.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-form-data.types.d.ts","sourceRoot":"","sources":["../../../src/core/readonly-form-data.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAE7C;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAE3C;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,EACtF,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAAC;IAER;;;;;;OAMG;IACH,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAE1D;;;;;;OAMG;IACH,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IAE/C;;;;OAIG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACrE"}

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

@@ -0,0 +1,164 @@
+/**
+ * 読み取り専用の URL 操作を行うためのインターフェースです。
+ *
+ * 標準の `URL` オブジェクトから、プロパティーへの代入による破壊的な変更を禁止し、安全な参照を可能にします。
+ *
+ * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL)
+ *
+ * [プロパティーの構成](https://nodejs.org/api/url.html#url-strings-and-url-objects)
+ */
+export interface ReadonlyURL {
+    /**
+     * URL のハッシュ（シャープ記号 `#` を含むフラグメント識別子）を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/hash)
+     */
+    readonly hash: string;
+    /**
+     * URL のホスト情報（ホスト名とポート番号 `hostname:port`）を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/host)
+     */
+    readonly host: string;
+    /**
+     * URL のホスト名を表します。ポート番号は含みません。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/hostname)
+     */
+    readonly hostname: string;
+    /**
+     * 完全にシリアライズされた URL 文字列全体を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/href)
+     */
+    readonly href: string;
+    /**
+     * URL のオリジン（プロトコル、ドメイン、およびポート番号）を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/origin)
+     */
+    readonly origin: string;
+    /**
+     * ドメインの前に指定されたパスワードを表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/password)
+     */
+    readonly password: string;
+    /**
+     * 最初のスラッシュ `/` から始まる URL のパス部分を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/pathname)
+     */
+    readonly pathname: string;
+    /**
+     * URL のポート番号を表します。デフォルトのポート番号である場合は空文字列を返します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/port)
+     */
+    readonly port: string;
+    /**
+     * 末尾のコロン `:` を含む URL のプロトコルスキームを表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/protocol)
+     */
+    readonly protocol: string;
+    /**
+     * 先頭のクエスチョンマーク `?` を含む URL のクエリー文字列を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/search)
+     */
+    readonly search: string;
+    /**
+     * クエリーパラメーターを操作するための読み取り専用オブジェクトを返します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
+     */
+    readonly searchParams: ReadonlyURLSearchParams;
+    /**
+     * ドメインの前に指定されたユーザー名を表します。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/username)
+     */
+    readonly username: string;
+    /**
+     * `href` プロパティーと同じシリアライズされた URL 文字列を返します。
+     *
+     * @returns URL の文字列表現です。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/toString)
+     */
+    toString(): string;
+    /**
+     * JSON シリアライズの際に呼び出され、`href` プロパティーと同じ文字列を返します。
+     *
+     * @returns URL の文字列表現です。
+     *
+     * [MDN リファレンス](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
+     */
+    toJSON(): string;
+}
+/**
+ * 読み取り専用の URL 検索パラメーターを操作するためのインターフェースです。
+ *
+ * `URLSearchParams` から破壊的な変更を行うメソッドを排除し、参照専用として定義しています。
+ *
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams)
+ */
+export interface ReadonlyURLSearchParams {
+    /**
+     * 検索パラメーターの総数です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size)
+     */
+    readonly size: number;
+    /**
+     * 指定された名前に関連付けられた最初のパラメーターの値を返します。
+     *
+     * 該当する名前が存在しない場合は `null` を返します。
+     *
+     * @param name 検索するパラメーターの名前です。
+     * @returns パラメーターの値、または `null` です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/get)
+     */
+    get(name: string): string | null;
+    /**
+     * 指定された名前に関連付けられたすべてのパラメーターの値を配列として返します。
+     *
+     * 該当する名前が存在しない場合は空の配列を返します。
+     *
+     * @param name 検索するパラメーターの名前です。
+     * @returns パラメーターの値を格納した文字列の配列です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/getAll)
+     */
+    getAll(name: string): string[];
+    /**
+     * 指定された名前（およびオプションで指定された値）に一致するパラメーターが存在するかどうかを判定します。
+     *
+     * @param name 判定するパラメーターの名前です。
+     * @param value 判定に含めるパラメーターの値です。
+     * @returns 一致するパラメーターが存在する場合は `true`、存在しない場合は `false` です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/has)
+     */
+    has(name: string, value?: string): boolean;
+    /**
+     * すべての検索パラメーターを URL エンコードされた文字列として返します。
+     *
+     * @returns URL エンコードされたパラメーター文字列です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/toString)
+     */
+    toString(): string;
+    /**
+     * 検索パラメーターに含まれるすべての要素に対して、指定されたコールバック関数を巡回して実行します。
+     *
+     * @param callbackfn 各要素に対して実行するコールバック関数です。
+     * @param thisArg コールバック関数の実行時に `this` として使用する値です。
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/forEach)
+     */
+    forEach(callbackfn: (value: string, key: string, parent: ReadonlyURLSearchParams) => void, thisArg?: any): void;
+}
+//# sourceMappingURL=readonly-url.types.d.ts.map

package/dist/src/core/readonly-url.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-url.types.d.ts","sourceRoot":"","sources":["../../../src/core/readonly-url.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAE/C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,IAAI,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;;;OASG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE/B;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3C;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;;;;;OAOG;IACH,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,KAAK,IAAI,EACjF,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAAC;CACT"}

package/dist/src/core/redirect-response.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 他のクラスやオブジェクトとの混同を避けるための、このクラス固有の一意の識別シンボル（名目的型付け用）です。
+ */
+declare const REDIRECT_RESPONSE_SYMBOL: unique symbol;
+/**
+ * アプリケーション内におけるリダイレクト（画面遷移）の応答を表す不変のデータ構造クラスです。
+ *
+ * アクションやローダーの処理過程で遷移要求が発生した際、その移動先となるリダイレクトパスの各コンポーネント（パス名、クエリー、ハッシュフラグメント）を解析・保持します。
+ */
+export default class RedirectResponse {
+    /**
+     * クラスの型としてのユニーク性を TypeScript 上で強制するためのダミーの読み取り専用プロパティーです。
+     *
+     * 構造が部分的に一致するだけの他のオブジェクトによる誤入力を防ぎます。
+     */
+    readonly [REDIRECT_RESPONSE_SYMBOL]: never;
+    /**
+     * 遷移先 URL のハッシュフラグメントです。
+     */
+    readonly hash: string;
+    /**
+     * 遷移先 URL のクエリー文字列です。
+     */
+    readonly search: string;
+    /**
+     * 遷移先 URL のドメイン部分を除いたパスです。
+     */
+    readonly pathname: string;
+    /**
+     * 指定された遷移先パス文字列を解析し、`RedirectResponse` クラスの新しいインスタンスを初期化します。
+     *
+     * @param destination リダイレクト先となる対象のパスです。
+     */
+    constructor(destination: string);
+}
+export {};
+//# sourceMappingURL=redirect-response.d.ts.map

package/dist/src/core/redirect-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-response.d.ts","sourceRoot":"","sources":["../../../src/core/redirect-response.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,OAAO,CAAC,MAAM,wBAAwB,EAAE,OAAO,MAAM,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC;;;;OAIG;IACH,SAAgB,CAAC,wBAAwB,CAAC,EAAG,KAAK,CAAC;IAEnD;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;gBACgB,WAAW,EAAE,MAAM;CAMvC"}

package/dist/src/core/redirect-response.js

@@ -0,0 +1,19 @@
+import RoutePath from "./route-path.js";
+/**
+ * アプリケーション内におけるリダイレクト（画面遷移）の応答を表す不変のデータ構造クラスです。
+ *
+ * アクションやローダーの処理過程で遷移要求が発生した際、その移動先となるリダイレクトパスの各コンポーネント（パス名、クエリー、ハッシュフラグメント）を解析・保持します。
+ */
+export default class RedirectResponse {
+    /**
+     * 指定された遷移先パス文字列を解析し、`RedirectResponse` クラスの新しいインスタンスを初期化します。
+     *
+     * @param destination リダイレクト先となる対象のパスです。
+     */
+    constructor(destination) {
+        const { hash, search, pathname } = new RoutePath(destination);
+        this.hash = hash;
+        this.search = search;
+        this.pathname = pathname;
+    }
+}

package/dist/src/core/route-path.d.ts

@@ -0,0 +1,57 @@
+import type { ReadonlyURL } from "./readonly-url.types.js";
+/**
+ * アプリケーション内のルーティングにおけるパスを安全に構築・解析・操作するためのクラスです。
+ *
+ * 内包するホストやプロトコルといった余分な情報を排除し、パス、クエリー、ハッシュのみを一貫した規則で管理します。
+ */
+export default class RoutePath {
+    /**
+     * 与えられた文字列または URL オブジェクトから、正規化されたパス文字列を即座に生成する静的メソッドです。
+     *
+     * @param path 正規化の対象となるパス文字列、または `ReadonlyURL` の一部分を構成するオブジェクトです。
+     * @returns 冗長なスラッシュや末尾のスラッシュが取り除かれた、結合済みのパス文字列を返します。
+     */
+    static encode(path: string | Pick<ReadonlyURL, "pathname" | "search" | "hash">): string;
+    /**
+     * 内部でパスコンポーネントの解析と検証を委譲するために保持する、組み込みの `URL` インスタンスです。
+     *
+     * 基底となる仮想的なオリジンと結合して管理されます。
+     */
+    private url;
+    /**
+     * 新しい `RoutePath` インスタンスを初期化します。
+     *
+     * 引数として渡された入力値を解析し、スラッシュの重複排除および末尾のスラッシュ削除を自動的に行います。
+     *
+     * @param path 初期化に使用するパス文字列、または `ReadonlyURL` の一部のプロパティーを持つオブジェクトです。既定値は空文字列です。
+     */
+    constructor(path?: string | Pick<ReadonlyURL, "pathname" | "search" | "hash">);
+    /**
+     * 正規化されたパス部分の文字列です。
+     */
+    get pathname(): string;
+    set pathname(value: string);
+    /**
+     * 先頭に `?` を含むクエリー文字列です。
+     *
+     * 常にソートされます。
+     */
+    get search(): string;
+    set search(value: string);
+    /**
+     * 内部の `URL` インスタンスが保持する、クエリーパラメーターを操作するための `URLSearchParams` オブジェクトを取得します。
+     */
+    get searchParams(): URLSearchParams;
+    /**
+     * 先頭に `#` を含むハッシュ文字列を取得します。
+     */
+    get hash(): string;
+    set hash(value: string);
+    /**
+     * 現在保持しているすべてのコンポーネントを結合し、ルーティング用のパス文字列として出力します。
+     *
+     * @returns ソート済みのクエリーおよびハッシュを含んだ、正規化されたパス全体の文字列を返します。
+     */
+    toString(): string;
+}
+//# sourceMappingURL=route-path.d.ts.map

package/dist/src/core/route-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-path.d.ts","sourceRoot":"","sources":["../../../src/core/route-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAO3D;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAC5B;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG,MAAM;IAI9F;;;;OAIG;IACH,OAAO,CAAC,GAAG,CAAM;IAEjB;;;;;;OAMG;gBACgB,IAAI,GAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAM;IAkBxF;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAQhC;IAED;;;;OAIG;IACH,IAAW,MAAM,IAAI,MAAM,CAG1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAE9B;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,eAAe,CAEzC;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAE5B;IAED;;;;OAIG;IACI,QAAQ,IAAI,MAAM;CAI1B"}

package/dist/src/core/route-path.js

@@ -0,0 +1,93 @@
+/**
+ * 連続する複数のスラッシュを検出するための正規表現です。
+ */
+const MULTI_SLASH = /\/\/+/gu;
+/**
+ * アプリケーション内のルーティングにおけるパスを安全に構築・解析・操作するためのクラスです。
+ *
+ * 内包するホストやプロトコルといった余分な情報を排除し、パス、クエリー、ハッシュのみを一貫した規則で管理します。
+ */
+export default class RoutePath {
+    /**
+     * 与えられた文字列または URL オブジェクトから、正規化されたパス文字列を即座に生成する静的メソッドです。
+     *
+     * @param path 正規化の対象となるパス文字列、または `ReadonlyURL` の一部分を構成するオブジェクトです。
+     * @returns 冗長なスラッシュや末尾のスラッシュが取り除かれた、結合済みのパス文字列を返します。
+     */
+    static encode(path) {
+        return new RoutePath(path).toString();
+    }
+    /**
+     * 新しい `RoutePath` インスタンスを初期化します。
+     *
+     * 引数として渡された入力値を解析し、スラッシュの重複排除および末尾のスラッシュ削除を自動的に行います。
+     *
+     * @param path 初期化に使用するパス文字列、または `ReadonlyURL` の一部のプロパティーを持つオブジェクトです。既定値は空文字列です。
+     */
+    constructor(path = "") {
+        if (typeof path === "string") {
+            path = ("/" + path).replace(MULTI_SLASH, "/");
+        }
+        else {
+            const { hash, search, pathname } = path;
+            path = ("/" + pathname).replace(MULTI_SLASH, "/") + search + hash;
+        }
+        // 組み込みの URL クラスによる厳密な解析機能を利用するため、仮想のプロトコルとホストを前置きして初期化します。
+        this.url = new URL("x://y" + path);
+        // ルートパス（/）単体である場合を除き、末尾に存在する不要なスラッシュを削除して一貫性を保ちます。
+        const { pathname } = this.url;
+        if (pathname !== "/" && pathname.endsWith("/")) {
+            this.url.pathname = pathname.substring(0, pathname.length - 1);
+        }
+    }
+    /**
+     * 正規化されたパス部分の文字列です。
+     */
+    get pathname() {
+        return this.url.pathname;
+    }
+    set pathname(value) {
+        this.url.pathname = value;
+        // ルートパス（/）単体である場合を除き、末尾に存在する不要なスラッシュを削除して一貫性を保ちます。
+        const pathname = ("/" + this.url.pathname).replace(MULTI_SLASH, "/");
+        if (pathname !== "/" && pathname.endsWith("/")) {
+            this.url.pathname = pathname.substring(0, pathname.length - 1);
+        }
+    }
+    /**
+     * 先頭に `?` を含むクエリー文字列です。
+     *
+     * 常にソートされます。
+     */
+    get search() {
+        this.url.searchParams.sort();
+        return this.url.search;
+    }
+    set search(value) {
+        this.url.search = value;
+    }
+    /**
+     * 内部の `URL` インスタンスが保持する、クエリーパラメーターを操作するための `URLSearchParams` オブジェクトを取得します。
+     */
+    get searchParams() {
+        return this.url.searchParams;
+    }
+    /**
+     * 先頭に `#` を含むハッシュ文字列を取得します。
+     */
+    get hash() {
+        return this.url.hash;
+    }
+    set hash(value) {
+        this.url.hash = value;
+    }
+    /**
+     * 現在保持しているすべてのコンポーネントを結合し、ルーティング用のパス文字列として出力します。
+     *
+     * @returns ソート済みのクエリーおよびハッシュを含んだ、正規化されたパス全体の文字列を返します。
+     */
+    toString() {
+        const { hash, search, pathname } = this;
+        return pathname + search + hash;
+    }
+}