fec-refactoring-api git:20260901.387d97aA

Immutable. This exact content never changes and is served at /api/v1/blob/b847e74a81bd8f95.

---
name: fec-refactoring-api
description: Use when behavior-preserving frontend refactoring focuses on function API shape, flags, dependencies, mutability, construction, or command/function trade-offs, and the selected technique needs family-specific mechanics, risks, and JavaScript/TypeScript/React/Vue adaptation.
---

# API Refactorings

## Overview
Use this family after evidence identifies a fitting structural transformation. Apply one primary technique at a time and verify immediately.

## Procedure
1. Confirm the selected technique and its preconditions in [API Refactorings](references/api-refactorings.md).
2. Record affected behavior and a diff budget.
3. Apply only the selected technique's smallest viable step.
4. Verify the step before composing another transformation.
5. Stop and reassess when public contracts, lifecycle, state identity, or actual scope exceed expectations.

## Quick Reference
The family reference contains 10 canonical techniques with intent, signals, avoid conditions, mechanics, preservation checkpoints, smell links, composition hints, JavaScript/TypeScript notes, React/Vue notes, adaptation guidance, and original frontend examples.

## Common Mistakes
- Choosing a technique by name without checking its preconditions.
- Combining several structural intentions in one diff.
- Assuming a classical class-based form is mandatory in modern frontend code.
- Treating passing tests as proof when the relevant behavior is not covered.