soseki 0.0.9 → 0.0.11

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

@@ -1 +1 @@
-{"version":3,"file":"_process-routes.d.ts","sourceRoot":"","sources":["../../../src/core/_process-routes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,KAAK,EAAE,CAoC1F"}
+{"version":3,"file":"_process-routes.d.ts","sourceRoot":"","sources":["../../../src/core/_process-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,KAAK,EAAE,CAiC1F"}

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

@@ -1,6 +1,5 @@
-import { parse } from "regexparam";
 import compareRoutePaths from "./_compare-route-paths.js";
-import RoutePath from "./route-path.js";
+import RoutePatternUtils from "./route-pattern-utils.js";
 /**
  * 定義したルーティング設定の配列を、内部のルーティングエンジンが直接利用可能な正規化済みのルートオブジェクトの配列へと変換します。
  *
@@ -15,15 +14,16 @@ import RoutePath from "./route-path.js";
 export default function processRoutes(routes) {
     return (routes
         .map((route) => {
-        const path = RoutePath.encode(route.path);
         const index = route.index === true;
-        const { keys: paramKeys, pattern: pathPattern } = parse(path, 
-        // インデックスルートでないとき loose オプションを `true` にして子ルートに対してもマッチするようにします。
-        // これにより、前方一致による階層的なマッチングが有効になります。
-        !index);
+        const utils = new RoutePatternUtils(route.path, {
+            // インデックスルートでないとき allowChild オプションを `true` にして子ルートに対してもマッチするようにします。
+            // これにより、前方一致による階層的なマッチングが有効になります。
+            allowChild: !index,
+        });
         return {
-            path,
+            path: utils.route,
             index,
+            utils,
             action: route.action,
             loader: route.loader,
             // オブジェクト形式またはモジュール形式の双方を安全に評価し、描画対象となる React コンポーネントを確定します。
@@ -34,8 +34,6 @@ export default function processRoutes(routes) {
                     typeof route.default === "function"
                     ? route.default
                     : undefined,
-            paramKeys,
-            pathPattern,
             shouldReload: route.shouldReload || ((args) => args.defaultShouldReload),
         };
     })

package/dist/src/core/_regexparam.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 個別のパスパラメーターを解析し、適切なプロパティーの型オブジェクトへと変換する内部ユーティリティー型です。
+ *
+ * パラメーターの末尾の形状を条件付き型により詳細に選別します。
+ *
+ * @template Param 解析対象となる単一のパラメーター文字列です。
+ */
+type ParamRecord<Param extends string> = Param extends `${infer Name}?` ? {
+    [K in Name]?: string;
+} : Param extends `${infer Name}.${string}` ? {
+    [K in Name]: string;
+} : {
+    [K in Param]: string;
+};
+/**
+ * パス文字列のセグメントから動的なパラメーターやワイルドカードを再帰的に抽出し、型安全なオブジェクト構造を構築するユーティリティー型です。
+ *
+ * 開発者が指定した文字列リテラル型の形状に基づいて、ルーティングに必要なパラメーターの型を静的に決定します。
+ *
+ * このユーティリティー型は、ライブラリー `regexparam` の改良版です。
+ *
+ * @template T 解析対象となる URL パス全体の文字列リテラル型です。
+ * @see https://github.com/lukeed/regexparam
+ * @see https://github.com/lukeed/regexparam/issues/31
+ * @see https://github.com/lukeed/regexparam/pull/33
+ */
+export type RouteParams<T extends string> = string extends T ? {
+    [K in string]?: string;
+} : T extends `${infer Prev}/*/${infer Rest}` ? RouteParams<Prev> & {
+    wild: string;
+} & RouteParams<`/${Rest}`> : T extends `:${infer Rest}` ? RouteParams<`/:${Rest}`> : T extends `${string}:${infer Param}/${infer Rest}` ? ParamRecord<Param> & RouteParams<`/${Rest}`> : T extends `${string}/:${infer Param}` ? ParamRecord<Param> : T extends `${string}/*?` ? {
+    "*"?: string;
+} : T extends `${string}/*` ? {
+    "*": string;
+} : {};
+export {};
+//# sourceMappingURL=_regexparam.d.ts.map

package/dist/src/core/_regexparam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_regexparam.d.ts","sourceRoot":"","sources":["../../../src/core/_regexparam.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,WAAW,CAAC,KAAK,SAAS,MAAM,IAEjC,KAAK,SAAS,GAAG,MAAM,IAAI,GAAG,GAC5B;KAAG,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM;CAAE,GAG1B,KAAK,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,EAAE,GACrC;KAAG,CAAC,IAAI,IAAI,GAAG,MAAM;CAAE,GAGzB;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM;CAAE,CAAC;AAE7B;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAEpC,MAAM,SAAS,CAAC,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM;CAAE,GAG5B,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,MAAM,IAAI,EAAE,GACrC,WAAW,CAAC,IAAI,CAAC,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,GAG3B,CAAC,SAAS,IAAI,MAAM,IAAI,EAAE,GACxB,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,GAG1B,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GAC9C,WAAW,CAAC,KAAK,CAAC,GAClB,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,GAG3B,CAAC,SAAS,GAAG,MAAM,KAAK,MAAM,KAAK,EAAE,GACnC,WAAW,CAAC,KAAK,CAAC,GAGpB,CAAC,SAAS,GAAG,MAAM,KAAK,GACtB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAGlB,CAAC,SAAS,GAAG,MAAM,IAAI,GACrB;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAGjB,EAAE,CAAC"}

package/dist/src/core/_regexparam.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/errors.d.ts

@@ -179,4 +179,33 @@ export declare class LoaderDataNotFoundError extends ErrorBase<LoaderDataNotFoun
      */
     constructor(args: LoaderDataNotFoundErrorArgs);
 }
+/**************************************************************************************************/
+/**
+ * ローダーデータの紛失を通知する際に付与されるメタデータの型定義です。
+ */
+export type RoutePatternMismatchErrorMeta = {
+    /**
+     * ルートパターン文字列です。
+     */
+    readonly route: string;
+    /**
+     * 検証対象のパス文字列です。
+     */
+    readonly target: string;
+};
+/**
+ * `RoutePatternMismatchError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type RoutePatternMismatchErrorArgs = ErrorOptions & RoutePatternMismatchErrorMeta;
+/**
+ * 対象のパスまたは URL が、指定されたルートパターンに一致しない場合に投げるエラーです。
+ */
+export declare class RoutePatternMismatchError extends ErrorBase<RoutePatternMismatchErrorMeta> {
+    /**
+     * `RoutePatternMismatchError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args 引数オブジェクトです。
+     */
+    constructor(args: RoutePatternMismatchErrorArgs);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/src/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/src/core/errors.js

@@ -1,4 +1,4 @@
-var _a, _b, _c, _d, _e, _f, _g;
+var _a, _b, _c, _d, _e, _f, _g, _h;
 import { I18nErrorBase, setErrorMessage } from "i18n-error-base";
 import { inspect } from "inspect-lite";
 import { isThenable } from "maypromise";
@@ -164,3 +164,22 @@ _g = LoaderDataNotFoundError;
 /*#__PURE__*/ setErrorMessage(LoaderDataNotFoundError, ({ loader }) => loader
     ? `ローダーデータが見つかりません（関数名: ${loader.name || "匿名"}）`
     : "ローダーが未定義です。", "ja");
+/**
+ * 対象のパスまたは URL が、指定されたルートパターンに一致しない場合に投げるエラーです。
+ */
+export class RoutePatternMismatchError extends ErrorBase {
+    /**
+     * `RoutePatternMismatchError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args 引数オブジェクトです。
+     */
+    constructor(args) {
+        const { route, target, ...options } = args;
+        super({ route, target }, ({ route, target }) => `The target path "${target}" does not match the route pattern "${route}"`, options);
+    }
+}
+_h = RoutePatternMismatchError;
+(() => {
+    _h.prototype.name = "SosekiRoutePatternMismatchError";
+})();
+/*#__PURE__*/ setErrorMessage(RoutePatternMismatchError, ({ route, target }) => `対象パス "${target}" がパターン "${route}" と一致しません`, "ja");

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

@@ -1,5 +1,5 @@
 import type { ReadonlyURL } from "./readonly-url.types.js";
-import type { Route, RoutePathParams } from "./route.types.js";
+import type { Route, RouteParams } from "./route.types.js";
 /**
  * URL とのマッチングが確認されたルート情報を表す型定義です。
  *
@@ -9,7 +9,7 @@ export type MatchedRoute = Route & {
     /**
      * 現在の URL パスから抽出された、このルート固有の動的パスパラメーターです。
      */
-    readonly params: RoutePathParams;
+    readonly params: RouteParams;
     /**
      * ルートの定義パターン（例: `/users/:id`）に抽出したパラメーター（例: `{ id: "42" }`）を流し込み、具現化されたリクエストパス（例: `/users/42`）です。
      */

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

@@ -1 +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"}
+{"version":3,"file":"match-routes.d.ts","sourceRoot":"","sources":["../../../src/core/match-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG;IACjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;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

@@ -1,5 +1,3 @@
-import { inject } from "regexparam";
-import matchRoutePath from "./_match-route-path.js";
 /**
  * 事前に詳細度順でソートされたルート定義の配列から、指定された URL に適合するすべてのルートを探索・抽出し、マッチした順に正規化して返す関数です。
  *
@@ -14,14 +12,14 @@ export default function matchRoutes(routes, url) {
     // 登録されているすべてのルートを前方から順番に走査します。
     // routes 配列は詳細度が高い順に並んでいることが前提となります。
     for (const route of routes) {
-        const result = matchRoutePath(route, url);
-        if (!result) {
+        const params = route.utils.parseSafe(url);
+        if (params === null) {
             continue;
         }
         matched.push({
             ...route,
-            params: result.params,
-            urlPath: inject(route.path, result.params),
+            params,
+            urlPath: route.utils.inject(params),
         });
     }
     if (matched.length > 0) {

package/dist/src/core/route-pattern-utils.d.ts

@@ -0,0 +1,163 @@
+import type { RouteParams } from "./_regexparam.js";
+/**
+ * 対象の型プロパティーをすべて任意とし、さらに各プロパティー値に undefined を許容する型です。
+ *
+ * @template T オブジェクトの型定義です。
+ */
+type Optional<T> = {
+    readonly [P in keyof T]?: T[P] | undefined;
+};
+/**
+ * ルートパターンの照合処理において、URL の文字列情報を抽出するためのインターフェースです。
+ */
+export interface RoutePatternMatchURL {
+    /**
+     * ホスト名を除いた URL パス全体の文字列を表します。
+     */
+    readonly pathname: string;
+}
+/**
+ * ルートパターンを解析および処理する際の挙動を設定するオプションです。
+ */
+export type RoutePatternUtilsOptions = {
+    /**
+     * 子ディレクトリーへの前方一致を許可するかどうかを制御するフラグです。下位パスが存在する場合にも一致とみなす場合に true を指定します。
+     *
+     * @default false
+     */
+    readonly allowChild?: boolean | undefined;
+};
+/**
+ * ルートパターンの解析などを行うユーティリティークラスです。
+ *
+ * @template TRoutePattern リテラル型で固定されたルートパターンの文字列定義です。
+ */
+export default class RoutePatternUtils<const TRoutePattern extends string = string> {
+    /**
+     * ルートパターンと対象のパスが一致するかどうかを静的に検証します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 検証対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 一致する場合は true、一致しない場合は false です。
+     */
+    static match<const TRoutePattern extends string>(routePattern: TRoutePattern, target: string | RoutePatternMatchURL, options: RoutePatternUtilsOptions): boolean;
+    /**
+     * 静的な解析を行い、対象のパスからパラメーターを抽出します。一致しない場合はエラーを投げます。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 抽出されたパラメーターオブジェクトです。
+     */
+    static parse<const TRoutePattern extends string>(routePattern: TRoutePattern, target: string | RoutePatternMatchURL, options: RoutePatternUtilsOptions): RouteParams<TRoutePattern>;
+    /**
+     * 静的な埋め込みを行い、ルートパターンにパラメーターを適用してパスを生成します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param params 埋め込むパラメーターのキーと値の組み合わせです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns パラメーターが適用された新しいパス文字列です。
+     */
+    static inject<const TRoutePattern extends string>(routePattern: TRoutePattern, params: Readonly<RouteParams<TRoutePattern>>, options: RoutePatternUtilsOptions): string;
+    /**
+     * 対象のパスに含まれるパラメーターの一部を指定された値で置き換えて、新しいパスを静的に生成します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 既存のパス文字列またはオブジェクトです。
+     * @param params 上書きするパラメーターです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 置き換え後のパス文字列です。
+     */
+    static replace<const TRoutePattern extends string>(routePattern: TRoutePattern, target: string | RoutePatternMatchURL, params: Optional<RouteParams<TRoutePattern>>, options: RoutePatternUtilsOptions): string;
+    /**
+     * 静的な解析を行い、対象のパスからパラメーターを安全に抽出します。一致しない場合は null を返します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 抽出されたパラメーターオブジェクト、一致しない場合は null です。
+     */
+    static parseSafe<const TRoutePattern extends string>(routePattern: TRoutePattern, target: string | RoutePatternMatchURL, options: RoutePatternUtilsOptions): RouteParams<TRoutePattern> | null;
+    /**
+     * 対象のパスに含まれるパラメーターの一部を指定された値で安全に置き換えます。不一致の場合は null を返します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 既存のパス文字列またはオブジェクトです。
+     * @param params 上書きするパラメーターです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 置き換え後のパス文字列、不一致の場合は null です。
+     */
+    static replaceSafe<const TRoutePattern extends string>(routePattern: TRoutePattern, target: string | RoutePatternMatchURL, params: Optional<RouteParams<TRoutePattern>>, options: RoutePatternUtilsOptions): string | null;
+    /**
+     * インスタンスに保持されるルートパターン文字列です。
+     */
+    readonly route: string;
+    /**
+     * ルートパターンのマッチングとパラメーター抽出に使用する正規表現オブジェクトです。
+     */
+    readonly pattern: RegExp;
+    /**
+     * ルートパターンから抽出されたパラメーター名の配列です。
+     */
+    readonly paramKeys: readonly Extract<keyof RouteParams<TRoutePattern>, string>[];
+    /**
+     * 新しい `RoutePatternUtils` インスタンスを作成します。
+     *
+     * @param routePattern 解析基準となるルートパターンです。
+     * @param options 前方一致などを制御するオプションです。
+     */
+    constructor(routePattern: TRoutePattern, options?: RoutePatternUtilsOptions);
+    /**
+     * パスが構築時のルートパターンに一致するかどうかを評価します。
+     *
+     * @param target 検証対象のパス文字列またはオブジェクトです。
+     * @returns パターンに合致する場合は true、それ以外は false です。
+     */
+    match(target: string | RoutePatternMatchURL): boolean;
+    /**
+     * インスタンスのルートパターンを基に対象パスからパラメーターを抽出します。解析できない場合は、処理が継続できないため例外を投げます。
+     *
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @returns 抽出したパラメーターオブジェクトです。
+     */
+    parse(target: string | RoutePatternMatchURL): RouteParams<TRoutePattern>;
+    /**
+     * 指定されたパラメーター群をルートパターンに埋め込んで、具体的なパス文字列を構築します。
+     *
+     * @param params パラメーターのキーと値のオブジェクトです。
+     * @returns 生成されたパス文字列です。
+     */
+    inject(params: Readonly<RouteParams<TRoutePattern>>): string;
+    /**
+     * 現在のパスに含まれるパラメーター値の一部を、指定された値で上書きした新しいパスを構築します。対象パスがルートパターンと一致しない場合は例外を投げます。
+     *
+     * @param target 基準となる現在のパス文字列またはオブジェクトです。
+     * @param params 変更を適用する一部のパラメーターです。
+     * @returns 新しく生成されたパス文字列です。
+     */
+    replace(target: string | RoutePatternMatchURL, params: Optional<RouteParams<TRoutePattern>>): string;
+    /**
+     * パターンに基づきパスの解析を行い、プレースホルダーに該当する箇所をオブジェクトとして抽出します。
+     *
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @returns 抽出に成功した場合はパラメーターのオブジェクト、不一致の場合は null です。
+     */
+    parseSafe(target: string | RoutePatternMatchURL): RouteParams<TRoutePattern> | null;
+    /**
+     * 既存のパスから抽出されたパラメーター値をベースとして、任意のパラメーターのみを上書きしたパス文字列を再構築します。
+     *
+     * @param target 基にするパス文字列またはオブジェクトです。
+     * @param params 上書き指定するパラメーターオブジェクトです。
+     * @returns 再構築されたパス文字列、パスが不一致の場合は null です。
+     */
+    replaceSafe(target: string | RoutePatternMatchURL, params: Optional<RouteParams<TRoutePattern>>): string | null;
+}
+export {};
+//# sourceMappingURL=route-pattern-utils.d.ts.map

package/dist/src/core/route-pattern-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-pattern-utils.d.ts","sourceRoot":"","sources":["../../../src/core/route-pattern-utils.ts"],"names":[],"mappings":"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"}

package/dist/src/core/route-pattern-utils.js

@@ -0,0 +1,222 @@
+import { inject, parse } from "regexparam";
+import { RoutePatternMismatchError } from "./errors.js";
+import RoutePath from "./route-path.js";
+/**
+ * 引数に渡された対象から URL パスを取得し、一貫した形式に正規化します。
+ *
+ * @param target 文字列または URL 情報を持つオブジェクトです。
+ * @returns 正規化されたパス文字列です。
+ */
+function normalizeTarget(target) {
+    return new RoutePath(typeof target === "string" ? target : target.pathname).pathname;
+}
+/**
+ * ルートパターンの解析などを行うユーティリティークラスです。
+ *
+ * @template TRoutePattern リテラル型で固定されたルートパターンの文字列定義です。
+ */
+export default class RoutePatternUtils {
+    /**
+     * ルートパターンと対象のパスが一致するかどうかを静的に検証します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 検証対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 一致する場合は true、一致しない場合は false です。
+     */
+    static match(routePattern, target, options) {
+        return new RoutePatternUtils(routePattern, options).match(target);
+    }
+    /**
+     * 静的な解析を行い、対象のパスからパラメーターを抽出します。一致しない場合はエラーを投げます。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 抽出されたパラメーターオブジェクトです。
+     */
+    static parse(routePattern, target, options) {
+        return new RoutePatternUtils(routePattern, options).parse(target);
+    }
+    /**
+     * 静的な埋め込みを行い、ルートパターンにパラメーターを適用してパスを生成します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param params 埋め込むパラメーターのキーと値の組み合わせです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns パラメーターが適用された新しいパス文字列です。
+     */
+    static inject(routePattern, params, options) {
+        return new RoutePatternUtils(routePattern, options).inject(params);
+    }
+    // public static partialInject<const TRoutePattern extends string>(
+    //   routePattern: TRoutePattern,
+    //   params: Optional<RouteParams<TRoutePattern>>,
+    //   options: RoutePatternUtilsOptions = {},
+    // ): string {}
+    /**
+     * 対象のパスに含まれるパラメーターの一部を指定された値で置き換えて、新しいパスを静的に生成します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 既存のパス文字列またはオブジェクトです。
+     * @param params 上書きするパラメーターです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 置き換え後のパス文字列です。
+     */
+    static replace(routePattern, target, params, options) {
+        return new RoutePatternUtils(routePattern, options).replace(target, params);
+    }
+    /**
+     * 静的な解析を行い、対象のパスからパラメーターを安全に抽出します。一致しない場合は null を返します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 抽出されたパラメーターオブジェクト、一致しない場合は null です。
+     */
+    static parseSafe(routePattern, target, options) {
+        return new RoutePatternUtils(routePattern, options).parseSafe(target);
+    }
+    // public static injectSafe<const TRoutePattern extends string>(
+    //   routePattern: TRoutePattern,
+    //   params: Readonly<RouteParams<TRoutePattern>>,
+    //   options: RoutePatternUtilsOptions = {},
+    // ): string | null {}
+    /**
+     * 対象のパスに含まれるパラメーターの一部を指定された値で安全に置き換えます。不一致の場合は null を返します。
+     *
+     * @template TRoutePattern パターンの文字列型です。
+     * @param routePattern 基準となるルートパターン文字列です。
+     * @param target 既存のパス文字列またはオブジェクトです。
+     * @param params 上書きするパラメーターです。
+     * @param options 解析時の振る舞いを制御するオプションです。
+     * @returns 置き換え後のパス文字列、不一致の場合は null です。
+     */
+    static replaceSafe(routePattern, target, params, options) {
+        return new RoutePatternUtils(routePattern, options).replaceSafe(target, params);
+    }
+    /**
+     * 新しい `RoutePatternUtils` インスタンスを作成します。
+     *
+     * @param routePattern 解析基準となるルートパターンです。
+     * @param options 前方一致などを制御するオプションです。
+     */
+    constructor(routePattern, options = {}) {
+        const { keys, pattern } = parse(routePattern, options.allowChild);
+        this.route = routePattern;
+        this.pattern = pattern;
+        this.paramKeys = keys;
+    }
+    /**
+     * パスが構築時のルートパターンに一致するかどうかを評価します。
+     *
+     * @param target 検証対象のパス文字列またはオブジェクトです。
+     * @returns パターンに合致する場合は true、それ以外は false です。
+     */
+    match(target) {
+        target = normalizeTarget(target);
+        return this.pattern.test(target);
+    }
+    /**
+     * インスタンスのルートパターンを基に対象パスからパラメーターを抽出します。解析できない場合は、処理が継続できないため例外を投げます。
+     *
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @returns 抽出したパラメーターオブジェクトです。
+     */
+    parse(target) {
+        const params = this.parseSafe(target);
+        if (params === null) {
+            throw new RoutePatternMismatchError({
+                route: this.route,
+                target: normalizeTarget(target),
+            });
+        }
+        return params;
+    }
+    /**
+     * 指定されたパラメーター群をルートパターンに埋め込んで、具体的なパス文字列を構築します。
+     *
+     * @param params パラメーターのキーと値のオブジェクトです。
+     * @returns 生成されたパス文字列です。
+     */
+    inject(params) {
+        return inject(this.route, params);
+    }
+    // public partialInject(params: Optional<RouteParams<TRoutePattern>>): string {}
+    /**
+     * 現在のパスに含まれるパラメーター値の一部を、指定された値で上書きした新しいパスを構築します。対象パスがルートパターンと一致しない場合は例外を投げます。
+     *
+     * @param target 基準となる現在のパス文字列またはオブジェクトです。
+     * @param params 変更を適用する一部のパラメーターです。
+     * @returns 新しく生成されたパス文字列です。
+     */
+    replace(target, params) {
+        const replaced = this.replaceSafe(target, params);
+        if (replaced === null) {
+            throw new RoutePatternMismatchError({
+                route: this.route,
+                target: normalizeTarget(target),
+            });
+        }
+        return replaced;
+    }
+    /**
+     * パターンに基づきパスの解析を行い、プレースホルダーに該当する箇所をオブジェクトとして抽出します。
+     *
+     * @param target 解析対象のパス文字列またはオブジェクトです。
+     * @returns 抽出に成功した場合はパラメーターのオブジェクト、不一致の場合は null です。
+     */
+    parseSafe(target) {
+        target = normalizeTarget(target);
+        const matches = this.pattern.exec(target);
+        if (!matches) {
+            return null;
+        }
+        const params = {};
+        for (let i = 0, param; i < this.paramKeys.length; i++) {
+            // exec メソッドの戻り値のインデックス 0 にはマッチした文字列全体が格納されているため、各パラメーターの値はインデックス 1 以降（i + 1）から取得します。
+            param = matches[i + 1];
+            // キャプチャーされたセグメントが存在し、かつ文字列型である場合にのみ、対応するパラメーターキーと値をマッピングします。
+            // オプショナルなパラメーターが URL 側で省略されている場合は undefined となるため、この条件節により除外されます。
+            if (typeof param === "string") {
+                params[this.paramKeys[i]] = param;
+            }
+        }
+        return params;
+    }
+    // public injectSafe(params: Readonly<RouteParams<TRoutePattern>>): string | null {
+    //   if (!this.paramKeys.every((key) => key in params && typeof params[key] === "string")) {
+    //     return null;
+    //   }
+    //   return inject(this.route, params);
+    // }
+    /**
+     * 既存のパスから抽出されたパラメーター値をベースとして、任意のパラメーターのみを上書きしたパス文字列を再構築します。
+     *
+     * @param target 基にするパス文字列またはオブジェクトです。
+     * @param params 上書き指定するパラメーターオブジェクトです。
+     * @returns 再構築されたパス文字列、パスが不一致の場合は null です。
+     */
+    replaceSafe(target, params) {
+        const defaults = this.parseSafe(target);
+        if (defaults === null) {
+            return null;
+        }
+        const values = {};
+        for (const key of this.paramKeys) {
+            const param = params[key];
+            if (typeof param === "string") {
+                values[key] = param;
+            }
+            else {
+                values[key] = defaults[key];
+            }
+        }
+        return inject(this.route, values);
+    }
+}