React Class To Functional
Developmentreact-class-to-functionalReact Class To Functional is an Agent Skill for development published in the cockroachdb/cockroach repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Convert React class components to functional components with hooks
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/cockroachdb/cockroach/blob/HEAD/pkg/ui/.claude/skills/react-class-to-functional/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/react-class-to-functional, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
React Class to Functional Component Converter
Convert the React class component at $ARGUMENTS to a functional component using React hooks.
Conversion Rules
State
this.state = { ... }→ individualuseStatehooksthis.setState({ key: value })→ setter functionthis.setState(prev => ...)→ functional update form- Mutable objects (Set/Map) must be cloned on update:
setExpandedRows(prev => { const next = new Set(prev); next.add(key); return next; });
Lifecycle → useEffect
| Class | Functional |
|---|---|
componentDidMount | useEffect(fn, []) |
componentDidUpdate | useEffect(fn) or useEffect(fn, [deps]) |
componentWillUnmount | useEffect(() => cleanup, []) |
| mount + unmount | single useEffect with cleanup return |
Other Mappings
React.createRef()→useRef(null)static contextType→useContext(MyContext)- Bound methods / arrow class methods → local function inside functional component
- Non-reactive instance variables (
this.timer) →useRef createSelector(reselect) →useMemowith explicit dependency array
Props and Defaults
this.props.x→ destructured propsstatic defaultProps→ default parameter values- Critical: mark defaultProps as optional (
?) in the interface:interface Props { sortSetting?: SortSetting; } function Component({ sortSetting = defaultValue }: Props) { ... }
setState with Callback
this.setState(update, callback) has no direct hook equivalent. Use ref + useEffect:
const pendingRef = useRef(false);
const prevRef = useRef(value);
const onUpdate = useCallback(() => {
pendingRef.current = true;
setValue(newValue);
}, []);
useEffect(() => {
if (pendingRef.current && prevRef.current !== value) {
pendingRef.current = false;
doCallback();
}
prevRef.current = value;
}, [value, doCallback]);
Generic Components
class MyTable extends SortedTable<Row> {}→const MyTable = SortedTable<Row>;- Exported type aliases require the props interface to also be exported (else "cannot be named" build errors)
- TypeScript may fail to infer generics with spread props — add explicit type params:
<SortedTable<Row> {...props} />
Workflow
- Read the file and summarize: state vars, lifecycle methods, refs, methods, generics, files extending this class
- Before converting each method, verify it's actually called — delete dead code, don't convert it
- Write the converted component, preserving imports/comments/exports and adding hook imports
- Search for and update dependent files that extend the class
Verification Checklist
- All
this.references removed - Hooks follow Rules of Hooks (top level, consistent order)
- TypeScript types preserved; exports unchanged
- defaultProps marked optional in interface
- Exported type aliases have their props interfaces exported
- Files extending the class updated to type alias pattern
- No dead code converted (every
useCallbackis actually called) - No orphaned helpers (if logic was inlined, delete the original)
- No unused destructured props
- No failed intermediate attempts left behind
- Within the appropriate directory with
package.json, run ESLint (fix) and Tests