soseki 0.0.5 → 0.0.7

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

@@ -0,0 +1,63 @@
+import { NinjaPromise } from "ninja-promise";
+import type { HistoryEntry } from "./expect-history-entry.js";
+import type { HistoryEntryId } from "./history-entry-id-schema.js";
+import type { MatchedRoute } from "./match-routes.js";
+import type { LoaderFunction } from "./route.types.js";
+/**
+ * `startLoaders` 関数を実行する際に必要となる引数オブジェクトの型定義です。
+ */
+export type StartLoadersArgs = {
+    /**
+     * 遷移前にマッチしていたルート情報の配列です。
+     */
+    readonly prevRoutes: readonly Pick<MatchedRoute, "path" | "params">[] | null;
+    /**
+     * 遷移先の URL にマッチしている全ルート情報の配列です。
+     */
+    readonly currentRoutes: readonly Pick<MatchedRoute, "path" | "params" | "action" | "loader" | "shouldReload">[];
+    /**
+     * 遷移前の履歴エントリー情報です。
+     */
+    readonly prevEntry: Pick<HistoryEntry, "id" | "url">;
+    /**
+     * 遷移先（現在）の履歴エントリー情報です。
+     */
+    readonly currentEntry: Pick<HistoryEntry, "id" | "url">;
+    /**
+     * 履歴エントリー ID ごとに、各ローダーの実行結果を多重管理しているグローバルなデータストアです。
+     */
+    readonly loaderDataStore: Map<HistoryEntryId, Map<LoaderFunction, NinjaPromise<unknown>>>;
+    /** 進行中のローダーの非同期処理を外部から中断するためのシグナルオブジェクトです。 */
+    readonly signal: AbortSignal;
+};
+/**
+ * 直前にアクションが実行されていた場合に、追加の文脈として渡されるオプションオブジェクトの型定義です。
+ */
+export type StartLoadersOptions = {
+    /**
+     * アクション実行時に送信された標準のフォームデータです。
+     */
+    readonly formData: FormData;
+    /**
+     * 直前のアクション関数が返した実行結果データです。
+     */
+    readonly actionData: unknown;
+};
+/**
+ * 起動されたローダー群のライフサイクルおよび完了待機を制御するインターフェースです。
+ */
+export interface StartedLoaders {
+    /**
+     * 現在のフェーズでスケジュールされたすべてのローダーの処理が完了するまで待機します。
+     */
+    idle: () => Promise<void>;
+}
+/**
+ * 画面遷移やデータ更新の発生に伴い、現在マッチしているルートのローダー関数群を精査し、キャッシュの再利用または読み込みを動的に判定・実行する関数です。
+ *
+ * @param args ローダーの評価に必要な現旧のルートおよび履歴コンテキストです。
+ * @param options 直前のアクション実行コンテキストを含むオプションです。
+ * @returns スケジュールされたローダー全体の処理完了を待機するための `StartedLoaders` オブジェクトを返します。
+ */
+export default function startLoaders(args: StartLoadersArgs, options?: StartLoadersOptions): StartedLoaders;
+//# sourceMappingURL=start-loaders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-loaders.d.ts","sourceRoot":"","sources":["../../../src/core/start-loaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC;IAE7E;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,CACnC,YAAY,EACZ,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,CACzD,EAAE,CAAC;IAEJ;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1F,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,cAAc,CAsJhB"}

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

@@ -0,0 +1,138 @@
+import { NinjaPromise } from "ninja-promise";
+import unreachable from "./_unreachable.js";
+import { LoaderConditionError } from "./errors.js";
+import RouteRequest from "./route-request.js";
+/**
+ * 画面遷移やデータ更新の発生に伴い、現在マッチしているルートのローダー関数群を精査し、キャッシュの再利用または読み込みを動的に判定・実行する関数です。
+ *
+ * @param args ローダーの評価に必要な現旧のルートおよび履歴コンテキストです。
+ * @param options 直前のアクション実行コンテキストを含むオプションです。
+ * @returns スケジュールされたローダー全体の処理完了を待機するための `StartedLoaders` オブジェクトを返します。
+ */
+export default function startLoaders(args, options) {
+    const { signal, prevEntry, prevRoutes, currentEntry, currentRoutes, loaderDataStore } = args;
+    // アクション契機でのデータリロードであるか、通常の GET 遷移であるかを識別するためのコンテキストを構築します。
+    const actionContext = options && {
+        formData: options.formData,
+        actionData: options.actionData,
+    };
+    // マッチした配列は「子ルート（詳細度高）」から「親ルート（詳細度低）」の順にソートされているため、先頭の要素から、ルート全体の動的パスパラメーターを一括して回収できます。
+    const prevParams = prevRoutes?.[0]?.params || {};
+    const prevRoutePathSet = new Set(prevRoutes?.map((r) => r.path));
+    // 遷移前の履歴 ID に紐づくローダーデータのキャッシュマップをストアから取得します。
+    const prevLoaderDataMap = loaderDataStore.get(prevEntry.id);
+    // 今回の実行フェーズで収集・確定させる新しいローダーデータマップを初期化します。
+    const currentLoaderDataMap = new Map();
+    const request = RouteRequest.new("GET", currentEntry.url, signal);
+    // 現在マッチしているすべてのルートセグメントを個別に精査します。
+    for (const currentRoute of currentRoutes) {
+        const { loader: currentLoader, params: currentParams, shouldReload } = currentRoute;
+        // ローダー関数が定義されていないルートセグメントはスキップします。
+        if (typeof currentLoader !== "function") {
+            continue;
+        }
+        // 過去に同じローダー関数が実行され、かつそのキャッシュデータが存在するかをチェックします。
+        const prevLoaderData = prevLoaderDataMap?.get(currentLoader);
+        if (!prevLoaderData) {
+            // 過去のキャッシュが存在しない＝今回新しくマッチした未知のルート階層であると判定し、判定の余地なく新規にローダーを起動します。
+            const data = NinjaPromise.try(function executeLoader() {
+                return currentLoader({
+                    params: currentParams,
+                    request,
+                });
+            });
+            // ローダーの結果を待機、エラーハンドリングする処理は、この結果を参照するコンポーネントに任せます。
+            currentLoaderDataMap.set(currentLoader, data);
+            continue;
+        }
+        // キャッシュが存在する場合、ユーザー定義の `shouldReload` に照らし合わせて再読み込みが必要かを安全に検証します。
+        const should = NinjaPromise.try(function executeShouldReload() {
+            if (!actionContext) {
+                // 通常の GET 遷移時における再読み込み判定用引数を組み立てて実行します。
+                return shouldReload({
+                    prevUrl: prevEntry.url,
+                    currentUrl: currentEntry.url,
+                    prevParams,
+                    currentParams,
+                    triggerMethod: "GET",
+                    // 遷移前のルート群に今回精査しているパスが含まれていなければ、新規表示扱いとして、既定値を true とします。
+                    defaultShouldReload: !prevRoutePathSet.has(currentRoute.path),
+                });
+            }
+            else {
+                // フォームデータの送信を伴う更新契機の場合の判定引数です。
+                return shouldReload({
+                    ...actionContext,
+                    prevUrl: prevEntry.url,
+                    currentUrl: prevEntry.url,
+                    prevParams,
+                    currentParams,
+                    triggerMethod: "POST",
+                    // データ更新後は原則として全再取得が安全なため、既定値を true とします。
+                    defaultShouldReload: true,
+                });
+            }
+        });
+        let data;
+        // `shouldReload` の同期的な実行結果に基づいて処理を分岐します。
+        switch (should.status) {
+            case "pending": {
+                // shouldReload は仕様上「同期的」に真偽値を返す必要があります（Promise を返してはならない）。
+                // もし pending であれば LoaderConditionError を生成して拒否状態のプロミスとしてラップします。
+                const error = new LoaderConditionError({
+                    url: request.url.href,
+                    returnValue: should,
+                    shouldReload,
+                });
+                data = NinjaPromise.reject(error);
+                break;
+            }
+            case "rejected":
+                // shouldReload の実行中に同期的な例外が発生した場合は、そのエラー状態をそのまま引き継ぎ、ハンドリングを画面側に委ねます。
+                data = should;
+                break;
+            case "fulfilled": {
+                const { value } = should;
+                switch (value) {
+                    case true:
+                        // 明示的にリロードの指示が出た場合のみ、ローダーを新規に再実行します。
+                        data = NinjaPromise.try(function executeLoader() {
+                            return currentLoader({
+                                params: currentParams,
+                                request,
+                            });
+                        });
+                        break;
+                    case false:
+                        // 再読み込みが不要（現状維持）と判定された場合は、前回のキャッシュプロミスをそのまま無加工で引き継ぎます。
+                        data = prevLoaderData;
+                        break;
+                    default: {
+                        // 戻り値が boolean 型（true / false）ではなかった場合、仕様不適合としてエラーを割り当てます。
+                        const error = new LoaderConditionError({
+                            url: request.url.href,
+                            returnValue: value,
+                            shouldReload,
+                        });
+                        // エラーハンドリングは、このローダーデータを参照するコンポーネントに任せます。
+                        data = NinjaPromise.reject(error);
+                    }
+                }
+                break;
+            }
+            default:
+                unreachable(should);
+        }
+        // 確定したプロミスを今回のマップに登録します。
+        currentLoaderDataMap.set(currentLoader, data);
+    }
+    // 今回の実行フェーズで収集・更新されたローダーデータが存在する場合、グローバルなキャッシュストアへマージして永続化します。
+    if (currentLoaderDataMap.size > 0) {
+        loaderDataStore.set(currentEntry.id, new Map([...(loaderDataStore.get(currentEntry.id) || []), ...currentLoaderDataMap]));
+    }
+    return {
+        async idle() {
+            await Promise.allSettled(currentLoaderDataMap.values());
+        },
+    };
+}

package/dist/{core.d.ts → src/core.d.ts}

@@ -1,12 +1,11 @@
-export { default as Router } from "./components/router.jsx";
 export type * from "./components/router.jsx";
+export { default as Router } from "./components/router.jsx";
+/**************************************************************************************************/
 export type * from "./contexts/route-context.js";
 export { default as RouteContext } from "./contexts/route-context.js";
 export type * from "./contexts/router-context.js";
 export { default as RouterContext } from "./contexts/router-context.js";
-export { ACTION_ID_FORM_DATA_NAME } from "./core/constants.js";
-export type * from "./core/data-map.types.js";
-export type * from "./core/data-store.types.js";
+/**************************************************************************************************/
 export type * from "./core/expect-history-entry.js";
 export { default as expectHistoryEntry } from "./core/expect-history-entry.js";
 export type * from "./core/history-entry-id-schema.js";
@@ -17,13 +16,10 @@ export type * from "./core/init-loaders.js";
 export { default as initLoaders } from "./core/init-loaders.js";
 export type * from "./core/match-routes.js";
 export { default as matchRoutes } from "./core/match-routes.js";
-export type * from "./core/redirect-response.js";
-export { default as RedirectResponse } from "./core/redirect-response.js";
-export type * from "./core/start-actions.js";
-export { default as startActions } from "./core/start-actions.js";
+export type * from "./core/route-path.js";
+export { default as RoutePath } from "./core/route-path.js";
+export type * from "./core/start-action.js";
+export { default as startAction } from "./core/start-action.js";
 export type * from "./core/start-loaders.js";
 export { default as startLoaders } from "./core/start-loaders.js";
-export type * from "./engines/engine.types.js";
-export type * from "./engines/navigation-api-engine.js";
-export { default as NavigationApiEngine } from "./engines/navigation-api-engine.js";
 //# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oGAAoG;AAEpG,mBAAmB,6BAA6B,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEtE,mBAAmB,8BAA8B,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAExE,oGAAoG;AAEpG,mBAAmB,gCAAgC,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAE/E,mBAAmB,mCAAmC,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEpF,mBAAmB,oCAAoC,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEtF,mBAAmB,wBAAwB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEhE,mBAAmB,wBAAwB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEhE,mBAAmB,sBAAsB,CAAC;AAC1C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE5D,mBAAmB,wBAAwB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEhE,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/{core.js → src/core.js}

@@ -1,13 +1,11 @@
 export { default as Router } from "./components/router.jsx";
 export { default as RouteContext } from "./contexts/route-context.js";
 export { default as RouterContext } from "./contexts/router-context.js";
-export { ACTION_ID_FORM_DATA_NAME } from "./core/constants.js";
 export { default as expectHistoryEntry } from "./core/expect-history-entry.js";
 export { default as HistoryEntryIdSchema } from "./core/history-entry-id-schema.js";
 export { default as HistoryEntryUrlSchema } from "./core/history-entry-url-schema.js";
 export { default as initLoaders } from "./core/init-loaders.js";
 export { default as matchRoutes } from "./core/match-routes.js";
-export { default as RedirectResponse } from "./core/redirect-response.js";
-export { default as startActions } from "./core/start-actions.js";
+export { default as RoutePath } from "./core/route-path.js";
+export { default as startAction } from "./core/start-action.js";
 export { default as startLoaders } from "./core/start-loaders.js";
-export { default as NavigationApiEngine } from "./engines/navigation-api-engine.js";

package/dist/src/engines/engine.types.d.ts

@@ -0,0 +1,216 @@
+import type { NinjaPromise } from "ninja-promise";
+import type { HistoryEntry } from "../core/expect-history-entry.js";
+import type { HistoryEntryId } from "../core/history-entry-id-schema.js";
+import type { MatchedRoute } from "../core/match-routes.js";
+import type { ReadonlyFormData } from "../core/readonly-form-data.types.js";
+import type { ReadonlyURLSearchParams } from "../core/readonly-url.types.js";
+import type { Route, ActionFunction, LoaderFunction } from "../core/route.types.js";
+/**
+ * ルーターが管理する現在の画面の状態を表す型定義です。
+ */
+export type RouterState = {
+    /**
+     * 現在のアクティブな履歴エントリーです。
+     */
+    entry: HistoryEntry;
+    /**
+     * 現在の URL にマッチしている子から親までの階層的なルートの配列です。
+     */
+    routes: readonly [MatchedRoute, ...MatchedRoute[]];
+};
+/**
+ * 実行中のルーティングエンジンを安全に停止させ、各種イベントリスナーや非同期処理をクリーンアップするための関数インターフェースです。
+ */
+export interface IStopEngine {
+    (): void;
+}
+/**
+ * ルーティングエンジンに関わる各種引数や戻り値の型をまとめた名前空間です。
+ */
+export declare namespace IEngine {
+    /**
+     * ルーター初期化メソッド `init` に渡される引数の型定義です。
+     */
+    type InitArgs = {
+        /**
+         * アプリケーションに登録されているすべての正規化済みルートの定義配列です。
+         */
+        routes: readonly Route[];
+        /**
+         * 各履歴エントリーに紐づくローダーの非同期状態を多重管理する、共有データストアへの参照です。
+         */
+        loaderDataStore: Map<HistoryEntryId, Map<LoaderFunction, NinjaPromise<unknown>>>;
+        /**
+         * 中断シグナルを取得します。
+         */
+        getSignal: () => AbortSignal;
+    };
+    /**
+     * ルーター初期化メソッド `init` が返す初期状態の型定義です。
+     *
+     * マッチするルートがあればその状態を返し、なければ `null` となります。
+     */
+    type InitReturn = RouterState | null;
+    /**
+     * エンジンの稼働開始メソッド `start` に渡される引数の型定義です。
+     *
+     * ナビゲーションイベントの監視や状態同期に必要な依存関係を集約します。
+     */
+    type StartArgs = {
+        /**
+         * アプリケーションに登録されているすべての正規化済みルートの定義配列です。
+         */
+        routes: readonly Route[];
+        /**
+         * 各履歴エントリーに紐づくアクションの非同期状態を保持する共有データストアです。
+         */
+        actionDataStore: Map<HistoryEntryId, Map<ActionFunction, NinjaPromise<unknown>>>;
+        /**
+         * 各履歴エントリーに紐づくローダーの非同期状態を保持する共有データストアです。
+         */
+        loaderDataStore: Map<HistoryEntryId, Map<LoaderFunction, NinjaPromise<unknown>>>;
+        /**
+         * エンジン内部で遷移が確定した際、新しい状態を Reactに通知して画面の再描画を要求するための更新関数です。
+         *
+         * 引数なしの呼び出しは、現在の状態を維持したままの強制再レンダリングを意味します。
+         */
+        update: {
+            /**
+             * 現在の状態を維持したまま強制的に再レンダリングします。
+             */
+            (): void;
+            /**
+             * ルーターの状態を更新します。
+             *
+             * @param newRouterState 新しいルーターの状態です。
+             */
+            (newRouterState: RouterState | null): void;
+        };
+        /**
+         * 中断シグナルを取得します。
+         */
+        getSignal: () => AbortSignal;
+    };
+    /**
+     * エンジンの稼働開始メソッド `start` の戻り値です。
+     *
+     * 監視イベントのリスナーを解除するためのクリーンアップ関数を返すか、環境によって何も返さない場合があります。
+     */
+    type StartReturn = IStopEngine | void;
+    /**
+     * プログラムからのフォーム送信やクエリー更新を行う `submit` メソッドの引数の型定義です。
+     */
+    type SubmitArgs = {
+        /**
+         * HTTP POST メソッドに相当する、マルチパートまたは URL エンコードされたフォームデータの送信です。
+         */
+        type: "FORM_DATA";
+        /**
+         * 送信する不変のフォームデータ本体です。
+         */
+        target: ReadonlyFormData;
+        /**
+         * アクションの送信先となる対象の URL パス文字列です。
+         */
+        action: string;
+    } | {
+        /**
+         * HTTP GET メソッドに相当する、URL の検索クエリーの更新送信です。
+         */
+        type: "URL_SEARCH_PARAMS";
+        /**
+         * 更新対象となる検索クエリーパラメータです。
+         */
+        target: ReadonlyURLSearchParams;
+        /**
+         * クエリーの付与先となる対象の URL パス文字列です。
+         */
+        action: string;
+        /**
+         * 履歴スタックへの追加方法を指定します。
+         *
+         * - `"push"`: 履歴エントリーの新規追加
+         * - `"replace"`: 履歴エントリーの上書き
+         */
+        history: "replace" | "push";
+    };
+    /**
+     * 命令的な画面遷移を行う `navigate` メソッドの引数の型定義です。
+     *
+     * リンクをクリックした際のアドレス遷移か、ブラウザーの「戻る・進む」に相当する相対移動かで分岐します。
+     */
+    type NavigateArgs = {
+        /**
+         * 明示的なアドレス指定による前方移動です。
+         */
+        type: "LINK";
+        /**
+         * 遷移先のアドレス表現の指定です。完全なパス文字列か、部分的なパーツの組み合わせかを選択します。
+         */
+        to: {
+            /**
+             * URL パスで前方移動する形式です。
+             */
+            type: "PATH";
+            /**
+             * URL パスです。
+             */
+            path: string;
+        } | {
+            /**
+             * URL の各コンポーネントを個別に指定する形式です。
+             */
+            type: "PARTIAL";
+            /**
+             * 最初のスラッシュ `/` から始まる URL のパス部分です。
+             */
+            pathname?: string | undefined;
+            /**
+             * 先頭のクエスチョンマーク `?` を含む URL のクエリー文字列です。
+             */
+            search?: string | undefined;
+            /**
+             * URL のハッシュ（シャープ記号 `#` を含むフラグメント識別子）です。
+             */
+            hash?: string | undefined;
+        };
+        /**
+         * 履歴スタックへの追加方法を指定します。
+         *
+         * - `"push"`: 履歴エントリーの新規追加
+         * - `"replace"`: 履歴エントリーの上書き
+         */
+        history: "replace" | "push";
+    } | {
+        /**
+         * 履歴スタック内の相対的な位置移動（例: `-1` で1つ戻る、`2` で2つ進む）です。
+         */
+        type: "MOVE";
+        /**
+         * 履歴を移動させる差分ステップ数です。
+         */
+        delta: number;
+    };
+}
+/**
+ * ルーティングエンジンのインターフェース定義です。
+ */
+export interface IEngine {
+    /**
+     * 現在の URL を基にルーターの初期状態を計算し、同期的に取得します。
+     */
+    init(args: IEngine.InitArgs): IEngine.InitReturn;
+    /**
+     * エンジンを稼働させ、ブラウザーの履歴変更やナビゲーションイベントの継続的な監視を開始します。
+     */
+    start(args: IEngine.StartArgs): IEngine.StartReturn;
+    /**
+     * ユーザーからの意図的なフォームデータまたはクエリーパラメータの送信を検知し、対応するルートのアクションやローダーを起動します。
+     */
+    submit(args: IEngine.SubmitArgs): void;
+    /**
+     * プログラムからの命令的なページ遷移を処理します。
+     */
+    navigate(args: IEngine.NavigateArgs): void;
+}
+//# sourceMappingURL=engine.types.d.ts.map

package/dist/src/engines/engine.types.d.ts.map

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

package/dist/src/engines/navigation-api-engine.d.ts

@@ -0,0 +1,50 @@
+import type { IEngine } from "./engine.types.js";
+/**
+ * モダンブラウザーに搭載されている標準の `Navigation API` を活用し、クライアントサイドにおける高度な SPA ルーティングを制御するエンジンクラスです。
+ */
+export default class NavigationApiEngine implements IEngine {
+    /**
+     * ブラウザー標準の `navigation` オブジェクトへの参照を保持します。
+     */
+    private navigation;
+    /**
+     * メモリーリークを防ぐため、すでに dispose リスナーを登録済みの履歴エントリー ID を追跡するセットです。
+     */
+    private subscribedEntryIds;
+    /**
+     * 連続して発生した画面遷移を適切にキャンセルするための、最新ナビゲーション用の中断コントローラーです。
+     */
+    private navAbortController;
+    /**
+     * `NavigationApiEngine` クラスのインスタンスを初期化します。
+     *
+     * 実行環境が `Navigation API` をサポートしていない場合はエラーを投げます。
+     */
+    constructor();
+    /**
+     * 現在のページ URL に基づき、ルーターの初期状態を構築・登録します。
+     *
+     * @param args ルート定義配列、共通データストア、初期化用のアボートシグナルを含むオブジェクトです。
+     * @returns 構築された初期の `RouterState`。適合するルートがないか、履歴が無い場合は `null` を返します。
+     */
+    init(args: IEngine.InitArgs): IEngine.InitReturn;
+    /**
+     * ブラウザーの継続的なナビゲーションイベント（リンククリック、フォーム送信、履歴移動）の監視を開始します。
+     *
+     * @param args ルート配列、UI側への状態反映関数、各種ストア、シグナル取得関数を含むオブジェクトです。
+     */
+    start(args: IEngine.StartArgs): IEngine.StartReturn;
+    /**
+     * フォームデータまたはクエリーパラメータを、ブラウザーの Navigation API のライフサイクルに載せて命令的に送信します。
+     *
+     * @param args 送信データの種類に応じたサブミット引数です。
+     */
+    submit(args: IEngine.SubmitArgs): void;
+    /**
+     * 命令的なページ遷移を処理します。
+     *
+     * @param args 遷移タイプに応じたナビゲーション引数です。
+     */
+    navigate(args: IEngine.NavigateArgs): void;
+}
+//# sourceMappingURL=navigation-api-engine.d.ts.map

package/dist/src/engines/navigation-api-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-api-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/navigation-api-engine.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,OAAO;IACzD;;OAEG;IACH,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAsB;IAEhD;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAyB;IAEnD;;;;OAIG;;IAwBH;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,UAAU;IA2BhD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW;IAgSnD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI;IAkCtC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,GAAG,IAAI;CAwE3C"}