soseki 0.0.5 → 0.0.7

package/dist/src/hooks/use-navigate.js

@@ -0,0 +1,43 @@
+import * as React from "react";
+import useRouterContext from "./use-router-context.js";
+/**
+ * リンクなどを介さない、ボタンのクリックハンドラーや非同期処理の完了時などから、プログラムによって命令的に画面遷移や履歴移動をトリガーするための関数を取得するカスタムフックです。
+ *
+ * @returns `NavigateFunction` 関数です。
+ */
+export default function useNavigate() {
+    const routerNavigate = useRouterContext((router) => router.navigate);
+    // レンダリング毎に関数の参照が変わって子コンポーネントが不要に再描画されるのを防ぐため、useCallback でラップします。
+    return React.useCallback(function navigate(...args) {
+        if (typeof args[0] === "number") {
+            const [delta] = args;
+            return routerNavigate({
+                type: "MOVE",
+                delta,
+            });
+        }
+        const [to, options = {}] = args;
+        const { replace = false } = options;
+        const history = replace ? "replace" : "push";
+        if (typeof to === "string") {
+            return routerNavigate({
+                to: {
+                    path: to,
+                    type: "PATH",
+                },
+                type: "LINK",
+                history,
+            });
+        }
+        else {
+            return routerNavigate({
+                to: {
+                    ...to,
+                    type: "PARTIAL",
+                },
+                type: "LINK",
+                history,
+            });
+        }
+    }, [routerNavigate]);
+}

package/dist/{hooks → src/hooks}/use-params.d.ts

@@ -1,8 +1,8 @@
-import type { PathParams } from "../core/route.types.js";
+import type { RoutePathParams } from "../core/route.types.js";
 /**
  * 現在のルートにマッチしたパスパラメーターを取得するためのカスタムフックです。
  *
  * @returns 現在のパスパラメーターを含むオブジェクトを返します。
  */
-export default function useParams<TPath extends string = string>(): PathParams<TPath>;
+export default function useParams<TPath extends string = string>(): RoutePathParams<TPath>;
 //# sourceMappingURL=use-params.d.ts.map

package/dist/src/hooks/use-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-params.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,KAAK,eAAe,CAAC,KAAK,CAAC,CAEzF"}

package/dist/{hooks → src/hooks}/use-params.js

@@ -1,4 +1,4 @@
-import useRouteContext from "./_use-route-context.js";
+import useRouteContext from "./use-route-context.js";
 /**
  * 現在のルートにマッチしたパスパラメーターを取得するためのカスタムフックです。
  *

package/dist/src/hooks/use-route-context.d.ts

@@ -0,0 +1,10 @@
+import { type RouteContextValue } from "../contexts/route-context.js";
+/**
+ * React のコンポーネントツリーから、現在の階層に紐づいているルートの文脈情報を安全に取得するためのカスタムフックです。
+ *
+ * コンテキストが供給されていない状況を検知した場合はエラーを投げます。
+ *
+ * @returns 現在の階層で確定している型 `RouteContextValue` のルートコンテキストデータを返します。
+ */
+export default function useRouteContext(): RouteContextValue;
+//# sourceMappingURL=use-route-context.d.ts.map

package/dist/src/hooks/use-route-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-route-context.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-route-context.ts"],"names":[],"mappings":"AAEA,OAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,IAAI,iBAAiB,CAO3D"}

package/dist/src/hooks/use-route-context.js

@@ -0,0 +1,17 @@
+import * as React from "react";
+import RouteContext from "../contexts/route-context.js";
+import { RouteContextMissingError } from "../core/errors.js";
+/**
+ * React のコンポーネントツリーから、現在の階層に紐づいているルートの文脈情報を安全に取得するためのカスタムフックです。
+ *
+ * コンテキストが供給されていない状況を検知した場合はエラーを投げます。
+ *
+ * @returns 現在の階層で確定している型 `RouteContextValue` のルートコンテキストデータを返します。
+ */
+export default function useRouteContext() {
+    const routeContext = React.use(RouteContext);
+    if (!routeContext) {
+        throw new RouteContextMissingError();
+    }
+    return routeContext;
+}

package/dist/src/hooks/use-router-context.d.ts

@@ -0,0 +1,12 @@
+import { type RouterRef } from "../contexts/router-context.js";
+/**
+ * グローバルなルーターの状態）ら、必要なデータの一部（スライス）をセレクター関数を介して選択的・効率的に購読するためのカスタムフックです。
+ *
+ * ルーターコンポーネントの配下で実行されていない場合はエラーを投げます。
+ *
+ * @template TSlice セレクター関数によって抽出される、コンポーネントが必要とする部分データの型定義です。
+ * @param selector ルーターの内部実体を受け取り、必要なプロパティーや状態を抽出して返す純粋関数です。
+ * @returns 選択され、外部ストアと同期された最新のスライスデータを返します。
+ */
+export default function useRouterContext<TSlice>(selector: (router: RouterRef["current"]) => TSlice): TSlice;
+//# sourceMappingURL=use-router-context.d.ts.map

package/dist/src/hooks/use-router-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-router-context.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-router-context.ts"],"names":[],"mappings":"AAEA,OAAsB,EAAE,KAAK,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG9E;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,MAAM,EAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,MAAM,GACjD,MAAM,CAQR"}

package/dist/src/hooks/use-router-context.js

@@ -0,0 +1,20 @@
+import * as React from "react";
+import RouterContext from "../contexts/router-context.js";
+import { RouterContextMissingError } from "../core/errors.js";
+/**
+ * グローバルなルーターの状態）ら、必要なデータの一部（スライス）をセレクター関数を介して選択的・効率的に購読するためのカスタムフックです。
+ *
+ * ルーターコンポーネントの配下で実行されていない場合はエラーを投げます。
+ *
+ * @template TSlice セレクター関数によって抽出される、コンポーネントが必要とする部分データの型定義です。
+ * @param selector ルーターの内部実体を受け取り、必要なプロパティーや状態を抽出して返す純粋関数です。
+ * @returns 選択され、外部ストアと同期された最新のスライスデータを返します。
+ */
+export default function useRouterContext(selector) {
+    const routerContext = React.use(RouterContext);
+    if (!routerContext) {
+        throw new RouterContextMissingError();
+    }
+    const { routerRef, subscribe } = routerContext;
+    return React.useSyncExternalStore(subscribe, () => selector(routerRef.current));
+}

package/dist/src/hooks/use-submit.d.ts

@@ -0,0 +1,59 @@
+import type { ReadonlyFormData } from "../core/readonly-form-data.types.js";
+import type { ReadonlyURLSearchParams } from "../core/readonly-url.types.js";
+/**
+ * クエリーパラメーター送信（HTTP GET 相当）のサブミット処理をカスタマイズするためのオプション型です。
+ */
+export type SubmitGetOptions = {
+    /**
+     * 送信先（遷移先）のベースとなる URL パスを明示的に上書き指定します。省略時は現在のフォームアクションパスが使用されます。
+     */
+    readonly action?: string | undefined;
+    /**
+     * 履歴スタックへの追加方法を制御します。`true` の場合は現在の履歴を上書きし、`false` または省略時は新規追加します。
+     */
+    readonly replace?: boolean | undefined;
+};
+/**
+ * フォームデータ送信（HTTP POST 相当）のサブミット処理をカスタマイズするためのオプション型です。
+ */
+export type SubmitPostOptions = {
+    /**
+     * 送信先（アクション実行先）の URL パスを明示的に上書き指定します。省略時は現在のフォームアクションパスが使用されます。
+     */
+    readonly action?: string | undefined;
+};
+/**
+ * プログラムから命令的にデータ送信および画面遷移を実行する、`submit` 関数のオーバーロードインターフェース定義です。
+ */
+export interface SubmitFunction {
+    /**
+     * 不変のフォームデータを引き渡して、HTTP POST 相当のアクション処理をトリガーします。
+     *
+     * @param target 送信するフォームデータです。
+     * @param options POST 送信用のオプションです。
+     */
+    (target: ReadonlyFormData, options?: SubmitPostOptions): void;
+    /**
+     * 不変のクエリーパラメーターを引き渡して、HTTP GET 相当の検索条件の更新をトリガーします。
+     *
+     * @param target 送信する検索クエリーです。
+     * @param options GET 送信用のオプションです。
+     */
+    (target: ReadonlyURLSearchParams, options?: SubmitGetOptions): void;
+    /**
+     * 内部実装および包括的なユースケースに対応する汎用シグニチャーです。
+     *
+     * @param target 送信愛用です。
+     * @param options オプションです。
+     */
+    (target: ReadonlyURLSearchParams | ReadonlyFormData, options?: SubmitGetOptions | SubmitPostOptions): void;
+}
+/**
+ * ユーザーのクリックイベントや、特定のロジックに基づくタイミングで、プログラムから宣言的・命令的にサブミット処理（データ送信および遷移）を実行するための関数を取得するカスタムフックです。
+ *
+ * 渡されたペイロードが `FormData` であるか `URLSearchParams` であるかをランタイムで自動判定し、適切なルーティングエンジンメソッドへと送信されます。
+ *
+ * @returns 依存関係が最適化され、同一参照が保証された `submit` 関数を返します。
+ */
+export default function useSubmit(): SubmitFunction;
+//# sourceMappingURL=use-submit.d.ts.map

package/dist/src/hooks/use-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-submit.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-submit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAI7E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEpE;;;;;OAKG;IACH,CACE,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,EAClD,OAAO,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAC7C,IAAI,CAAC;CACT;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,IAAI,cAAc,CAkClD"}

package/dist/src/hooks/use-submit.js

@@ -0,0 +1,38 @@
+import * as React from "react";
+import useFormAction from "./use-form-action.js";
+import useRouterContext from "./use-router-context.js";
+/**
+ * ユーザーのクリックイベントや、特定のロジックに基づくタイミングで、プログラムから宣言的・命令的にサブミット処理（データ送信および遷移）を実行するための関数を取得するカスタムフックです。
+ *
+ * 渡されたペイロードが `FormData` であるか `URLSearchParams` であるかをランタイムで自動判定し、適切なルーティングエンジンメソッドへと送信されます。
+ *
+ * @returns 依存関係が最適化され、同一参照が保証された `submit` 関数を返します。
+ */
+export default function useSubmit() {
+    const formAction = useFormAction();
+    const routerSubmit = useRouterContext((router) => router.submit);
+    // レンダリング毎に関数の参照が変わって子コンポーネントが不要に再描画されるのを防ぐため、useCallback でラップします。
+    return React.useCallback(function submit(target, options = {}) {
+        if (target instanceof FormData) {
+            // 分岐 1: データ実体がフォームデータである場合 ＝ 副作用を伴うデータ変更処理（POST / Action 契機）
+            const { action = formAction } = options;
+            // エンジンに対して「FORM_DATA」タイプとしてのサブミットタスクを発行します。
+            return routerSubmit({
+                type: "FORM_DATA",
+                target,
+                action,
+            });
+        }
+        else {
+            // 分岐 2: データ実体がクエリーパラメーターである場合 ＝ 読み取り専用の条件更新処理（GET / Loader 契機）
+            const { action = formAction, replace } = options;
+            return routerSubmit({
+                type: "URL_SEARCH_PARAMS",
+                target: target,
+                action,
+                // replace の真偽値に基づき、ブラウザー履歴の追加方法（push / replace）を明示的にマッピングします。
+                history: replace ? "replace" : "push",
+            });
+        }
+    }, [routerSubmit, formAction]);
+}

package/dist/src/soseki.d.ts

@@ -0,0 +1,31 @@
+export type * from "./components/browser-router.jsx";
+export { default as BrowserRouter } from "./components/browser-router.jsx";
+export type * from "./components/outlet.jsx";
+export { default as Outlet } from "./components/outlet.jsx";
+/**************************************************************************************************/
+export type { Issue, UnreachableErrorArgs, UnreachableErrorMeta, LoaderConditionErrorArgs, LoaderConditionErrorMeta, LoaderDataNotFoundErrorArgs, LoaderDataNotFoundErrorMeta, UnexpectedValidationErrorArgs, UnexpectedValidationErrorMeta, } from "./core/errors.js";
+export { ErrorBase, setErrorMessage, UnreachableError, ValidationErrorBase, LoaderConditionError, LoaderDataNotFoundError, RouteContextMissingError, RouterContextMissingError, UnexpectedValidationError, NavigationApiNotSupportedError, } from "./core/errors.js";
+export type * from "./core/readonly-form-data.types.js";
+export type * from "./core/readonly-url.types.js";
+export type * from "./core/redirect-response.js";
+export { default as RedirectResponse } from "./core/redirect-response.js";
+export type * from "./core/route-request.js";
+export { default as RouteRequest } from "./core/route-request.js";
+export type * from "./core/route.types.js";
+/**************************************************************************************************/
+export type * from "./hooks/use-action-data.js";
+export { default as useActionData } from "./hooks/use-action-data.js";
+export type * from "./hooks/use-form-action.js";
+export { default as useFormAction } from "./hooks/use-form-action.js";
+export type * from "./hooks/use-loader-data.js";
+export { default as useLoaderData } from "./hooks/use-loader-data.js";
+export type * from "./hooks/use-navigate.js";
+export { default as useNavigate } from "./hooks/use-navigate.js";
+export type * from "./hooks/use-params.js";
+export { default as useParams } from "./hooks/use-params.js";
+export type * from "./hooks/use-submit.js";
+export { default as useSubmit } from "./hooks/use-submit.js";
+/**************************************************************************************************/
+export type * from "./utils/redirect.js";
+export { default as redirect } from "./utils/redirect.js";
+//# sourceMappingURL=soseki.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soseki.d.ts","sourceRoot":"","sources":["../../src/soseki.ts"],"names":[],"mappings":"AAAA,mBAAmB,iCAAiC,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3E,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oGAAoG;AAEpG,YAAY,EACV,KAAK,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,mBAAmB,oCAAoC,CAAC;AAExD,mBAAmB,8BAA8B,CAAC;AAElD,mBAAmB,6BAA6B,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAElE,mBAAmB,uBAAuB,CAAC;AAE3C,oGAAoG;AAEpG,mBAAmB,4BAA4B,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEtE,mBAAmB,4BAA4B,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEtE,mBAAmB,4BAA4B,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEtE,mBAAmB,yBAAyB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEjE,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE7D,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE7D,oGAAoG;AAEpG,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/soseki.js

@@ -0,0 +1,12 @@
+export { default as BrowserRouter } from "./components/browser-router.jsx";
+export { default as Outlet } from "./components/outlet.jsx";
+export { ErrorBase, setErrorMessage, UnreachableError, ValidationErrorBase, LoaderConditionError, LoaderDataNotFoundError, RouteContextMissingError, RouterContextMissingError, UnexpectedValidationError, NavigationApiNotSupportedError, } from "./core/errors.js";
+export { default as RedirectResponse } from "./core/redirect-response.js";
+export { default as RouteRequest } from "./core/route-request.js";
+export { default as useActionData } from "./hooks/use-action-data.js";
+export { default as useFormAction } from "./hooks/use-form-action.js";
+export { default as useLoaderData } from "./hooks/use-loader-data.js";
+export { default as useNavigate } from "./hooks/use-navigate.js";
+export { default as useParams } from "./hooks/use-params.js";
+export { default as useSubmit } from "./hooks/use-submit.js";
+export { default as redirect } from "./utils/redirect.js";

package/dist/src/utils/redirect.d.ts

@@ -0,0 +1,11 @@
+import RedirectResponse from "../core/redirect-response.js";
+/**
+ * 指定された URL パスへのリダイレクトを表すレスポンスオブジェクトを作成します。
+ *
+ * アクションの中で、別のページへ遷移させるために使用されます。
+ *
+ * @param destination リダイレクト先の URL パスです。
+ * @returns 作成された `RedirectResponse` オブジェクトです。
+ */
+export default function redirect(destination: string): RedirectResponse;
+//# sourceMappingURL=redirect.d.ts.map

package/dist/src/utils/redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../../src/utils/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,8BAA8B,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAEtE"}

package/dist/src/utils/redirect.js

@@ -0,0 +1,12 @@
+import RedirectResponse from "../core/redirect-response.js";
+/**
+ * 指定された URL パスへのリダイレクトを表すレスポンスオブジェクトを作成します。
+ *
+ * アクションの中で、別のページへ遷移させるために使用されます。
+ *
+ * @param destination リダイレクト先の URL パスです。
+ * @returns 作成された `RedirectResponse` オブジェクトです。
+ */
+export default function redirect(destination) {
+    return new RedirectResponse(destination);
+}

package/package.json

@@ -1,18 +1,12 @@
 {
   "name": "soseki",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "",
-  "sideEffects": false,
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/soseki.d.ts",
-      "default": "./dist/soseki.js"
-    },
-    "./core": {
-      "types": "./dist/core.d.ts",
-      "default": "./dist/core.js"
-    }
+  "homepage": "https://github.com/tai-kun/soseki.js",
+  "license": "MIT",
+  "author": "tai-kun",
+  "repository": {
+    "url": "https://github.com/tai-kun/soseki.js"
   },
   "files": [
     "dist",
@@ -20,44 +14,57 @@
     "package.json",
     "LICENSE"
   ],
-  "homepage": "https://github.com/tai-kun/soseki.js",
-  "repository": {
-    "url": "https://github.com/tai-kun/soseki.js"
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/src/soseki.js",
+  "types": "./dist/src/soseki.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/soseki.d.ts",
+      "default": "./dist/src/soseki.js"
+    },
+    "./core": {
+      "types": "./dist/src/core.d.ts",
+      "default": "./dist/src/core.js"
+    },
+    "./engines": {
+      "types": "./dist/src/engines.d.ts",
+      "default": "./dist/src/engines.js"
+    }
   },
   "dependencies": {
+    "@tai-kun/valibot-extra-lab": "^0.0.5",
+    "call-fn-once": "^0.0.6",
+    "i18n-error-base": "^0.0.4",
+    "inspect-lite": "^0.0.2",
+    "maypromise": "^0.0.4",
+    "ninja-promise": "^0.0.3",
     "regexparam": "^3.0.0",
+    "try-capture-stack-trace": "^0.0.3",
     "type-name": "^2.0.2"
   },
-  "peerDependencies": {
-    "react": "^19.0.0",
-    "valibot": "^1.0.0"
-  },
   "devDependencies": {
-    "@tsconfig/node22": "^22.0.5",
+    "@tsconfig/node24": "^24.0.4",
     "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^22.19.3",
-    "@types/react": "^19.2.7",
+    "@types/node": "^24.12.4",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
     "@types/type-name": "^1.0.32",
-    "@vitest/browser": "^4.0.16",
-    "@vitest/browser-playwright": "^4.0.16",
-    "@vitejs/plugin-react": "^5.1.2",
-    "dependency-cruiser": "^17.3.5",
-    "navigation-api-types": "^0.6.1",
-    "npm-check-updates": "^19.2.0",
-    "playwright": "^1.57.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "valibot": "^1.2.0",
-    "vitest": "^4.0.16",
-    "vitest-browser-react": "^2.0.2"
+    "@vitest/browser": "^4.1.7",
+    "@vitest/browser-playwright": "^4.1.7",
+    "npm-check-updates": "^20.0.2",
+    "playwright": "^1.60.0",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
+  },
+  "peerDependencies": {
+    "@logtape/logtape": "^2.0.0",
+    "react": "^19.0.0",
+    "valibot": "^1.0.0"
   },
   "scripts": {
     "build": "tsc --project ./.config/tsconfig.build.json"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/",
-    "provenance": true
   }
-}
+}

package/src/components/browser-router.tsx

@@ -1,31 +1,28 @@
-import useSingleton from "../core/_use-singleton.js";
 import type { RouteDefinition } from "../core/route.types.js";
 import NavigationApiEngine from "../engines/navigation-api-engine.js";
+import useSingleton from "../hooks/_use-singleton.js";
 import Router from "./router.jsx";
 
 /**
- * BrowserRouter コンポーネントに渡されるプロパティーの型定義です。
+ * `BrowserRouter` コンポーネントに引き渡すプロパティーの型定義です。
  */
 export type BrowserRouterProps = {
   /**
-   * アプリケーション全体のルート定義を格納した配列です。
+   * アプリケーション全体の画面構造を定義したルート定義の配列です。
    */
   routes: readonly RouteDefinition[];
 };
 
 /**
- * ブラウザー標準の Navigation API を使用してルーティングを行うためのコンポーネントです。
+ * ブラウザー環境における SPA ルーティングを開始するための、最上位エントリーポイントコンポーネントです。
  *
- * `NavigationApiEngine` のインスタンスをシングルトンとして保持し、ルーターの基盤を提供します。
+ * モダンなブラウザー標準の `Navigation API` に依存しています。
+ *
+ * @param props アプリケーションに組み込むルート定義の配列です。
  */
 export default function BrowserRouter(props: BrowserRouterProps): React.ReactElement {
   const { routes } = props;
   const engine = useSingleton(() => new NavigationApiEngine());
 
-  return (
-    <Router
-      engine={engine}
-      routes={routes}
-    />
-  );
+  return <Router engine={engine} routes={routes} />;
 }

package/src/components/outlet.tsx

@@ -1,11 +1,12 @@
 import * as React from "react";
+
 import RouteContext from "../contexts/route-context.js";
 import { RouteContextMissingError } from "../core/errors.js";
 
 /**
- * 現在のルート階層における子ルート（アウトレット）を描画するためのコンポーネントです。
+ * ネストされたルーティング構造において、親ルートのレイアウト内にマッチした子ルートを適切な位置にはめ込んで描画するためのプレースホルダーコンポーネントです。
  *
- * ネストされたルーティングにおいて、親ルートのコンポーネント内で子ルートの挿入位置を指定するために使用します。
+ * @returns 描画すべき子ルートの React 要素を返します。これ以上下位のルートがない場合は `null` を返します。
  */
 export default function Outlet(): React.ReactElement | null {
   const routeContext = React.use(RouteContext);