deslop-cli 0.0.20 → 0.0.21

package/README.md

@@ -49,40 +49,41 @@ deslop ./my-app --fail-on-cycles
 
 The default scan emits the following finding categories (each grouped in human output, fully detailed in `--json`):
 
-| Category                  | What it catches                                                                  |
-| ------------------------- | -------------------------------------------------------------------------------- |
-| `unusedFiles`             | Files unreachable from any entry point                                           |
-| `unusedExports`           | Exported symbols never imported anywhere                                         |
-| `unusedDependencies`      | `package.json` deps not imported                                                 |
-| `circularDependencies`    | Import cycles                                                                    |
-| `redundantAliases`        | `import { x as x }`, useless re-export renames                                   |
-| `duplicateExports`        | Same name exported twice from one module                                         |
-| `duplicateImports`        | Same specifier imported on multiple lines (merge them)                           |
-| `redundantTypePatterns`   | `T & {}`, `Partial<Partial<T>>`, `Pick<T, keyof T>`, empty `extends`             |
-| `identityWrappers`        | `const wrap = (x) => fn(x)`, calls without transforming                          |
-| `duplicateTypeDefinitions`| Same structural type declared in multiple files                                  |
-| `duplicateInlineTypes`    | Anonymous `{ a, b, c }` shapes repeated across modules                           |
-| `simplifiableFunctions`   | `(x) => { return f(x) }`, `await x; return x;`, useless `async`                  |
-| `simplifiableExpressions` | `!!x`, `x ? x : y`, `cond ? true : false`, `x !== null && x !== undefined`       |
-| `duplicateConstants`      | Same literal value used in N files under different names                         |
-| `analysisErrors`          | Structured info / warning / error notes (parse failures, skipped files, etc.)    |
+| Category                   | What it catches                                                               |
+| -------------------------- | ----------------------------------------------------------------------------- |
+| `unusedFiles`              | Files unreachable from any entry point                                        |
+| `unusedExports`            | Exported symbols never imported anywhere                                      |
+| `unusedDependencies`       | `package.json` deps not imported                                              |
+| `circularDependencies`     | Import cycles                                                                 |
+| `redundantAliases`         | `import { x as x }`, useless re-export renames                                |
+| `duplicateExports`         | Same name exported twice from one module                                      |
+| `duplicateImports`         | Same specifier imported on multiple lines (merge them)                        |
+| `redundantTypePatterns`    | `T & {}`, `Partial<Partial<T>>`, `Pick<T, keyof T>`, empty `extends`          |
+| `identityWrappers`         | `const wrap = (x) => fn(x)`, calls without transforming                       |
+| `duplicateTypeDefinitions` | Same structural type declared in multiple files                               |
+| `duplicateInlineTypes`     | Anonymous `{ a, b, c }` shapes repeated across modules                        |
+| `simplifiableFunctions`    | `(x) => { return f(x) }`, `await x; return x;`, useless `async`               |
+| `simplifiableExpressions`  | `!!x`, `x ? x : y`, `cond ? true : false`, `x !== null && x !== undefined`    |
+| `duplicateConstants`       | Same literal value used in N files under different names                      |
+| `analysisErrors`           | Structured info / warning / error notes (parse failures, skipped files, etc.) |
 
 Type-aware findings (`unusedTypes`, `unusedClassMembers`, `misclassifiedDependencies`, etc.) require enabling the semantic layer programmatically. See the [`deslop-js` README](https://github.com/aidenybai/deslop-js#semantic-type-aware-analysis). They are not exposed via CLI flags yet.
 
 ### Options
 
-| Option                    | Description                                                       |
-| ------------------------- | ----------------------------------------------------------------- |
-| `[root]`                  | Project root directory (default: `.`; must exist)                 |
-| `-e, --entry <pattern>`   | Entry point glob patterns                                         |
-| `-i, --ignore <pattern>`  | Glob patterns to exclude                                          |
-| `--extensions <ext>`      | File extensions to scan (e.g. `.ts` `.vue`)                       |
-| `--tsconfig <path>`       | Path to tsconfig.json for alias resolution                        |
-| `--report-types`          | Include type-only exports in results                              |
-| `--include-entry-exports` | Report unused exports from entry files                            |
-| `--json`                  | Output results as JSON                                            |
-| `--fail-on-issues`        | Exit 1 when unused files, exports, or dependencies are found      |
-| `--fail-on-cycles`        | Exit 1 when circular imports are found                            |
+| Option                    | Description                                                  |
+| ------------------------- | ------------------------------------------------------------ |
+| `[root]`                  | Project root directory (default: `.`; must exist)            |
+| `-e, --entry <pattern>`   | Entry point glob patterns                                    |
+| `-i, --ignore <pattern>`  | Glob patterns to exclude                                     |
+| `--extensions <ext>`      | File extensions to scan (e.g. `.ts` `.vue`)                  |
+| `--tsconfig <path>`       | Path to tsconfig.json for alias resolution                   |
+| `--paths <alias=target>`  | Explicit path-alias mappings (e.g. `@app/*=src/*`), repeatable |
+| `--report-types`          | Include type-only exports in results                         |
+| `--include-entry-exports` | Report unused exports from entry files                       |
+| `--json`                  | Output results as JSON                                       |
+| `--fail-on-issues`        | Exit 1 when unused files, exports, or dependencies are found |
+| `--fail-on-cycles`        | Exit 1 when circular imports are found                       |
 
 ### Exit codes
 

package/dist/cli.mjs

@@ -206,6 +206,7 @@ const runAnalyze = async (options, output = defaultAnalyzeOutput()) => {
 		ignorePatterns: options.ignore ?? [],
 		includeExtensions: options.extensions,
 		tsConfigPath: options.tsconfig,
+		paths: options.paths,
 		reportTypes: options.reportTypes,
 		includeEntryExports: options.includeEntryExports
 	}));
@@ -226,12 +227,30 @@ const readPackageVersion = (moduleUrl) => {
 
 //#endregion
 //#region src/cli.ts
+const parsePathsOption = (rawPaths) => {
+	if (!rawPaths || rawPaths.length === 0) return void 0;
+	const pathMap = {};
+	for (const entry of rawPaths) {
+		const separatorIndex = entry.indexOf("=");
+		const pattern = separatorIndex === -1 ? "" : entry.slice(0, separatorIndex);
+		const target = separatorIndex === -1 ? "" : entry.slice(separatorIndex + 1);
+		if (!pattern || !target) {
+			process.stderr.write(`deslop: ignoring malformed --paths entry "${entry}" (expected "alias=target", e.g. "@app/*=src/*")\n`);
+			continue;
+		}
+		const existing = pathMap[pattern];
+		if (existing) existing.push(target);
+		else pathMap[pattern] = [target];
+	}
+	return Object.keys(pathMap).length > 0 ? pathMap : void 0;
+};
 const toAnalyzeOptions = (root, optionValues) => ({
 	root: root ?? ".",
 	entry: optionValues.entry,
 	ignore: optionValues.ignore,
 	extensions: optionValues.extensions,
 	tsconfig: optionValues.tsconfig,
+	paths: parsePathsOption(optionValues.paths),
 	reportTypes: Boolean(optionValues.reportTypes),
 	includeEntryExports: Boolean(optionValues.includeEntryExports),
 	json: Boolean(optionValues.json),
@@ -242,7 +261,7 @@ const runAnalyzeAction = async (root, optionValues) => {
 	const exitCode = await runAnalyze(toAnalyzeOptions(root, optionValues));
 	process.exitCode = exitCode;
 };
-const addAnalyzeOptions = (command) => command.argument("[root]", "project root directory", ".").option("-e, --entry <pattern...>", "entry point glob patterns").option("-i, --ignore <pattern...>", "glob patterns to exclude from analysis").option("--extensions <extension...>", "file extensions to scan (e.g. .ts .vue)").option("--tsconfig <path>", "path to tsconfig.json for path alias resolution").option("--report-types", "include type-only exports in results").option("--include-entry-exports", "report unused exports from entry files").option("--json", "output results as JSON").option("--fail-on-issues", "exit with code 1 when unused files, exports, or dependencies are found").option("--fail-on-cycles", "exit with code 1 when circular imports are found");
+const addAnalyzeOptions = (command) => command.argument("[root]", "project root directory", ".").option("-e, --entry <pattern...>", "entry point glob patterns").option("-i, --ignore <pattern...>", "glob patterns to exclude from analysis").option("--extensions <extension...>", "file extensions to scan (e.g. .ts .vue)").option("--tsconfig <path>", "path to tsconfig.json for path alias resolution").option("--paths <alias=target...>", "path alias mappings (e.g. @lib/*=src/lib/*)").option("--report-types", "include type-only exports in results").option("--include-entry-exports", "report unused exports from entry files").option("--json", "output results as JSON").option("--fail-on-issues", "exit with code 1 when unused files, exports, or dependencies are found").option("--fail-on-cycles", "exit with code 1 when circular imports are found");
 const program = new Command();
 program.name("deslop").description("Find unused files, exports, dependencies, and circular imports in JavaScript projects").version(readPackageVersion(import.meta.url));
 addAnalyzeOptions(program).action(runAnalyzeAction);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deslop-cli",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "CLI for deslop-js — find unused files, exports, and dependencies",
   "keywords": [
     "cli",
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "commander": "^14.0.3",
-    "deslop-js": "0.0.20"
+    "deslop-js": "0.0.21"
   },
   "devDependencies": {
     "@types/node": "^25.6.0"