refactor repo

Author: mohab-sameh

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  docs-and-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.14.2
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run lint
+
+  active:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.14.2
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run test:active
+      - run: pnpm run check-types:active
+
+  legacy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.14.2
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm run test:legacy

LEGACY.md

@@ -0,0 +1,40 @@
+# Legacy Codemods
+
+This branch keeps the non-high-priority `react-codemod` transforms as a legacy jscodeshift snapshot under [`codemods/legacy/transforms/`](./codemods/legacy/transforms/).
+
+The legacy snapshot is preserved for source reference, upstream-style tests, and branch preview parity with the structure of `reactjs/react-codemod`.
+
+## Legacy Catalog
+
+- [`create-element-to-jsx`](./codemods/legacy/transforms/create-element-to-jsx.js)
+- [`error-boundaries`](./codemods/legacy/transforms/error-boundaries.js)
+- [`findDOMNode`](./codemods/legacy/transforms/findDOMNode.js)
+- [`manual-bind-to-arrow`](./codemods/legacy/transforms/manual-bind-to-arrow.js)
+- [`pure-component`](./codemods/legacy/transforms/pure-component.js)
+- [`pure-render-mixin`](./codemods/legacy/transforms/pure-render-mixin.js)
+- [`React-DOM-to-react-dom-factories`](./codemods/legacy/transforms/React-DOM-to-react-dom-factories.js)
+- [`ReactNative-View-propTypes`](./codemods/legacy/transforms/ReactNative-View-propTypes.js)
+- [`react-to-react-dom`](./codemods/legacy/transforms/react-to-react-dom.js)
+- [`remove-context-provider`](./codemods/legacy/transforms/remove-context-provider.ts)
+- [`remove-forward-ref`](./codemods/legacy/transforms/remove-forward-ref.ts)
+- [`rename-unsafe-lifecycles`](./codemods/legacy/transforms/rename-unsafe-lifecycles.js)
+- [`sort-comp`](./codemods/legacy/transforms/sort-comp.js)
+- [`update-react-imports`](./codemods/legacy/transforms/update-react-imports.js)
+- [`class`](./codemods/legacy/transforms/class.js)
+
+## Notes
+
+- The 6 promoted JSSG transforms are not duplicated in `codemods/legacy/`.
+- This preview branch does not claim that legacy transforms can be run through Codemod Registry.
+- The legacy snapshot keeps the full upstream-style test corpus in `codemods/legacy/transforms/__tests__`.
+- The preview branch CI runs the compatible legacy subset under the current preview runtime:
+
+```bash
+pnpm run test:legacy
+```
+
+- To run the full legacy snapshot test corpus manually from `codemods/legacy/`:
+
+```bash
+pnpm test
+```

PARITY_STATUS.md

@@ -0,0 +1,41 @@
+# Legacy Parity Status
+
+Last updated: 2026-04-15
+
+Status meanings:
+
+- `Certified`: replacement-grade rollout confidence. Strict/default package tests are green, public test posture is portable, and there are no known rollout-blocking logic gaps versus the legacy jscodeshift codemod. `Certified` may include intentional safe extensions on legacy-unsupported edge cases, as long as intentional legacy behavior remains unbroken.
+- `Legacy Snapshot`: preserved as upstream jscodeshift source and tests on this branch, but not promoted as part of the active JSSG replacement surface.
+
+## Active JSSG Surface
+
+These are the only codemods promoted as active replacements on this branch.
+
+| Codemod | Legacy Source | Status | Notes |
+| --- | --- | --- | --- |
+| `replace-use-form-state` | `replace-use-form-state.ts` | `Certified` | Legacy fixture surface plus added multi-import regression coverage are green. Collection-wide replacement on matching `react-dom` imports fixes a real parity gap, and the broader multi-import handling is treated as an acceptable safe extension where legacy only partially migrated files. |
+| `replace-act-import` | `replace-act-import.ts` | `Certified` | Legacy fixture surface plus added multi-import regression coverage. This closes a real parity gap, and the mixed test-utils partial-removal path is an acceptable safe extension that does not break intentional legacy behavior. |
+| `replace-string-ref` | `replace-string-ref.ts` | `Certified` | Legacy fixture surface plus added namespace/default-export/multi-ref coverage are green, and the direct-superclass guard restores the intended direct-superclass behavior by avoiding the prior mixin false positive. |
+| `replace-reactdom-render` | `replace-reactdom-render.ts` | `Certified` | Legacy fixtures plus added multi-alias regression coverage are green. The extra multi-alias handling is an acceptable safe extension over legacy implementation limits; it preserves intentional legacy behavior while covering additional valid cases. |
+| `react-proptypes-to-prop-types` | `React-PropTypes-to-prop-types.js` | `Certified` | Full legacy fixture surface is green, targeted mixed-import validation is aligned, and no JSSG-specific rollout blocker was found in the audit. No additional extension beyond the legacy behavior is currently relied on for certification. |
+| `use-context-hook` | `use-context-hook.ts` | `Certified` | Legacy fixture surface plus added multi-import regression coverage are green. The multi-import handling goes beyond the legacy implementation, but it is treated as an acceptable safe extension because it preserves intentional legacy behavior while covering additional valid cases. |
+
+## Legacy Snapshot Surface
+
+These codemods remain available only as an upstream jscodeshift snapshot under [`codemods/legacy/transforms/`](./codemods/legacy/transforms/):
+
+- `class`
+- `create-element-to-jsx`
+- `error-boundaries`
+- `findDOMNode`
+- `manual-bind-to-arrow`
+- `pure-component`
+- `pure-render-mixin`
+- `React-DOM-to-react-dom-factories`
+- `ReactNative-View-propTypes`
+- `react-to-react-dom`
+- `remove-context-provider`
+- `remove-forward-ref`
+- `rename-unsafe-lifecycles`
+- `sort-comp`
+- `update-react-imports`

README.md

@@ -1,32 +1,42 @@
-# jssg-react-codemods
-
-React codemods built with JSSG and JavaScript ast-grep.
-
-## Packages
-
-- `@react/error-boundaries`
-- `@react/find-dom-node`
-- `@react/manual-bind-to-arrow`
-- `@react/pure-render-mixin`
-- `@react/react-proptypes-to-prop-types`
-- `@react/rename-unsafe-lifecycles`
-- `@react/replace-act-import`
-- `@react/replace-reactdom-render`
-- `@react/replace-string-ref`
-- `@react/replace-use-form-state`
-- `@react/sort-comp`
-- `@react/update-react-imports`
-- `@react/use-context-hook`
+# React Codemods Preview
+
+This branch is a React-facing preview of how this repo should look as a replacement-style home for `react-codemod`.
+
+It promotes 6 audited JSSG codemods as the active surface and preserves the remaining upstream jscodeshift codemods as a legacy snapshot.
+
+## Active JSSG Transforms
+
+These transforms are the active replacement surface on this branch. They are source-first JSSG codemods and are not described here as Codemod Registry entries unless they are actually published.
+
+- [`use-context-hook`](./codemods/jssg/use-context-hook/) — replace `useContext` usage with `use`
+- [`replace-act-import`](./codemods/jssg/replace-act-import/) — move `act` from `react-dom/test-utils` to `react`
+- [`replace-string-ref`](./codemods/jssg/replace-string-ref/) — replace deprecated string refs with callback refs
+- [`replace-use-form-state`](./codemods/jssg/replace-use-form-state/) — rename `useFormState` to `useActionState`
+- [`replace-reactdom-render`](./codemods/jssg/replace-reactdom-render/) — replace `ReactDOM.render` with `createRoot(...).render(...)`
+- [`react-proptypes-to-prop-types`](./codemods/jssg/react-proptypes-to-prop-types/) — replace `React.PropTypes` with `prop-types`
+
+## Legacy Codemods
+
+All non-priority transforms are preserved as an upstream-style legacy jscodeshift snapshot under [`codemods/legacy/`](./codemods/legacy/).
+
+See [LEGACY.md](./LEGACY.md) for the legacy catalog and testing notes.
 
 ## Development
 
 ```bash
-pnpm test
-pnpm -r check-types
+pnpm install
+pnpm run ci
+```
+
+Run active JSSG checks only:
+
+```bash
+pnpm run test:active
+pnpm run check-types:active
 ```
 
-Run a single package:
+Run the legacy snapshot test harness:
 
 ```bash
-pnpm --filter @react-codemods/replace-reactdom-render test
+pnpm run test:legacy
 ```