soseki 0.0.5 → 0.0.7

package/src/core/errors.ts

@@ -1,164 +1,60 @@
+import { type ErrorMeta, type ErrorOptions, I18nErrorBase, setErrorMessage } from "i18n-error-base";
+import { inspect } from "inspect-lite";
+import { isThenable } from "maypromise";
 import getTypeName from "type-name";
-import { type BaseIssue, getGlobalConfig } from "valibot";
-import isPromiseLike from "./_is-promise-like.js";
-import singleton from "./_singleton.js";
+import type { BaseIssue } from "valibot";
 
-/***************************************************************************************************
- *
- * 型
- *
- **************************************************************************************************/
-
-/**
- * エラーのオプションです。
- */
-export type ErrorOptions = Readonly<{
-  /**
-   * エラーの原因です。
-   */
-  cause?: unknown;
-}>;
-
-/**
- * エラーに紐づくメタデータです。
- */
-export type ErrorMeta = {
-  readonly [prop: string]: unknown;
-};
-
-/**
- * soseki におけるエラーのコンストラクターです。
- */
-export interface ISosekiErrorConstructor {
-  new(...args: any): ErrorBase<ErrorMeta | undefined>;
-}
-
-/**
- * 検証エラーの問題点です。
- */
-export type Issue = BaseIssue<unknown>;
-
-/***************************************************************************************************
- *
- * ユーティリティー
- *
- **************************************************************************************************/
+/**************************************************************************************************/
 
-/**
- * エラーコンストラクターと言語ごとのエラーメッセージ作成関数のマップを取得します。
- *
- * @returns エラーコンストラクターと言語ごとのエラーメッセージ作成関数のマップです。
- */
-function getMessage(): WeakMap<Function | object, Map<string, (error: any) => string>> {
-  return singleton("errors__message", () => new WeakMap());
-}
+export type { ErrorMeta, ErrorOptions };
+export { setErrorMessage };
 
-/**
- * エラーコンストラクター内でメッセージプロパティーを初期化します。
- *
- * @template TInstance エラーオブジェクトの型です。
- * @param instance エラーオブジェクトです。
- * @param message エラーメッセージです。
- */
-function initMessage<TInstance extends Error>(
-  instance: TInstance,
-  message: (error: TInstance) => string,
-): void {
-  const reference = instance.constructor;
-  const { lang = "en" } = getGlobalConfig();
-  const msg = getMessage();
-  const store = msg.get(reference);
-  const genMessage = store?.get(lang) ?? message;
-  instance.message = genMessage(instance);
-}
+/**************************************************************************************************/
 
 /**
- * soseki のエラーに特定の言語でエラーメッセージを設定します。
+ * データ検証の過程で検出された具体的な問題点を表す型定義です。
  *
- * @template TReference soseki のエラーコンストラクターの型です。
- * @param reference soseki のエラーコンストラクターです。
- * @param message エラーメッセージです。
- * @param lang 言語です。
- * @example
- * ```ts
- * setErrorMessage(
- *   TypeError,
- *   ({ meta }) => `${meta.expected} を期待しましたが、${meta.actual} を得ました`,
- *   "ja",
- * );
- * ```
+ * 外部のスキーマ検証ライブラリーである `valibot` の `BaseIssue` を基盤としています。
  */
-export function setErrorMessage<TReference extends ISosekiErrorConstructor>(
-  reference: TReference,
-  message: (error: InstanceType<TReference>) => string,
-  lang: string,
-): void {
-  const msg = getMessage();
-  let store = msg.get(reference);
-  if (store === undefined) {
-    store = new Map();
-    msg.set(reference, store);
-  }
+export type Issue = BaseIssue<unknown>;
 
-  store.set(lang, message);
-}
+/**************************************************************************************************/
 
 /**
- * あらゆる値を文字列に整形します。
+ * soseki ルーティングライブラリーにおける、すべてのカスタムエラーの頂点に位置する基底クラスです。
  *
- * @param value 文字列に整形する値です。
- * @returns 文字列に整形された値です。
+ * @template TMeta エラーの発生コンテキストを保持するために紐付けるメタデータオブジェクトの型定義です。
  */
-function formatErrorValue(value: unknown): string {
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return String(value);
-  }
-}
+export class ErrorBase<
+  TMeta extends ErrorMeta | undefined = undefined,
+> extends I18nErrorBase<TMeta> {}
 
-/***************************************************************************************************
- *
- * エラークラス
- *
- **************************************************************************************************/
+/**************************************************************************************************/
 
 /**
- * soseki エラーの基底クラスです。
- *
- * @template TMeta エラーに紐づくメタデータです。
+ * プログラムの制御フローにおいて、理論上到達しないはずのコード領域へ侵入した際に付与されるメタデータの型定義です。
  */
-export class ErrorBase<TMeta extends ErrorMeta | undefined = undefined> extends Error {
+export type UnreachableErrorMeta = {
   /**
-   * エラーのメタデータです。
+   * 網羅性チェックをすり抜けて、実行時に入り込んできた予期せぬ不正な値です。
    */
-  public meta: Readonly<TMeta>;
+  readonly value?: unknown;
+};
 
+/**
+ * `UnreachableError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type UnreachableErrorArgs = ErrorOptions & {
   /**
-   * @internal
+   * 網羅性検証において `never` 型となるべき変数を格納した、要素数 1 のタプルまたは空の配列です。
    */
-  public constructor(options: ErrorOptions | undefined, meta: TMeta) {
-    super("", options);
-
-    if (!("cause" in this) && options && "cause" in options) {
-      this.cause = options.cause;
-    }
-
-    this.meta = meta;
-  }
-}
-
-/**************************************************************************************************/
+  readonly actual: [never?];
+};
 
 /**
- * 到達不能なコードに到達した場合に投げられるエラーです。
+ * 網羅性チェックにおいて、プログラムの制御フローが理論上決して到達しないはずの場所に達した場合に投げるエラーです。
  */
-export class UnreachableError extends ErrorBase<{
-  /**
-   * 到達しないはずの値です。
-   */
-  value?: unknown;
-}> {
+export class UnreachableError extends ErrorBase<UnreachableErrorMeta> {
   static {
     this.prototype.name = "SosekiUnreachableError";
   }
@@ -166,337 +62,143 @@ export class UnreachableError extends ErrorBase<{
   /**
    * `UnreachableError` クラスの新しいインスタンスを初期化します。
    *
-   * @param args 到達しないはずの値があれば指定します。
-   * @param options エラーのオプションです。
+   * @param args エラーオプションおよび実行時に混入した実際の値を含む引数オブジェクトです。
    */
-  public constructor(args: [never?], options?: ErrorOptions | undefined) {
-    super(options, args.length > 0 ? { value: args[0] } : {});
-    initMessage(this, ({ meta }) => (
-      "value" in meta
-        ? "Encountered impossible value: " + formatErrorValue(meta.value)
-        : "Unreachable code reached"
-    ));
+  public constructor(args: UnreachableErrorArgs) {
+    const { actual, ...options } = args;
+    super(
+      actual.length > 0 ? { value: actual[0] } : {},
+      (meta) =>
+        "value" in meta
+          ? "Encountered impossible value: " + inspect(meta.value)
+          : "Unreachable code reached",
+      options,
+    );
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
   UnreachableError,
-  ({ meta }) => (
+  (meta) =>
     "value" in meta
-      ? "不可能な値に遭遇しました: " + formatErrorValue(meta.value)
-      : "到達できないコードに到達しました"
-  ),
+      ? "不可能な値に遭遇しました: " + inspect(meta.value)
+      : "到達できないコードに到達しました",
   "ja",
 );
 
 /**************************************************************************************************/
 
 /**
- * 検証エラーの基底クラスです。
+ * データ検証の失敗に関連するエラーを集約するための共通基底クラスです。
  *
- * @template TMeta エラーに紐づくメタデータです。
+ * @template TMeta エラーに紐づく、検証結果の問題点などのメタデータ型定義です。
  */
-export class ValidationErrorBase<TMeta extends ErrorMeta> extends ErrorBase<TMeta> {
-  /**
-   * @internal
-   */
-  public constructor(options: ErrorOptions | undefined, meta: TMeta) {
-    super(options, meta);
-  }
-}
-
-/**************************************************************************************************/
-
-// /**
-//  * 入力値検証エラーの基底クラスです。
-//  *
-//  * @template TMeta エラーに紐づくメタデータです。
-//  */
-// export class InvalidInputErrorBase<TMeta extends ErrorMeta> extends ValidationErrorBase<TMeta> {
-//   /**
-//    * @internal
-//    */
-//   public constructor(options: ErrorOptions | undefined, meta: TMeta) {
-//     super(options, meta);
-//   }
-// }
-
-/**************************************************************************************************/
-
-// /**
-//  * 入力値の検証に失敗した場合に投げられるエラーです。
-//  */
-// export class InvalidInputError extends InvalidInputErrorBase<{
-//   /**
-//    * 検証エラーの問題点です。
-//    */
-//   issues: [Issue, ...Issue[]];
-
-//   /**
-//    * 検証した入力値です。
-//    */
-//   input: unknown;
-// }> {
-//   static {
-//     this.prototype.name = "SosekiInvalidInputError";
-//   }
-
-//   /**
-//    * `InvalidInputError` クラスの新しいインスタンスを初期化します。
-//    *
-//    * @param issues 検証エラーの問題点です。
-//    * @param input 検証した入力値です。
-//    * @param options エラーのオプションです。
-//    */
-//   public constructor(
-//     issues: [Issue, ...Issue[]],
-//     input: unknown,
-//     options?: ErrorOptions | undefined,
-//   ) {
-//     super(options, { issues, input });
-//     this.message = issues.map(issue => issue.message).join(": ");
-//   }
-// }
+export class ValidationErrorBase<
+  TMeta extends ErrorMeta | undefined = ErrorMeta | undefined,
+> extends ErrorBase<TMeta> {}
 
 /**************************************************************************************************/
 
 /**
- * 予期しない値に遭遇した場合に投げられるエラーです。
+ * 予期しないデータ構造や型に遭遇した際に付与される、検証エラー情報のメタデータ型定義です。
  */
-export class UnexpectedValidationError extends ValidationErrorBase<{
+export type UnexpectedValidationErrorMeta = {
   /**
-   * 検証エラーの問題点です。
+   * スキーマ検証によって不適合と判定された問題点のリストです。最低 1 つ以上の要素を持つことが保証された読み取り専用の配列です。
    */
-  issues: [Issue, ...Issue[]];
+  readonly issues: readonly [Issue, ...Issue[]];
 
   /**
-   * 予期しない値です。
+   * 検証の対象となった、予期しない生の入力値です。
    */
-  value: unknown;
-}> {
-  static {
-    this.prototype.name = "SosekiUnexpectedValidationError";
-  }
-
-  /**
-   * `UnexpectedValidationError` クラスの新しいインスタンスを初期化します。
-   *
-   * @param issues 検証エラーの問題点です。
-   * @param value 予期しない値です。
-   * @param options エラーのオプションです。
-   */
-  public constructor(
-    issues: [Issue, ...Issue[]],
-    value: unknown,
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, { issues, value });
-    this.message = issues.map(issue => issue.message).join(": ");
-  }
-}
-
-/**************************************************************************************************/
+  readonly value: unknown;
+};
 
 /**
- * shouldAction が不正な値を返した場合に投げられるエラーです。
+ * `UnexpectedValidationError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
  */
-export class ActionConditionError extends ErrorBase<{
-  /**
-   * ルートの URL です。
-   */
-  url: string;
-
-  /**
-   * shouldAction 関数です。
-   */
-  shouldAction: Function;
+export type UnexpectedValidationErrorArgs = ErrorOptions & UnexpectedValidationErrorMeta;
 
-  /**
-   * shouldAction が返した値です。
-   */
-  returnValue: unknown;
-}> {
+/**
+ * スキーマによるデータ構造の検証において、予期しない形式の値に遭遇した場合に投げるエラーです。
+ */
+export class UnexpectedValidationError extends ValidationErrorBase<UnexpectedValidationErrorMeta> {
   static {
-    this.prototype.name = "SosekiActionConditionError";
+    this.prototype.name = "SosekiUnexpectedValidationError";
   }
 
   /**
-   * `ActionConditionError` クラスの新しいインスタンスを初期化します。
+   * `UnexpectedValidationError` クラスの新しいインスタンスを初期化します。
    *
-   * @param url ルートの URL です。
-   * @param shouldAction shouldAction 関数です。
-   * @param returnValue shouldAction が返した値です。
-   * @param options エラーのオプションです。
+   * @param args エラーオプション、入力値、および検出された不適合箇所の一覧を含む引数オブジェクトです。
    */
-  public constructor(
-    url: string,
-    shouldAction: Function,
-    returnValue: unknown,
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, {
-      url,
-      returnValue,
-      shouldAction,
-    });
-    initMessage(
-      this,
-      ({ meta }) =>
-        isPromiseLike(meta.returnValue)
-          ? "shouldAction must return a boolean value synchronously"
-          : `Expected boolean, but got ${getTypeName(meta.returnValue) || "unknown"}`,
+  public constructor(args: UnexpectedValidationErrorArgs) {
+    const { value, issues, ...options } = args;
+    super(
+      { value, issues },
+      ({ issues }) => issues.map((issue) => issue.message).join(": "),
+      options,
     );
   }
 }
 
-/*#__PURE__*/ setErrorMessage(
-  ActionConditionError,
-  ({ meta }) =>
-    isPromiseLike(meta.returnValue)
-      ? "shouldAction は同期的に真偽値を返す必要があります"
-      : `真偽値を期待しましたが、${getTypeName(meta.returnValue) || "unknown"} を得ました`,
-  "ja",
-);
-
 /**************************************************************************************************/
 
 /**
- * 1 つ以上のアクションが失敗した際に投げられるエラーです。
+ * ブラウザー標準の Navigation API が、現在の実行環境でサポートされていない場合に投げるエラーです。
  */
-export class ActionExecutionError extends ErrorBase<{
-  /**
-   * ルートの URL です。
-   */
-  url: string;
-
-  /**
-   * エラーのリストです。
-   */
-  errors: readonly {
-    /**
-     * action 関数です。
-     */
-    readonly action: Function;
-
-    /**
-     * エラーの原因です。
-     */
-    readonly reason: unknown;
-  }[];
-}> {
+export class NavigationApiNotSupportedError extends ErrorBase<undefined> {
   static {
-    this.prototype.name = "SosekiActionExecutionError";
+    this.prototype.name = "SosekiNavigationApiNotSupportedError";
   }
 
   /**
-   * `ActionExecutionError` クラスの新しいインスタンスを初期化します。
+   * `NavigationApiNotSupportedError` クラスの新しいインスタンスを初期化します。
    *
-   * @param url ルートの URL です。
-   * @param errors エラーのリストです。
-   * @param options エラーのオプションです。
+   * @param options エラーの共通オプションです。
    */
-  public constructor(
-    url: string,
-    errors: readonly {
-      /**
-       * action 関数です。
-       */
-      action: Function;
-
-      /**
-       * エラーの原因です。
-       */
-      reason: unknown;
-    }[],
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, {
-      url,
-      errors,
-    });
-    initMessage(
-      this,
-      ({ meta }) => `Errors occurred in ${meta.errors.length} action(s)`,
-    );
+  public constructor(options?: ErrorOptions) {
+    super("The Navigation API is not supported in this environment", options);
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
-  ActionExecutionError,
-  ({ meta }) => `${meta.errors.length} 個のアクションでエラーが発生しました。`,
+  NavigationApiNotSupportedError,
+  "現在の環境では Navigation API がサポートされていません",
   "ja",
 );
 
 /**************************************************************************************************/
 
 /**
- * 複数のアクションからリダイレクトが返された際に投げられるエラーです。
+ * データの再読み込み判定において、不正なデータ型が検出された際に付与されるメタデータの型定義です。
  */
-export class MultipleRedirectError extends ErrorBase<{
+export type LoaderConditionErrorMeta = {
   /**
-   * ルートの URL です。
+   * エラーが発生した対象ルートの URL パス文字列です。
    */
-  url: string;
+  readonly url: string;
 
   /**
-   * 検出されたリダイレクト先パスのリストです。
+   * 不正な値を返した対象の `shouldReload` 関数の参照です。
    */
-  redirects: readonly string[];
-}> {
-  static {
-    this.prototype.name = "SosekiMultipleRedirectError";
-  }
+  readonly shouldReload: Function;
 
   /**
-   * `MultipleRedirectError` クラスの新しいインスタンスを初期化します。
-   *
-   * @param url ルートの URL です。
-   * @param redirects リダイレクト先パスのリストです。
-   * @param options エラーのオプションです。
+   * `shouldReload` 関数が実際に返した、期待値とは異なるオブジェクトやプリミティブ値です。
    */
-  public constructor(
-    url: string,
-    redirects: readonly string[],
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, {
-      url,
-      redirects,
-    });
-    initMessage(
-      this,
-      ({ meta }) => `Multiple redirects detected: ${meta.redirects.join(", ")}`,
-    );
-  }
-}
-
-/*#__PURE__*/ setErrorMessage(
-  MultipleRedirectError,
-  ({ meta }) => `複数のリダイレクトが検出されました: ${meta.redirects.join(", ")}`,
-  "ja",
-);
-
-/**************************************************************************************************/
+  readonly returnValue: unknown;
+};
 
 /**
- * shouldLoader が不正な値を返した場合に投げられるエラーです。
+ * `LoaderConditionError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
  */
-export class LoaderConditionError extends ErrorBase<{
-  /**
-   * ルートの URL です。
-   */
-  url: string;
+export type LoaderConditionErrorArgs = ErrorOptions & LoaderConditionErrorMeta;
 
-  /**
-   * shouldLoader 関数です。
-   */
-  shouldLoader: Function;
-
-  /**
-   * shouldLoader が返した値です。
-   */
-  returnValue: unknown;
-}> {
+/**
+ * ユーザーが定義した `shouldReload` 関数が、仕様に準拠した同期的な真偽値ではなく、不正な値を返した場合に投げるエラーです。
+ */
+export class LoaderConditionError extends ErrorBase<LoaderConditionErrorMeta> {
   static {
     this.prototype.name = "SosekiLoaderConditionError";
   }
@@ -504,84 +206,60 @@ export class LoaderConditionError extends ErrorBase<{
   /**
    * `LoaderConditionError` クラスの新しいインスタンスを初期化します。
    *
-   * @param url ルートの URL です。
-   * @param shouldLoader shouldLoader 関数です。
-   * @param returnValue shouldLoader が返した値です。
-   * @param options エラーのオプションです。
+   * @param args エラーオプション、対象URL、関数の参照、および実際の戻り値を含む引数オブジェクトです。
    */
-  public constructor(
-    url: string,
-    shouldLoader: Function,
-    returnValue: unknown,
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, {
-      url,
-      returnValue,
-      shouldLoader,
-    });
-    initMessage(
-      this,
-      ({ meta }) =>
-        isPromiseLike(meta.returnValue)
-          ? "shouldLoader must return a boolean value synchronously"
-          : `Expected boolean, but got ${getTypeName(meta.returnValue) || "unknown"}`,
+  public constructor(args: LoaderConditionErrorArgs) {
+    const { url, returnValue, shouldReload, ...options } = args;
+    super(
+      { url, returnValue, shouldReload },
+      ({ returnValue }) =>
+        isThenable(returnValue)
+          ? "shouldReload must return a boolean value synchronously"
+          : `Expected boolean, but got ${getTypeName(returnValue) || "unknown"}`,
+      options,
     );
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
   LoaderConditionError,
-  ({ meta }) =>
-    isPromiseLike(meta.returnValue)
-      ? "shouldLoader は同期的に真偽値を返す必要があります"
-      : `真偽値を期待しましたが、${getTypeName(meta.returnValue) || "unknown"} を得ました`,
+  ({ returnValue }) =>
+    isThenable(returnValue)
+      ? "shouldReload は同期的に真偽値を返す必要があります"
+      : `真偽値を期待しましたが、${getTypeName(returnValue) || "unknown"} を得ました`,
   "ja",
 );
 
 /**************************************************************************************************/
 
 /**
- * Navigation API が現在の環境でサポートされていない場合に投げられるエラーです。
+ * ルーター全体の共通状態 `RouterContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
  */
-export class NavigationApiNotSupportedError extends ErrorBase<{
-  /**
-   * 現在のブラウザの UserAgent です。
-   */
-  userAgent: string;
-}> {
+export class RouterContextMissingError extends ErrorBase<undefined> {
   static {
-    this.prototype.name = "SosekiNavigationApiNotSupportedError";
+    this.prototype.name = "SosekiRouterContextMissingError";
   }
 
   /**
-   * `NavigationApiNotSupportedError` クラスの新しいインスタンスを初期化します。
+   * `RouterContextMissingError` クラスの新しいインスタンスを初期化します。
    *
-   * @param options エラーのオプションです。
+   * @param options エラーの共通オプションです。
    */
-  public constructor(options?: ErrorOptions | undefined) {
-    super(options, {
-      userAgent: typeof window !== "undefined"
-        ? window.navigator.userAgent
-        : "unknown",
-    });
-    initMessage(
-      this,
-      () => "The Navigation API is not supported in this environment",
-    );
+  public constructor(options?: ErrorOptions) {
+    super("RouterContext not found. Did you forget to wrap your app in <Router />?", options);
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
-  NavigationApiNotSupportedError,
-  () => "現在の環境では Navigation API がサポートされていません",
+  RouterContextMissingError,
+  "RouterContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？",
   "ja",
 );
 
 /**************************************************************************************************/
 
 /**
- * RouteContext が供給されていない場合に投げられるエラーです。
+ * 個々のルート固有の状態 `RouteContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
  */
 export class RouteContextMissingError extends ErrorBase<undefined> {
   static {
@@ -591,66 +269,40 @@ export class RouteContextMissingError extends ErrorBase<undefined> {
   /**
    * `RouteContextMissingError` クラスの新しいインスタンスを初期化します。
    *
-   * @param options エラーのオプションです。
+   * @param options エラーの共通オプションです。
    */
-  public constructor(options?: ErrorOptions | undefined) {
-    // メタデータは不要なため undefined を渡す
-    super(options, undefined);
-    initMessage(
-      this,
-      () => "RouteContext not found. Did you forget to wrap your app in <Router />?",
-    );
+  public constructor(options?: ErrorOptions) {
+    super("RouteContext not found. Did you forget to wrap your app in <Router />?", options);
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
   RouteContextMissingError,
-  () => "RouteContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？",
+  "RouteContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？",
   "ja",
 );
 
 /**************************************************************************************************/
 
 /**
- * RouterContext が供給されていない場合に投げられるエラーです。
+ * ローダーデータの紛失を通知する際に付与されるメタデータの型定義です。
  */
-export class RouterContextMissingError extends ErrorBase<undefined> {
-  static {
-    this.prototype.name = "SosekiRouterContextMissingError";
-  }
-
+export type LoaderDataNotFoundErrorMeta = {
   /**
-   * `RouterContextMissingError` クラスの新しいインスタンスを初期化します。
-   *
-   * @param options エラーのオプションです。
+   * データの取得を試みた対象のローダー関数の参照です。未定義の場合は `undefined` となることがあります。
    */
-  public constructor(options?: ErrorOptions | undefined) {
-    // メタデータは不要なため undefined を渡す
-    super(options, undefined);
-    initMessage(
-      this,
-      () => "RouterContext not found. Did you forget to wrap your app in <Router />?",
-    );
-  }
-}
-
-/*#__PURE__*/ setErrorMessage(
-  RouterContextMissingError,
-  () => "RouterContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？",
-  "ja",
-);
+  readonly loader: Function | undefined;
+};
 
-/**************************************************************************************************/
+/**
+ * `LoaderDataNotFoundError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type LoaderDataNotFoundErrorArgs = ErrorOptions & LoaderDataNotFoundErrorMeta;
 
 /**
- * ローダーに紐づくデータが見つからない場合に投げられるエラーです。
+ * ルートに紐づくデータ取得用のローダー関数が正常に処理されたはずであるにもかかわらず、該当するキャッシュデータや応答結果が見つからない場合に投げるエラーです。
  */
-export class LoaderDataNotFoundError extends ErrorBase<{
-  /**
-   * データが見つからなかった loader 関数です。
-   */
-  loader: Function;
-}> {
+export class LoaderDataNotFoundError extends ErrorBase<LoaderDataNotFoundErrorMeta> {
   static {
     this.prototype.name = "SosekiLoaderDataNotFoundError";
   }
@@ -658,23 +310,26 @@ export class LoaderDataNotFoundError extends ErrorBase<{
   /**
    * `LoaderDataNotFoundError` クラスの新しいインスタンスを初期化します。
    *
-   * @param loader データが見つからなかった loader 関数です。
-   * @param options エラーのオプションです。
+   * @param args エラーオプションおよび対象ローダー関数の参照を含む引数オブジェクトです。
    */
-  public constructor(
-    loader: Function,
-    options?: ErrorOptions | undefined,
-  ) {
-    super(options, { loader });
-    initMessage(
-      this,
-      ({ meta }) => `Loader data not found (Loader: ${meta.loader.name || "anonymous"})`,
+  public constructor(args: LoaderDataNotFoundErrorArgs) {
+    const { loader, ...options } = args;
+    super(
+      { loader },
+      ({ loader }) =>
+        loader
+          ? `Loader data not found (Function name: ${loader.name || "anonymous"})`
+          : "Loader is undefined",
+      options,
     );
   }
 }
 
 /*#__PURE__*/ setErrorMessage(
   LoaderDataNotFoundError,
-  ({ meta }) => `ローダーデータが見つかりません（Loader: ${meta.loader.name || "匿名"}）`,
+  ({ loader }) =>
+    loader
+      ? `ローダーデータが見つかりません（関数名: ${loader.name || "匿名"}）`
+      : "ローダーが未定義です。",
   "ja",
 );