reactjs/react-codemod
React Codemod
This project is a suite of abstract syntax tree transformation tools designed to automate the migration of source code to newer versions of React. It provides a set of scripts that programmatically modify code structures to replace deprecated APIs and component patterns with modern equivalents.
The toolkit specializes in converting class components into functional components using arrow functions and prop destructuring. It also includes utilities for modernizing JSX syntax, updating deprecated lifecycle methods to stable versions, and migrating legacy string-based references to callback refs.
Additional capabilities cover the optimization of import patterns, the removal of redundant imports, and the updating of package references and module paths. The project uses rule-driven source migration and pattern-matching syntax analysis to ensure transformations are applied consistently across large codebases.
Features
- API Version Migration Scripts - Provides specialized scripts for automating the transition between different API versions of a framework.
- AST Transformation Tools - Provides a suite of utilities for parsing, manipulating, and transforming source code via Abstract Syntax Trees to automate framework migrations.
- AST-Based Source Transformations - Provides programmatic modification of source code by replacing matched abstract syntax tree nodes while preserving original formatting.
- Automated Large-Scale Refactoring - Executes synchronized structural changes across entire codebases to align with new import patterns and module structures.
- Framework Version Migrators - Automates the update of source code to newer React versions by replacing deprecated APIs and patterns.
- Automated Migration Codemods - Ships automated migration codemods to transform deprecated function calls and component patterns into modern equivalents.
- Source Code Transformation Engines - Implements a transformation engine that replaces or removes specific code segments to resolve compatibility issues.
- JavaScript Source Transformers - Provides tools for programmatically transforming JavaScript source code through AST manipulation pipelines.
- AST-Based Refactorers - Implements automated refactoring by modifying internal syntax trees and rendering them back to source code.
- Declarative Pattern Matching - Uses declarative pattern matching to identify deprecated API calls and component patterns within the abstract syntax tree.
- Class to Functional Component Converters - Transforms ES6 class components into functional components using arrow functions and prop destructuring.
- Class to Functional Component Converters - Transforms legacy React class components into modern functional components using hooks and arrow functions.
- Functional Component Converters - Transforms ES6 class components into functional components with arrow functions and prop destructuring.
- Modernizers - Converts legacy element creation calls and deprecated provider syntax into standard JSX elements.
- Import Optimizations - Removes redundant imports and converts namespace imports to named imports to optimize module structures.
- Deprecated Method Renaming - Automatically updates deprecated or experimental lifecycle method names to their stable or unsafe versions.
- Transformation Idempotency - Ensures that running migration scripts multiple times does not corrupt the source code.
- Package Import Mappers - Swaps outdated module references and import paths between split packages or externalized dependencies.
- AST Traversal Utilities - Walks through the program structure to find and update specific naming conventions and import declarations.
- Ref Migration Tools - Replaces deprecated string-based references with callback refs to ensure stable element referencing.
- Refactoring Utilities - Provides utilities to convert legacy element creation and outdated provider syntax into standard JSX elements.
- Lifecycle Method Modernizers - Updates deprecated or experimental lifecycle methods to their stable equivalents to ensure framework compatibility.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
