soseki 0.0.6 → 0.0.8

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

@@ -5,13 +5,27 @@ import type RedirectResponse from "../core/redirect-response.js";
  *
  * アクションがリダイレクトを返した場合、フレームワークの内部仕様によって実際の値は `undefined` に置換されるため、型定義においてもその挙動を忠実に表現します。
  */
-type ActionResult<TResult> = TResult extends RedirectResponse ? undefined : TResult;
+type ActionResult<TResult> = Awaited<TResult extends RedirectResponse ? undefined : TResult>;
+/**
+ * アクション関数またはデータ型から、最終的に解決されるデータの型を抽出するユーティリティー型です。
+ *
+ * @template TData アクション関数、または解決されるデータの型です。
+ */
+export type FulfilledActionData<TData = unknown> = ActionResult<TData extends (...args: any) => infer TReturn ? TReturn : TData>;
+/**
+ * {@link useActionData|`useActionData`} カスタムフックが返すオブジェクトの型定義です。
+ *
+ * 非同期処理の進行状況を管理する `NinjaPromise` でラップされた、解決済みのデータ型を表します。
+ *
+ * @template TData アクション関数、またはアクションが返すデータの型定義です。
+ */
+export type ActionData<TData = unknown> = NinjaPromise<FulfilledActionData<TData>>;
 /**
  * 現在の階層のルートに紐づくアクション関数の最新の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその戻り値の型（推論結果）が解凍されます。
+ * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns アクションが実行済み、または実行中であれば結果を内包した `NinjaPromise` を返し、一度も実行されていないか対象のアクションが存在しない場合は `undefined` を返します。
  */
-export default function useActionData<TData = unknown>(): NinjaPromise<ActionResult<Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>>> | undefined;
+export default function useActionData<TData = unknown>(): ActionData<TData> | undefined;
 export {};
 //# sourceMappingURL=use-action-data.d.ts.map

package/dist/src/hooks/use-action-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-action-data.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-action-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,gBAAgB,MAAM,8BAA8B,CAAC;AAIjE;;;;GAIG;AACH,KAAK,YAAY,CAAC,OAAO,IAAI,OAAO,SAAS,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,GAAG,OAAO,KACjD,YAAY,CACV,YAAY,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC,CACvF,GACD,SAAS,CAQZ"}
+{"version":3,"file":"use-action-data.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-action-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,gBAAgB,MAAM,8BAA8B,CAAC;AAIjE;;;;GAIG;AACH,KAAK,YAAY,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,SAAS,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,OAAO,IAAI,YAAY,CAC7D,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAChE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,OAAO,IAAI,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,GAAG,OAAO,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,CAQtF"}

package/dist/src/hooks/use-action-data.js

@@ -3,7 +3,7 @@ import useRouterContext from "./use-router-context.js";
 /**
  * 現在の階層のルートに紐づくアクション関数の最新の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその戻り値の型（推論結果）が解凍されます。
+ * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns アクションが実行済み、または実行中であれば結果を内包した `NinjaPromise` を返し、一度も実行されていないか対象のアクションが存在しない場合は `undefined` を返します。
  */
 export default function useActionData() {

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

@@ -1,9 +1,23 @@
 import type { NinjaPromise } from "ninja-promise";
+/**
+ * ローダー関数またはデータ型から、最終的に解決されるデータの型を抽出するユーティリティー型です。
+ *
+ * @template TData ローダー関数、または解決されるデータの型です。
+ */
+export type FulfilledLoaderData<TData = unknown> = Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>;
+/**
+ * {@link useLoaderData|`useLoaderData`} カスタムフックが返すオブジェクトの型定義です。
+ *
+ * 非同期処理の進行状況を管理する `NinjaPromise` でラップされた、解決済みのデータ型を表します。
+ *
+ * @template TData ローダー関数、またはローダーが返すデータの型定義です。
+ */
+export type LoaderData<TData = unknown> = NinjaPromise<FulfilledLoaderData<TData>>;
 /**
  * 現在の階層のルートに紐づくローダー関数の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型（非同期の解凍結果）が推論されます。
+ * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns ローダーの実行状態を管理している `NinjaPromise` を返します。
  */
-export default function useLoaderData<TData = unknown>(): NinjaPromise<Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>>;
+export default function useLoaderData<TData = unknown>(): LoaderData<TData>;
 //# sourceMappingURL=use-loader-data.d.ts.map

package/dist/src/hooks/use-loader-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-loader-data.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-loader-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,GAAG,OAAO,KAAK,YAAY,CACpE,OAAO,CAAC,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC,CACzE,CAWA"}
+{"version":3,"file":"use-loader-data.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-loader-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,OAAO,IAAI,OAAO,CACxD,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,CAChE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,OAAO,IAAI,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,GAAG,OAAO,KAAK,UAAU,CAAC,KAAK,CAAC,CAW1E"}

package/dist/src/hooks/use-loader-data.js

@@ -4,7 +4,7 @@ import useRouterContext from "./use-router-context.js";
 /**
  * 現在の階層のルートに紐づくローダー関数の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型（非同期の解凍結果）が推論されます。
+ * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns ローダーの実行状態を管理している `NinjaPromise` を返します。
  */
 export default function useLoaderData() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soseki",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "",
   "homepage": "https://github.com/tai-kun/soseki.js",
   "license": "MIT",
@@ -33,6 +33,7 @@
     }
   },
   "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",
@@ -43,7 +44,6 @@
     "type-name": "^2.0.2"
   },
   "devDependencies": {
-    "@tai-kun/valibot-extra-lab": "^0.0.5",
     "@tsconfig/node24": "^24.0.4",
     "@tsconfig/strictest": "^2.0.8",
     "@types/node": "^24.12.4",

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

@@ -9,24 +9,38 @@ import useRouterContext from "./use-router-context.js";
  *
  * アクションがリダイレクトを返した場合、フレームワークの内部仕様によって実際の値は `undefined` に置換されるため、型定義においてもその挙動を忠実に表現します。
  */
-type ActionResult<TResult> = TResult extends RedirectResponse ? undefined : TResult;
+type ActionResult<TResult> = Awaited<TResult extends RedirectResponse ? undefined : TResult>;
+
+/**
+ * アクション関数またはデータ型から、最終的に解決されるデータの型を抽出するユーティリティー型です。
+ *
+ * @template TData アクション関数、または解決されるデータの型です。
+ */
+export type FulfilledActionData<TData = unknown> = ActionResult<
+  TData extends (...args: any) => infer TReturn ? TReturn : TData
+>;
+
+/**
+ * {@link useActionData|`useActionData`} カスタムフックが返すオブジェクトの型定義です。
+ *
+ * 非同期処理の進行状況を管理する `NinjaPromise` でラップされた、解決済みのデータ型を表します。
+ *
+ * @template TData アクション関数、またはアクションが返すデータの型定義です。
+ */
+export type ActionData<TData = unknown> = NinjaPromise<FulfilledActionData<TData>>;
 
 /**
  * 現在の階層のルートに紐づくアクション関数の最新の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその戻り値の型（推論結果）が解凍されます。
+ * @template TData アクション関数そのものの型、またはアクションが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns アクションが実行済み、または実行中であれば結果を内包した `NinjaPromise` を返し、一度も実行されていないか対象のアクションが存在しない場合は `undefined` を返します。
  */
-export default function useActionData<TData = unknown>():
-  | NinjaPromise<
-      ActionResult<Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>>
-    >
-  | undefined {
+export default function useActionData<TData = unknown>(): ActionData<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;
+  return actionData satisfies ActionData<unknown> | undefined as ActionData<any> | undefined;
 }

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

@@ -4,15 +4,31 @@ import { LoaderDataNotFoundError } from "../core/errors.js";
 import useRouteContext from "./use-route-context.js";
 import useRouterContext from "./use-router-context.js";
 
+/**
+ * ローダー関数またはデータ型から、最終的に解決されるデータの型を抽出するユーティリティー型です。
+ *
+ * @template TData ローダー関数、または解決されるデータの型です。
+ */
+export type FulfilledLoaderData<TData = unknown> = Awaited<
+  TData extends (...args: any) => infer TReturn ? TReturn : TData
+>;
+
+/**
+ * {@link useLoaderData|`useLoaderData`} カスタムフックが返すオブジェクトの型定義です。
+ *
+ * 非同期処理の進行状況を管理する `NinjaPromise` でラップされた、解決済みのデータ型を表します。
+ *
+ * @template TData ローダー関数、またはローダーが返すデータの型定義です。
+ */
+export type LoaderData<TData = unknown> = NinjaPromise<FulfilledLoaderData<TData>>;
+
 /**
  * 現在の階層のルートに紐づくローダー関数の実行結果を購読・取得するためのカスタムフックです。
  *
- * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型（非同期の解凍結果）が推論されます。
+ * @template TData ローダー関数そのものの型、またはローダーが返すことが期待されるデータ構造の型定義です。関数型が渡された場合は、自動的にその非同期戻り値の型が推論されます。
  * @returns ローダーの実行状態を管理している `NinjaPromise` を返します。
  */
-export default function useLoaderData<TData = unknown>(): NinjaPromise<
-  Awaited<TData extends (...args: any) => infer TReturn ? TReturn : TData>
-> {
+export default function useLoaderData<TData = unknown>(): LoaderData<TData> {
   const { loader } = useRouteContext();
   const loaderData = useRouterContext((router) => {
     const { currentEntry, loaderDataStore } = router;
@@ -22,5 +38,5 @@ export default function useLoaderData<TData = unknown>(): NinjaPromise<
     throw new LoaderDataNotFoundError({ loader });
   }
 
-  return loaderData satisfies NinjaPromise<unknown> as NinjaPromise<any>;
+  return loaderData satisfies LoaderData<unknown> as LoaderData<any>;
 }