@omnimod/plugin-lodash-to-es-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-lodash-to-es-toolkit
+
+[![npm](https://img.shields.io/npm/v/%40omnimod%2Fplugin-lodash-to-es-toolkit?label=npm)](https://www.npmjs.com/package/@omnimod/plugin-lodash-to-es-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 lodash imports to es-toolkit, and to native APIs
+where the replacement is safe.
+
+## Use With The CLI
+
+```bash
+omnimod run lodash-to-es-toolkit "src/**/*.{ts,tsx,js,jsx}"
+omnimod run lodash-to-es-toolkit "src/**/*.{ts,tsx,js,jsx}" --write
+```
+
+## Use As A Library
+
+```ts
+import { lodashToEsToolkit } from "@omnimod/plugin-lodash-to-es-toolkit";
+```
+
+## Notes
+
+The plugin rewrites supported named lodash imports. Helpers with semantics that
+need review are left in place and reported as diagnostics.

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+//#region src/plugin.d.ts
+type LodashToEsToolkitOptions = Record<string, unknown>;
+/**
+ * Migrate named `lodash` / `lodash-es` imports to `es-toolkit`, rewriting a small
+ * set of native-safe helpers to their JS built-ins and leaving divergent helpers
+ * on lodash (with a diagnostic). Default (`import _ from "lodash"`) and namespace
+ * imports are reported and left untouched.
+ */
+declare const lodashToEsToolkit: import("@omnimod/core").Plugin<LodashToEsToolkitOptions, unknown>;
+//#endregion
+export { type LodashToEsToolkitOptions, lodashToEsToolkit as default, lodashToEsToolkit };

package/dist/index.mjs

@@ -0,0 +1,233 @@
+import { definePlugin, walk } from "@omnimod/core";
+import { cast } from "@omnimod/plugin-utils";
+//#region src/plugin.ts
+const LODASH_SOURCES = /* @__PURE__ */ new Set(["lodash", "lodash-es"]);
+const ES_TOOLKIT_SOURCE = "es-toolkit";
+/**
+* Names that es-toolkit re-exports under the same identifier. The import source is
+* rewritten to "es-toolkit" and the specifier kept verbatim.
+*/
+const SUPPORTED = /* @__PURE__ */ new Set([
+	"debounce",
+	"throttle",
+	"cloneDeep",
+	"clone",
+	"isEqual",
+	"isEqualWith",
+	"groupBy",
+	"keyBy",
+	"uniq",
+	"uniqBy",
+	"uniqWith",
+	"difference",
+	"differenceBy",
+	"intersection",
+	"intersectionBy",
+	"omit",
+	"omitBy",
+	"pick",
+	"pickBy",
+	"mapValues",
+	"mapKeys",
+	"merge",
+	"mergeWith",
+	"chunk",
+	"compact",
+	"flatten",
+	"flattenDeep",
+	"drop",
+	"dropRight",
+	"take",
+	"takeRight",
+	"zip",
+	"unzip",
+	"sum",
+	"sumBy",
+	"mean",
+	"meanBy",
+	"maxBy",
+	"minBy",
+	"sortBy",
+	"orderBy",
+	"range",
+	"random",
+	"sample",
+	"sampleSize",
+	"shuffle",
+	"capitalize",
+	"camelCase",
+	"kebabCase",
+	"snakeCase",
+	"startCase",
+	"upperFirst",
+	"lowerFirst",
+	"isNil",
+	"isPlainObject",
+	"isBoolean",
+	"isString",
+	"isNumber",
+	"isFunction",
+	"isDate",
+	"isRegExp",
+	"isSymbol",
+	"delay",
+	"once",
+	"memoize",
+	"partition",
+	"countBy",
+	"invert",
+	"toMerged",
+	"head",
+	"last",
+	"initial",
+	"tail"
+]);
+/**
+* Native-safe rewrites: the import specifier is dropped and simple call sites
+* `name(...args)` are rewritten to the native callee. `noop` maps to an inlined
+* arrow. Only trivial call forms are rewritten; anything else keeps the import.
+*/
+const NATIVE_CALLEE = {
+	isArray: "Array.isArray",
+	isInteger: "Number.isInteger",
+	isNaN: "Number.isNaN",
+	isFinite: "Number.isFinite"
+};
+const NATIVE_NAMES = /* @__PURE__ */ new Set([...Object.keys(NATIVE_CALLEE), "noop"]);
+/** Names left on lodash because their es-toolkit / native semantics diverge. */
+const UNSUPPORTED_REASON = {
+	get: "lodash.get has no direct es-toolkit equivalent (path access differs)",
+	set: "lodash.set has no direct es-toolkit equivalent",
+	has: "lodash.has has no direct es-toolkit equivalent",
+	isEmpty: "es-toolkit.isEmpty diverges from lodash.isEmpty",
+	map: "lodash collection semantics (objects/iteratee shorthand) differ",
+	filter: "lodash collection semantics (objects/iteratee shorthand) differ",
+	reduce: "lodash collection semantics (objects/iteratee shorthand) differ",
+	forEach: "lodash collection semantics (objects/iteratee shorthand) differ",
+	template: "lodash.template has no es-toolkit equivalent",
+	chain: "lodash.chain has no es-toolkit equivalent",
+	flow: "lodash.flow has no direct es-toolkit equivalent"
+};
+/**
+* Migrate named `lodash` / `lodash-es` imports to `es-toolkit`, rewriting a small
+* set of native-safe helpers to their JS built-ins and leaving divergent helpers
+* on lodash (with a diagnostic). Default (`import _ from "lodash"`) and namespace
+* imports are reported and left untouched.
+*/
+const lodashToEsToolkit = definePlugin({
+	name: "lodash-to-es-toolkit",
+	description: "Migrate lodash to es-toolkit (and native where safe).",
+	include: ["**/*.{ts,tsx,js,jsx,mts,cts}"],
+	transform(file) {
+		for (const stmt of file.program.body) {
+			if (stmt.type !== "ImportDeclaration") continue;
+			const imp = cast(stmt);
+			if (!LODASH_SOURCES.has(imp.source.value)) continue;
+			convertImport(file, imp);
+		}
+	}
+});
+function convertImport(file, imp) {
+	const named = [];
+	let hasDefault = false;
+	let hasNamespace = false;
+	for (const spec of imp.specifiers) if (spec.type === "ImportDefaultSpecifier") hasDefault = true;
+	else if (spec.type === "ImportNamespaceSpecifier") hasNamespace = true;
+	else if (spec.type === "ImportSpecifier") {
+		const s = cast(spec);
+		if (s.imported.type !== "Identifier") continue;
+		named.push({
+			imported: cast(s.imported).name,
+			local: s.local.name,
+			node: spec
+		});
+	}
+	if (hasDefault) {
+		file.report({
+			severity: "warn",
+			message: `Default \`${imp.source.value}\` import; convert to named imports manually.`
+		});
+		return;
+	}
+	if (hasNamespace) {
+		file.report({
+			severity: "warn",
+			message: `Namespace \`${imp.source.value}\` import; convert to named imports manually.`
+		});
+		return;
+	}
+	if (named.length === 0) return;
+	const supported = [];
+	const nativeSafe = [];
+	const residual = [];
+	for (const spec of named) if (SUPPORTED.has(spec.imported)) supported.push(spec);
+	else if (NATIVE_NAMES.has(spec.imported) && canRewriteNative(spec)) nativeSafe.push(spec);
+	else {
+		residual.push(spec);
+		const reason = UNSUPPORTED_REASON[spec.imported] ?? `\`${spec.imported}\` has no known es-toolkit equivalent`;
+		file.report({
+			severity: "warn",
+			message: `Left \`${spec.imported}\` on ${imp.source.value}: ${reason}`
+		});
+	}
+	for (const spec of nativeSafe) rewriteNativeUsages(file, spec);
+	if (supported.length === 0 && residual.length === 0) {
+		file.magic.remove(imp.start, imp.end);
+		return;
+	}
+	if (residual.length === 0) {
+		const line = renderImport(ES_TOOLKIT_SOURCE, supported);
+		file.magic.update(imp.start, imp.end, line);
+		return;
+	}
+	if (supported.length === 0) {
+		if (nativeSafe.length > 0) {
+			const line = renderImport(imp.source.value, residual);
+			file.magic.update(imp.start, imp.end, line);
+		}
+		return;
+	}
+	const esLine = renderImport(ES_TOOLKIT_SOURCE, supported);
+	const residualLine = renderImport(imp.source.value, residual);
+	file.magic.update(imp.start, imp.end, `${esLine}\n${residualLine}`);
+}
+/** Render `import { a, b as c } from "source";` for a set of specifiers. */
+function renderImport(source, specs) {
+	return `import { ${specs.map((spec) => spec.local === spec.imported ? spec.imported : `${spec.imported} as ${spec.local}`).sort((a, b) => a.localeCompare(b)).join(", ")} } from ${JSON.stringify(source)};`;
+}
+/**
+* Whether a native-safe specifier is trivially rewritable. `noop` is only safe
+* when it is never aliased (its local name is `noop`) — aliasing would require
+* tracking the binding, which v1 does not do.
+*/
+function canRewriteNative(spec) {
+	if (spec.imported === "noop") return spec.local === "noop";
+	return true;
+}
+/**
+* Rewrite call sites of a native-safe helper. For the mapped built-ins we only
+* rewrite direct call callees (`name(...)`), leaving any non-call reference (e.g.
+* passing `isArray` as a value) untouched. `noop` references are replaced with an
+* inlined `(() => {})` arrow.
+*/
+function rewriteNativeUsages(file, spec) {
+	const nativeCallee = NATIVE_CALLEE[spec.imported];
+	walk(file.program, (node, parent, key) => {
+		if (node === spec.node) return "skip";
+		if (nativeCallee) {
+			if (node.type !== "CallExpression") return;
+			const call = cast(node);
+			if (call.callee.type !== "Identifier") return;
+			if (cast(call.callee).name !== spec.local) return;
+			file.magic.update(call.callee.start, call.callee.end, nativeCallee);
+			return;
+		}
+		if (node.type !== "Identifier") return;
+		if (cast(node).name !== spec.local) return;
+		if (parent && parent.type === "MemberExpression" && key === "property") return;
+		if (parent && parent.type === "ImportSpecifier") return "skip";
+		file.magic.update(node.start, node.end, "(() => {})");
+	});
+}
+//#endregion
+export { lodashToEsToolkit as default, lodashToEsToolkit };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@omnimod/plugin-lodash-to-es-toolkit",
+  "version": "0.1.0",
+  "description": "omnimod plugin: migrate lodash to es-toolkit (and native where safe).",
+  "keywords": [
+    "codemod",
+    "es-toolkit",
+    "lodash",
+    "migration",
+    "omnimod-plugin"
+  ],
+  "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-lodash-to-es-toolkit"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@omnimod/core": "0.1.0",
+    "@omnimod/plugin-utils": "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"
+  }
+}