@fringeworks/react-utils 0.10.0 → 0.12.0

package/hooks/useCombinedRefs/useCombinedRefs.d.mts

@@ -2,8 +2,10 @@ import { Ref, RefCallback } from "react";
 //#region src/hooks/useCombinedRefs/useCombinedRefs.d.ts
 /**
  * 複数のrefに纏めて値を渡すことができるRefCallbackを取得する
+ *
+ * null・undefined のrefは無視する（省略できる `ref` のプロパティをそのまま渡せる）
  * @param refs
  * @returns
  */
-export default function useCombinedRefs<T = unknown>(...refs: Ref<T>[]): RefCallback<T>;
+export default function useCombinedRefs<T = unknown>(...refs: (Ref<T> | undefined)[]): RefCallback<T>;
 //#endregion

package/hooks/useCombinedRefs/useCombinedRefs.mjs

@@ -6,6 +6,8 @@ import { useCallback } from "react";
 //#region src/hooks/useCombinedRefs/useCombinedRefs.ts
 /**
 * 複数のrefに纏めて値を渡すことができるRefCallbackを取得する
+*
+* null・undefined のrefは無視する（省略できる `ref` のプロパティをそのまま渡せる）
 * @param refs
 * @returns
 */

package/hooks/useExecutionAt/index.d.cts

@@ -1,3 +1,3 @@
-import { ExecutionFunction, ExecutionRequest, UseExecutionAtOptions, UseExecutionAtResult } from "./types.cjs";
+import { ExecutionFunction, ExecutionRequest, UseExecutionAtResult } from "./types.cjs";
 import useExecutionAt from "./useExecutionAt.cjs";
-export { type ExecutionFunction, type ExecutionRequest, type UseExecutionAtOptions, type UseExecutionAtResult, useExecutionAt as default, useExecutionAt };
+export { type ExecutionFunction, type ExecutionRequest, type UseExecutionAtResult, useExecutionAt as default, useExecutionAt };

package/hooks/useExecutionAt/index.d.mts

@@ -1,3 +1,3 @@
-import { ExecutionFunction, ExecutionRequest, UseExecutionAtOptions, UseExecutionAtResult } from "./types.mjs";
+import { ExecutionFunction, ExecutionRequest, UseExecutionAtResult } from "./types.mjs";
 import useExecutionAt from "./useExecutionAt.mjs";
-export { type ExecutionFunction, type ExecutionRequest, type UseExecutionAtOptions, type UseExecutionAtResult, useExecutionAt as default, useExecutionAt };
+export { type ExecutionFunction, type ExecutionRequest, type UseExecutionAtResult, useExecutionAt as default, useExecutionAt };

package/hooks/useExecutionAt/types.d.cts

@@ -1,14 +1,5 @@
-import { MarkAtResult } from "../../utils/markAt/types.cjs";
+import { ExecutionMark } from "../../types.cjs";
 //#region src/hooks/useExecutionAt/types.d.ts
-/**
- * オプション
- */
-export type UseExecutionAtOptions<P = void> = {
-  /**
-   * ペイロードの初期値
-   */
-  initialPayload?: P;
-};
 /**
  * 戻り値
  */
@@ -20,7 +11,7 @@ export type ExecutionRequest<P = void> = {
   /**
    * 実行される度に増加する値
    */
-  readonly at: MarkAtResult;
+  readonly at: ExecutionMark;
   /**
    * ペイロード
    * 初期値や実行時の引数を省略した場合は undefined

package/hooks/useExecutionAt/types.d.mts

@@ -1,14 +1,5 @@
-import { MarkAtResult } from "../../utils/markAt/types.mjs";
+import { ExecutionMark } from "../../types.mjs";
 //#region src/hooks/useExecutionAt/types.d.ts
-/**
- * オプション
- */
-export type UseExecutionAtOptions<P = void> = {
-  /**
-   * ペイロードの初期値
-   */
-  initialPayload?: P;
-};
 /**
  * 戻り値
  */
@@ -20,7 +11,7 @@ export type ExecutionRequest<P = void> = {
   /**
    * 実行される度に増加する値
    */
-  readonly at: MarkAtResult;
+  readonly at: ExecutionMark;
   /**
    * ペイロード
    * 初期値や実行時の引数を省略した場合は undefined

package/hooks/useExecutionAt/useExecutionAt.cjs

@@ -10,7 +10,6 @@ let react = require("react");
 * プロパティを通じて命令的コンポーネントのメソッドを実行する仕組みを提供する。
 *
 * @template P 実行時にExecution Requestプロパティに渡すペイロードの型
-* @param options オプション
 * @returns [request, execute]
 * - `request`: 現在のリクエスト
 * - `execute`: 新しいリクエストを発行する関数
@@ -22,10 +21,10 @@ let react = require("react");
 * // 3. 処理を実行するコンポーネント
 * <WrappedImperativeComponent undoAt={undoAt} />
 */
-function useExecutionAt(options = {}) {
+function useExecutionAt() {
 	const [executionRequest, setExecutionRequest] = (0, react.useState)({
 		at: 0,
-		payload: options.initialPayload
+		payload: void 0
 	});
 	return [executionRequest, (0, react.useCallback)((payload) => {
 		setExecutionRequest({

package/hooks/useExecutionAt/useExecutionAt.d.cts

@@ -1,4 +1,4 @@
-import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.cjs";
+import { UseExecutionAtResult } from "./types.cjs";
 //#region src/hooks/useExecutionAt/useExecutionAt.d.ts
 /**
  * Execution Requestプロパティ(xxxxxAt)へ渡す値と、\
@@ -7,7 +7,6 @@ import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.cjs";
  * プロパティを通じて命令的コンポーネントのメソッドを実行する仕組みを提供する。
  *
  * @template P 実行時にExecution Requestプロパティに渡すペイロードの型
- * @param options オプション
  * @returns [request, execute]
  * - `request`: 現在のリクエスト
  * - `execute`: 新しいリクエストを発行する関数
@@ -19,5 +18,5 @@ import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.cjs";
  * // 3. 処理を実行するコンポーネント
  * <WrappedImperativeComponent undoAt={undoAt} />
  */
-declare function useExecutionAt<P = void>(options?: UseExecutionAtOptions<P>): UseExecutionAtResult<P>;
+declare function useExecutionAt<P = void>(): UseExecutionAtResult<P>;
 export = useExecutionAt;

package/hooks/useExecutionAt/useExecutionAt.d.mts

@@ -1,4 +1,4 @@
-import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.mjs";
+import { UseExecutionAtResult } from "./types.mjs";
 //#region src/hooks/useExecutionAt/useExecutionAt.d.ts
 /**
  * Execution Requestプロパティ(xxxxxAt)へ渡す値と、\
@@ -7,7 +7,6 @@ import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.mjs";
  * プロパティを通じて命令的コンポーネントのメソッドを実行する仕組みを提供する。
  *
  * @template P 実行時にExecution Requestプロパティに渡すペイロードの型
- * @param options オプション
  * @returns [request, execute]
  * - `request`: 現在のリクエスト
  * - `execute`: 新しいリクエストを発行する関数
@@ -19,5 +18,5 @@ import { UseExecutionAtOptions, UseExecutionAtResult } from "./types.mjs";
  * // 3. 処理を実行するコンポーネント
  * <WrappedImperativeComponent undoAt={undoAt} />
  */
-export default function useExecutionAt<P = void>(options?: UseExecutionAtOptions<P>): UseExecutionAtResult<P>;
+export default function useExecutionAt<P = void>(): UseExecutionAtResult<P>;
 //#endregion

package/hooks/useExecutionAt/useExecutionAt.mjs

@@ -9,7 +9,6 @@ import { useCallback, useState } from "react";
 * プロパティを通じて命令的コンポーネントのメソッドを実行する仕組みを提供する。
 *
 * @template P 実行時にExecution Requestプロパティに渡すペイロードの型
-* @param options オプション
 * @returns [request, execute]
 * - `request`: 現在のリクエスト
 * - `execute`: 新しいリクエストを発行する関数
@@ -21,10 +20,10 @@ import { useCallback, useState } from "react";
 * // 3. 処理を実行するコンポーネント
 * <WrappedImperativeComponent undoAt={undoAt} />
 */
-function useExecutionAt(options = {}) {
+function useExecutionAt() {
 	const [executionRequest, setExecutionRequest] = useState({
 		at: 0,
-		payload: options.initialPayload
+		payload: void 0
 	});
 	return [executionRequest, useCallback((payload) => {
 		setExecutionRequest({

package/hooks/useExecutionEffect/useExecutionEffect.cjs

@@ -1,21 +1,23 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__useExecutionHandler = require("../../_helpers/_useExecutionHandler.cjs");
+const require__internal__useExecutionHandler = require("../../_internal/_useExecutionHandler.cjs");
 let react = require("react");
 
 //#region src/hooks/useExecutionEffect/useExecutionEffect.ts
 /**
 * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに処理を実行するフック
 *
-* `useExecutionAt` と対になる、受け取る側のフック。
+* `useExecutionAt`・`useExecutionMark` と対になる、受け取る側のフック。
 * 命令的なコンポーネントをラップした React のコンポーネントで、プロパティを通じてメソッドを実行する。
 * 処理は画面に表示した後（`useEffect`）に実行する。表示する前に実行する場合は `useExecutionLayoutEffect` を使う。
 *
-* - `at` が変わったときだけ実行する（`payload` は比べない）
-* - マウントより前に出た要求（マウントしたときにすでに渡されていた要求を含む）は実行しない
+* - 印（`at`、または ExecutionMark の値）が変わったときだけ実行する（`payload` は比べない）
+* - マウントしたときに渡されていた要求は実行しない（マウントしたときの印を基準にする）
+* - 印が `0`（まだ要求していない）や undefined の場合は実行しない
+* - ExecutionMark を受け取った場合、コールバックの payload は undefined
 * - 次のレンダリングまでに複数回要求した場合は、最後の要求だけを実行する
 * - コールバックは最新のものを呼ぶ。参照が変わっても実行しない
 *
-* @param request 受け取った Execution Request。undefined の場合は要求なし
+* @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
 * @param callback 要求があったときに実行する処理。要求の payload を受け取る
 * @example
 * // 呼び出す側
@@ -27,7 +29,7 @@ let react = require("react");
 * });
 */
 function useExecutionEffect(request, callback) {
-	const handle = require__helpers__useExecutionHandler.default(request, callback);
+	const handle = require__internal__useExecutionHandler.default(request, callback);
 	(0, react.useEffect)(() => {
 		handle();
 	}, [handle]);

package/hooks/useExecutionEffect/useExecutionEffect.d.cts

@@ -1,18 +1,22 @@
+import { ExecutionMark } from "../../types.cjs";
 import { ExecutionRequest } from "../useExecutionAt/types.cjs";
+import "../useExecutionAt/index.cjs";
 //#region src/hooks/useExecutionEffect/useExecutionEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに処理を実行するフック
  *
- * `useExecutionAt` と対になる、受け取る側のフック。
+ * `useExecutionAt`・`useExecutionMark` と対になる、受け取る側のフック。
  * 命令的なコンポーネントをラップした React のコンポーネントで、プロパティを通じてメソッドを実行する。
  * 処理は画面に表示した後（`useEffect`）に実行する。表示する前に実行する場合は `useExecutionLayoutEffect` を使う。
  *
- * - `at` が変わったときだけ実行する（`payload` は比べない）
- * - マウントより前に出た要求（マウントしたときにすでに渡されていた要求を含む）は実行しない
+ * - 印（`at`、または ExecutionMark の値）が変わったときだけ実行する（`payload` は比べない）
+ * - マウントしたときに渡されていた要求は実行しない（マウントしたときの印を基準にする）
+ * - 印が `0`（まだ要求していない）や undefined の場合は実行しない
+ * - ExecutionMark を受け取った場合、コールバックの payload は undefined
  * - 次のレンダリングまでに複数回要求した場合は、最後の要求だけを実行する
  * - コールバックは最新のものを呼ぶ。参照が変わっても実行しない
  *
- * @param request 受け取った Execution Request。undefined の場合は要求なし
+ * @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
  * @param callback 要求があったときに実行する処理。要求の payload を受け取る
  * @example
  * // 呼び出す側
@@ -23,5 +27,5 @@ import { ExecutionRequest } from "../useExecutionAt/types.cjs";
  *   instance.undo(payload);
  * });
  */
-declare function useExecutionEffect<P = void>(request: ExecutionRequest<P> | undefined, callback: (payload: P | undefined) => void): void;
+declare function useExecutionEffect<P = void>(request: ExecutionRequest<P> | ExecutionMark | undefined, callback: (payload: P | undefined) => void): void;
 export = useExecutionEffect;

package/hooks/useExecutionEffect/useExecutionEffect.d.mts

@@ -1,18 +1,22 @@
+import { ExecutionMark } from "../../types.mjs";
 import { ExecutionRequest } from "../useExecutionAt/types.mjs";
+import "../useExecutionAt/index.mjs";
 //#region src/hooks/useExecutionEffect/useExecutionEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに処理を実行するフック
  *
- * `useExecutionAt` と対になる、受け取る側のフック。
+ * `useExecutionAt`・`useExecutionMark` と対になる、受け取る側のフック。
  * 命令的なコンポーネントをラップした React のコンポーネントで、プロパティを通じてメソッドを実行する。
  * 処理は画面に表示した後（`useEffect`）に実行する。表示する前に実行する場合は `useExecutionLayoutEffect` を使う。
  *
- * - `at` が変わったときだけ実行する（`payload` は比べない）
- * - マウントより前に出た要求（マウントしたときにすでに渡されていた要求を含む）は実行しない
+ * - 印（`at`、または ExecutionMark の値）が変わったときだけ実行する（`payload` は比べない）
+ * - マウントしたときに渡されていた要求は実行しない（マウントしたときの印を基準にする）
+ * - 印が `0`（まだ要求していない）や undefined の場合は実行しない
+ * - ExecutionMark を受け取った場合、コールバックの payload は undefined
  * - 次のレンダリングまでに複数回要求した場合は、最後の要求だけを実行する
  * - コールバックは最新のものを呼ぶ。参照が変わっても実行しない
  *
- * @param request 受け取った Execution Request。undefined の場合は要求なし
+ * @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
  * @param callback 要求があったときに実行する処理。要求の payload を受け取る
  * @example
  * // 呼び出す側
@@ -23,5 +27,5 @@ import { ExecutionRequest } from "../useExecutionAt/types.mjs";
  *   instance.undo(payload);
  * });
  */
-export default function useExecutionEffect<P = void>(request: ExecutionRequest<P> | undefined, callback: (payload: P | undefined) => void): void;
+export default function useExecutionEffect<P = void>(request: ExecutionRequest<P> | ExecutionMark | undefined, callback: (payload: P | undefined) => void): void;
 //#endregion

package/hooks/useExecutionEffect/useExecutionEffect.mjs

@@ -1,20 +1,22 @@
-import useExecutionHandler from "../../_helpers/_useExecutionHandler.mjs";
+import useExecutionHandler from "../../_internal/_useExecutionHandler.mjs";
 import { useEffect } from "react";
 
 //#region src/hooks/useExecutionEffect/useExecutionEffect.ts
 /**
 * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに処理を実行するフック
 *
-* `useExecutionAt` と対になる、受け取る側のフック。
+* `useExecutionAt`・`useExecutionMark` と対になる、受け取る側のフック。
 * 命令的なコンポーネントをラップした React のコンポーネントで、プロパティを通じてメソッドを実行する。
 * 処理は画面に表示した後（`useEffect`）に実行する。表示する前に実行する場合は `useExecutionLayoutEffect` を使う。
 *
-* - `at` が変わったときだけ実行する（`payload` は比べない）
-* - マウントより前に出た要求（マウントしたときにすでに渡されていた要求を含む）は実行しない
+* - 印（`at`、または ExecutionMark の値）が変わったときだけ実行する（`payload` は比べない）
+* - マウントしたときに渡されていた要求は実行しない（マウントしたときの印を基準にする）
+* - 印が `0`（まだ要求していない）や undefined の場合は実行しない
+* - ExecutionMark を受け取った場合、コールバックの payload は undefined
 * - 次のレンダリングまでに複数回要求した場合は、最後の要求だけを実行する
 * - コールバックは最新のものを呼ぶ。参照が変わっても実行しない
 *
-* @param request 受け取った Execution Request。undefined の場合は要求なし
+* @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
 * @param callback 要求があったときに実行する処理。要求の payload を受け取る
 * @example
 * // 呼び出す側

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.cjs

@@ -1,5 +1,5 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__useExecutionHandler = require("../../_helpers/_useExecutionHandler.cjs");
+const require__internal__useExecutionHandler = require("../../_internal/_useExecutionHandler.cjs");
 let react = require("react");
 
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.ts
@@ -10,11 +10,11 @@ let react = require("react");
 * スクロールの位置を合わせる、計測し直すなど、結果を画面に表示する前に反映したい処理に使う。
 * 要求の扱いは `useExecutionEffect` と同じ。
 *
-* @param request 受け取った Execution Request。undefined の場合は要求なし
+* @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
 * @param callback 要求があったときに実行する処理。要求の payload を受け取る
 */
 function useExecutionLayoutEffect(request, callback) {
-	const handle = require__helpers__useExecutionHandler.default(request, callback);
+	const handle = require__internal__useExecutionHandler.default(request, callback);
 	(0, react.useLayoutEffect)(() => {
 		handle();
 	}, [handle]);

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.cts

@@ -1,4 +1,6 @@
+import { ExecutionMark } from "../../types.cjs";
 import { ExecutionRequest } from "../useExecutionAt/types.cjs";
+import "../useExecutionAt/index.cjs";
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに画面に表示する前に処理を実行するフック
@@ -7,8 +9,8 @@ import { ExecutionRequest } from "../useExecutionAt/types.cjs";
  * スクロールの位置を合わせる、計測し直すなど、結果を画面に表示する前に反映したい処理に使う。
  * 要求の扱いは `useExecutionEffect` と同じ。
  *
- * @param request 受け取った Execution Request。undefined の場合は要求なし
+ * @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
  * @param callback 要求があったときに実行する処理。要求の payload を受け取る
  */
-declare function useExecutionLayoutEffect<P = void>(request: ExecutionRequest<P> | undefined, callback: (payload: P | undefined) => void): void;
+declare function useExecutionLayoutEffect<P = void>(request: ExecutionRequest<P> | ExecutionMark | undefined, callback: (payload: P | undefined) => void): void;
 export = useExecutionLayoutEffect;

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.mts

@@ -1,4 +1,6 @@
+import { ExecutionMark } from "../../types.mjs";
 import { ExecutionRequest } from "../useExecutionAt/types.mjs";
+import "../useExecutionAt/index.mjs";
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに画面に表示する前に処理を実行するフック
@@ -7,8 +9,8 @@ import { ExecutionRequest } from "../useExecutionAt/types.mjs";
  * スクロールの位置を合わせる、計測し直すなど、結果を画面に表示する前に反映したい処理に使う。
  * 要求の扱いは `useExecutionEffect` と同じ。
  *
- * @param request 受け取った Execution Request。undefined の場合は要求なし
+ * @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
  * @param callback 要求があったときに実行する処理。要求の payload を受け取る
  */
-export default function useExecutionLayoutEffect<P = void>(request: ExecutionRequest<P> | undefined, callback: (payload: P | undefined) => void): void;
+export default function useExecutionLayoutEffect<P = void>(request: ExecutionRequest<P> | ExecutionMark | undefined, callback: (payload: P | undefined) => void): void;
 //#endregion

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.mjs

@@ -1,4 +1,4 @@
-import useExecutionHandler from "../../_helpers/_useExecutionHandler.mjs";
+import useExecutionHandler from "../../_internal/_useExecutionHandler.mjs";
 import { useLayoutEffect } from "react";
 
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.ts
@@ -9,7 +9,7 @@ import { useLayoutEffect } from "react";
 * スクロールの位置を合わせる、計測し直すなど、結果を画面に表示する前に反映したい処理に使う。
 * 要求の扱いは `useExecutionEffect` と同じ。
 *
-* @param request 受け取った Execution Request。undefined の場合は要求なし
+* @param request 受け取った Execution Request（`useExecutionAt` の値、または payload の無い ExecutionMark）。undefined の場合は要求なし
 * @param callback 要求があったときに実行する処理。要求の payload を受け取る
 */
 function useExecutionLayoutEffect(request, callback) {

package/hooks/useExecutionMark/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_hooks_useExecutionMark_useExecutionMark = require("./useExecutionMark.cjs");
+
+exports.default = require_hooks_useExecutionMark_useExecutionMark.default;
+exports.useExecutionMark = require_hooks_useExecutionMark_useExecutionMark.default;

package/hooks/useExecutionMark/index.d.cts

@@ -0,0 +1,3 @@
+import { UseExecutionMarkResult } from "./types.cjs";
+import useExecutionMark from "./useExecutionMark.cjs";
+export { type UseExecutionMarkResult, useExecutionMark as default, useExecutionMark };

package/hooks/useExecutionMark/index.d.mts

@@ -0,0 +1,3 @@
+import { UseExecutionMarkResult } from "./types.mjs";
+import useExecutionMark from "./useExecutionMark.mjs";
+export { type UseExecutionMarkResult, useExecutionMark as default, useExecutionMark };

package/hooks/useExecutionMark/index.mjs

@@ -0,0 +1,3 @@
+import useExecutionMark from "./useExecutionMark.mjs";
+
+export { useExecutionMark as default, useExecutionMark };

package/hooks/useExecutionMark/types.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });

package/hooks/useExecutionMark/types.d.cts

@@ -0,0 +1,7 @@
+import { ExecutionMark } from "../../types.cjs";
+//#region src/hooks/useExecutionMark/types.d.ts
+/**
+ * useExecutionMark の戻り値
+ */
+export type UseExecutionMarkResult = readonly [mark: ExecutionMark, execute: () => void];
+//#endregion

package/hooks/useExecutionMark/types.d.mts

@@ -0,0 +1,7 @@
+import { ExecutionMark } from "../../types.mjs";
+//#region src/hooks/useExecutionMark/types.d.ts
+/**
+ * useExecutionMark の戻り値
+ */
+export type UseExecutionMarkResult = readonly [mark: ExecutionMark, execute: () => void];
+//#endregion

package/hooks/useExecutionMark/types.mjs

@@ -0,0 +1 @@
+export {  };

package/hooks/useExecutionMark/useExecutionMark.cjs

@@ -0,0 +1,29 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_utils_markAt_markAt = require("../../utils/markAt/markAt.cjs");
+let react = require("react");
+
+//#region src/hooks/useExecutionMark/useExecutionMark.ts
+/**
+* payload の無い Execution Request（実行の印）と、要求する関数を返すフック
+*
+* `useExecutionAt` の payload を持たない版。命令的なコンポーネントの `focus()`・`reset()` のような、
+* 引数の要らないメソッドを、プロパティを通じて実行する場合に使う。
+*
+* - 印は初期状態では `0`（まだ要求していない）で、`execute` を呼ぶたびに `markAt()` で作った新しい値になる
+* - `execute` の参照は常に同じ
+*
+* @returns [mark, execute]
+* @example
+* const [focusAt, focus] = useExecutionMark();
+* <button onClick={focus}>Focus</button>
+* <WrappedImperativeComponent focusAt={focusAt} />
+*/
+function useExecutionMark() {
+	const [mark, setMark] = (0, react.useState)(0);
+	return [mark, (0, react.useCallback)(() => {
+		setMark(require_utils_markAt_markAt.default());
+	}, [])];
+}
+
+//#endregion
+exports.default = useExecutionMark;

package/hooks/useExecutionMark/useExecutionMark.d.cts

@@ -0,0 +1,19 @@
+import { UseExecutionMarkResult } from "./types.cjs";
+//#region src/hooks/useExecutionMark/useExecutionMark.d.ts
+/**
+ * payload の無い Execution Request（実行の印）と、要求する関数を返すフック
+ *
+ * `useExecutionAt` の payload を持たない版。命令的なコンポーネントの `focus()`・`reset()` のような、
+ * 引数の要らないメソッドを、プロパティを通じて実行する場合に使う。
+ *
+ * - 印は初期状態では `0`（まだ要求していない）で、`execute` を呼ぶたびに `markAt()` で作った新しい値になる
+ * - `execute` の参照は常に同じ
+ *
+ * @returns [mark, execute]
+ * @example
+ * const [focusAt, focus] = useExecutionMark();
+ * <button onClick={focus}>Focus</button>
+ * <WrappedImperativeComponent focusAt={focusAt} />
+ */
+declare function useExecutionMark(): UseExecutionMarkResult;
+export = useExecutionMark;

package/hooks/useExecutionMark/useExecutionMark.d.mts

@@ -0,0 +1,19 @@
+import { UseExecutionMarkResult } from "./types.mjs";
+//#region src/hooks/useExecutionMark/useExecutionMark.d.ts
+/**
+ * payload の無い Execution Request（実行の印）と、要求する関数を返すフック
+ *
+ * `useExecutionAt` の payload を持たない版。命令的なコンポーネントの `focus()`・`reset()` のような、
+ * 引数の要らないメソッドを、プロパティを通じて実行する場合に使う。
+ *
+ * - 印は初期状態では `0`（まだ要求していない）で、`execute` を呼ぶたびに `markAt()` で作った新しい値になる
+ * - `execute` の参照は常に同じ
+ *
+ * @returns [mark, execute]
+ * @example
+ * const [focusAt, focus] = useExecutionMark();
+ * <button onClick={focus}>Focus</button>
+ * <WrappedImperativeComponent focusAt={focusAt} />
+ */
+export default function useExecutionMark(): UseExecutionMarkResult;
+//#endregion

package/hooks/useExecutionMark/useExecutionMark.mjs

@@ -0,0 +1,28 @@
+import markAt from "../../utils/markAt/markAt.mjs";
+import { useCallback, useState } from "react";
+
+//#region src/hooks/useExecutionMark/useExecutionMark.ts
+/**
+* payload の無い Execution Request（実行の印）と、要求する関数を返すフック
+*
+* `useExecutionAt` の payload を持たない版。命令的なコンポーネントの `focus()`・`reset()` のような、
+* 引数の要らないメソッドを、プロパティを通じて実行する場合に使う。
+*
+* - 印は初期状態では `0`（まだ要求していない）で、`execute` を呼ぶたびに `markAt()` で作った新しい値になる
+* - `execute` の参照は常に同じ
+*
+* @returns [mark, execute]
+* @example
+* const [focusAt, focus] = useExecutionMark();
+* <button onClick={focus}>Focus</button>
+* <WrappedImperativeComponent focusAt={focusAt} />
+*/
+function useExecutionMark() {
+	const [mark, setMark] = useState(0);
+	return [mark, useCallback(() => {
+		setMark(markAt());
+	}, [])];
+}
+
+//#endregion
+export { useExecutionMark as default };

package/index.cjs

@@ -1,13 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_hooks_useLatestRef_useLatestRef = require("./hooks/useLatestRef/useLatestRef.cjs");
+const require_hooks_useChangeEffect_useChangeEffect = require("./hooks/useChangeEffect/useChangeEffect.cjs");
+const require_hooks_useChangeLayoutEffect_useChangeLayoutEffect = require("./hooks/useChangeLayoutEffect/useChangeLayoutEffect.cjs");
 const require_utils_setRefCurrent_setRefCurrent = require("./utils/setRefCurrent/setRefCurrent.cjs");
 const require_hooks_useStableLength_useStableLength = require("./hooks/useStableLength/useStableLength.cjs");
 const require_hooks_useCombinedRefs_useCombinedRefs = require("./hooks/useCombinedRefs/useCombinedRefs.cjs");
 const require_hooks_useConstant_useConstant = require("./hooks/useConstant/useConstant.cjs");
 const require_utils_markAt_markAt = require("./utils/markAt/markAt.cjs");
 const require_hooks_useExecutionAt_useExecutionAt = require("./hooks/useExecutionAt/useExecutionAt.cjs");
-const require_hooks_useLatestRef_useLatestRef = require("./hooks/useLatestRef/useLatestRef.cjs");
 const require_hooks_useExecutionEffect_useExecutionEffect = require("./hooks/useExecutionEffect/useExecutionEffect.cjs");
 const require_hooks_useExecutionLayoutEffect_useExecutionLayoutEffect = require("./hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.cjs");
+const require_hooks_useExecutionMark_useExecutionMark = require("./hooks/useExecutionMark/useExecutionMark.cjs");
 const require_hooks_useIsHydrated_useIsHydrated = require("./hooks/useIsHydrated/useIsHydrated.cjs");
 const require_hooks_useIsMounted_useIsMounted = require("./hooks/useIsMounted/useIsMounted.cjs");
 const require_hooks_usePreviousValue_usePreviousValue = require("./hooks/usePreviousValue/usePreviousValue.cjs");
@@ -34,11 +37,14 @@ exports.markAt = require_utils_markAt_markAt.default;
 exports.setRefCurrent = require_utils_setRefCurrent_setRefCurrent.default;
 exports.transformContent = require_utils_transformContent_transformContent.default;
 exports.transformElement = require_utils_transformElement_transformElement.default;
+exports.useChangeEffect = require_hooks_useChangeEffect_useChangeEffect.default;
+exports.useChangeLayoutEffect = require_hooks_useChangeLayoutEffect_useChangeLayoutEffect.default;
 exports.useCombinedRefs = require_hooks_useCombinedRefs_useCombinedRefs.default;
 exports.useConstant = require_hooks_useConstant_useConstant.default;
 exports.useExecutionAt = require_hooks_useExecutionAt_useExecutionAt.default;
 exports.useExecutionEffect = require_hooks_useExecutionEffect_useExecutionEffect.default;
 exports.useExecutionLayoutEffect = require_hooks_useExecutionLayoutEffect_useExecutionLayoutEffect.default;
+exports.useExecutionMark = require_hooks_useExecutionMark_useExecutionMark.default;
 exports.useIsHydrated = require_hooks_useIsHydrated_useIsHydrated.default;
 exports.useIsMounted = require_hooks_useIsMounted_useIsMounted.default;
 exports.useLatestRef = require_hooks_useLatestRef_useLatestRef.default;

package/index.d.cts

@@ -1,11 +1,15 @@
-import { MarkAtResult } from "./utils/markAt/types.cjs";
-import markAt from "./utils/markAt/markAt.cjs";
-import { ExecutionFunction, ExecutionRequest, UseExecutionAtOptions, UseExecutionAtResult } from "./hooks/useExecutionAt/types.cjs";
+import { ChangeDependencies } from "./hooks/useChangeEffect/types.cjs";
+import { CSSPropertiesWithVars, ExecutionMark } from "./types.cjs";
+import { ExecutionFunction, ExecutionRequest, UseExecutionAtResult } from "./hooks/useExecutionAt/types.cjs";
 import useExecutionAt from "./hooks/useExecutionAt/useExecutionAt.cjs";
+import useChangeEffect from "./hooks/useChangeEffect/useChangeEffect.cjs";
+import useChangeLayoutEffect from "./hooks/useChangeLayoutEffect/useChangeLayoutEffect.cjs";
 import useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.cjs";
 import useConstant from "./hooks/useConstant/useConstant.cjs";
 import useExecutionEffect from "./hooks/useExecutionEffect/useExecutionEffect.cjs";
 import useExecutionLayoutEffect from "./hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.cjs";
+import { UseExecutionMarkResult } from "./hooks/useExecutionMark/types.cjs";
+import useExecutionMark from "./hooks/useExecutionMark/useExecutionMark.cjs";
 import useIsHydrated from "./hooks/useIsHydrated/useIsHydrated.cjs";
 import useIsMounted from "./hooks/useIsMounted/useIsMounted.cjs";
 import { LatestRef } from "./hooks/useLatestRef/types.cjs";
@@ -16,7 +20,6 @@ import useRerender from "./hooks/useRerender/useRerender.cjs";
 import useStableCallback from "./hooks/useStableCallback/useStableCallback.cjs";
 import useStableLength from "./hooks/useStableLength/useStableLength.cjs";
 import "./hooks/index.cjs";
-import { CSSPropertiesWithVars } from "./types.cjs";
 import { AppliedProps, SkippedDefaults } from "./utils/applyDefaultProps/types.cjs";
 import applyDefaultProps from "./utils/applyDefaultProps/applyDefaultProps.cjs";
 import ensureComponent from "./utils/ensureComponent/ensureComponent.cjs";
@@ -25,8 +28,9 @@ import extendElement from "./utils/extendElement/extendElement.cjs";
 import forEachContent from "./utils/forEachContent/forEachContent.cjs";
 import forEachElement from "./utils/forEachElement/forEachElement.cjs";
 import getComponentName from "./utils/getComponentName/getComponentName.cjs";
+import markAt from "./utils/markAt/markAt.cjs";
 import setRefCurrent from "./utils/setRefCurrent/setRefCurrent.cjs";
 import transformContent from "./utils/transformContent/transformContent.cjs";
 import transformElement from "./utils/transformElement/transformElement.cjs";
 import "./utils/index.cjs";
-export { type AppliedProps, type CSSPropertiesWithVars, type ExecutionFunction, type ExecutionRequest, type ExtendableProps, type LatestRef, type MarkAtResult, type SkippedDefaults, type UseExecutionAtOptions, type UseExecutionAtResult, type UsePreviousValueOptions, applyDefaultProps, ensureComponent, extendElement, forEachContent, forEachElement, getComponentName, markAt, setRefCurrent, transformContent, transformElement, useCombinedRefs, useConstant, useExecutionAt, useExecutionEffect, useExecutionLayoutEffect, useIsHydrated, useIsMounted, useLatestRef, usePreviousValue, useRerender, useStableCallback, useStableLength };
+export { type AppliedProps, type CSSPropertiesWithVars, type ChangeDependencies, type ExecutionFunction, type ExecutionMark, type ExecutionRequest, type ExtendableProps, type LatestRef, type SkippedDefaults, type UseExecutionAtResult, type UseExecutionMarkResult, type UsePreviousValueOptions, applyDefaultProps, ensureComponent, extendElement, forEachContent, forEachElement, getComponentName, markAt, setRefCurrent, transformContent, transformElement, useChangeEffect, useChangeLayoutEffect, useCombinedRefs, useConstant, useExecutionAt, useExecutionEffect, useExecutionLayoutEffect, useExecutionMark, useIsHydrated, useIsMounted, useLatestRef, usePreviousValue, useRerender, useStableCallback, useStableLength };