context-forge
Version:
AI orchestration platform with autonomous teams, enhancement planning, migration tools, 25+ slash commands, checkpoints & hooks. Multi-IDE: Claude, Cursor, Windsurf, Cline, Copilot
239 lines (197 loc) • 7.31 kB
Markdown
Dependency Mapping Database
# Overview
This document contains the comprehensive mapping of package dependencies for framework migrations.
# React Ecosystem
## Core Libraries
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| react-scripts | @vitejs/plugin-react + vite | CRA → Vite migration | No |
| enzyme | @testing-library/react | Different testing approach | No |
| react-router v5 | react-router-dom v6 | Major API changes | No |
| react-redux | @reduxjs/toolkit | Modern Redux approach | Yes |
## Testing
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| enzyme | @testing-library/react | No shallow rendering | No |
| react-test-renderer | @testing-library/react | Better testing practices | Yes |
| jest-enzyme | @testing-library/jest-dom | Different matchers | No |
## State Management
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| redux | @reduxjs/toolkit | Official Redux approach | Yes |
| redux | zustand | Simpler alternative | Yes |
| redux | jotai | Atomic state management | Yes |
| mobx | valtio | Proxy-based state | Yes |
## Styling
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| styled-components v4 | styled-components v5 | Performance improvements | No |
| styled-components | @emotion/styled | Similar API | Yes |
| css-modules | vanilla-extract | Type-safe CSS | Yes |
# Vue Ecosystem
## Core Libraries
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| vue 2 | vue 3 | Major breaking changes | No |
| vue-cli-service | @vitejs/plugin-vue + vite | Vue CLI → Vite | No |
| vuex 3 | vuex 4 | Vue 3 compatibility | No |
| vuex | pinia | Recommended for Vue 3 | No |
| vue-router 3 | vue-router 4 | Vue 3 compatibility | No |
## Component Libraries
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| element-ui | element-plus | Vue 3 version | No |
| vuetify 2 | vuetify 3 | Vue 3 version | No |
| ant-design-vue 1 | ant-design-vue 3 | Vue 3 version | No |
# Angular → React Migration
## Core Framework
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| @angular/core | react + react-dom | Framework change | No |
| @angular/router | react-router-dom | Different routing | No |
| @angular/forms | react-hook-form | Form handling | No |
| @angular/forms | formik | Alternative forms | No |
| @angular/http | axios | HTTP client | No |
| @angular/http | @tanstack/react-query | Data fetching | No |
## Services → Hooks
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| @angular/common/http | swr | Data fetching hook | No |
| Angular Services | Custom React Hooks | Pattern change | No |
| RxJS (Angular) | React hooks | Different paradigm | Yes* |
# Express → Modern Frameworks
## Core Migration
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| express | fastify | Better performance | Yes |
| express | @nestjs/core | Enterprise features | No |
| express | koa | Modern middleware | Yes |
| express | hono | Edge-first | Yes |
## Middleware
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| body-parser | Built-in | Express 4.16+ | Yes |
| multer | @fastify/multipart | Fastify equivalent | No |
| helmet | @fastify/helmet | Security headers | No |
| cors | @fastify/cors | CORS handling | No |
# Build Tools
## Bundlers
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| webpack 4 | webpack 5 | Major upgrade | No |
| webpack | vite | Faster dev | No |
| webpack | esbuild | Faster builds | No |
| parcel 1 | parcel 2 | Major upgrade | No |
| rollup | vite | Better DX | Yes |
## Task Runners
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| gulp | npm scripts | Simpler | Yes |
| gulp | webpack | Modern bundling | Yes |
| grunt | vite | Modern tooling | No |
# Testing Frameworks
## Test Runners
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| mocha | vitest | Vite-native | Yes |
| mocha | jest | More features | Yes |
| karma | vitest | Modern runner | No |
| jasmine | jest | Better DX | Yes |
## E2E Testing
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| protractor | playwright | Modern E2E | No |
| protractor | cypress | Popular E2E | No |
| selenium | playwright | Better API | Yes |
| puppeteer | playwright | More features | Yes |
# Utility Libraries
## Date/Time
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| moment | date-fns | Modular | Yes |
| moment | dayjs | Smaller size | Yes |
| moment | luxon | Immutable | Yes |
| moment-timezone | date-fns-tz | Timezone support | Yes |
## Utilities
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| lodash | lodash-es | ES modules | Yes |
| lodash | ramda | Functional | Yes |
| underscore | lodash | More features | Yes |
| jquery | Native JS | Modern APIs | No |
## HTTP Clients
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| request | axios | Deprecated | Yes |
| request | node-fetch | Promise-based | Yes |
| request | got | Modern | Yes |
| superagent | axios | Popular | Yes |
# CSS Preprocessors
## Sass
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| node-sass | sass | Dart Sass | No |
| node-sass | postcss | Different approach | Yes |
| less | sass | Similar features | Yes |
| stylus | sass | Similar features | Yes |
# Database/ORM
## SQL
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| sequelize 5 | sequelize 6 | Major upgrade | No |
| sequelize | prisma | Type-safe | Yes |
| typeorm | prisma | Modern ORM | Yes |
| knex | prisma | Higher level | Yes |
## MongoDB
| From | To | Notes | Compatible |
|------|-----|-------|------------|
| mongoose 5 | mongoose 7 | Major upgrades | No |
| mongodb 3 | mongodb 5 | Driver updates | No |
# Framework-Specific Patterns
## React Patterns
- HOCs → Hooks
- Class Components → Functional Components
- Redux Connect → useSelector/useDispatch
- Context API → Zustand/Jotai
## Vue Patterns
- Options API → Composition API
- Mixins → Composables
- Filters → Methods/Computed
- Event Bus → Provide/Inject
## Angular → React Patterns
- Services → Custom Hooks
- Dependency Injection → Context/Props
- Decorators → HOCs/Hooks
- RxJS → useEffect/useState
# Version Compatibility Matrix
## React Versions
| Library | React 16 | React 17 | React 18 |
|---------|----------|----------|----------|
| react-router-dom | v5 | v5 | v6 |
| redux | v4 | v4 | v4 |
| styled-components | v4-5 | v5 | v5 |
| material-ui | v4 | v4-5 | v5 |
## Vue Versions
| Library | Vue 2 | Vue 3 |
|---------|-------|-------|
| vuex | v3 | v4 |
| vue-router | v3 | v4 |
| vuetify | v2 | v3 |
| element | element-ui | element-plus |
# Migration Complexity Ratings
## Trivial (< 1 hour)
- Version upgrades within same major
- Drop-in replacements
- Config-only changes
## Small (1-4 hours)
- API method changes
- Import path updates
- Simple refactoring
## Medium (1-3 days)
- Architectural changes
- Testing framework migrations
- Build tool changes
## Large (1+ week)
- Framework migrations
- Complete rewrites
- Paradigm shifts