soseki 0.0.5 → 0.0.7

package/src/engines.ts

@@ -0,0 +1,4 @@
+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";

package/src/hooks/_use-singleton.ts

@@ -0,0 +1,30 @@
+import * as React from "react";
+
+/**
+ * 初期化前（未初期化状態）であることを安全に判定するための、値が空の内部専用ユニークオブジェクトです。
+ */
+const nil = {};
+
+/**
+ * コンポーネントのライフサイクルにおいて、渡されたファクトリー関数を最初のレンダリング時に一度だけ実行し、その結果を以降の再レンダリング間で永続的に共有・保持するためのカスタムフックです。
+ *
+ * `React.useMemo` と異なり、React の内部都合によるキャッシュの不意な破棄・再計算が発生しないことが保証されます。
+ *
+ * @template T ファクトリー関数が生成するオブジェクトの型定義です。
+ * @param fn 初回レンダリング時にのみ呼び出される、オブジェクト生成用の初期化関数です。
+ * @returns 初回実行時に生成され、保持され続けている型 `T` のシングルトンインスタンスを返します。
+ */
+export default function useSingleton<T>(fn: () => T): T {
+  // 生成されたオブジェクトをコンポーネントの生存期間中保持するために useRef を使用します。
+  // 初期値として、未初期化の目印である nil オブジェクトを型アサーションして流し込みます。
+  const ref = React.useRef<T>(nil as T);
+
+  // 参照している中身がマッピングされたオブジェクト（nil）のままであれば、まだ一度も初期化されていないと判定します。
+  if (ref.current === nil) {
+    // 初期化関数を実行し、生成された実体を現在の参照へと上書きします。
+    // この処理は初回のレンダリングパスの中で完全に同期的に実行されます。
+    ref.current = fn();
+  }
+
+  return ref.current;
+}

package/src/hooks/use-action-data.ts

@@ -1,37 +1,32 @@
-import type DeferredPromise from "../core/deferred-promise.js";
+import type { NinjaPromise } from "ninja-promise";
+
 import type RedirectResponse from "../core/redirect-response.js";
-import type { IAction } from "../core/route.types.js";
-import useRouterContext from "./_use-router-context.js";
+import useRouteContext from "./use-route-context.js";
+import useRouterContext from "./use-router-context.js";
 
 /**
- * アクションの実行結果を推論するためのユーティリティー型です。
- *
- * 結果が `RedirectResponse` の場合は `undefined` を返し、それ以外の場合はそのままの型を返します。
+ * アクション関数の戻り値の型から、リダイレクト応答を除外して正規化するユーティリティー型です。
  *
- * @template TResult 推論対象となる型です。
+ * アクションがリダイレクトを返した場合、フレームワークの内部仕様によって実際の値は `undefined` に置換されるため、型定義においてもその挙動を忠実に表現します。
  */
-// dprint-ignore
-type $InferResult<TResult> = TResult extends RedirectResponse
-  ? undefined
-  : TResult;
+type ActionResult<TResult> = TResult extends RedirectResponse ? undefined : TResult;
 
 /**
- * 特定のアクションに関連付けられたデータ（実行結果）をルーターのストアから取得するカスタムフックです。
+ * 現在の階層のルートに紐づくアクション関数の最新の実行結果を購読・取得するためのカスタムフックです。
  *
- * 現在の履歴エントリーに対応するアクションデータを返します。
- *
- * @template TAction 対象となるアクションの型です。
- * @param action データを取得したいアクションの定義です。
- * @returns アクションの実行結果を含む `DeferredPromise` を返します。データが存在しない場合は `undefined` を返します。
+ * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその戻り値の型（推論結果）が解凍されます。
+ * @returns アクションが実行済み、または実行中であれば結果を内包した `NinjaPromise` を返し、一度も実行されていないか対象のアクションが存在しない場合は `undefined` を返します。
  */
-export default function useActionData<TAction extends IAction>(
-  action: TAction,
-): DeferredPromise<$InferResult<Awaited<ReturnType<TAction>>>> | undefined {
-  return useRouterContext((router): DeferredPromise<any> | undefined => {
-    const {
-      currentEntry,
-      actionDataStore,
-    } = router;
-    return actionDataStore.get(currentEntry.id)?.get(action);
+export default function useActionData<TData = unknown>():
+  | NinjaPromise<
+      ActionResult<Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>>
+    >
+  | undefined {
+  const { action } = useRouteContext();
+  const actionData = useRouterContext((router) => {
+    const { currentEntry, actionDataStore } = router;
+    return actionDataStore.get(currentEntry.id)?.get(action!);
   });
+
+  return actionData satisfies NinjaPromise<unknown> | undefined as NinjaPromise<any> | undefined;
 }

package/src/hooks/use-form-action.ts

@@ -1,11 +1,10 @@
-import useRouteContext from "./_use-route-context.js";
+import useRouteContext from "./use-route-context.js";
 
 /**
- * フォームの送信先となるアクション URL を取得するためのカスタムフックです。
+ * 現在の階層のルートに紐づく、動的パラメーターが具現化された実際の URL パス文字列を取得するカスタムフックです。
  *
- * @returns 現在のルートコンテキストから抽出された URL パスを返します。
+ * @returns 現在のルートに対応する具現化済みの URL パス文字列（例: `"/items/123"`）を返します。
  */
 export default function useFormAction(): string {
-  const { urlPath } = useRouteContext();
-  return urlPath;
+  return useRouteContext().urlPath;
 }

package/src/hooks/use-loader-data.ts

@@ -1,28 +1,26 @@
-import type DeferredPromise from "../core/deferred-promise.js";
+import type { NinjaPromise } from "ninja-promise";
+
 import { LoaderDataNotFoundError } from "../core/errors.js";
-import type { ILoader } from "../core/route.types.js";
-import useRouterContext from "./_use-router-context.js";
+import useRouteContext from "./use-route-context.js";
+import useRouterContext from "./use-router-context.js";
 
 /**
- * 指定されたローダーに関連付けられたデータを取得するためのカスタムフックです。
+ * 現在の階層のルートに紐づくローダー関数の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TLoader 対象となるローダーの型です。
- * @param loader データを取得したいローダーの定義です。
- * @returns ローダーの実行結果を含む `DeferredPromise` を返します。
+ * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型（非同期の解凍結果）が推論されます。
+ * @returns ローダーの実行状態を管理している `NinjaPromise` を返します。
  */
-export default function useLoaderData<TLoader extends ILoader>(
-  loader: TLoader,
-): DeferredPromise<Awaited<ReturnType<TLoader>>> {
-  const loaderData = useRouterContext((router): DeferredPromise<any> | undefined => {
-    const {
-      currentEntry,
-      loaderDataStore,
-    } = router;
-    return loaderDataStore.get(currentEntry.id)?.get(loader);
+export default function useLoaderData<TData = unknown>(): NinjaPromise<
+  Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>
+> {
+  const { loader } = useRouteContext();
+  const loaderData = useRouterContext((router) => {
+    const { currentEntry, loaderDataStore } = router;
+    return loaderDataStore.get(currentEntry.id)?.get(loader!);
   });
   if (!loaderData) {
-    throw new LoaderDataNotFoundError(loader);
+    throw new LoaderDataNotFoundError({ loader });
   }
 
-  return loaderData;
+  return loaderData satisfies NinjaPromise<unknown> as NinjaPromise<any>;
 }

package/src/hooks/use-navigate.ts

@@ -1,64 +1,105 @@
 import * as React from "react";
-import type { NavigateTo } from "../engines/engine.types.js";
-import useRouterContext from "./_use-router-context.js";
+
+import type {} from "../engines/engine.types.js";
+import useRouterContext from "./use-router-context.js";
+
+/**
+ * 遷移先のアドレスを指定するための表現型です。
+ *
+ * 完全な URL パス文字列か、またはパスの各コンポーネントを部分的にパッチするためのオブジェクトのいずれかを受け入れます。
+ */
+export type NavigateTo =
+  | string
+  | {
+      /**
+       * 遷移先のドメイン以下のリクエストパス（例: `"/dashboard"`）です。
+       */
+      readonly pathname?: string | undefined;
+
+      /**
+       * 遷移先に付与する検索クエリー文字列（例: `"?id=foo"`）です。
+       */
+      readonly search?: string | undefined;
+
+      /**
+       * 遷移先に付与するハッシュフラグメント（例: `"#profile"`）です。
+       */
+      readonly hash?: string | undefined;
+    };
 
 /**
- * 遷移（ナビゲート）を実行する際のオプション設定です。
+ * 画面遷移の挙動をカスタマイズするためのオプション型です。
  */
 export type NavigateOptions = {
   /**
-   * 履歴を置き換えるかどうかを指定します。
-   *
-   * `true` の場合は現在のエントリーを置換し、`false` または未定義の場合は新しいエントリーを追加します。
+   * 履歴スタックへの追加方法を制御します。`true` の場合は現在の履歴を上書きし、`false` または省略時は新規追加します。
    */
   readonly replace?: boolean | undefined;
 };
 
 /**
- * 指定されたパスへ遷移するための関数インターフェースです。
+ * プログラムから命令的に画面遷移を実行する、`NavigateFunction` 関数のオーバーロードインターフェース定義です。
  */
-export interface INavigate {
+export interface NavigateFunction {
   /**
-   * ナビゲーションを実行します。
+   * 指定されたアドレスへ画面を遷移させます。
    *
-   * @param to 遷移先です。
-   * @param options 遷移時のオプション設定です。
+   * @param to 遷移先の対象となるデータ表現です。
+   * @param options 履歴のスタック方法などを制御するオプションです。
    */
-  (to: NavigateTo, options?: NavigateOptions | undefined): void;
+  (to: NavigateTo, options?: NavigateOptions): void;
 
   /**
-   * ナビゲーションを実行します。
+   * ブラウザーのセッション履歴スタック内を、現在地を基準に相対移動させます。
    *
-   * @param delta 履歴スタックの相対位置です。
+   * @param delta 移動する履歴のステップ数（例: `-1` で1つ戻る、`1` で1つ進む）です。
    */
   (delta: number): void;
 }
 
 /**
- * プログラムによる遷移（ナビゲート）を行うための関数を取得するカスタムフックです。
- *
- * コンポーネント内でこのフックを使用することで、ボタンのクリックイベントなどで任意のパスへ移動できるようになります。
+ * リンクなどを介さない、ボタンのクリックハンドラーや非同期処理の完了時などから、プログラムによって命令的に画面遷移や履歴移動をトリガーするための関数を取得するカスタムフックです。
  *
- * @returns 遷移を実行するための関数である `INavigate` を返します。
+ * @returns `NavigateFunction` 関数です。
  */
-export default function useNavigate(): INavigate {
-  const call = useRouterContext(router => router.navigate);
+export default function useNavigate(): NavigateFunction {
+  const routerNavigate = useRouterContext((router) => router.navigate);
+
+  // レンダリング毎に関数の参照が変わって子コンポーネントが不要に再描画されるのを防ぐため、useCallback でラップします。
   return React.useCallback(
     function navigate(...args: [NavigateTo, options?: NavigateOptions | undefined] | [number]) {
       if (typeof args[0] === "number") {
         const [delta] = args;
-        return call({ delta });
+
+        return routerNavigate({
+          type: "MOVE",
+          delta,
+        });
       }
 
       const [to, options = {}] = args;
       const { replace = false } = options;
-      return call({
-        to,
-        history: replace
-          ? "replace"
-          : "push",
-      });
+      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,
+        });
+      }
     },
-    [call],
+    [routerNavigate],
   );
 }

package/src/hooks/use-params.ts

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

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

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

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

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

package/src/hooks/use-submit.ts

@@ -1,111 +1,106 @@
 import * as React from "react";
+
 import type { ReadonlyFormData } from "../core/readonly-form-data.types.js";
 import type { ReadonlyURLSearchParams } from "../core/readonly-url.types.js";
-import type { IAction } from "../core/route.types.js";
-import useRouterContext from "./_use-router-context.js";
 import useFormAction from "./use-form-action.js";
+import useRouterContext from "./use-router-context.js";
 
 /**
- * GET メソッドによる送信時のオプションです。
+ * クエリーパラメーター送信（HTTP GET 相当）のサブミット処理をカスタマイズするためのオプション型です。
  */
 export type SubmitGetOptions = {
   /**
-   * 送信先のパスです。
+   * 送信先（遷移先）のベースとなる URL パスを明示的に上書き指定します。省略時は現在のフォームアクションパスが使用されます。
    */
   readonly action?: string | undefined;
 
   /**
-   * 現在の履歴エントリーを置き換えるかどうかを指定します。
+   * 履歴スタックへの追加方法を制御します。`true` の場合は現在の履歴を上書きし、`false` または省略時は新規追加します。
    */
   readonly replace?: boolean | undefined;
 };
 
 /**
- * POST メソッドによる送信時のオプションです。
+ * フォームデータ送信（HTTP POST 相当）のサブミット処理をカスタマイズするためのオプション型です。
  */
 export type SubmitPostOptions = {
   /**
-   * 送信先のパスです。
+   * 送信先（アクション実行先）の URL パスを明示的に上書き指定します。省略時は現在のフォームアクションパスが使用されます。
    */
   readonly action?: string | undefined;
-
-  /**
-   * 実行するアクションの定義です。
-   */
-  readonly actionId?: IAction | undefined;
 };
 
 /**
- * 送信処理に使用するオプションの連合型です。
- */
-export type SubmitOptions = SubmitGetOptions | SubmitPostOptions;
-
-/**
- * データを送信するための関数インターフェースです。
+ * プログラムから命令的にデータ送信および画面遷移を実行する、`submit` 関数のオーバーロードインターフェース定義です。
  */
-export interface ISubmit {
+export interface SubmitFunction {
   /**
-   * フォーム データを送信します。
+   * 不変のフォームデータを引き渡して、HTTP POST 相当のアクション処理をトリガーします。
    *
-   * @param target 送信対象のフォームデータです。
-   * @param options 送信時のオプションです。
+   * @param target 送信するフォームデータです。
+   * @param options POST 送信用のオプションです。
    */
-  (target: ReadonlyFormData, options?: SubmitPostOptions | undefined): void;
+  (target: ReadonlyFormData, options?: SubmitPostOptions): void;
 
   /**
-   * URL クエリーパラメーターを送信します。
+   * 不変のクエリーパラメーターを引き渡して、HTTP GET 相当の検索条件の更新をトリガーします。
    *
-   * @param target 送信対象の URL クエリーパラメーターです。
-   * @param options 送信時のオプションです。
+   * @param target 送信する検索クエリーです。
+   * @param options GET 送信用のオプションです。
    */
-  (target: ReadonlyURLSearchParams, options?: SubmitGetOptions | undefined): void;
+  (target: ReadonlyURLSearchParams, options?: SubmitGetOptions): void;
 
   /**
-   * フォーム データまたは URL クエリーパラメーターを送信します。
+   * 内部実装および包括的なユースケースに対応する汎用シグニチャーです。
    *
-   * @param target 送信対象のデータです。
-   * @param options 送信時のオプションです。
+   * @param target 送信愛用です。
+   * @param options オプションです。
    */
-  (target: ReadonlyURLSearchParams | ReadonlyFormData, options?: SubmitOptions | undefined): void;
+  (
+    target: ReadonlyURLSearchParams | ReadonlyFormData,
+    options?: SubmitGetOptions | SubmitPostOptions,
+  ): void;
 }
 
 /**
- * 命令的にデータを送信するための submit 関数を提供するフックです。
+ * ユーザーのクリックイベントや、特定のロジックに基づくタイミングで、プログラムから宣言的・命令的にサブミット処理（データ送信および遷移）を実行するための関数を取得するカスタムフックです。
  *
- * @returns データを送信するための ISubmit 関数を返します。
+ * 渡されたペイロードが `FormData` であるか `URLSearchParams` であるかをランタイムで自動判定し、適切なルーティングエンジンメソッドへと送信されます。
+ *
+ * @returns 依存関係が最適化され、同一参照が保証された `submit` 関数を返します。
  */
-export default function useSubmit(): ISubmit {
+export default function useSubmit(): SubmitFunction {
   const formAction = useFormAction();
-  const call = useRouterContext(router => router.submit);
+  const routerSubmit = useRouterContext((router) => router.submit);
+
+  // レンダリング毎に関数の参照が変わって子コンポーネントが不要に再描画されるのを防ぐため、useCallback でラップします。
   return React.useCallback(
     function submit(target, options = {}) {
       if (target instanceof FormData) {
-        const {
-          action = formAction,
-          actionId,
-        } = options as SubmitPostOptions;
-        return call({
+        // 分岐 1: データ実体がフォームデータである場合 ＝ 副作用を伴うデータ変更処理（POST / Action 契機）
+
+        const { action = formAction } = options as SubmitPostOptions;
+
+        // エンジンに対して「FORM_DATA」タイプとしてのサブミットタスクを発行します。
+        return routerSubmit({
+          type: "FORM_DATA",
           target,
           action,
-          actionId,
         });
       } else {
-        const {
-          action = formAction,
-          replace,
-        } = options as SubmitGetOptions;
-        return call({
+        // 分岐 2: データ実体がクエリーパラメーターである場合 ＝ 読み取り専用の条件更新処理（GET / Loader 契機）
+
+        const { action = formAction, replace } = options as SubmitGetOptions;
+
+        return routerSubmit({
+          type: "URL_SEARCH_PARAMS",
           target: target as URLSearchParams,
           action,
-          history: replace
-            ? "replace"
-            : "push",
+          // replace の真偽値に基づき、ブラウザー履歴の追加方法（push / replace）を明示的にマッピングします。
+          history: replace ? "replace" : "push",
         });
       }
     },
-    [
-      call,
-      formAction,
-    ],
+    [routerSubmit, formAction],
   );
 }

package/src/soseki.ts

@@ -1,46 +1,55 @@
-export type * from "./components/action-id.jsx";
-export { default as ActionId } from "./components/action-id.jsx";
-
 export type * from "./components/browser-router.jsx";
 export { default as BrowserRouter } from "./components/browser-router.jsx";
 
-export type * from "./components/hidden-input.jsx";
-export { default as HiddenInput } from "./components/hidden-input.jsx";
-
 export type * from "./components/outlet.jsx";
 export { default as Outlet } from "./components/outlet.jsx";
 
-export type * from "./core/deferred-promise.js";
-export { default as DeferredPromise } from "./core/deferred-promise.js";
-
-export type { ErrorMeta, ErrorOptions, ISosekiErrorConstructor, Issue } from "./core/errors.js";
+/**************************************************************************************************/
+
+export type {
+  Issue,
+  UnreachableErrorArgs,
+  UnreachableErrorMeta,
+  LoaderConditionErrorArgs,
+  LoaderConditionErrorMeta,
+  LoaderDataNotFoundErrorArgs,
+  LoaderDataNotFoundErrorMeta,
+  UnexpectedValidationErrorArgs,
+  UnexpectedValidationErrorMeta,
+} from "./core/errors.js";
 export {
-  ActionConditionError,
-  ActionExecutionError,
   ErrorBase,
+  setErrorMessage,
+  UnreachableError,
+  ValidationErrorBase,
   LoaderConditionError,
-  MultipleRedirectError,
-  NavigationApiNotSupportedError,
+  LoaderDataNotFoundError,
   RouteContextMissingError,
   RouterContextMissingError,
-  setErrorMessage,
   UnexpectedValidationError,
-  UnreachableError,
-  ValidationErrorBase,
+  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";
 
@@ -50,26 +59,10 @@ 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-pathname.js";
-export { default as usePathname } from "./hooks/use-pathname.js";
-
 export type * from "./hooks/use-submit.js";
 export { default as useSubmit } from "./hooks/use-submit.js";
 
-export type * from "./utils/get-action-id.js";
-export { default as getActionId } from "./utils/get-action-id.js";
-
-export type * from "./utils/href.js";
-export { default as href } from "./utils/href.js";
+/**************************************************************************************************/
 
 export type * from "./utils/redirect.js";
 export { default as redirect } from "./utils/redirect.js";
-
-export type * from "./utils/route-index.js";
-export { default as index } from "./utils/route-index.js";
-
-export type * from "./utils/route-route.js";
-export { default as route } from "./utils/route-route.js";
-
-export type * from "./utils/set-action-id.js";
-export { default as setActionId } from "./utils/set-action-id.js";

package/src/utils/redirect.ts

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