deslop-js 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Million Software, Inc.
+
+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/dist/cli.cjs

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+const require_src = require('./src-wbNpmldQ.cjs');
+let node_path = require("node:path");
+
+//#region src/cli.ts
+const HELP_TEXT = `
+deslop - Dead code detector for TypeScript/JavaScript
+
+Usage:
+  deslop [options] [rootDir]
+
+Options:
+  --entry <pattern>       Entry point glob pattern (can be repeated)
+  --ignore <pattern>      Ignore glob pattern (can be repeated)
+  --tsconfig <path>       Path to tsconfig.json
+  --include-types         Include type-only exports in results
+  --include-entry-exports Include entry file exports in results
+  --json                  Output as JSON
+  --help                  Show this help message
+  --version               Show version
+
+Examples:
+  deslop
+  deslop ./my-project
+  deslop --entry "src/main.ts" --ignore "**/*.test.ts"
+  deslop --json > results.json
+`;
+const parseArguments = (argv) => {
+	const entries = [];
+	const ignores = [];
+	let rootDir = ".";
+	let tsconfig;
+	let includeTypes = false;
+	let includeEntryExports = false;
+	let outputJson = false;
+	let showHelp = false;
+	let showVersion = false;
+	let argumentIndex = 0;
+	while (argumentIndex < argv.length) {
+		const argument = argv[argumentIndex];
+		if (argument === "--help" || argument === "-h") showHelp = true;
+		else if (argument === "--version" || argument === "-v") showVersion = true;
+		else if (argument === "--entry" || argument === "-e") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) entries.push(argv[argumentIndex]);
+		} else if (argument === "--ignore" || argument === "-i") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) ignores.push(argv[argumentIndex]);
+		} else if (argument === "--tsconfig") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) tsconfig = argv[argumentIndex];
+		} else if (argument === "--include-types") includeTypes = true;
+		else if (argument === "--include-entry-exports") includeEntryExports = true;
+		else if (argument === "--json") outputJson = true;
+		else if (!argument.startsWith("-")) rootDir = argument;
+		argumentIndex++;
+	}
+	return {
+		rootDir,
+		entries,
+		ignores,
+		tsconfig,
+		includeTypes,
+		includeEntryExports,
+		outputJson,
+		showHelp,
+		showVersion
+	};
+};
+const formatResults = (analysisResult, rootDir) => {
+	const outputLines = [];
+	outputLines.push(`\n  deslop analysis complete\n`);
+	outputLines.push(`  Scanned ${analysisResult.totalFiles} files with ${analysisResult.totalExports} exports in ${analysisResult.analysisTimeMs.toFixed(0)}ms\n`);
+	if (analysisResult.unusedFiles.length > 0) {
+		outputLines.push(`  Unused files (${analysisResult.unusedFiles.length}):`);
+		for (const unusedFile of analysisResult.unusedFiles) outputLines.push(`    ${(0, node_path.relative)(rootDir, unusedFile.path)}`);
+		outputLines.push("");
+	}
+	if (analysisResult.unusedExports.length > 0) {
+		outputLines.push(`  Unused exports (${analysisResult.unusedExports.length}):`);
+		for (const unusedExport of analysisResult.unusedExports) {
+			const relativePath = (0, node_path.relative)(rootDir, unusedExport.path);
+			const typeLabel = unusedExport.isTypeOnly ? " (type)" : "";
+			outputLines.push(`    ${relativePath}:${unusedExport.line}  ${unusedExport.name}${typeLabel}`);
+		}
+		outputLines.push("");
+	}
+	if (analysisResult.unusedDependencies.length > 0) {
+		outputLines.push(`  Unused dependencies (${analysisResult.unusedDependencies.length}):`);
+		for (const unusedDependency of analysisResult.unusedDependencies) {
+			const devLabel = unusedDependency.isDevDependency ? " (dev)" : "";
+			outputLines.push(`    ${unusedDependency.name}${devLabel}`);
+		}
+		outputLines.push("");
+	}
+	if (analysisResult.circularDependencies.length > 0) {
+		outputLines.push(`  Circular dependencies (${analysisResult.circularDependencies.length}):`);
+		for (const cycle of analysisResult.circularDependencies) {
+			const relativePaths = cycle.files.map((filePath) => (0, node_path.relative)(rootDir, filePath));
+			outputLines.push(`    ${relativePaths.join(" → ")} → ${relativePaths[0]}`);
+		}
+		outputLines.push("");
+	}
+	const totalIssueCount = analysisResult.unusedFiles.length + analysisResult.unusedExports.length + analysisResult.unusedDependencies.length + analysisResult.circularDependencies.length;
+	if (totalIssueCount === 0) outputLines.push("  No dead code found!\n");
+	else outputLines.push(`  Total issues: ${totalIssueCount}\n`);
+	return outputLines.join("\n");
+};
+const main = async () => {
+	const cliArguments = parseArguments(process.argv.slice(2));
+	if (cliArguments.showHelp) {
+		process.stdout.write(HELP_TEXT);
+		process.exit(0);
+	}
+	if (cliArguments.showVersion) {
+		process.stdout.write("deslop 0.1.0\n");
+		process.exit(0);
+	}
+	const rootDir = (0, node_path.resolve)(cliArguments.rootDir);
+	const config = require_src.createConfig({
+		rootDir,
+		entryPatterns: cliArguments.entries.length > 0 ? cliArguments.entries : void 0,
+		ignorePatterns: cliArguments.ignores.length > 0 ? cliArguments.ignores : void 0,
+		tsConfigPath: cliArguments.tsconfig,
+		reportTypes: cliArguments.includeTypes,
+		includeEntryExports: cliArguments.includeEntryExports
+	});
+	try {
+		const analysisResult = await require_src.analyze(config);
+		const outputContent = cliArguments.outputJson ? JSON.stringify(analysisResult, null, 2) + "\n" : formatResults(analysisResult, rootDir);
+		const exitCode = analysisResult.unusedFiles.length + analysisResult.unusedExports.length + analysisResult.unusedDependencies.length + analysisResult.circularDependencies.length > 0 ? 1 : 0;
+		if (process.stdout.write(outputContent)) process.exit(exitCode);
+		else process.stdout.once("drain", () => process.exit(exitCode));
+	} catch (error) {
+		process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
+		process.exit(2);
+	}
+};
+main();
+
+//#endregion

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { n as createConfig, t as analyze } from "./src-BIp8ek0h.mjs";
+import { relative, resolve } from "node:path";
+
+//#region src/cli.ts
+const HELP_TEXT = `
+deslop - Dead code detector for TypeScript/JavaScript
+
+Usage:
+  deslop [options] [rootDir]
+
+Options:
+  --entry <pattern>       Entry point glob pattern (can be repeated)
+  --ignore <pattern>      Ignore glob pattern (can be repeated)
+  --tsconfig <path>       Path to tsconfig.json
+  --include-types         Include type-only exports in results
+  --include-entry-exports Include entry file exports in results
+  --json                  Output as JSON
+  --help                  Show this help message
+  --version               Show version
+
+Examples:
+  deslop
+  deslop ./my-project
+  deslop --entry "src/main.ts" --ignore "**/*.test.ts"
+  deslop --json > results.json
+`;
+const parseArguments = (argv) => {
+	const entries = [];
+	const ignores = [];
+	let rootDir = ".";
+	let tsconfig;
+	let includeTypes = false;
+	let includeEntryExports = false;
+	let outputJson = false;
+	let showHelp = false;
+	let showVersion = false;
+	let argumentIndex = 0;
+	while (argumentIndex < argv.length) {
+		const argument = argv[argumentIndex];
+		if (argument === "--help" || argument === "-h") showHelp = true;
+		else if (argument === "--version" || argument === "-v") showVersion = true;
+		else if (argument === "--entry" || argument === "-e") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) entries.push(argv[argumentIndex]);
+		} else if (argument === "--ignore" || argument === "-i") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) ignores.push(argv[argumentIndex]);
+		} else if (argument === "--tsconfig") {
+			argumentIndex++;
+			if (argumentIndex < argv.length) tsconfig = argv[argumentIndex];
+		} else if (argument === "--include-types") includeTypes = true;
+		else if (argument === "--include-entry-exports") includeEntryExports = true;
+		else if (argument === "--json") outputJson = true;
+		else if (!argument.startsWith("-")) rootDir = argument;
+		argumentIndex++;
+	}
+	return {
+		rootDir,
+		entries,
+		ignores,
+		tsconfig,
+		includeTypes,
+		includeEntryExports,
+		outputJson,
+		showHelp,
+		showVersion
+	};
+};
+const formatResults = (analysisResult, rootDir) => {
+	const outputLines = [];
+	outputLines.push(`\n  deslop analysis complete\n`);
+	outputLines.push(`  Scanned ${analysisResult.totalFiles} files with ${analysisResult.totalExports} exports in ${analysisResult.analysisTimeMs.toFixed(0)}ms\n`);
+	if (analysisResult.unusedFiles.length > 0) {
+		outputLines.push(`  Unused files (${analysisResult.unusedFiles.length}):`);
+		for (const unusedFile of analysisResult.unusedFiles) outputLines.push(`    ${relative(rootDir, unusedFile.path)}`);
+		outputLines.push("");
+	}
+	if (analysisResult.unusedExports.length > 0) {
+		outputLines.push(`  Unused exports (${analysisResult.unusedExports.length}):`);
+		for (const unusedExport of analysisResult.unusedExports) {
+			const relativePath = relative(rootDir, unusedExport.path);
+			const typeLabel = unusedExport.isTypeOnly ? " (type)" : "";
+			outputLines.push(`    ${relativePath}:${unusedExport.line}  ${unusedExport.name}${typeLabel}`);
+		}
+		outputLines.push("");
+	}
+	if (analysisResult.unusedDependencies.length > 0) {
+		outputLines.push(`  Unused dependencies (${analysisResult.unusedDependencies.length}):`);
+		for (const unusedDependency of analysisResult.unusedDependencies) {
+			const devLabel = unusedDependency.isDevDependency ? " (dev)" : "";
+			outputLines.push(`    ${unusedDependency.name}${devLabel}`);
+		}
+		outputLines.push("");
+	}
+	if (analysisResult.circularDependencies.length > 0) {
+		outputLines.push(`  Circular dependencies (${analysisResult.circularDependencies.length}):`);
+		for (const cycle of analysisResult.circularDependencies) {
+			const relativePaths = cycle.files.map((filePath) => relative(rootDir, filePath));
+			outputLines.push(`    ${relativePaths.join(" → ")} → ${relativePaths[0]}`);
+		}
+		outputLines.push("");
+	}
+	const totalIssueCount = analysisResult.unusedFiles.length + analysisResult.unusedExports.length + analysisResult.unusedDependencies.length + analysisResult.circularDependencies.length;
+	if (totalIssueCount === 0) outputLines.push("  No dead code found!\n");
+	else outputLines.push(`  Total issues: ${totalIssueCount}\n`);
+	return outputLines.join("\n");
+};
+const main = async () => {
+	const cliArguments = parseArguments(process.argv.slice(2));
+	if (cliArguments.showHelp) {
+		process.stdout.write(HELP_TEXT);
+		process.exit(0);
+	}
+	if (cliArguments.showVersion) {
+		process.stdout.write("deslop 0.1.0\n");
+		process.exit(0);
+	}
+	const rootDir = resolve(cliArguments.rootDir);
+	const config = createConfig({
+		rootDir,
+		entryPatterns: cliArguments.entries.length > 0 ? cliArguments.entries : void 0,
+		ignorePatterns: cliArguments.ignores.length > 0 ? cliArguments.ignores : void 0,
+		tsConfigPath: cliArguments.tsconfig,
+		reportTypes: cliArguments.includeTypes,
+		includeEntryExports: cliArguments.includeEntryExports
+	});
+	try {
+		const analysisResult = await analyze(config);
+		const outputContent = cliArguments.outputJson ? JSON.stringify(analysisResult, null, 2) + "\n" : formatResults(analysisResult, rootDir);
+		const exitCode = analysisResult.unusedFiles.length + analysisResult.unusedExports.length + analysisResult.unusedDependencies.length + analysisResult.circularDependencies.length > 0 ? 1 : 0;
+		if (process.stdout.write(outputContent)) process.exit(exitCode);
+		else process.stdout.once("drain", () => process.exit(exitCode));
+	} catch (error) {
+		process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
+		process.exit(2);
+	}
+};
+main();
+
+//#endregion
+export {  };