@ripast/cli 0.0.0 → 0.1.0

package/bin/ripast.mjs

@@ -45,7 +45,9 @@ function ensureAdapters(needed) {
   const require = createRequire(import.meta.url)
   const missing = []
   for (const name of needed) {
-    try { require.resolve(`@ripast/${name}`) }
+    try {
+      require.resolve(`@ripast/${name}`)
+    }
     catch { missing.push(`@ripast/${name}`) }
   }
   if (!missing.length)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 import { mkdirSync, readFileSync, renameSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import process from "node:process";
-import { buildDeclarationTree, buildScanGraph, formatAgentDeclarationTree, formatAgentHits, formatAgentScanHits, formatDeclarationTree, formatHits, formatRegressions, formatScanGraph, formatScanHits, printDiffs, resolveVerifyMode, runCssClassRename, runCssClassScan, runMove, runRename, runRenameFile, scan, summarize, writeChanges } from "@ripast/core";
+import { buildDeclarationTree, buildScanGraph, buildUnusedDeclarations, formatAgentDeclarationTree, formatAgentFileScanHits, formatAgentHits, formatAgentScanHits, formatDeclarationTree, formatFileScanHits, formatHits, formatRegressions, formatScanGraph, formatScanHits, formatUnusedDeclarations, printDiffs, resolveVerifyMode, runCssClassFileScan, runCssClassRename, runCssClassScan, runDelete, runMove, runRename, runRenameFile, runReplace, scan, summarize, writeChanges } from "@ripast/core";
 import { defineCommand, runMain } from "citty";
 import { agent, isAgent } from "std-env";
 const globArg = {
@@ -69,7 +69,7 @@ function resolveCliVerifyMode(verify, verifyMode) {
 }
 function resolveExportFilter(raw) {
 	if (raw !== "all" && raw !== "exported" && raw !== "local") {
-		process.stderr.write(`ripast tree: --exports must be "all", "exported", or "local".\n`);
+		process.stderr.write(`ripast: --exports must be "all", "exported", or "local".\n`);
 		process.exit(2);
 	}
 	return raw;
@@ -162,6 +162,42 @@ const renameCmd = defineCommand({
 		}), !!args.apply, verifyMode !== "none", !!args.json, resolveProfile(args.profile).agentProfile);
 	}
 });
+const replaceCmd = defineCommand({
+	meta: {
+		name: "replace",
+		description: "Replace an imported symbol with another project export; updates imports and call sites."
+	},
+	args: {
+		"from": {
+			type: "positional",
+			required: true
+		},
+		"to": {
+			type: "positional",
+			required: true
+		},
+		"tsconfig": { type: "string" },
+		"glob": globArg,
+		"target-scope": {
+			type: "string",
+			description: "Restrict target symbol resolution to a single file when multiple files export the same name."
+		},
+		"apply": applyArg,
+		"verify": verifyArg,
+		"verifyMode": verifyModeArg,
+		"profile": profileArg,
+		"json": jsonArg
+	},
+	async run({ args }) {
+		const verifyMode = resolveCliVerifyMode(args.verify, args.verifyMode);
+		emitResult(await runReplace(args.from, args.to, {
+			tsconfig: args.tsconfig,
+			glob: args.glob ? args.glob.split(",") : void 0,
+			verify: verifyMode,
+			targetScope: args["target-scope"]
+		}), !!args.apply, verifyMode !== "none", !!args.json, resolveProfile(args.profile).agentProfile);
+	}
+});
 const treeCmd = defineCommand({
 	meta: {
 		name: "tree",
@@ -191,6 +227,30 @@ const treeCmd = defineCommand({
 		process.stdout.write(`${formatDeclarationTree(tree, !!args.json)}\n`);
 	}
 });
+const unusedCmd = defineCommand({
+	meta: {
+		name: "unused",
+		description: "Find unreferenced top-level declarations."
+	},
+	args: {
+		glob: globArg,
+		exports: {
+			type: "string",
+			description: "Declaration filter: all, exported, or local. Defaults to local."
+		},
+		tsconfig: { type: "string" },
+		json: jsonArg
+	},
+	run({ args }) {
+		const exportFilter = args.exports == null ? "local" : resolveExportFilter(args.exports);
+		const unused = buildUnusedDeclarations({
+			glob: args.glob ? args.glob.split(",") : void 0,
+			exports: exportFilter,
+			tsconfig: args.tsconfig
+		});
+		process.stdout.write(`${formatUnusedDeclarations(unused, !!args.json)}\n`);
+	}
+});
 const moveCmd = defineCommand({
 	meta: {
 		name: "move",
@@ -228,6 +288,36 @@ const moveCmd = defineCommand({
 		}), !!args.apply, verifyMode !== "none", !!args.json, resolveProfile(args.profile).agentProfile);
 	}
 });
+const deleteCmd = defineCommand({
+	meta: {
+		name: "delete",
+		description: "Delete an unused top-level declaration from a file; refuses if references remain."
+	},
+	args: {
+		symbol: {
+			type: "positional",
+			required: true
+		},
+		from: {
+			type: "string",
+			required: true,
+			description: "Source file path."
+		},
+		tsconfig: { type: "string" },
+		apply: applyArg,
+		verify: verifyArg,
+		verifyMode: verifyModeArg,
+		profile: profileArg,
+		json: jsonArg
+	},
+	async run({ args }) {
+		const verifyMode = resolveCliVerifyMode(args.verify, args.verifyMode);
+		emitResult(await runDelete(args.symbol, args.from, {
+			tsconfig: args.tsconfig,
+			verify: verifyMode
+		}), !!args.apply, verifyMode !== "none", !!args.json, resolveProfile(args.profile).agentProfile);
+	}
+});
 function emitResult(r, apply, verify = false, json = false, agentProfile = false) {
 	const s = summarize(r.changes);
 	if (json) {
@@ -345,11 +435,13 @@ const renameFileCmd = defineCommand({
 					before: c.before,
 					after: c.after
 				})),
-				regressions: r.regressions
+				regressions: r.regressions,
+				warnings: r.warnings
 			})}\n`);
 			if (blockedByRegression) process.exit(1);
 			return;
 		}
+		for (const w of r.warnings) process.stderr.write(`warning: ${w}\n`);
 		if (agentProfile) {
 			process.stdout.write(`${profileHeader()}\n`);
 			process.stdout.write(`rename-file: ${args.old} -> ${args.new}\n`);
@@ -458,6 +550,82 @@ function buildRenameMap(from, to, mapPath) {
 	}
 	return new Map(entries);
 }
+const cssClassScanCmd = defineCommand({
+	meta: {
+		name: "css-class-scan",
+		description: "Tokenize every class site (strings, Vue class attrs, @apply) and emit sortable token or file frequency lists. Use --sort count-asc for rare tokens or --by file for files introducing the most unique classes."
+	},
+	args: {
+		pattern: {
+			type: "string",
+			description: "Comma-separated globs matched against the bare token (e.g. \"bg-*,text-*\"). Default: all tokens."
+		},
+		glob: globArg,
+		by: {
+			type: "string",
+			description: "Group by token or file. Default: token."
+		},
+		sort: {
+			type: "string",
+			description: "Sort order. Token: count-desc, count-asc, token. File: unique-desc, unique-asc, count-desc, count-asc, file."
+		},
+		profile: profileArg,
+		json: jsonArg
+	},
+	run({ args }) {
+		const { agentProfile } = resolveProfile(args.profile);
+		const by = resolveCssClassScanGroup(args.by);
+		const base = {
+			glob: args.glob ? args.glob.split(",") : void 0,
+			pattern: args.pattern ? args.pattern.split(",") : void 0
+		};
+		if (by === "file") {
+			const hits = runCssClassFileScan({
+				...base,
+				sort: resolveCssClassFileScanSort(args.sort)
+			});
+			if (agentProfile && !args.json) {
+				process.stdout.write(`${profileHeader()}\n${formatAgentFileScanHits(hits)}\n`);
+				return;
+			}
+			process.stdout.write(`${formatFileScanHits(hits, !!args.json)}\n`);
+			return;
+		}
+		const hits = runCssClassScan({
+			...base,
+			sort: resolveCssClassScanSort(args.sort)
+		});
+		if (agentProfile && !args.json) {
+			process.stdout.write(`${profileHeader()}\n${formatAgentScanHits(hits)}\n`);
+			return;
+		}
+		process.stdout.write(`${formatScanHits(hits, !!args.json)}\n`);
+	}
+});
+function resolveCssClassScanGroup(raw) {
+	if (raw == null) return "token";
+	if (raw !== "token" && raw !== "file") {
+		process.stderr.write(`ripast css-class-scan: --by must be "token" or "file".\n`);
+		process.exit(2);
+	}
+	return raw;
+}
+function resolveCssClassScanSort(raw) {
+	if (raw == null) return "count-desc";
+	if (raw !== "count-desc" && raw !== "count-asc" && raw !== "token") {
+		process.stderr.write(`ripast css-class-scan: --sort must be "count-desc", "count-asc", or "token".\n`);
+		process.exit(2);
+	}
+	return raw;
+}
+function resolveCssClassFileScanSort(raw) {
+	if (raw == null) return "unique-desc";
+	if (raw !== "unique-desc" && raw !== "unique-asc" && raw !== "count-desc" && raw !== "count-asc" && raw !== "file") {
+		process.stderr.write(`ripast css-class-scan: --sort with --by file must be "unique-desc", "unique-asc", "count-desc", "count-asc", or "file".\n`);
+		process.exit(2);
+	}
+	return raw;
+}
 runMain(defineCommand({
 	meta: {
 		name: "ripast",
@@ -466,37 +634,14 @@ runMain(defineCommand({
 	subCommands: {
 		"scan": scanCmd,
 		"tree": treeCmd,
+		"unused": unusedCmd,
 		"rename": renameCmd,
+		"replace": replaceCmd,
 		"rename-file": renameFileCmd,
 		"move": moveCmd,
+		"delete": deleteCmd,
 		"css-class-rename": cssClassRenameCmd,
-		"css-class-scan": defineCommand({
-			meta: {
-				name: "css-class-scan",
-				description: "Tokenize every class site (strings, Vue class attrs, @apply) and emit a frequency-sorted list. Feeds --map for css-class-rename."
-			},
-			args: {
-				pattern: {
-					type: "string",
-					description: "Comma-separated globs matched against the bare token (e.g. \"bg-*,text-*\"). Default: all tokens."
-				},
-				glob: globArg,
-				profile: profileArg,
-				json: jsonArg
-			},
-			run({ args }) {
-				const { agentProfile } = resolveProfile(args.profile);
-				const hits = runCssClassScan({
-					glob: args.glob ? args.glob.split(",") : void 0,
-					pattern: args.pattern ? args.pattern.split(",") : void 0
-				});
-				if (agentProfile && !args.json) {
-					process.stdout.write(`${profileHeader()}\n${formatAgentScanHits(hits)}\n`);
-					return;
-				}
-				process.stdout.write(`${formatScanHits(hits, !!args.json)}\n`);
-			}
-		})
+		"css-class-scan": cssClassScanCmd
 	}
 }));
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ripast/cli",
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "description": "CLI for ripast. Deterministic AST refactors (rename, move, find-usages, tailwind/CSS class migration) for TypeScript and frontend frameworks. Auto-installs framework adapters as needed.",
   "author": {
     "name": "Harlan Wilton",
@@ -50,7 +50,7 @@
   "dependencies": {
     "citty": "^0.2.2",
     "std-env": "^4.1.0",
-    "@ripast/core": "0.0.0"
+    "@ripast/core": "0.1.0"
   },
   "scripts": {
     "build": "obuild",