@omnimod/plugin-redux-to-toolkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 salnika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @omnimod/plugin-redux-to-toolkit
+
+[![npm](https://img.shields.io/npm/v/%40omnimod%2Fplugin-redux-to-toolkit?label=npm)](https://www.npmjs.com/package/@omnimod/plugin-redux-to-toolkit)
+[![CI](https://img.shields.io/github/actions/workflow/status/Salnika/omnimod/ci.yml?branch=master&label=ci)](https://github.com/Salnika/omnimod/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/Salnika/omnimod)](../../LICENSE)
+
+omnimod plugin that migrates legacy Redux store setup to Redux Toolkit.
+
+## Use With The CLI
+
+```bash
+omnimod run redux-to-toolkit "src/**/*.{ts,tsx,js,jsx}"
+omnimod run redux-to-toolkit "src/**/*.{ts,tsx,js,jsx}" --write
+```
+
+## Use As A Library
+
+```ts
+import { reduxToToolkit } from "@omnimod/plugin-redux-to-toolkit";
+```
+
+## Notes
+
+The plugin rewrites supported `createStore` usage to `configureStore` and updates
+imports. Reducer rewrites, middleware-specific behavior, and connected component
+patterns may need manual follow-up.

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+//#region src/plugin.d.ts
+type ReduxToToolkitOptions = Record<string, unknown>;
+/**
+ * Migrate legacy Redux to Redux Toolkit. Rewrites `redux` imports to
+ * `@reduxjs/toolkit` (re-exported helpers) and `createStore`/`legacy_createStore`
+ * to `configureStore`, rewriting `createStore(rootReducer[, preloadedState])`
+ * call sites into `configureStore({ reducer, preloadedState })`. Semantic
+ * migrations (switch reducers, `connect`, action creators, saga/thunk) are left
+ * untouched with a `warn` diagnostic and a `// TODO(omnimod)` breadcrumb.
+ */
+declare const reduxToToolkit: import("@omnimod/core").Plugin<ReduxToToolkitOptions, unknown>;
+//#endregion
+export { type ReduxToToolkitOptions, reduxToToolkit as default, reduxToToolkit };

package/dist/index.mjs

@@ -0,0 +1,246 @@
+import { definePlugin, walk } from "@omnimod/core";
+import { cast } from "@omnimod/plugin-utils";
+//#region src/plugin.ts
+const RTK_MODULE = "@reduxjs/toolkit";
+const REDUX_MODULE = "redux";
+const RTK_REEXPORTED = /* @__PURE__ */ new Set([
+	"combineReducers",
+	"compose",
+	"bindActionCreators",
+	"applyMiddleware"
+]);
+const STORE_CREATORS = /* @__PURE__ */ new Set(["createStore", "legacy_createStore"]);
+/**
+* Migrate legacy Redux to Redux Toolkit. Rewrites `redux` imports to
+* `@reduxjs/toolkit` (re-exported helpers) and `createStore`/`legacy_createStore`
+* to `configureStore`, rewriting `createStore(rootReducer[, preloadedState])`
+* call sites into `configureStore({ reducer, preloadedState })`. Semantic
+* migrations (switch reducers, `connect`, action creators, saga/thunk) are left
+* untouched with a `warn` diagnostic and a `// TODO(omnimod)` breadcrumb.
+*/
+const reduxToToolkit = definePlugin({
+	name: "redux-to-toolkit",
+	description: "Migrate legacy Redux to Redux Toolkit.",
+	include: ["**/*.{ts,tsx,js,jsx,mts,cts}"],
+	transform(file) {
+		const reduxImport = findReduxImport(file);
+		const storeCreatorLocals = /* @__PURE__ */ new Set();
+		if (reduxImport) {
+			for (const [imported, local] of reduxImport.named) if (STORE_CREATORS.has(imported)) storeCreatorLocals.add(local);
+			rewriteReduxImport(file, reduxImport);
+		}
+		if (storeCreatorLocals.size > 0) rewriteStoreCalls(file, storeCreatorLocals);
+		reportSemanticFollowups(file);
+	}
+});
+/** Find the first `import ... from "redux"` declaration in the file. */
+function findReduxImport(file) {
+	for (const stmt of file.program.body) {
+		if (stmt.type !== "ImportDeclaration") continue;
+		const imp = cast(stmt);
+		if (imp.source.value !== REDUX_MODULE) continue;
+		const named = /* @__PURE__ */ new Map();
+		let hasNonNamed = false;
+		for (const spec of imp.specifiers) if (spec.type === "ImportSpecifier") {
+			const s = cast(spec);
+			const imported = s.imported.type === "Identifier" ? cast(s.imported).name : null;
+			if (imported === null) {
+				hasNonNamed = true;
+				continue;
+			}
+			named.set(imported, s.local.name);
+		} else hasNonNamed = true;
+		return {
+			node: imp,
+			named,
+			hasNonNamed
+		};
+	}
+	return null;
+}
+/**
+* Rewrite the `redux` import to `@reduxjs/toolkit`. Every named specifier we care
+* about (re-exported helpers + store creators) is available from RTK, so in the
+* common all-named case we just retarget the source and swap store-creator names.
+* If any specifier is unknown (some other redux export) or the declaration has a
+* default/namespace binding, we split: known names move to a new RTK import and
+* the original `redux` import keeps the rest.
+*/
+function rewriteReduxImport(file, reduxImport) {
+	const { node, named, hasNonNamed } = reduxImport;
+	const knownNames = [];
+	const unknownNames = [];
+	for (const imported of named.keys()) if (RTK_REEXPORTED.has(imported) || STORE_CREATORS.has(imported)) knownNames.push(imported);
+	else unknownNames.push(imported);
+	if (knownNames.length === 0) return;
+	if (!hasNonNamed && unknownNames.length === 0) {
+		for (const spec of node.specifiers) {
+			if (spec.type !== "ImportSpecifier") continue;
+			const s = cast(spec);
+			if (s.imported.type !== "Identifier") continue;
+			const importedName = cast(s.imported).name;
+			if (STORE_CREATORS.has(importedName)) file.magic.update(s.start, s.end, "configureStore");
+		}
+		file.magic.update(node.source.start, node.source.end, JSON.stringify(RTK_MODULE));
+		return;
+	}
+	const rtkSpecifiers = [];
+	for (const imported of knownNames) {
+		if (STORE_CREATORS.has(imported)) {
+			rtkSpecifiers.push("configureStore");
+			continue;
+		}
+		const local = named.get(imported) ?? imported;
+		rtkSpecifiers.push(local === imported ? imported : `${imported} as ${local}`);
+	}
+	const rtkImport = `import { ${[...new Set(rtkSpecifiers)].join(", ")} } from ${JSON.stringify(RTK_MODULE)};`;
+	removeKnownSpecifiers(file, node, knownNames);
+	file.magic.prependLeft(node.start, `${rtkImport}\n`);
+}
+/**
+* Remove the given imported names from an import declaration's specifier list,
+* adjusting the surrounding commas so the remaining specifiers stay well-formed.
+*/
+function removeKnownSpecifiers(file, node, removeImported) {
+	const toRemove = new Set(removeImported);
+	const specs = node.specifiers;
+	for (let i = 0; i < specs.length; i++) {
+		const spec = specs[i];
+		if (!spec || spec.type !== "ImportSpecifier") continue;
+		const s = cast(spec);
+		if (s.imported.type !== "Identifier") continue;
+		if (!toRemove.has(cast(s.imported).name)) continue;
+		const prev = specs[i - 1];
+		const next = specs[i + 1];
+		if (next) file.magic.remove(spec.start, next.start);
+		else if (prev) file.magic.remove(prev.end, spec.end);
+		else file.magic.remove(spec.start, spec.end);
+	}
+}
+/** Rewrite `createStore(reducer[, preloadedState][, enhancer])` call sites. */
+function rewriteStoreCalls(file, storeCreatorLocals) {
+	walk(file.program, (node) => {
+		if (node.type !== "CallExpression") return;
+		const call = cast(node);
+		if (call.callee.type !== "Identifier") return;
+		if (!storeCreatorLocals.has(cast(call.callee).name)) return;
+		const args = call.arguments;
+		const reducerArg = args[0];
+		if (!reducerArg) {
+			file.report({
+				message: "`createStore()` called without a reducer; convert to `configureStore({ reducer })` manually.",
+				severity: "warn"
+			});
+			return;
+		}
+		const reducerText = file.source.slice(reducerArg.start, reducerArg.end);
+		const secondArg = args[1];
+		const thirdArg = args[2];
+		const configParts = [`reducer: ${reducerText}`];
+		let enhancerText = null;
+		for (const extra of [secondArg, thirdArg]) {
+			if (!extra) continue;
+			if (isEnhancerLike(extra, file)) enhancerText = file.source.slice(extra.start, extra.end);
+			else {
+				const preloadedText = file.source.slice(extra.start, extra.end);
+				configParts.push(`preloadedState: ${preloadedText}`);
+			}
+		}
+		const objectLiteral = `configureStore({ ${configParts.join(", ")} })`;
+		file.magic.update(call.start, call.end, objectLiteral);
+		if (enhancerText !== null) {
+			file.report({
+				message: "Middleware/enhancers passed to `createStore` must be moved to `configureStore`'s `middleware`/`enhancers` option. Left the original as a TODO.",
+				severity: "warn"
+			});
+			file.magic.appendLeft(call.end, ` /* TODO(omnimod): move to configureStore middleware/enhancers: ${enhancerText} */`);
+		}
+	});
+}
+/** Heuristic: is this argument an enhancer (applyMiddleware/compose call) vs preloadedState? */
+function isEnhancerLike(arg, file) {
+	if (arg.type !== "CallExpression") return false;
+	const calleeName = calleeRootName(cast(arg).callee);
+	if (calleeName === "applyMiddleware" || calleeName === "compose") return true;
+	const text = file.source.slice(arg.start, arg.end);
+	return /applyMiddleware|compose|enhancer|middleware/i.test(text);
+}
+/** Root identifier name of a (possibly member/call) callee, else null. */
+function calleeRootName(node) {
+	if (node.type === "Identifier") return cast(node).name;
+	if (node.type === "MemberExpression") return calleeRootName(cast(node).object);
+	if (node.type === "CallExpression") return calleeRootName(cast(node).callee);
+	return null;
+}
+/**
+* Report (but never rewrite) the semantic migrations that need human judgement:
+* switch-based reducers, `connect(...)`, and saga/thunk middleware imports.
+*/
+function reportSemanticFollowups(file) {
+	let reportedSwitchReducer = false;
+	let reportedConnect = false;
+	walk(file.program, (node) => {
+		if (!reportedSwitchReducer && isSwitchReducer(node)) {
+			reportedSwitchReducer = true;
+			file.report({
+				message: "Switch-statement reducer detected: convert it to `createSlice` (reducers map + generated action creators).",
+				severity: "warn"
+			});
+			file.magic.appendLeft(node.start, "// TODO(omnimod): convert this switch reducer to createSlice.\n");
+		}
+		if (!reportedConnect && isConnectCall(node)) {
+			reportedConnect = true;
+			file.report({
+				message: "`connect()` detected: prefer the `useSelector`/`useDispatch` hooks from react-redux.",
+				severity: "warn"
+			});
+		}
+	});
+	for (const stmt of file.program.body) {
+		if (stmt.type !== "ImportDeclaration") continue;
+		const src = cast(stmt).source.value;
+		if (src === "redux-saga" || src.startsWith("redux-saga/") || src === "redux-thunk") file.report({
+			message: `\`${src}\` middleware detected: RTK ships \`createAsyncThunk\`/listener middleware; migrate async logic accordingly.`,
+			severity: "info"
+		});
+	}
+}
+/**
+* True for a function whose body is (or immediately contains) a `switch` on an
+* `action.type`-shaped discriminant and whose first param defaults to an initial
+* state — the classic hand-written reducer shape.
+*/
+function isSwitchReducer(node) {
+	let params;
+	let body;
+	if (node.type === "ArrowFunctionExpression") {
+		const fn = cast(node);
+		params = fn.params;
+		body = fn.body;
+	} else if (node.type === "FunctionDeclaration") {
+		const fn = cast(node);
+		params = fn.params;
+		body = fn.body;
+	} else if (node.type === "FunctionExpression") {
+		const fn = cast(node);
+		params = fn.params;
+		body = fn.body;
+	} else return false;
+	if (params.length < 2) return false;
+	if (!(params[0]?.type === "AssignmentPattern")) return false;
+	if (!body || body.type !== "BlockStatement") return false;
+	return (body.body ?? []).some((stmt) => stmt.type === "SwitchStatement");
+}
+/** True for `connect(...)(Component)` or `connect(...)` from react-redux. */
+function isConnectCall(node) {
+	if (node.type !== "CallExpression") return false;
+	const inner = cast(node).callee;
+	if (inner.type === "Identifier" && cast(inner).name === "connect") return true;
+	if (inner.type === "CallExpression") {
+		const innerCall = cast(inner);
+		if (innerCall.callee.type === "Identifier" && cast(innerCall.callee).name === "connect") return true;
+	}
+	return false;
+}
+//#endregion
+export { reduxToToolkit as default, reduxToToolkit };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@omnimod/plugin-redux-to-toolkit",
+  "version": "0.1.0",
+  "description": "omnimod plugin: migrate legacy Redux to Redux Toolkit.",
+  "keywords": [
+    "codemod",
+    "migration",
+    "omnimod-plugin",
+    "redux",
+    "redux-toolkit"
+  ],
+  "homepage": "https://salnika.github.io/omnimod/",
+  "bugs": "https://github.com/salnika/omnimod/issues",
+  "license": "MIT",
+  "author": "salnika",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/salnika/omnimod.git",
+    "directory": "packages/plugin-redux-to-toolkit"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@omnimod/plugin-utils": "0.1.0",
+    "@omnimod/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "typescript": "^6.0.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2",
+    "vite-plus": "0.2.2"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}