useSetState
Object state with shallow merge, class-component style.
Import
TypeScript
import { useSetState } from '@/hooks';API
Signature
useSetState<T>(initial) → [state, setMerge]
When to use
Use useSetState instead of re-implementing the same pattern in multiple components.
SSR / Next.js
Fully SSR-safe. Pure React state.
Live playground
Edit the example and see it run against the real @/hooks package in this app.
Live playgroundEdit · run with real
@/hooks · useSetStateEditor
function ProfileForm() { const [state, setState] = useSetState({ name: '', age: 0 }); return ( <> <input value={state.name} onChange={(e) => setState({ name: e.target.value })} /> <button onClick={() => setState((s) => ({ age: s.age + 1 }))}> Age {state.age} </button> </> ); }
Preview
Implementation source
Full library source for useSetState — copy into your project when you are not installing a package yet.
hooks/state/useSetState.ts
import { useCallback, useState } from 'react';
export type SetStateActionPartial<T extends object> =
| Partial<T>
| ((prev: T) => Partial<T>);
/**
* Object state with shallow merge (class component setState style).
*/
export function useSetState<T extends object>(
initialState: T | (() => T),
): [T, (patch: SetStateActionPartial<T>) => void] {
const [state, setState] = useState(initialState);
const setMerge = useCallback((patch: SetStateActionPartial<T>) => {
setState((prev) => {
const next = typeof patch === 'function' ? patch(prev) : patch;
return { ...prev, ...next };
});
}, []);
return [state, setMerge];
}
Copy-paste example
useSetState.example.tsx
'use client';
import { useSetState } from '@/hooks';
export function ProfileForm() {
const [state, setState] = useSetState({ name: '', age: 0 });
return (
<>
<input
value={state.name}
onChange={(e) => setState({ name: e.target.value })}
/>
<button onClick={() => setState((s) => ({ age: s.age + 1 }))}>
Age {state.age}
</button>
</>
);
}Production checklist
- Called only from Client Components or other custom hooks
- Type parameters filled in (e.g.
useFetch<User[]>) - Tip: Keep state setters stable; prefer action helpers over manual setState spreads.
- Source of truth: open
hooks/state/useSetState.tsfor implementation details