From 1425afb086597d5d4a9f3861b67aa546de859b0d Mon Sep 17 00:00:00 2001
From: mnxmnz <48766355+mnxmnz@users.noreply.github.com>
Date: Tue, 6 Oct 2026 23:40:32 +0900
Subject: [PATCH 1/3] refactor(useBooleanState, useStorageState, useCounter):
 return the value with an actions object

---
 .changeset/state-hook-returns.md              | 19 +++++
 AGENTS.md                                     |  6 +-
 CLAUDE.md                                     |  6 +-
 .../references/useBooleanState.md             | 19 ++---
 .../react-simplikit/references/useCounter.md  | 12 +--
 .../references/useStorageState.md             | 15 ++--
 .../useBooleanState/es/useBooleanState.md     | 19 ++---
 .../useBooleanState/ja/useBooleanState.md     | 19 ++---
 .../useBooleanState/ko/useBooleanState.md     | 19 ++---
 .../hooks/useBooleanState/useBooleanState.md  | 19 ++---
 .../useBooleanState/useBooleanState.spec.ts   | 18 ++++-
 .../hooks/useBooleanState/useBooleanState.ts  | 26 ++++---
 .../zh-Hans/useBooleanState.md                | 19 ++---
 .../src/hooks/useCounter/es/useCounter.md     | 12 +--
 .../src/hooks/useCounter/ja/useCounter.md     | 12 +--
 .../src/hooks/useCounter/ko/useCounter.md     | 12 +--
 .../src/hooks/useCounter/useCounter.md        | 12 +--
 .../src/hooks/useCounter/useCounter.spec.ts   | 78 +++++++++++--------
 .../src/hooks/useCounter/useCounter.ts        | 32 ++++----
 .../hooks/useCounter/zh-Hans/useCounter.md    | 12 +--
 .../useStorageState/es/useStorageState.md     | 15 ++--
 .../useStorageState/ja/useStorageState.md     | 15 ++--
 .../useStorageState/ko/useStorageState.md     | 15 ++--
 .../hooks/useStorageState/useStorageState.md  | 15 ++--
 .../useStorageState/useStorageState.spec.ts   | 30 ++++---
 .../hooks/useStorageState/useStorageState.ts  | 48 ++++++------
 .../zh-Hans/useStorageState.md                | 15 ++--
 .../src/hooks/useToggle/useToggle.ts          | 10 +--
 28 files changed, 287 insertions(+), 262 deletions(-)
 create mode 100644 .changeset/state-hook-returns.md

diff --git a/.changeset/state-hook-returns.md b/.changeset/state-hook-returns.md
new file mode 100644
index 00000000..c53cee1f
--- /dev/null
+++ b/.changeset/state-hook-returns.md
@@ -0,0 +1,19 @@
+---
+'react-simplikit': major
+---
+
+`useBooleanState`, `useStorageState` and `useCounter` now return `[value, actions]`, matching `useList`, `useMap` and `useSet`. The actions object keeps the same reference across renders.
+
+```ts
+// before
+const [isOpen, setTrue, setFalse, toggle] = useBooleanState(false);
+const [token, setToken, refreshToken] = useStorageState<string>('token');
+const { count, increment, decrement, reset, setCount } = useCounter(0);
+
+// after
+const [isOpen, { setTrue, setFalse, toggle }] = useBooleanState(false);
+const [token, { setValue, refresh }] = useStorageState<string>('token');
+const [count, { increment, decrement, reset, setCount }] = useCounter(0);
+```
+
+`useToggle` keeps its `[value, toggle]` signature, is now built on `useBooleanState`, and declares its return type so that React 18 consumers no longer see the React 19 `ActionDispatch` type.
diff --git a/AGENTS.md b/AGENTS.md
index 4e92374c..119d49b9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -116,9 +116,9 @@ Never initialize state with browser API calls (causes hydration mismatch).
 ### Hook Return Value Convention
 
 - **Single value**: `useDebounce<T>(value, delay): T`
-- **Tuple** (2 items): `useToggle(init): [boolean, () => void]`
-- **Object** (3+ items): `usePagination(): { page, nextPage, prevPage }`
-- **Object** also when the shape is expected to grow: `useKeyboardHeight(): { keyboardHeight }`
+- **Tuple** (state + one action): `useToggle(init): [boolean, () => void]`
+- **Tuple with an actions object** (state + two or more actions): `useBooleanState(init): [boolean, { setTrue, setFalse, toggle }]`, `useList`, `useCounter`
+- **Object** for results that are not state + actions, and whenever the shape is expected to grow: browser measurements such as `useKeyboardHeight(): { keyboardHeight }`
 
 ## Testing
 
diff --git a/CLAUDE.md b/CLAUDE.md
index 2809c868..7332c8fd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -89,9 +89,9 @@ Never initialize state with browser API calls (causes hydration mismatch).
 ### Hook Return Value Convention
 
 - **Single value**: `useDebounce<T>(value, delay): T`
-- **Tuple** (state + action, 2 items): `useToggle(init): [boolean, () => void]`
-- **Object** (3+ items): `usePagination(): { page, nextPage, prevPage }`
-- **Object** also when the shape is expected to grow: browser measurements such as `useKeyboardHeight(): { keyboardHeight }`
+- **Tuple** (state + one action): `useToggle(init): [boolean, () => void]`
+- **Tuple with an actions object** (state + two or more actions): `useBooleanState(init): [boolean, { setTrue, setFalse, toggle }]`, `useList`, `useCounter`
+- **Object** for results that are not state + actions, and whenever the shape is expected to grow: browser measurements such as `useKeyboardHeight(): { keyboardHeight }`
 
 ### Performance Patterns
 
diff --git a/packages/plugin/skills/react-simplikit/references/useBooleanState.md b/packages/plugin/skills/react-simplikit/references/useBooleanState.md
index 3ef27c3e..50443689 100644
--- a/packages/plugin/skills/react-simplikit/references/useBooleanState.md
+++ b/packages/plugin/skills/react-simplikit/references/useBooleanState.md
@@ -8,12 +8,7 @@ It provides functions to set the state to `true`, set it to `false`, and toggle
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### Parameters
@@ -28,8 +23,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="A tuple containing:"
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="A tuple containing the state and actions to change it."
   :nested="[
     {
       name: 'state',
@@ -38,19 +33,19 @@ function useBooleanState(
       description: 'The current state value.',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: 'A function to set the state to <code>true</code>.',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: 'A function to set the state to <code>false</code>.',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: 'A function to toggle the state.',
@@ -61,6 +56,6 @@ function useBooleanState(
 ## Example
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/plugin/skills/react-simplikit/references/useCounter.md b/packages/plugin/skills/react-simplikit/references/useCounter.md
index fcfa9049..54052aea 100644
--- a/packages/plugin/skills/react-simplikit/references/useCounter.md
+++ b/packages/plugin/skills/react-simplikit/references/useCounter.md
@@ -55,7 +55,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="An object with count value and control functions."
+  description="A tuple containing the count and actions to change it."
   :nested="[
     {
       name: 'count',
@@ -64,25 +64,25 @@ function useCounter(
       description: 'The current count value.',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: 'A function to increment the count.',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: 'A function to decrement the count.',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: 'A function to reset the count to the initial value.',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -97,7 +97,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/plugin/skills/react-simplikit/references/useStorageState.md b/packages/plugin/skills/react-simplikit/references/useStorageState.md
index 08ee4a2c..f4efb065 100644
--- a/packages/plugin/skills/react-simplikit/references/useStorageState.md
+++ b/packages/plugin/skills/react-simplikit/references/useStorageState.md
@@ -11,8 +11,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -63,8 +62,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="A tuple:"
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="A tuple containing the state and actions to change it."
   :nested="[
     {
       name: 'state',
@@ -73,13 +72,13 @@ function useStorageState<T>(
       description: 'The current state value retrieved from storage.',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: 'A function to update and persist the state.',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: 'A function to refresh the state from storage.',
@@ -94,12 +93,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/es/useBooleanState.md b/packages/react-simplikit/src/hooks/useBooleanState/es/useBooleanState.md
index 4cd9664c..2f945add 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/es/useBooleanState.md
+++ b/packages/react-simplikit/src/hooks/useBooleanState/es/useBooleanState.md
@@ -8,12 +8,7 @@ Proporciona funciones para establecer el estado en `true`, establecerlo en `fals
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### Parámetros
@@ -28,8 +23,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="Una tupla que contiene:"
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="Una tupla con el estado y las acciones para cambiarlo."
   :nested="[
     {
       name: 'state',
@@ -38,19 +33,19 @@ function useBooleanState(
       description: 'El valor actual del estado.',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: 'Una función para establecer el estado en <code>true</code>.',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: 'Una función para establecer el estado en <code>false</code>.',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: 'Una función para alternar el estado.',
@@ -61,6 +56,6 @@ function useBooleanState(
 ## Ejemplo
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/ja/useBooleanState.md b/packages/react-simplikit/src/hooks/useBooleanState/ja/useBooleanState.md
index 3e58dea9..1a1b28bc 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/ja/useBooleanState.md
+++ b/packages/react-simplikit/src/hooks/useBooleanState/ja/useBooleanState.md
@@ -8,12 +8,7 @@
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### パラメータ
@@ -28,8 +23,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="以下を含むタプル。"
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="状態と、状態を変更するアクションを含むタプル。"
   :nested="[
     {
       name: 'state',
@@ -38,19 +33,19 @@ function useBooleanState(
       description: '現在の状態の値。',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: '状態を <code>true</code> にする関数。',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: '状態を <code>false</code> にする関数。',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: '状態を切り替える関数。',
@@ -61,6 +56,6 @@ function useBooleanState(
 ## 使用例
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/ko/useBooleanState.md b/packages/react-simplikit/src/hooks/useBooleanState/ko/useBooleanState.md
index 494cc406..055efe57 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/ko/useBooleanState.md
+++ b/packages/react-simplikit/src/hooks/useBooleanState/ko/useBooleanState.md
@@ -7,12 +7,7 @@
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### 파라미터
@@ -27,8 +22,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="다음 값들을 포함하는 튜플이에요:"
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="상태와 상태를 바꾸는 액션을 담은 튜플이에요."
   :nested="[
     {
       name: 'state',
@@ -37,19 +32,19 @@ function useBooleanState(
       description: '현재 상태 값이에요.',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: '상태를 <code>true</code>로 설정하는 함수예요.',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: '상태를 <code>false</code>로 설정하는 함수예요.',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: '상태를 토글하는 함수예요.',
@@ -60,6 +55,6 @@ function useBooleanState(
 ## 예시
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.md b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.md
index 3ef27c3e..50443689 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.md
+++ b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.md
@@ -8,12 +8,7 @@ It provides functions to set the state to `true`, set it to `false`, and toggle
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### Parameters
@@ -28,8 +23,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="A tuple containing:"
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="A tuple containing the state and actions to change it."
   :nested="[
     {
       name: 'state',
@@ -38,19 +33,19 @@ function useBooleanState(
       description: 'The current state value.',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: 'A function to set the state to <code>true</code>.',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: 'A function to set the state to <code>false</code>.',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: 'A function to toggle the state.',
@@ -61,6 +56,6 @@ function useBooleanState(
 ## Example
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.spec.ts b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.spec.ts
index 7fbd2640..b13f3d2e 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.spec.ts
+++ b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.spec.ts
@@ -23,7 +23,7 @@ describe('useBooleanState', () => {
 
   it('should set value to true when setTrue is called', async () => {
     const { result } = await renderHookSSR(() => useBooleanState(false));
-    const [, setTrue] = result.current;
+    const [, { setTrue }] = result.current;
 
     await act(async () => {
       setTrue();
@@ -35,7 +35,7 @@ describe('useBooleanState', () => {
 
   it('should set value to false when setFalse is called', async () => {
     const { result } = await renderHookSSR(() => useBooleanState(true));
-    const [, , setFalse] = result.current;
+    const [, { setFalse }] = result.current;
 
     await act(async () => {
       setFalse();
@@ -47,7 +47,7 @@ describe('useBooleanState', () => {
 
   it('should toggle value when toggle is called', async () => {
     const { result } = await renderHookSSR(() => useBooleanState(false));
-    const [, , , toggle] = result.current;
+    const [, { toggle }] = result.current;
 
     await act(async () => {
       toggle();
@@ -86,4 +86,16 @@ describe('useBooleanState', () => {
 
     expect(initializer).toHaveBeenCalledTimes(1);
   });
+
+  it('should keep the actions object stable across renders', async () => {
+    const { result } = await renderHookSSR(() => useBooleanState(false));
+    const [, actions] = result.current;
+
+    await act(async () => {
+      actions.toggle();
+    });
+
+    expect(result.current[0]).toBe(true);
+    expect(result.current[1]).toBe(actions);
+  });
 });
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.ts b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.ts
index 8bc7915b..1d025279 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.ts
+++ b/packages/react-simplikit/src/hooks/useBooleanState/useBooleanState.ts
@@ -1,7 +1,13 @@
-import { useCallback, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 
 type InitialValue = boolean | (() => boolean);
 
+type BooleanStateActions = {
+  setTrue: () => void;
+  setFalse: () => void;
+  toggle: () => void;
+};
+
 /**
  * @description
  * `useBooleanState` is a React hook that simplifies managing a boolean state.
@@ -9,18 +15,16 @@ type InitialValue = boolean | (() => boolean);
  *
  * @param {boolean | (() => boolean)} [initialValue=false] - The initial value of the state. Defaults to `false`.
  *
- * @returns {readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]} A tuple containing:
+ * @returns {readonly [state: boolean, actions: BooleanStateActions]} A tuple containing the state and actions to change it.
  * - state `boolean` - The current state value;
- * - setTrue `() => void` - A function to set the state to `true`;
- * - setFalse `() => void` - A function to set the state to `false`;
- * - toggle `() => void` - A function to toggle the state;
+ * - actions.setTrue `() => void` - A function to set the state to `true`;
+ * - actions.setFalse `() => void` - A function to set the state to `false`;
+ * - actions.toggle `() => void` - A function to toggle the state;
  *
  * @example
- * const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] = useBooleanState(false);
+ * const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] = useBooleanState(false);
  */
-export function useBooleanState(
-  initialValue: InitialValue = false
-): readonly [boolean, () => void, () => void, () => void] {
+export function useBooleanState(initialValue: InitialValue = false): readonly [boolean, BooleanStateActions] {
   const [bool, setBool] = useState(initialValue);
 
   const setTrue = useCallback(() => {
@@ -35,5 +39,7 @@ export function useBooleanState(
     setBool(prevBool => !prevBool);
   }, []);
 
-  return [bool, setTrue, setFalse, toggle] as const;
+  const actions = useMemo<BooleanStateActions>(() => ({ setTrue, setFalse, toggle }), [setTrue, setFalse, toggle]);
+
+  return [bool, actions] as const;
 }
diff --git a/packages/react-simplikit/src/hooks/useBooleanState/zh-Hans/useBooleanState.md b/packages/react-simplikit/src/hooks/useBooleanState/zh-Hans/useBooleanState.md
index 4877198e..03b31c01 100644
--- a/packages/react-simplikit/src/hooks/useBooleanState/zh-Hans/useBooleanState.md
+++ b/packages/react-simplikit/src/hooks/useBooleanState/zh-Hans/useBooleanState.md
@@ -7,12 +7,7 @@
 ```ts
 function useBooleanState(
   initialValue: boolean | (() => boolean) = false
-): readonly [
-  state: boolean,
-  setTrue: () => void,
-  setFalse: () => void,
-  toggle: () => void,
-];
+): readonly [state: boolean, actions: BooleanStateActions];
 ```
 
 ### 参数
@@ -27,8 +22,8 @@ function useBooleanState(
 
 <Interface
   name=""
-  type="readonly [state: boolean, setTrue: () => void, setFalse: () => void, toggle: () => void]"
-  description="包含以下内容的元组："
+  type="readonly [state: boolean, actions: BooleanStateActions]"
+  description="包含状态和状态修改操作的元组。"
   :nested="[
     {
       name: 'state',
@@ -37,19 +32,19 @@ function useBooleanState(
       description: '当前的状态值。',
     },
     {
-      name: 'setTrue',
+      name: 'actions.setTrue',
       type: '() => void',
       required: false,
       description: '将状态设置为 <code>true</code> 的函数。',
     },
     {
-      name: 'setFalse',
+      name: 'actions.setFalse',
       type: '() => void',
       required: false,
       description: '将状态设置为 <code>false</code> 的函数。',
     },
     {
-      name: 'toggle',
+      name: 'actions.toggle',
       type: '() => void',
       required: false,
       description: '切换状态的函数。',
@@ -60,6 +55,6 @@ function useBooleanState(
 ## 示例
 
 ```tsx
-const [open, openBottomSheet, closeBottomSheet, toggleBottomSheet] =
+const [open, { setTrue: openBottomSheet, setFalse: closeBottomSheet }] =
   useBooleanState(false);
 ```
diff --git a/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
index 47a4c3b1..3c4286e7 100644
--- a/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
@@ -55,7 +55,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="Un objeto con el valor del contador y las funciones de control."
+  description="Una tupla con el valor del contador y las acciones para cambiarlo."
   :nested="[
     {
       name: 'count',
@@ -64,25 +64,25 @@ function useCounter(
       description: 'El valor actual del contador.',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: 'Una función para incrementar el contador.',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: 'Una función para decrementar el contador.',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: 'Una función para restablecer el contador a su valor inicial.',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -97,7 +97,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
index 55843629..6716f3b8 100644
--- a/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
@@ -55,7 +55,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="カウンターの値と操作用の関数を含むオブジェクト。"
+  description="カウンターの値と、値を変更するアクションを含むタプル。"
   :nested="[
     {
       name: 'count',
@@ -64,25 +64,25 @@ function useCounter(
       description: '現在のカウンターの値。',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: 'カウンターの値を増やす関数。',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: 'カウンターの値を減らす関数。',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: 'カウンターを初期値にリセットする関数。',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -97,7 +97,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
index d176a0ec..63d4dfe8 100644
--- a/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
@@ -54,7 +54,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="카운트 값과 제어 함수들을 가진 객체예요."
+  description="카운트 값과 카운트를 바꾸는 액션을 담은 튜플이에요."
   :nested="[
     {
       name: 'count',
@@ -63,25 +63,25 @@ function useCounter(
       description: '현재 카운트 값이에요.',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: '카운트를 증가시키는 함수예요.',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: '카운트를 감소시키는 함수예요.',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: '카운트를 초기값으로 재설정하는 함수예요.',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -96,7 +96,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/react-simplikit/src/hooks/useCounter/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/useCounter.md
index fcfa9049..54052aea 100644
--- a/packages/react-simplikit/src/hooks/useCounter/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/useCounter.md
@@ -55,7 +55,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="An object with count value and control functions."
+  description="A tuple containing the count and actions to change it."
   :nested="[
     {
       name: 'count',
@@ -64,25 +64,25 @@ function useCounter(
       description: 'The current count value.',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: 'A function to increment the count.',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: 'A function to decrement the count.',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: 'A function to reset the count to the initial value.',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -97,7 +97,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/react-simplikit/src/hooks/useCounter/useCounter.spec.ts b/packages/react-simplikit/src/hooks/useCounter/useCounter.spec.ts
index 92784749..950033b0 100644
--- a/packages/react-simplikit/src/hooks/useCounter/useCounter.spec.ts
+++ b/packages/react-simplikit/src/hooks/useCounter/useCounter.spec.ts
@@ -7,50 +7,50 @@ describe('useCounter', () => {
   it('should initialize with default value', () => {
     const { result } = renderHook(() => useCounter());
 
-    expect(result.current.count).toBe(0);
+    expect(result.current[0]).toBe(0);
   });
 
   it('should initialize with provided initial value', () => {
     const { result } = renderHook(() => useCounter(10));
 
-    expect(result.current.count).toBe(10);
+    expect(result.current[0]).toBe(10);
   });
 
   it('should increment the counter', async () => {
     const { result } = renderHook(() => useCounter(5));
 
     await act(async () => {
-      result.current.increment();
+      result.current[1].increment();
     });
 
-    expect(result.current.count).toBe(6);
+    expect(result.current[0]).toBe(6);
   });
 
   it('should decrement the counter', async () => {
     const { result } = renderHook(() => useCounter(5));
 
     await act(async () => {
-      result.current.decrement();
+      result.current[1].decrement();
     });
 
-    expect(result.current.count).toBe(4);
+    expect(result.current[0]).toBe(4);
   });
 
   it('should reset the counter to initial value', async () => {
     const { result } = renderHook(() => useCounter(5));
 
     await act(async () => {
-      result.current.increment();
-      result.current.increment();
+      result.current[1].increment();
+      result.current[1].increment();
     });
 
-    expect(result.current.count).toBe(7);
+    expect(result.current[0]).toBe(7);
 
     await act(async () => {
-      result.current.reset();
+      result.current[1].reset();
     });
 
-    expect(result.current.count).toBe(5);
+    expect(result.current[0]).toBe(5);
   });
 
   it('should not go below minimum value', async () => {
@@ -61,12 +61,12 @@ describe('useCounter', () => {
     );
 
     await act(async () => {
-      result.current.decrement();
-      result.current.decrement();
-      result.current.decrement();
+      result.current[1].decrement();
+      result.current[1].decrement();
+      result.current[1].decrement();
     });
 
-    expect(result.current.count).toBe(3);
+    expect(result.current[0]).toBe(3);
   });
 
   it('should not go above maximum value', async () => {
@@ -77,12 +77,12 @@ describe('useCounter', () => {
     );
 
     await act(async () => {
-      result.current.increment();
-      result.current.increment();
-      result.current.increment();
+      result.current[1].increment();
+      result.current[1].increment();
+      result.current[1].increment();
     });
 
-    expect(result.current.count).toBe(7);
+    expect(result.current[0]).toBe(7);
   });
 
   it('should use the provided step value for increment and decrement', async () => {
@@ -93,16 +93,16 @@ describe('useCounter', () => {
     );
 
     await act(async () => {
-      result.current.increment();
+      result.current[1].increment();
     });
 
-    expect(result.current.count).toBe(7);
+    expect(result.current[0]).toBe(7);
 
     await act(async () => {
-      result.current.decrement();
+      result.current[1].decrement();
     });
 
-    expect(result.current.count).toBe(5);
+    expect(result.current[0]).toBe(5);
   });
 
   it('should adjust initial value to match constraints', () => {
@@ -112,7 +112,7 @@ describe('useCounter', () => {
       })
     );
 
-    expect(result.current.count).toBe(3);
+    expect(result.current[0]).toBe(3);
 
     const { result: result2 } = renderHook(() =>
       useCounter(10, {
@@ -120,7 +120,7 @@ describe('useCounter', () => {
       })
     );
 
-    expect(result2.current.count).toBe(8);
+    expect(result2.current[0]).toBe(8);
   });
 
   it('should allow setting arbitrary value within constraints', async () => {
@@ -132,31 +132,43 @@ describe('useCounter', () => {
     );
 
     await act(async () => {
-      result.current.setCount(6);
+      result.current[1].setCount(6);
     });
 
-    expect(result.current.count).toBe(6);
+    expect(result.current[0]).toBe(6);
 
     await act(async () => {
-      result.current.setCount(1);
+      result.current[1].setCount(1);
     });
 
-    expect(result.current.count).toBe(3);
+    expect(result.current[0]).toBe(3);
 
     await act(async () => {
-      result.current.setCount(10);
+      result.current[1].setCount(10);
     });
 
-    expect(result.current.count).toBe(8);
+    expect(result.current[0]).toBe(8);
   });
 
   it('should work with updater function for setCount', async () => {
     const { result } = renderHook(() => useCounter(5));
 
     await act(async () => {
-      result.current.setCount(prev => prev + 3);
+      result.current[1].setCount(prev => prev + 3);
     });
 
-    expect(result.current.count).toBe(8);
+    expect(result.current[0]).toBe(8);
+  });
+
+  it('should keep the actions object stable across renders', () => {
+    const { result } = renderHook(() => useCounter(0));
+    const [, actions] = result.current;
+
+    act(() => {
+      actions.increment();
+    });
+
+    expect(result.current[0]).toBe(1);
+    expect(result.current[1]).toBe(actions);
   });
 });
diff --git a/packages/react-simplikit/src/hooks/useCounter/useCounter.ts b/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
index 12af9125..fd6d744b 100644
--- a/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
+++ b/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
@@ -1,4 +1,4 @@
-import { useCallback, useState } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 
 type UseCounterOptions = {
   min?: number;
@@ -6,14 +6,15 @@ type UseCounterOptions = {
   step?: number;
 };
 
-type UseCounterReturn = {
-  count: number;
+type CounterActions = {
   increment: () => void;
   decrement: () => void;
   reset: () => void;
   setCount: (value: number | ((prev: number) => number)) => void;
 };
 
+type UseCounterReturn = readonly [number, CounterActions];
+
 const validateValue = (value: number, { min, max }: Omit<UseCounterOptions, 'step'>): number => {
   if (min !== undefined && value < min) {
     return min;
@@ -37,18 +38,18 @@ const validateValue = (value: number, { min, max }: Omit<UseCounterOptions, 'ste
  * @param {number} [options.max] - Maximum value the counter can reach. If not provided, there is no upper limit.
  * @param {number} [options.step=1] - Value to increment or decrement by. Defaults to 1.
  *
- * @returns {UseCounterReturn} An object with count value and control functions.
+ * @returns {UseCounterReturn} A tuple containing the count and actions to change it.
  * - count `number` - The current count value;
- * - increment `() => void` - A function to increment the count;
- * - decrement `() => void` - A function to decrement the count;
- * - reset `() => void` - A function to reset the count to the initial value;
- * - setCount `(value: number | ((prev: number) => number)) => void` - A function to set the count to a specific value or a function that returns a new value;
+ * - actions.increment `() => void` - A function to increment the count;
+ * - actions.decrement `() => void` - A function to decrement the count;
+ * - actions.reset `() => void` - A function to reset the count to the initial value;
+ * - actions.setCount `(value: number | ((prev: number) => number)) => void` - A function to set the count to a specific value or a function that returns a new value;
  *
  * @example
  * import { useCounter } from 'react-simplikit';
  *
  * function ShoppingCart() {
- *   const { count, increment, decrement, reset } = useCounter(1, {
+ *   const [count, { increment, decrement, reset }] = useCounter(1, {
  *     min: 1,
  *     max: 10,
  *   });
@@ -89,11 +90,10 @@ export function useCounter(initialValue = 0, { min, max, step = 1 }: UseCounterO
     setCount(initialValue);
   }, [setCount, initialValue]);
 
-  return {
-    count,
-    increment,
-    decrement,
-    reset,
-    setCount,
-  };
+  const actions = useMemo<CounterActions>(
+    () => ({ increment, decrement, reset, setCount }),
+    [increment, decrement, reset, setCount]
+  );
+
+  return [count, actions] as const;
 }
diff --git a/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
index 6c1fe3f3..4c717cb2 100644
--- a/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
@@ -54,7 +54,7 @@ function useCounter(
 <Interface
   name=""
   type="UseCounterReturn"
-  description="包含计数值和控制函数的对象。"
+  description="包含计数值和计数修改操作的元组。"
   :nested="[
     {
       name: 'count',
@@ -63,25 +63,25 @@ function useCounter(
       description: '当前的计数值。',
     },
     {
-      name: 'increment',
+      name: 'actions.increment',
       type: '() => void',
       required: false,
       description: '递增计数的函数。',
     },
     {
-      name: 'decrement',
+      name: 'actions.decrement',
       type: '() => void',
       required: false,
       description: '递减计数的函数。',
     },
     {
-      name: 'reset',
+      name: 'actions.reset',
       type: '() => void',
       required: false,
       description: '将计数重置为初始值的函数。',
     },
     {
-      name: 'setCount',
+      name: 'actions.setCount',
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
@@ -96,7 +96,7 @@ function useCounter(
 import { useCounter } from 'react-simplikit';
 
 function ShoppingCart() {
-  const { count, increment, decrement, reset } = useCounter(1, {
+  const [count, { increment, decrement, reset }] = useCounter(1, {
     min: 1,
     max: 10,
   });
diff --git a/packages/react-simplikit/src/hooks/useStorageState/es/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/es/useStorageState.md
index a10a3cc7..f6c11570 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/es/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/es/useStorageState.md
@@ -11,8 +11,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -63,8 +62,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="Una tupla:"
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="Una tupla con el estado y las acciones para cambiarlo."
   :nested="[
     {
       name: 'state',
@@ -73,13 +72,13 @@ function useStorageState<T>(
       description: 'El valor actual del estado obtenido del almacenamiento.',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: 'Una función para actualizar y guardar el estado de forma persistente.',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: 'Una función para actualizar el estado a partir del almacenamiento.',
@@ -94,12 +93,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Conteo: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Conteo: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useStorageState/ja/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/ja/useStorageState.md
index 2d586814..beb794eb 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/ja/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/ja/useStorageState.md
@@ -11,8 +11,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -63,8 +62,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="次の要素を含むタプル。"
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="状態と、状態を変更するアクションを含むタプル。"
   :nested="[
     {
       name: 'state',
@@ -73,13 +72,13 @@ function useStorageState<T>(
       description: 'ストレージから取得した現在の状態の値。',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: '状態を更新し、永続化する関数。',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: 'ストレージから状態を再取得する関数。',
@@ -94,12 +93,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
index ecf1be84..df82c1ee 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
@@ -10,8 +10,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -62,8 +61,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="튜플이에요:"
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="상태와 상태를 바꾸는 액션을 담은 튜플이에요."
   :nested="[
     {
       name: 'state',
@@ -72,13 +71,13 @@ function useStorageState<T>(
       description: '저장소에서 가져온 현재 상태 값이에요.',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: '상태를 업데이트하고 지속하는 함수예요.',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: '저장소에서 상태를 다시 가져오는 함수예요.',
@@ -93,12 +92,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
index 08ee4a2c..f4efb065 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
@@ -11,8 +11,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -63,8 +62,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="A tuple:"
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="A tuple containing the state and actions to change it."
   :nested="[
     {
       name: 'state',
@@ -73,13 +72,13 @@ function useStorageState<T>(
       description: 'The current state value retrieved from storage.',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: 'A function to update and persist the state.',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: 'A function to refresh the state from storage.',
@@ -94,12 +93,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.spec.ts b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.spec.ts
index 5bccd602..5dadc1d4 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.spec.ts
+++ b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.spec.ts
@@ -167,7 +167,7 @@ describe('useStorageState', () => {
     it('should set and get value', async () => {
       const { result } = await renderHookSSR(() => useStorageState<string>('test-key', { storage }));
       await act(async () => {
-        result.current[1]('new value');
+        result.current[1].setValue('new value');
       });
       expect(result.current[0]).toBe('new value');
     });
@@ -175,17 +175,27 @@ describe('useStorageState', () => {
     it('should update value using function', async () => {
       const { result } = await renderHookSSR(() => useStorageState<number>('test-key', { defaultValue: 0, storage }));
       await act(async () => {
-        result.current[1](prev => prev + 1);
+        result.current[1].setValue(prev => prev + 1);
       });
       expect(result.current[0]).toBe(1);
     });
 
+    it('should keep the actions object stable across renders', async () => {
+      const { result } = await renderHookSSR(() => useStorageState<string>('test-key', { storage }));
+      const [, actions] = result.current;
+      await act(async () => {
+        actions.setValue('new value');
+      });
+      expect(result.current[0]).toBe('new value');
+      expect(result.current[1]).toBe(actions);
+    });
+
     it('should sync between multiple hooks with same key', async () => {
       const { result: result1 } = await renderHookSSR(() => useStorageState<string>('test-key', { storage }));
       const { result: result2 } = await renderHookSSR(() => useStorageState<string>('test-key', { storage }));
 
       await act(async () => {
-        result1.current[1]('updated value');
+        result1.current[1].setValue('updated value');
       });
 
       expect(result2.current[0]).toBe('updated value');
@@ -197,7 +207,7 @@ describe('useStorageState', () => {
       storage.set('test-key', JSON.stringify({ hello: 'world' }));
 
       await act(async () => {
-        result.current[2]();
+        result.current[1].refresh();
       });
 
       expect(result.current[0]).toEqual({ hello: 'world' });
@@ -212,7 +222,7 @@ describe('useStorageState', () => {
       const { result } = await renderHookSSR(() => useStorageState('test-key', { storage, serializer, deserializer }));
 
       await act(async () => {
-        result.current[1]('hello');
+        result.current[1].setValue('hello');
       });
 
       expect(result.current[0]).toEqual('hello');
@@ -244,7 +254,7 @@ describe('useStorageState', () => {
       const { result, rerender } = await renderHookSSR(() => useStorageState<string>('test-key', { storage }));
 
       await act(async () => {
-        result.current[1]('memo value');
+        result.current[1].setValue('memo value');
       });
 
       rerender();
@@ -266,7 +276,7 @@ describe('useStorageState', () => {
       );
 
       await act(async () => {
-        result.current[1]('session value');
+        result.current[1].setValue('session value');
       });
 
       rerender();
@@ -304,7 +314,7 @@ describe('useStorageState', () => {
       );
 
       await act(async () => {
-        result.current[1]('local value');
+        result.current[1].setValue('local value');
       });
 
       rerender();
@@ -404,13 +414,13 @@ describe('useStorageState', () => {
       const { result } = await renderHookSSR(() => useStorageState<string>('test-key', { storage: safeLocalStorage }));
 
       await act(async () => {
-        result.current[1]('value');
+        result.current[1].setValue('value');
       });
 
       expect(result.current[0]).toBe('value');
 
       await act(async () => {
-        result.current[1](undefined);
+        result.current[1].setValue(undefined);
       });
 
       expect(result.current[0]).toBeUndefined();
diff --git a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
index b63349d9..06578f11 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
+++ b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
@@ -1,5 +1,5 @@
 /* eslint-disable react-hooks/exhaustive-deps */
-import { SetStateAction, useCallback, useRef, useSyncExternalStore } from 'react';
+import { SetStateAction, useCallback, useMemo, useRef, useSyncExternalStore } from 'react';
 
 import { safeLocalStorage, Storage } from './storage.ts';
 
@@ -21,6 +21,11 @@ type StorageStateOptionsWithSerializer<T> = StorageStateOptions<T> & {
   deserializer: (value: string) => Serializable<T>;
 };
 
+type StorageStateActions<V> = {
+  setValue: (value: SetStateAction<V>) => void;
+  refresh: () => void;
+};
+
 type SerializableGuard<T extends readonly any[]> = T[0] extends any
   ? T
   : T[0] extends never
@@ -74,43 +79,37 @@ const ensureSerializable = <T extends readonly any[]>(value: T): SerializableGua
  * @param {Function} [options.serializer] - A function to serialize the state value to a string.
  * @param {Function} [options.deserializer] - A function to deserialize the state value from a string.
  *
- * @returns {readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]} A tuple:
+ * @returns {readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]} A tuple containing the state and actions to change it.
  * - state `Serializable<T> | undefined` - The current state value retrieved from storage;
- * - setState `(value: SetStateAction<Serializable<T> | undefined>) => void` - A function to update and persist the state;
- * - refreshState `() => void` - A function to refresh the state from storage;
+ * - actions.setValue `(value: SetStateAction<Serializable<T> | undefined>) => void` - A function to update and persist the state;
+ * - actions.refresh `() => void` - A function to refresh the state from storage;
  * @example
  * // Counter with persistent state
  * import { useStorageState } from 'react-simplikit';
  *
  * function Counter() {
- *   const [count, setCount] = useStorageState<number>('counter', {
+ *   const [count, { setValue }] = useStorageState<number>('counter', {
  *     defaultValue: 0,
  *   });
  *
- *   return <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>;
+ *   return <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>;
  * }
  */
 export function useStorageState<T>(
   key: string
-): SerializableGuard<
-  readonly [Serializable<T> | undefined, (value: SetStateAction<Serializable<T> | undefined>) => void, () => void]
->;
+): SerializableGuard<readonly [Serializable<T> | undefined, StorageStateActions<Serializable<T> | undefined>]>;
 export function useStorageState<T>(
   key: string,
   options: StorageStateOptionsWithDefaultValue<T>
-): SerializableGuard<readonly [Serializable<T>, (value: SetStateAction<Serializable<T>>) => void, () => void]>;
+): SerializableGuard<readonly [Serializable<T>, StorageStateActions<Serializable<T>>]>;
 export function useStorageState<T>(
   key: string,
   options: StorageStateOptions<T>
-): SerializableGuard<
-  readonly [Serializable<T> | undefined, (value: SetStateAction<Serializable<T> | undefined>) => void, () => void]
->;
+): SerializableGuard<readonly [Serializable<T> | undefined, StorageStateActions<Serializable<T> | undefined>]>;
 export function useStorageState<T>(
   key: string,
   options: StorageStateOptionsWithSerializer<T>
-): SerializableGuard<
-  readonly [Serializable<T> | undefined, (value: SetStateAction<Serializable<T> | undefined>) => void, () => void]
->;
+): SerializableGuard<readonly [Serializable<T> | undefined, StorageStateActions<Serializable<T> | undefined>]>;
 export function useStorageState<T>(
   key: string,
   {
@@ -118,9 +117,7 @@ export function useStorageState<T>(
     defaultValue,
     ...options
   }: StorageStateOptions<T> | StorageStateOptionsWithSerializer<T> = {}
-): SerializableGuard<
-  readonly [Serializable<T> | undefined, (value: SetStateAction<Serializable<T> | undefined>) => void, () => void]
-> {
+): SerializableGuard<readonly [Serializable<T> | undefined, StorageStateActions<Serializable<T> | undefined>]> {
   // Without `'use no memo'`, React Compiler throws when `panicThreshold` is not `'none'`
   // because `cache.current` is read from `getSnapshot`, which `useSyncExternalStore` calls
   // during render. Belongs on this implementation signature — the overload declarations
@@ -193,9 +190,14 @@ export function useStorageState<T>(
     setStorageState(getSnapshot());
   }, [storage, getSnapshot, setStorageState]);
 
-  /* eslint-disable-next-line react-hooks/refs -- the two callbacks close over `cache` through
-     `getSnapshot`, so the rule treats handing them to any function as a possible ref read
+  const actions = useMemo<StorageStateActions<Serializable<T> | undefined>>(
+    () => ({ setValue: setStorageState, refresh: refreshStorageState }),
+    [setStorageState, refreshStorageState]
+  );
+
+  /* eslint-disable-next-line react-hooks/refs -- the two callbacks in `actions` close over `cache`
+     through `getSnapshot`, so the rule treats handing them to any function as a possible ref read
      during render. `ensureSerializable` only inspects element 0 — `storageState`, a plain
-     value — and never calls them; passing either callback alone reproduces the report. */
-  return ensureSerializable([storageState, setStorageState, refreshStorageState] as const);
+     value — and never calls them. */
+  return ensureSerializable([storageState, actions] as const);
 }
diff --git a/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
index 36ded34f..3f4a458d 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
@@ -10,8 +10,7 @@ function useStorageState<T>(
   options?: Object
 ): readonly [
   state: Serializable<T> | undefined,
-  setState: (value: SetStateAction<Serializable<T> | undefined>) => void,
-  refreshState: () => void,
+  actions: StorageStateActions<Serializable<T> | undefined>,
 ];
 ```
 
@@ -62,8 +61,8 @@ function useStorageState<T>(
 
 <Interface
   name=""
-  type="readonly [state: Serializable<T> | undefined, setState: (value: SetStateAction<Serializable<T> | undefined>) => void, refreshState: () => void]"
-  description="一个元组："
+  type="readonly [state: Serializable<T> | undefined, actions: StorageStateActions<Serializable<T> | undefined>]"
+  description="包含状态和状态修改操作的元组。"
   :nested="[
     {
       name: 'state',
@@ -72,13 +71,13 @@ function useStorageState<T>(
       description: '从存储中检索到的当前状态值。',
     },
     {
-      name: 'setState',
+      name: 'actions.setValue',
       type: '(value: SetStateAction<Serializable<T> | undefined>) => void',
       required: false,
       description: '更新并持久化状态的函数。',
     },
     {
-      name: 'refreshState',
+      name: 'actions.refresh',
       type: '() => void',
       required: false,
       description: '从存储中刷新状态的函数。',
@@ -93,12 +92,12 @@ function useStorageState<T>(
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {
-  const [count, setCount] = useStorageState<number>('counter', {
+  const [count, { setValue }] = useStorageState<number>('counter', {
     defaultValue: 0,
   });
 
   return (
-    <button onClick={() => setCount(prev => prev + 1)}>Count: {count}</button>
+    <button onClick={() => setValue(prev => prev + 1)}>Count: {count}</button>
   );
 }
 ```
diff --git a/packages/react-simplikit/src/hooks/useToggle/useToggle.ts b/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
index a83de479..0ed34902 100644
--- a/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
+++ b/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
@@ -1,4 +1,4 @@
-import { useReducer } from 'react';
+import { useBooleanState } from '../useBooleanState/index.ts';
 
 /**
  * @description
@@ -25,8 +25,8 @@ import { useReducer } from 'react';
  *   );
  * }
  */
-export function useToggle(initialValue: boolean = false) {
-  return useReducer(toggle, initialValue);
-}
+export function useToggle(initialValue: boolean = false): [boolean, () => void] {
+  const [state, { toggle }] = useBooleanState(initialValue);
 
-const toggle = (state: boolean) => !state;
+  return [state, toggle];
+}

From 4a8348f7dcc2e8423334b78a704dc8b9ca294fae Mon Sep 17 00:00:00 2001
From: mnxmnz <48766355+mnxmnz@users.noreply.github.com>
Date: Tue, 6 Oct 2026 23:43:58 +0900
Subject: [PATCH 2/3] docs(useCounter, useStorageState): clarify setCount,
 restore the missing "hook" and translate the zh-Hans example comment

---
 packages/plugin/skills/react-simplikit/SKILL.md                 | 2 +-
 packages/plugin/skills/react-simplikit/references/useCounter.md | 2 +-
 .../plugin/skills/react-simplikit/references/useStorageState.md | 2 +-
 packages/react-simplikit/src/hooks/useCounter/es/useCounter.md  | 2 +-
 packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md  | 2 +-
 packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md  | 2 +-
 packages/react-simplikit/src/hooks/useCounter/useCounter.md     | 2 +-
 packages/react-simplikit/src/hooks/useCounter/useCounter.ts     | 2 +-
 .../react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md  | 2 +-
 .../src/hooks/useStorageState/ko/useStorageState.md             | 2 +-
 .../src/hooks/useStorageState/useStorageState.md                | 2 +-
 .../src/hooks/useStorageState/useStorageState.ts                | 2 +-
 .../src/hooks/useStorageState/zh-Hans/useStorageState.md        | 2 +-
 13 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/packages/plugin/skills/react-simplikit/SKILL.md b/packages/plugin/skills/react-simplikit/SKILL.md
index 0004a1fd..ea4c0113 100644
--- a/packages/plugin/skills/react-simplikit/SKILL.md
+++ b/packages/plugin/skills/react-simplikit/SKILL.md
@@ -106,7 +106,7 @@ Backticks in this table mark catalog entries only.
 | [`useSafeAreaInset`](references/useSafeAreaInset.md) | `useSafeAreaInset` is a React hook that tracks safe area inset changes. |
 | [`useScrollDirection`](references/useScrollDirection.md) | `useScrollDirection` is a React hook that detects scroll direction. |
 | [`useSet`](references/useSet.md) | A React hook that manages a Set as state. |
-| [`useStorageState`](references/useStorageState.md) | `useStorageState` is a React that functions like `useState` but persists the state value in browser storage. |
+| [`useStorageState`](references/useStorageState.md) | `useStorageState` is a React hook that functions like `useState` but persists the state value in browser storage. |
 | [`useThrottle`](references/useThrottle.md) | `useThrottle` is a React hook that creates a throttled version of a callback function. |
 | [`useThrottledCallback`](references/useThrottledCallback.md) | `useThrottledCallback` is a React hook that returns a throttled version of the provided callback function. |
 | [`useThrottledValue`](references/useThrottledValue.md) | `useThrottledValue` is a React hook that returns a throttled copy of the given value. |
diff --git a/packages/plugin/skills/react-simplikit/references/useCounter.md b/packages/plugin/skills/react-simplikit/references/useCounter.md
index 54052aea..51f8edd9 100644
--- a/packages/plugin/skills/react-simplikit/references/useCounter.md
+++ b/packages/plugin/skills/react-simplikit/references/useCounter.md
@@ -86,7 +86,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        'A function to set the count to a specific value or a function that returns a new value.',
+        'A function to set the count, either to a value or with an updater function that receives the previous count and returns the next one.',
     },
   ]"
 />
diff --git a/packages/plugin/skills/react-simplikit/references/useStorageState.md b/packages/plugin/skills/react-simplikit/references/useStorageState.md
index f4efb065..851d5d84 100644
--- a/packages/plugin/skills/react-simplikit/references/useStorageState.md
+++ b/packages/plugin/skills/react-simplikit/references/useStorageState.md
@@ -1,6 +1,6 @@
 # useStorageState
 
-`useStorageState` is a React that functions like `useState` but persists the state value in browser storage.
+`useStorageState` is a React hook that functions like `useState` but persists the state value in browser storage.
 The value is retained across page reloads and can be shared between tabs when using `localStorage`.
 
 ## Interface
diff --git a/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
index 3c4286e7..58e727c5 100644
--- a/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/es/useCounter.md
@@ -86,7 +86,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        'Una función para actualizar el contador con un valor específico o con una función que devuelve un nuevo valor.',
+        'Una función para actualizar el contador con un valor específico o con una función que recibe el valor anterior y devuelve el siguiente.',
     },
   ]"
 />
diff --git a/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
index 6716f3b8..3ed3033e 100644
--- a/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/ja/useCounter.md
@@ -86,7 +86,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        '特定の値、または新しい値を返す関数を渡して、カウンターの値を設定する関数。',
+        '特定の値、または前のカウントを受け取って次の値を返す関数を渡して、カウンターの値を設定する関数。',
     },
   ]"
 />
diff --git a/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
index 63d4dfe8..f3883246 100644
--- a/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/ko/useCounter.md
@@ -85,7 +85,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        '카운트를 특정 값으로 설정하거나 새로운 값을 반환하는 함수예요.',
+        '카운트를 특정 값으로 설정하거나, 이전 카운트를 받아 다음 값을 반환하는 함수로 갱신하는 함수예요.',
     },
   ]"
 />
diff --git a/packages/react-simplikit/src/hooks/useCounter/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/useCounter.md
index 54052aea..51f8edd9 100644
--- a/packages/react-simplikit/src/hooks/useCounter/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/useCounter.md
@@ -86,7 +86,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        'A function to set the count to a specific value or a function that returns a new value.',
+        'A function to set the count, either to a value or with an updater function that receives the previous count and returns the next one.',
     },
   ]"
 />
diff --git a/packages/react-simplikit/src/hooks/useCounter/useCounter.ts b/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
index fd6d744b..0568ec1e 100644
--- a/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
+++ b/packages/react-simplikit/src/hooks/useCounter/useCounter.ts
@@ -43,7 +43,7 @@ const validateValue = (value: number, { min, max }: Omit<UseCounterOptions, 'ste
  * - actions.increment `() => void` - A function to increment the count;
  * - actions.decrement `() => void` - A function to decrement the count;
  * - actions.reset `() => void` - A function to reset the count to the initial value;
- * - actions.setCount `(value: number | ((prev: number) => number)) => void` - A function to set the count to a specific value or a function that returns a new value;
+ * - actions.setCount `(value: number | ((prev: number) => number)) => void` - A function to set the count, either to a value or with an updater function that receives the previous count and returns the next one;
  *
  * @example
  * import { useCounter } from 'react-simplikit';
diff --git a/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md b/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
index 4c717cb2..dda11d5c 100644
--- a/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
+++ b/packages/react-simplikit/src/hooks/useCounter/zh-Hans/useCounter.md
@@ -85,7 +85,7 @@ function useCounter(
       type: '(value: number | ((prev: number) => number)) => void',
       required: false,
       description:
-        '将计数设置为特定值，或设置为返回新值的函数的函数。',
+        '将计数设置为特定值，或通过接收上一个计数并返回下一个值的函数来更新计数。',
     },
   ]"
 />
diff --git a/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
index df82c1ee..7ebaa27d 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/ko/useStorageState.md
@@ -1,6 +1,6 @@
 # useStorageState
 
-리액트 훅으로, `useState`처럼 작동하지만 상태 값을 브라우저 저장소에 저장해요. 이 값은 페이지를 새로고침해도 유지되며, `localStorage`를 사용할 경우 탭 간에 공유될 수 있어요.
+`useStorageState`는 `useState`처럼 작동하지만 상태 값을 브라우저 저장소에 저장하는 리액트 훅이에요. 이 값은 페이지를 새로고침해도 유지되며, `localStorage`를 사용할 경우 탭 간에 공유될 수 있어요.
 
 ## 인터페이스
 
diff --git a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
index f4efb065..851d5d84 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.md
@@ -1,6 +1,6 @@
 # useStorageState
 
-`useStorageState` is a React that functions like `useState` but persists the state value in browser storage.
+`useStorageState` is a React hook that functions like `useState` but persists the state value in browser storage.
 The value is retained across page reloads and can be shared between tabs when using `localStorage`.
 
 ## Interface
diff --git a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
index 06578f11..267f7461 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
+++ b/packages/react-simplikit/src/hooks/useStorageState/useStorageState.ts
@@ -68,7 +68,7 @@ const ensureSerializable = <T extends readonly any[]>(value: T): SerializableGua
 
 /**
  * @description
- * `useStorageState` is a React that functions like `useState` but persists the state value in browser storage.
+ * `useStorageState` is a React hook that functions like `useState` but persists the state value in browser storage.
  * The value is retained across page reloads and can be shared between tabs when using `localStorage`.
  *
  * @template T - The type of the stored value.
diff --git a/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md b/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
index 3f4a458d..548705c0 100644
--- a/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
+++ b/packages/react-simplikit/src/hooks/useStorageState/zh-Hans/useStorageState.md
@@ -88,7 +88,7 @@ function useStorageState<T>(
 ## 示例
 
 ```tsx
-// Counter with persistent state
+// 具有持久化状态的计数器
 import { useStorageState } from 'react-simplikit';
 
 function Counter() {

From a403c7e065b9396d14e7d8d5418d666ffe3291a7 Mon Sep 17 00:00:00 2001
From: mnxmnz <48766355+mnxmnz@users.noreply.github.com>
Date: Tue, 6 Oct 2026 23:46:22 +0900
Subject: [PATCH 3/3] fix(useToggle): keep the useReducer implementation to
 stay within the tree-shaking size gate

---
 .changeset/state-hook-returns.md                          | 2 +-
 packages/react-simplikit/src/hooks/useToggle/useToggle.ts | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.changeset/state-hook-returns.md b/.changeset/state-hook-returns.md
index c53cee1f..3062b7c2 100644
--- a/.changeset/state-hook-returns.md
+++ b/.changeset/state-hook-returns.md
@@ -16,4 +16,4 @@ const [token, { setValue, refresh }] = useStorageState<string>('token');
 const [count, { increment, decrement, reset, setCount }] = useCounter(0);
 ```
 
-`useToggle` keeps its `[value, toggle]` signature, is now built on `useBooleanState`, and declares its return type so that React 18 consumers no longer see the React 19 `ActionDispatch` type.
+`useToggle` keeps its `[value, toggle]` signature and now declares its return type, so React 18 consumers no longer see the React 19 `ActionDispatch` type.
diff --git a/packages/react-simplikit/src/hooks/useToggle/useToggle.ts b/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
index 0ed34902..b117c87a 100644
--- a/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
+++ b/packages/react-simplikit/src/hooks/useToggle/useToggle.ts
@@ -1,4 +1,4 @@
-import { useBooleanState } from '../useBooleanState/index.ts';
+import { useReducer } from 'react';
 
 /**
  * @description
@@ -26,7 +26,7 @@ import { useBooleanState } from '../useBooleanState/index.ts';
  * }
  */
 export function useToggle(initialValue: boolean = false): [boolean, () => void] {
-  const [state, { toggle }] = useBooleanState(initialValue);
-
-  return [state, toggle];
+  return useReducer(toggle, initialValue);
 }
+
+const toggle = (state: boolean) => !state;