@fringeworks/react-utils 0.9.1 → 0.10.0

package/hooks/useExecutionEffect/useExecutionEffect.d.cts

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

package/hooks/useExecutionEffect/useExecutionEffect.d.mts

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

package/hooks/useExecutionEffect/useExecutionEffect.mjs

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

package/hooks/useExecutionLayoutEffect/index.cjs

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

package/hooks/useExecutionLayoutEffect/index.d.cts

@@ -0,0 +1,2 @@
+import useExecutionLayoutEffect from "./useExecutionLayoutEffect.cjs";
+export { useExecutionLayoutEffect as default, useExecutionLayoutEffect };

package/hooks/useExecutionLayoutEffect/index.d.mts

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

package/hooks/useExecutionLayoutEffect/index.mjs

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

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.cjs

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

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.cts

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

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.d.mts

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

package/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.mjs

@@ -0,0 +1,23 @@
+import useExecutionHandler from "../../_helpers/_useExecutionHandler.mjs";
+import { useLayoutEffect } from "react";
+
+//#region src/hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.ts
+/**
+* Execution Request プロパティ（xxxAt）を受け取り、要求があったときに画面に表示する前に処理を実行するフック
+*
+* `useExecutionEffect` の、処理を `useLayoutEffect` で実行する版。
+* スクロールの位置を合わせる、計測し直すなど、結果を画面に表示する前に反映したい処理に使う。
+* 要求の扱いは `useExecutionEffect` と同じ。
+*
+* @param request 受け取った Execution Request。undefined の場合は要求なし
+* @param callback 要求があったときに実行する処理。要求の payload を受け取る
+*/
+function useExecutionLayoutEffect(request, callback) {
+	const handle = useExecutionHandler(request, callback);
+	useLayoutEffect(() => {
+		handle();
+	}, [handle]);
+}
+
+//#endregion
+export { useExecutionLayoutEffect as default };

package/hooks/useIsHydrated/index.cjs

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

package/hooks/useIsHydrated/index.d.cts

@@ -0,0 +1,2 @@
+import useIsHydrated from "./useIsHydrated.cjs";
+export { useIsHydrated as default, useIsHydrated };

package/hooks/useIsHydrated/index.d.mts

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

package/hooks/useIsHydrated/index.mjs

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

package/hooks/useIsHydrated/useIsHydrated.cjs

@@ -0,0 +1,28 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+let react = require("react");
+
+//#region src/hooks/useIsHydrated/useIsHydrated.ts
+/**
+* 購読しない（値が変わることは無い）
+*/
+const subscribe = () => () => {};
+const getSnapshot = () => true;
+const getServerSnapshot = () => false;
+/**
+* ハイドレーションが終わっているかを返すフック
+*
+* - サーバーの描画とハイドレーション中は false、その後は true を返す
+* - ハイドレーションの後にマウントしたコンポーネントや、クライアントだけで描画した場合は、最初から true を返す
+*
+* クライアントにしか無い値（`window`・`localStorage`・画面の幅など）を、ハイドレーションの不一致を起こさずに描画するために使う。
+* `typeof window` による判定と違い、クライアントでもハイドレーション中は false になる。
+* `useSyncExternalStore` の、サーバーとハイドレーション中は `getServerSnapshot` の値を使う性質を利用している。
+*
+* @returns ハイドレーションが終わっている場合は true
+*/
+function useIsHydrated() {
+	return (0, react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+}
+
+//#endregion
+exports.default = useIsHydrated;

package/hooks/useIsHydrated/useIsHydrated.d.cts

@@ -0,0 +1,15 @@
+//#region src/hooks/useIsHydrated/useIsHydrated.d.ts
+/**
+ * ハイドレーションが終わっているかを返すフック
+ *
+ * - サーバーの描画とハイドレーション中は false、その後は true を返す
+ * - ハイドレーションの後にマウントしたコンポーネントや、クライアントだけで描画した場合は、最初から true を返す
+ *
+ * クライアントにしか無い値（`window`・`localStorage`・画面の幅など）を、ハイドレーションの不一致を起こさずに描画するために使う。
+ * `typeof window` による判定と違い、クライアントでもハイドレーション中は false になる。
+ * `useSyncExternalStore` の、サーバーとハイドレーション中は `getServerSnapshot` の値を使う性質を利用している。
+ *
+ * @returns ハイドレーションが終わっている場合は true
+ */
+declare function useIsHydrated(): boolean;
+export = useIsHydrated;

package/hooks/useIsHydrated/useIsHydrated.d.mts

@@ -0,0 +1,15 @@
+//#region src/hooks/useIsHydrated/useIsHydrated.d.ts
+/**
+ * ハイドレーションが終わっているかを返すフック
+ *
+ * - サーバーの描画とハイドレーション中は false、その後は true を返す
+ * - ハイドレーションの後にマウントしたコンポーネントや、クライアントだけで描画した場合は、最初から true を返す
+ *
+ * クライアントにしか無い値（`window`・`localStorage`・画面の幅など）を、ハイドレーションの不一致を起こさずに描画するために使う。
+ * `typeof window` による判定と違い、クライアントでもハイドレーション中は false になる。
+ * `useSyncExternalStore` の、サーバーとハイドレーション中は `getServerSnapshot` の値を使う性質を利用している。
+ *
+ * @returns ハイドレーションが終わっている場合は true
+ */
+export default function useIsHydrated(): boolean;
+//#endregion

package/hooks/useIsHydrated/useIsHydrated.mjs

@@ -0,0 +1,27 @@
+import { useSyncExternalStore } from "react";
+
+//#region src/hooks/useIsHydrated/useIsHydrated.ts
+/**
+* 購読しない（値が変わることは無い）
+*/
+const subscribe = () => () => {};
+const getSnapshot = () => true;
+const getServerSnapshot = () => false;
+/**
+* ハイドレーションが終わっているかを返すフック
+*
+* - サーバーの描画とハイドレーション中は false、その後は true を返す
+* - ハイドレーションの後にマウントしたコンポーネントや、クライアントだけで描画した場合は、最初から true を返す
+*
+* クライアントにしか無い値（`window`・`localStorage`・画面の幅など）を、ハイドレーションの不一致を起こさずに描画するために使う。
+* `typeof window` による判定と違い、クライアントでもハイドレーション中は false になる。
+* `useSyncExternalStore` の、サーバーとハイドレーション中は `getServerSnapshot` の値を使う性質を利用している。
+*
+* @returns ハイドレーションが終わっている場合は true
+*/
+function useIsHydrated() {
+	return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+
+//#endregion
+export { useIsHydrated as default };

package/hooks/useRerender/index.cjs

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

package/hooks/useRerender/index.d.cts

@@ -0,0 +1,2 @@
+import useRerender from "./useRerender.cjs";
+export { useRerender as default, useRerender };

package/hooks/useRerender/index.d.mts

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

package/hooks/useRerender/index.mjs

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

package/hooks/useRerender/useRerender.cjs

@@ -0,0 +1,19 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+let react = require("react");
+
+//#region src/hooks/useRerender/useRerender.ts
+/**
+* 再レンダリングだけを起こす関数を返すフック
+*
+* 値を持たずに描画し直したい場合（外部の状態を読み直して表示するときなど）に使う。
+* `useReducer` のカウンターを進めることで、再レンダリングを要求する。
+*
+* @returns 呼ぶと再レンダリングを要求する関数。参照は常に同じ
+*/
+function useRerender() {
+	const [, rerender] = (0, react.useReducer)((count) => count + 1, 0);
+	return rerender;
+}
+
+//#endregion
+exports.default = useRerender;

package/hooks/useRerender/useRerender.d.cts

@@ -0,0 +1,11 @@
+//#region src/hooks/useRerender/useRerender.d.ts
+/**
+ * 再レンダリングだけを起こす関数を返すフック
+ *
+ * 値を持たずに描画し直したい場合（外部の状態を読み直して表示するときなど）に使う。
+ * `useReducer` のカウンターを進めることで、再レンダリングを要求する。
+ *
+ * @returns 呼ぶと再レンダリングを要求する関数。参照は常に同じ
+ */
+declare function useRerender(): () => void;
+export = useRerender;

package/hooks/useRerender/useRerender.d.mts

@@ -0,0 +1,11 @@
+//#region src/hooks/useRerender/useRerender.d.ts
+/**
+ * 再レンダリングだけを起こす関数を返すフック
+ *
+ * 値を持たずに描画し直したい場合（外部の状態を読み直して表示するときなど）に使う。
+ * `useReducer` のカウンターを進めることで、再レンダリングを要求する。
+ *
+ * @returns 呼ぶと再レンダリングを要求する関数。参照は常に同じ
+ */
+export default function useRerender(): () => void;
+//#endregion

package/hooks/useRerender/useRerender.mjs

@@ -0,0 +1,18 @@
+import { useReducer } from "react";
+
+//#region src/hooks/useRerender/useRerender.ts
+/**
+* 再レンダリングだけを起こす関数を返すフック
+*
+* 値を持たずに描画し直したい場合（外部の状態を読み直して表示するときなど）に使う。
+* `useReducer` のカウンターを進めることで、再レンダリングを要求する。
+*
+* @returns 呼ぶと再レンダリングを要求する関数。参照は常に同じ
+*/
+function useRerender() {
+	const [, rerender] = useReducer((count) => count + 1, 0);
+	return rerender;
+}
+
+//#endregion
+export { useRerender as default };

package/hooks/useStableCallback/index.cjs

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

package/hooks/useStableCallback/index.d.cts

@@ -0,0 +1,2 @@
+import useStableCallback from "./useStableCallback.cjs";
+export { useStableCallback as default, useStableCallback };

package/hooks/useStableCallback/index.d.mts

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

package/hooks/useStableCallback/index.mjs

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

package/hooks/useStableCallback/useStableCallback.cjs

@@ -0,0 +1,25 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_hooks_useLatestRef_useLatestRef = require("../useLatestRef/useLatestRef.cjs");
+require("../useLatestRef/index.cjs");
+let react = require("react");
+
+//#region src/hooks/useStableCallback/useStableCallback.ts
+/**
+* 参照が変わらず、呼ぶと最新のコールバックを実行する関数を返すフック
+*
+* 子のコンポーネントに渡すイベントハンドラーの参照を変えずに、中身は常に最新にする場合に使う。
+* React 19.2 の `useEffectEvent` と違い、子のコンポーネントに渡せる。
+*
+* 最新のコールバックはコミット時に反映されるため、レンダリング中には呼ばないこと（古いコールバックが呼ばれる）。
+* イベントハンドラーやエフェクトの中から呼ぶ。
+*
+* @param callback コールバック
+* @returns 最新のコールバックを呼ぶ関数。参照は常に同じ
+*/
+function useStableCallback(callback) {
+	const latestRef = require_hooks_useLatestRef_useLatestRef.default(callback);
+	return (0, react.useCallback)((...args) => latestRef.current(...args), [latestRef]);
+}
+
+//#endregion
+exports.default = useStableCallback;

package/hooks/useStableCallback/useStableCallback.d.cts

@@ -0,0 +1,15 @@
+//#region src/hooks/useStableCallback/useStableCallback.d.ts
+/**
+ * 参照が変わらず、呼ぶと最新のコールバックを実行する関数を返すフック
+ *
+ * 子のコンポーネントに渡すイベントハンドラーの参照を変えずに、中身は常に最新にする場合に使う。
+ * React 19.2 の `useEffectEvent` と違い、子のコンポーネントに渡せる。
+ *
+ * 最新のコールバックはコミット時に反映されるため、レンダリング中には呼ばないこと（古いコールバックが呼ばれる）。
+ * イベントハンドラーやエフェクトの中から呼ぶ。
+ *
+ * @param callback コールバック
+ * @returns 最新のコールバックを呼ぶ関数。参照は常に同じ
+ */
+declare function useStableCallback<A extends unknown[], R>(callback: (...args: A) => R): (...args: A) => R;
+export = useStableCallback;

package/hooks/useStableCallback/useStableCallback.d.mts

@@ -0,0 +1,15 @@
+//#region src/hooks/useStableCallback/useStableCallback.d.ts
+/**
+ * 参照が変わらず、呼ぶと最新のコールバックを実行する関数を返すフック
+ *
+ * 子のコンポーネントに渡すイベントハンドラーの参照を変えずに、中身は常に最新にする場合に使う。
+ * React 19.2 の `useEffectEvent` と違い、子のコンポーネントに渡せる。
+ *
+ * 最新のコールバックはコミット時に反映されるため、レンダリング中には呼ばないこと（古いコールバックが呼ばれる）。
+ * イベントハンドラーやエフェクトの中から呼ぶ。
+ *
+ * @param callback コールバック
+ * @returns 最新のコールバックを呼ぶ関数。参照は常に同じ
+ */
+export default function useStableCallback<A extends unknown[], R>(callback: (...args: A) => R): (...args: A) => R;
+//#endregion

package/hooks/useStableCallback/useStableCallback.mjs

@@ -0,0 +1,24 @@
+import useLatestRef from "../useLatestRef/useLatestRef.mjs";
+import "../useLatestRef/index.mjs";
+import { useCallback } from "react";
+
+//#region src/hooks/useStableCallback/useStableCallback.ts
+/**
+* 参照が変わらず、呼ぶと最新のコールバックを実行する関数を返すフック
+*
+* 子のコンポーネントに渡すイベントハンドラーの参照を変えずに、中身は常に最新にする場合に使う。
+* React 19.2 の `useEffectEvent` と違い、子のコンポーネントに渡せる。
+*
+* 最新のコールバックはコミット時に反映されるため、レンダリング中には呼ばないこと（古いコールバックが呼ばれる）。
+* イベントハンドラーやエフェクトの中から呼ぶ。
+*
+* @param callback コールバック
+* @returns 最新のコールバックを呼ぶ関数。参照は常に同じ
+*/
+function useStableCallback(callback) {
+	const latestRef = useLatestRef(callback);
+	return useCallback((...args) => latestRef.current(...args), [latestRef]);
+}
+
+//#endregion
+export { useStableCallback as default };

package/index.cjs

@@ -5,15 +5,21 @@ const require_hooks_useCombinedRefs_useCombinedRefs = require("./hooks/useCombin
 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_useIsMounted_useIsMounted = require("./hooks/useIsMounted/useIsMounted.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_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");
+const require_hooks_useRerender_useRerender = require("./hooks/useRerender/useRerender.cjs");
+const require_hooks_useStableCallback_useStableCallback = require("./hooks/useStableCallback/useStableCallback.cjs");
 require("./hooks/index.cjs");
 const require_utils_applyDefaultProps_applyDefaultProps = require("./utils/applyDefaultProps/applyDefaultProps.cjs");
 const require_utils_ensureComponent_ensureComponent = require("./utils/ensureComponent/ensureComponent.cjs");
 const require_utils_extendElement_extendElement = require("./utils/extendElement/extendElement.cjs");
 const require_utils_forEachContent_forEachContent = require("./utils/forEachContent/forEachContent.cjs");
 const require_utils_forEachElement_forEachElement = require("./utils/forEachElement/forEachElement.cjs");
+const require_utils_getComponentName_getComponentName = require("./utils/getComponentName/getComponentName.cjs");
 const require_utils_transformContent_transformContent = require("./utils/transformContent/transformContent.cjs");
 const require_utils_transformElement_transformElement = require("./utils/transformElement/transformElement.cjs");
 require("./utils/index.cjs");
@@ -23,6 +29,7 @@ exports.ensureComponent = require_utils_ensureComponent_ensureComponent.default;
 exports.extendElement = require_utils_extendElement_extendElement.default;
 exports.forEachContent = require_utils_forEachContent_forEachContent.default;
 exports.forEachElement = require_utils_forEachElement_forEachElement.default;
+exports.getComponentName = require_utils_getComponentName_getComponentName.default;
 exports.markAt = require_utils_markAt_markAt.default;
 exports.setRefCurrent = require_utils_setRefCurrent_setRefCurrent.default;
 exports.transformContent = require_utils_transformContent_transformContent.default;
@@ -30,7 +37,12 @@ exports.transformElement = require_utils_transformElement_transformElement.defau
 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.useIsHydrated = require_hooks_useIsHydrated_useIsHydrated.default;
 exports.useIsMounted = require_hooks_useIsMounted_useIsMounted.default;
 exports.useLatestRef = require_hooks_useLatestRef_useLatestRef.default;
 exports.usePreviousValue = require_hooks_usePreviousValue_usePreviousValue.default;
+exports.useRerender = require_hooks_useRerender_useRerender.default;
+exports.useStableCallback = require_hooks_useStableCallback_useStableCallback.default;
 exports.useStableLength = require_hooks_useStableLength_useStableLength.default;

package/index.d.cts

@@ -1,14 +1,19 @@
-import useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.cjs";
-import useConstant from "./hooks/useConstant/useConstant.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 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 useIsHydrated from "./hooks/useIsHydrated/useIsHydrated.cjs";
 import useIsMounted from "./hooks/useIsMounted/useIsMounted.cjs";
 import { LatestRef } from "./hooks/useLatestRef/types.cjs";
 import useLatestRef from "./hooks/useLatestRef/useLatestRef.cjs";
 import { UsePreviousValueOptions } from "./hooks/usePreviousValue/types.cjs";
 import usePreviousValue from "./hooks/usePreviousValue/usePreviousValue.cjs";
+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";
@@ -19,8 +24,9 @@ import { ExtendableProps } from "./utils/extendElement/types.cjs";
 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 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, markAt, setRefCurrent, transformContent, transformElement, useCombinedRefs, useConstant, useExecutionAt, useIsMounted, useLatestRef, usePreviousValue, useStableLength };
+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 };

package/index.d.mts

@@ -1,14 +1,19 @@
-import useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.mjs";
-import useConstant from "./hooks/useConstant/useConstant.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 useCombinedRefs from "./hooks/useCombinedRefs/useCombinedRefs.mjs";
+import useConstant from "./hooks/useConstant/useConstant.mjs";
+import useExecutionEffect from "./hooks/useExecutionEffect/useExecutionEffect.mjs";
+import useExecutionLayoutEffect from "./hooks/useExecutionLayoutEffect/useExecutionLayoutEffect.mjs";
+import useIsHydrated from "./hooks/useIsHydrated/useIsHydrated.mjs";
 import useIsMounted from "./hooks/useIsMounted/useIsMounted.mjs";
 import { LatestRef } from "./hooks/useLatestRef/types.mjs";
 import useLatestRef from "./hooks/useLatestRef/useLatestRef.mjs";
 import { UsePreviousValueOptions } from "./hooks/usePreviousValue/types.mjs";
 import usePreviousValue from "./hooks/usePreviousValue/usePreviousValue.mjs";
+import useRerender from "./hooks/useRerender/useRerender.mjs";
+import useStableCallback from "./hooks/useStableCallback/useStableCallback.mjs";
 import useStableLength from "./hooks/useStableLength/useStableLength.mjs";
 import "./hooks/index.mjs";
 import { CSSPropertiesWithVars } from "./types.mjs";
@@ -19,8 +24,9 @@ import { ExtendableProps } from "./utils/extendElement/types.mjs";
 import extendElement from "./utils/extendElement/extendElement.mjs";
 import forEachContent from "./utils/forEachContent/forEachContent.mjs";
 import forEachElement from "./utils/forEachElement/forEachElement.mjs";
+import getComponentName from "./utils/getComponentName/getComponentName.mjs";
 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, markAt, setRefCurrent, transformContent, transformElement, useCombinedRefs, useConstant, useExecutionAt, useIsMounted, useLatestRef, usePreviousValue, useStableLength };
+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 };