@omnimod/cli 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,42 @@
+# @omnimod/cli
+
+[![npm](https://img.shields.io/npm/v/%40omnimod%2Fcli?label=npm)](https://www.npmjs.com/package/@omnimod/cli)
+[![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)
+
+Command-line runner for omnimod codemods.
+
+The CLI bundles the official migration plugins and can also resolve external
+plugins by package name or local path.
+
+## Install
+
+```bash
+pnpm add -D @omnimod/cli
+```
+
+## Usage
+
+```bash
+omnimod list
+omnimod run styled-to-vanilla-extract "src/**/*.tsx"
+omnimod run styled-to-vanilla-extract "src/**/*.tsx" --write
+```
+
+Runs are dry by default. Pass `--write` to update files and `--no-format` to
+skip formatter/linter detection after writing.
+
+## Commands
+
+- `omnimod list`: list bundled plugins.
+- `omnimod run <plugin> [...paths]`: run one plugin against a project.
+
+## Bundled Plugins
+
+- `styled-to-vanilla-extract`
+- `moment-to-dayjs`
+- `jest-to-vitest`
+- `lodash-to-es-toolkit`
+- `redux-to-toolkit`
+- `react-class-to-hooks`
+- `webpack-to-vite`

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+import { Plugin, RunResult } from "@omnimod/core";
+
+//#region src/index.d.ts
+/** Sorted names of every built-in plugin. */
+declare function listPlugins(): string[];
+/** `name — description` lines for every built-in plugin, sorted by name. */
+declare function describePlugins(): string[];
+/**
+ * Resolve a plugin by registered name, a relative/absolute path, or a bare name
+ * using the `@omnimod/plugin-<name>` / `omnimod-plugin-<name>` conventions.
+ */
+declare function resolvePlugin(nameOrPath: string): Promise<Plugin>;
+/** Render a run result (diffs, emitted files, diagnostics, summary) for the terminal. */
+declare function formatResult(result: RunResult, write: boolean, root: string): string;
+declare function main(argv?: string[]): Promise<number>;
+//#endregion
+export { describePlugins, formatResult, listPlugins, main, resolvePlugin };

package/dist/index.mjs

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { detectFixers, renderDiff, renderEmitted, run } from "@omnimod/core";
+import { jestToVitest } from "@omnimod/plugin-jest-to-vitest";
+import { lodashToEsToolkit } from "@omnimod/plugin-lodash-to-es-toolkit";
+import { momentToDayjs } from "@omnimod/plugin-moment-to-dayjs";
+import { reactClassToHooks } from "@omnimod/plugin-react-class-to-hooks";
+import { reduxToToolkit } from "@omnimod/plugin-redux-to-toolkit";
+import { styledToVanillaExtract } from "@omnimod/plugin-styled-to-vanilla-extract";
+import { webpackToVite } from "@omnimod/plugin-webpack-to-vite";
+import { cac } from "cac";
+import pc from "picocolors";
+//#region src/index.ts
+/** Built-in plugin registry, keyed by plugin name. */
+const REGISTRY = new Map([
+	styledToVanillaExtract,
+	momentToDayjs,
+	jestToVitest,
+	lodashToEsToolkit,
+	reduxToToolkit,
+	reactClassToHooks,
+	webpackToVite
+].map((plugin) => [plugin.name, plugin]));
+/** Sorted names of every built-in plugin. */
+function listPlugins() {
+	return [...REGISTRY.keys()].sort();
+}
+/** `name — description` lines for every built-in plugin, sorted by name. */
+function describePlugins() {
+	return listPlugins().map((name) => `${name} — ${REGISTRY.get(name)?.description ?? ""}`);
+}
+async function importPlugin(specifier) {
+	const mod = await import(specifier);
+	const plugin = mod.default ?? mod.plugin;
+	if (!plugin) throw new Error(`Module "${specifier}" has no plugin export (default or \`plugin\`)`);
+	return plugin;
+}
+function isModuleNotFound(error) {
+	return typeof error === "object" && error !== null && error.code === "ERR_MODULE_NOT_FOUND";
+}
+/**
+* Resolve a plugin by registered name, a relative/absolute path, or a bare name
+* using the `@omnimod/plugin-<name>` / `omnimod-plugin-<name>` conventions.
+*/
+async function resolvePlugin(nameOrPath) {
+	const known = REGISTRY.get(nameOrPath);
+	if (known) return known;
+	if (nameOrPath.startsWith(".") || nameOrPath.startsWith("/")) return importPlugin(pathToFileURL(resolve(nameOrPath)).href);
+	const candidates = /[@/]/.test(nameOrPath) ? [nameOrPath] : [
+		`@omnimod/plugin-${nameOrPath}`,
+		`omnimod-plugin-${nameOrPath}`,
+		nameOrPath
+	];
+	for (const specifier of candidates) try {
+		return await importPlugin(specifier);
+	} catch (error) {
+		if (!isModuleNotFound(error)) throw error;
+	}
+	throw new Error(`Could not resolve plugin "${nameOrPath}". Tried: ${candidates.join(", ")}.`);
+}
+/** Render a run result (diffs, emitted files, diagnostics, summary) for the terminal. */
+function formatResult(result, write, root) {
+	const blocks = [];
+	for (const change of result.changed) blocks.push(renderDiff(change));
+	for (const file of result.emitted) blocks.push(renderEmitted(file));
+	for (const diagnostic of result.diagnostics) {
+		const tag = diagnostic.severity === "error" ? pc.red("error") : diagnostic.severity === "warn" ? pc.yellow("warn") : pc.blue("info");
+		blocks.push(`${tag} ${diagnostic.file}: ${diagnostic.message}`);
+	}
+	if (result.format && result.format.tools.length > 0) {
+		blocks.push(pc.blue(`formatted with ${result.format.tools.join(", ")}`));
+		for (const error of result.format.errors) blocks.push(pc.yellow(`format: ${error}`));
+	} else if (!write) {
+		const fixers = detectFixers(root).map((fixer) => fixer.tool);
+		if (fixers.length > 0) blocks.push(pc.dim(`on --write, output will be formatted with ${fixers.join(", ")}`));
+	}
+	const summary = `${result.changed.length} changed, ${result.emitted.length} created, ${result.diagnostics.length} diagnostic(s)`;
+	blocks.push(write ? pc.green(summary) : pc.dim(`${summary} — dry-run, pass --write to apply`));
+	return blocks.join("\n\n");
+}
+function toArray(value) {
+	if (value === void 0) return void 0;
+	return Array.isArray(value) ? value : [value];
+}
+async function main(argv = process.argv) {
+	const cli = cac("omnimod");
+	cli.command("run <plugin> [...paths]", "Run a codemod plugin over the project").option("--write", "Write changes to disk (default: dry-run)").option("--cwd <dir>", "Project root to operate on", { default: "." }).option("--exclude <glob>", "Glob to exclude (repeatable)").option("--no-format", "Skip the project formatter/linter after writing").action(async (plugin, paths, flags) => {
+		const result = await run(await resolvePlugin(plugin), {
+			root: flags.cwd,
+			include: paths.length > 0 ? paths : void 0,
+			exclude: toArray(flags.exclude),
+			write: flags.write,
+			format: flags.format
+		});
+		process.stdout.write(`${formatResult(result, flags.write ?? false, flags.cwd)}\n`);
+	});
+	cli.command("list", "List available plugins").action(() => {
+		process.stdout.write(`${describePlugins().join("\n")}\n`);
+	});
+	cli.help();
+	cli.version("0.1.0");
+	cli.parse(argv, { run: false });
+	await cli.runMatchedCommand();
+	return 0;
+}
+async function isDirectInvocation(invoked) {
+	if (!invoked) return false;
+	try {
+		return await realpath(invoked) === await realpath(fileURLToPath(import.meta.url));
+	} catch {
+		return import.meta.url === pathToFileURL(invoked).href;
+	}
+}
+if (await isDirectInvocation(process.argv[1])) main().then((code) => process.exit(code), (error) => {
+	process.stderr.write(`${String(error)}\n`);
+	process.exit(1);
+});
+//#endregion
+export { describePlugins, formatResult, listPlugins, main, resolvePlugin };

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@omnimod/cli",
+  "version": "0.1.0",
+  "description": "Command-line runner for omnimod codemods.",
+  "keywords": [
+    "cli",
+    "codemod",
+    "omnimod",
+    "styled-components",
+    "vanilla-extract"
+  ],
+  "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/cli"
+  },
+  "bin": {
+    "omnimod": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cac": "^7.0.0",
+    "picocolors": "^1.1.1",
+    "@omnimod/core": "0.1.0",
+    "@omnimod/plugin-jest-to-vitest": "0.1.0",
+    "@omnimod/plugin-lodash-to-es-toolkit": "0.1.0",
+    "@omnimod/plugin-react-class-to-hooks": "0.1.0",
+    "@omnimod/plugin-redux-to-toolkit": "0.1.0",
+    "@omnimod/plugin-styled-to-vanilla-extract": "0.1.0",
+    "@omnimod/plugin-webpack-to-vite": "0.1.0",
+    "@omnimod/plugin-moment-to-dayjs": "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"
+  }
+}