@fringeworks/react-utils 0.10.0 → 0.11.0

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,5 @@
 import { ExecutionRequest } from "../useExecutionAt/types.cjs";
+import { ExecutionMark } from "../useExecutionMark/types.cjs";
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに画面に表示する前に処理を実行するフック
@@ -7,8 +8,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,5 @@
 import { ExecutionRequest } from "../useExecutionAt/types.mjs";
+import { ExecutionMark } from "../useExecutionMark/types.mjs";
 //#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.ts
 /**
  * Execution Request プロパティ（xxxAt）を受け取り、要求があったときに画面に表示する前に処理を実行するフック
@@ -7,8 +8,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 { ExecutionMark, UseExecutionMarkResult } from "./types.cjs";
+import useExecutionMark from "./useExecutionMark.cjs";
+export { type ExecutionMark, type UseExecutionMarkResult, useExecutionMark as default, useExecutionMark };

package/hooks/useExecutionMark/index.d.mts

@@ -0,0 +1,3 @@
+import { ExecutionMark, UseExecutionMarkResult } from "./types.mjs";
+import useExecutionMark from "./useExecutionMark.mjs";
+export { type ExecutionMark, 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,15 @@
+//#region src/hooks/useExecutionMark/types.d.ts
+/**
+ * payload の無い Execution Request（実行の印）
+ *
+ * 実体は数値。Execution Request プロパティ（xxxAt）に渡し、値が変わるたびに1回の要求とみなす。
+ * **要求のたびに、前回と異なる値にすること**（同じ値を続けて渡しても、2回目は要求とみなさない）。
+ * `markAt()` で作ると、呼ぶたびに異なる値になる。`useExecutionMark` を使うと、`markAt()` で作った値と、要求する関数を受け取れる。
+ * `0` は「まだ要求していない」を表し、実行しない。
+ */
+export type ExecutionMark = number;
+/**
+ * useExecutionMark の戻り値
+ */
+export type UseExecutionMarkResult = readonly [mark: ExecutionMark, execute: () => void];
+//#endregion

package/hooks/useExecutionMark/types.d.mts

@@ -0,0 +1,15 @@
+//#region src/hooks/useExecutionMark/types.d.ts
+/**
+ * payload の無い Execution Request（実行の印）
+ *
+ * 実体は数値。Execution Request プロパティ（xxxAt）に渡し、値が変わるたびに1回の要求とみなす。
+ * **要求のたびに、前回と異なる値にすること**（同じ値を続けて渡しても、2回目は要求とみなさない）。
+ * `markAt()` で作ると、呼ぶたびに異なる値になる。`useExecutionMark` を使うと、`markAt()` で作った値と、要求する関数を受け取れる。
+ * `0` は「まだ要求していない」を表し、実行しない。
+ */
+export type ExecutionMark = number;
+/**
+ * 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,7 +1,12 @@
+import { ChangeDependencies } from "./hooks/useChangeEffect/types.cjs";
 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 useExecutionAt from "./hooks/useExecutionAt/useExecutionAt.cjs";
+import { ExecutionMark, UseExecutionMarkResult } from "./hooks/useExecutionMark/types.cjs";
+import useExecutionMark from "./hooks/useExecutionMark/useExecutionMark.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";
@@ -29,4 +34,4 @@ 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 MarkAtResult, type SkippedDefaults, type UseExecutionAtOptions, 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 };

package/index.d.mts

@@ -1,7 +1,12 @@
+import { ChangeDependencies } from "./hooks/useChangeEffect/types.mjs";
 import { MarkAtResult } from "./utils/markAt/types.mjs";
 import markAt from "./utils/markAt/markAt.mjs";
 import { ExecutionFunction, ExecutionRequest, UseExecutionAtOptions, UseExecutionAtResult } from "./hooks/useExecutionAt/types.mjs";
 import useExecutionAt from "./hooks/useExecutionAt/useExecutionAt.mjs";
+import { ExecutionMark, UseExecutionMarkResult } from "./hooks/useExecutionMark/types.mjs";
+import useExecutionMark from "./hooks/useExecutionMark/useExecutionMark.mjs";
+import useChangeEffect from "./hooks/useChangeEffect/useChangeEffect.mjs";
+import useChangeLayoutEffect from "./hooks/useChangeLayoutEffect/useChangeLayoutEffect.mjs";
 import useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.mjs";
 import useConstant from "./hooks/useConstant/useConstant.mjs";
 import useExecutionEffect from "./hooks/useExecutionEffect/useExecutionEffect.mjs";
@@ -29,4 +34,4 @@ import setRefCurrent from "./utils/setRefCurrent/setRefCurrent.mjs";
 import transformContent from "./utils/transformContent/transformContent.mjs";
 import transformElement from "./utils/transformElement/transformElement.mjs";
 import "./utils/index.mjs";
-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 MarkAtResult, type SkippedDefaults, type UseExecutionAtOptions, 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 };

package/index.mjs

@@ -1,12 +1,15 @@
+import useLatestRef from "./hooks/useLatestRef/useLatestRef.mjs";
+import useChangeEffect from "./hooks/useChangeEffect/useChangeEffect.mjs";
+import useChangeLayoutEffect from "./hooks/useChangeLayoutEffect/useChangeLayoutEffect.mjs";
 import setRefCurrent from "./utils/setRefCurrent/setRefCurrent.mjs";
 import useStableLength from "./hooks/useStableLength/useStableLength.mjs";
 import useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.mjs";
 import useConstant from "./hooks/useConstant/useConstant.mjs";
 import markAt from "./utils/markAt/markAt.mjs";
 import useExecutionAt from "./hooks/useExecutionAt/useExecutionAt.mjs";
-import useLatestRef from "./hooks/useLatestRef/useLatestRef.mjs";
 import useExecutionEffect from "./hooks/useExecutionEffect/useExecutionEffect.mjs";
 import useExecutionLayoutEffect from "./hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.mjs";
+import useExecutionMark from "./hooks/useExecutionMark/useExecutionMark.mjs";
 import useIsHydrated from "./hooks/useIsHydrated/useIsHydrated.mjs";
 import useIsMounted from "./hooks/useIsMounted/useIsMounted.mjs";
 import usePreviousValue from "./hooks/usePreviousValue/usePreviousValue.mjs";
@@ -23,4 +26,4 @@ import transformContent from "./utils/transformContent/transformContent.mjs";
 import transformElement from "./utils/transformElement/transformElement.mjs";
 import "./utils/index.mjs";
 
-export { applyDefaultProps, ensureComponent, extendElement, forEachContent, forEachElement, getComponentName, markAt, setRefCurrent, transformContent, transformElement, useCombinedRefs, useConstant, useExecutionAt, useExecutionEffect, useExecutionLayoutEffect, useIsHydrated, useIsMounted, useLatestRef, usePreviousValue, useRerender, useStableCallback, useStableLength };
+export { 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fringeworks/react-utils",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A library some will find handy, providing utilities for React.",
   "keywords": [
     "react"
@@ -34,6 +34,26 @@
         "default": "./hooks/index.cjs"
       }
     },
+    "./hooks/useChangeEffect": {
+      "import": {
+        "types": "./hooks/useChangeEffect/index.d.mts",
+        "default": "./hooks/useChangeEffect/index.mjs"
+      },
+      "require": {
+        "types": "./hooks/useChangeEffect/index.d.cts",
+        "default": "./hooks/useChangeEffect/index.cjs"
+      }
+    },
+    "./hooks/useChangeLayoutEffect": {
+      "import": {
+        "types": "./hooks/useChangeLayoutEffect/index.d.mts",
+        "default": "./hooks/useChangeLayoutEffect/index.mjs"
+      },
+      "require": {
+        "types": "./hooks/useChangeLayoutEffect/index.d.cts",
+        "default": "./hooks/useChangeLayoutEffect/index.cjs"
+      }
+    },
     "./hooks/useCombinedRefs": {
       "import": {
         "types": "./hooks/useCombinedRefs/index.d.mts",
@@ -84,6 +104,16 @@
         "default": "./hooks/useExecutionLayoutEffect/index.cjs"
       }
     },
+    "./hooks/useExecutionMark": {
+      "import": {
+        "types": "./hooks/useExecutionMark/index.d.mts",
+        "default": "./hooks/useExecutionMark/index.mjs"
+      },
+      "require": {
+        "types": "./hooks/useExecutionMark/index.d.cts",
+        "default": "./hooks/useExecutionMark/index.cjs"
+      }
+    },
     "./hooks/useIsHydrated": {
       "import": {
         "types": "./hooks/useIsHydrated/index.d.mts",

package/utils/forEachContent/forEachContent.cjs

@@ -1,5 +1,5 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__traverseChildren = require("../../_helpers/_traverseChildren.cjs");
+const require__internal__traverseChildren = require("../../_internal/_traverseChildren.cjs");
 
 //#region src/utils/forEachContent/forEachContent.ts
 /**
@@ -8,7 +8,7 @@ const require__helpers__traverseChildren = require("../../_helpers/_traverseChil
 * @param callback コールバック。indexはFragmentをまたいだ連番
 */
 function forEachContent(children, callback) {
-	require__helpers__traverseChildren.default(children, require__helpers__traverseChildren._isContent, callback);
+	require__internal__traverseChildren.default(children, require__internal__traverseChildren._isContent, callback);
 }
 
 //#endregion

package/utils/forEachContent/forEachContent.mjs

@@ -1,4 +1,4 @@
-import _traverseChildren, { _isContent } from "../../_helpers/_traverseChildren.mjs";
+import _traverseChildren, { _isContent } from "../../_internal/_traverseChildren.mjs";
 
 //#region src/utils/forEachContent/forEachContent.ts
 /**

package/utils/forEachElement/forEachElement.cjs

@@ -1,5 +1,5 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__traverseChildren = require("../../_helpers/_traverseChildren.cjs");
+const require__internal__traverseChildren = require("../../_internal/_traverseChildren.cjs");
 let react = require("react");
 
 //#region src/utils/forEachElement/forEachElement.ts
@@ -9,7 +9,7 @@ let react = require("react");
 * @param callback コールバック。indexはFragmentをまたいだ連番
 */
 function forEachElement(children, callback) {
-	require__helpers__traverseChildren.default(children, react.isValidElement, callback);
+	require__internal__traverseChildren.default(children, react.isValidElement, callback);
 }
 
 //#endregion

package/utils/forEachElement/forEachElement.mjs

@@ -1,4 +1,4 @@
-import _traverseChildren from "../../_helpers/_traverseChildren.mjs";
+import _traverseChildren from "../../_internal/_traverseChildren.mjs";
 import { isValidElement } from "react";
 
 //#region src/utils/forEachElement/forEachElement.ts

package/utils/markAt/types.d.cts

@@ -1,3 +1,6 @@
 //#region src/utils/markAt/types.d.ts
+/**
+ * 一意な値
+ */
 export type MarkAtResult = number;
 //#endregion

package/utils/markAt/types.d.mts

@@ -1,3 +1,6 @@
 //#region src/utils/markAt/types.d.ts
+/**
+ * 一意な値
+ */
 export type MarkAtResult = number;
 //#endregion

package/utils/transformContent/transformContent.cjs

@@ -1,5 +1,5 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__traverseChildren = require("../../_helpers/_traverseChildren.cjs");
+const require__internal__traverseChildren = require("../../_internal/_traverseChildren.cjs");
 
 //#region src/utils/transformContent/transformContent.ts
 /**
@@ -15,7 +15,7 @@ const require__helpers__traverseChildren = require("../../_helpers/_traverseChil
 */
 function transformContent(children, callback) {
 	const result = [];
-	require__helpers__traverseChildren.default(children, require__helpers__traverseChildren._isContent, callback, (value) => result.push(value));
+	require__internal__traverseChildren.default(children, require__internal__traverseChildren._isContent, callback, (value) => result.push(value));
 	return result;
 }
 

package/utils/transformContent/transformContent.mjs

@@ -1,4 +1,4 @@
-import _traverseChildren, { _isContent } from "../../_helpers/_traverseChildren.mjs";
+import _traverseChildren, { _isContent } from "../../_internal/_traverseChildren.mjs";
 
 //#region src/utils/transformContent/transformContent.ts
 /**

package/utils/transformElement/transformElement.cjs

@@ -1,5 +1,5 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
-const require__helpers__traverseChildren = require("../../_helpers/_traverseChildren.cjs");
+const require__internal__traverseChildren = require("../../_internal/_traverseChildren.cjs");
 let react = require("react");
 
 //#region src/utils/transformElement/transformElement.ts
@@ -16,7 +16,7 @@ let react = require("react");
 */
 function transformElement(children, callback) {
 	const result = [];
-	require__helpers__traverseChildren.default(children, react.isValidElement, callback, (value) => result.push(value));
+	require__internal__traverseChildren.default(children, react.isValidElement, callback, (value) => result.push(value));
 	return result;
 }
 

package/utils/transformElement/transformElement.mjs

@@ -1,4 +1,4 @@
-import _traverseChildren from "../../_helpers/_traverseChildren.mjs";
+import _traverseChildren from "../../_internal/_traverseChildren.mjs";
 import { isValidElement } from "react";
 
 //#region src/utils/transformElement/transformElement.ts

package/_helpers/_useExecutionHandler.mjs

@@ -1,36 +0,0 @@
-import useConstant from "../hooks/useConstant/useConstant.mjs";
-import "../hooks/useConstant/index.mjs";
-import markAt from "../utils/markAt/markAt.mjs";
-import useLatestRef from "../hooks/useLatestRef/useLatestRef.mjs";
-import "../hooks/useLatestRef/index.mjs";
-import { useCallback, useRef } from "react";
-
-//#region src/_helpers/_useExecutionHandler.ts
-/**
-* Execution Request を受け取り、要求があれば処理を実行する関数を返すフック
-*
-* `useExecutionEffect`・`useExecutionLayoutEffect` に共通の処理。返す関数をエフェクトで呼ぶ。
-*
-* - 初回のレンダリングで `markAt()` の値を基準にし、`at` がそれより大きい要求だけを実行する。
-*   `at` は `markAt()` で単調に増えるため、マウントより前に出た要求は実行しない
-* - 一度実行した要求は、エフェクトが再実行されても（StrictMode など）実行しない
-* - コールバックは最新のものを呼ぶ
-*
-* @param request 受け取った Execution Request。undefined の場合は要求なし
-* @param callback 要求があったときに実行する処理
-* @returns エフェクトで呼ぶ関数。参照は request が変わったときだけ変わる
-*/
-function useExecutionHandler(request, callback) {
-	const callbackRef = useLatestRef(callback);
-	const baseline = useConstant(markAt);
-	const handledAtRef = useRef(baseline);
-	return useCallback(() => {
-		if (request && request.at > handledAtRef.current) {
-			handledAtRef.current = request.at;
-			callbackRef.current(request.payload);
-		}
-	}, [request, callbackRef]);
-}
-
-//#endregion
-export { useExecutionHandler as default };