@mathonsunday/dead-code-toolkit 0.1.0

package/dist/src/checkers/typescriptChecker.js

@@ -0,0 +1,174 @@
+/**
+ * TypeScript compiler integration for detecting type errors
+ * Uses tsc to compile and collect diagnostics
+ */
+import { execSync } from 'child_process';
+/**
+ * Run TypeScript type checking on a project
+ */
+export async function runTypeScriptCheck(projectRoot) {
+    const startTime = Date.now();
+    try {
+        // Check if TypeScript is available
+        if (!isTypeScriptInstalled()) {
+            return {
+                type: 'typescript',
+                status: 'skipped',
+                findings: [],
+                executionTime: Date.now() - startTime,
+                error: 'TypeScript not installed. Install with: npm install --save-dev typescript',
+            };
+        }
+        // Run tsc and capture diagnostics
+        const errors = await executeTypeScriptCheck(projectRoot);
+        // Convert to findings
+        const findings = parseTypeScriptErrors(errors);
+        return {
+            type: 'typescript',
+            status: findings.length > 0 ? 'success' : 'success',
+            findings,
+            executionTime: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            type: 'typescript',
+            status: 'failure',
+            findings: [],
+            executionTime: Date.now() - startTime,
+            error: `TypeScript check failed: ${message}`,
+        };
+    }
+}
+/**
+ * Check if TypeScript is installed
+ */
+function isTypeScriptInstalled() {
+    try {
+        execSync('npm list typescript 2>/dev/null', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Execute TypeScript compiler and capture errors
+ */
+async function executeTypeScriptCheck(projectRoot) {
+    try {
+        // Run tsc with noEmit to check types without emitting
+        // The command may exit with non-zero code if errors found
+        execSync('npx tsc --noEmit 2>&1', {
+            cwd: projectRoot,
+            stdio: 'pipe',
+        });
+        // If we got here, no errors
+        return [];
+    }
+    catch (error) {
+        // Parse the error output
+        const output = error instanceof Error && 'stdout' in error
+            ? error.stdout?.toString() ||
+                error.message
+            : String(error);
+        return parseTypeScriptOutput(output);
+    }
+}
+/**
+ * Parse TypeScript compiler output into structured errors
+ * Format: file.ts:line:col - error TS1234: message
+ */
+function parseTypeScriptOutput(output) {
+    const errors = [];
+    const lines = output.split('\n');
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        // Match TypeScript error format: file:line:col - error TSxxxx: message
+        const match = line.match(/^(.+):(\d+):(\d+)\s*-\s*(error|warning)\s*TS(\d+):\s*(.+)$/);
+        if (match) {
+            const [, file, lineStr, colStr, severity, code, message] = match;
+            errors.push({
+                file,
+                line: parseInt(lineStr, 10),
+                column: parseInt(colStr, 10),
+                code: parseInt(code, 10),
+                message,
+                severity: severity || 'error',
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Convert TypeScript errors to standardized Finding format
+ */
+function parseTypeScriptErrors(errors) {
+    return errors
+        .map((error) => {
+        // Map common TypeScript error codes
+        const category = mapTypeScriptErrorCode(error.code);
+        return {
+            category,
+            severity: error.severity === 'error' ? 'error' : 'warning',
+            file: error.file,
+            line: error.line,
+            column: error.column,
+            message: error.message,
+            fixable: isTypeScriptFixable(),
+            suggestion: getTypeScriptSuggestion(error.code),
+            source: 'typescript',
+            rule: `TS${error.code}`,
+        };
+    })
+        .filter((f) => 
+    // Filter to only type-related errors that are relevant to dead code
+    f.rule !== 'TS6133' && // "is declared but never used" - covered by other tools
+        f.rule !== 'TS6138' // "are declared but never used" - covered by other tools
+    );
+}
+/**
+ * Map TypeScript error code to dead code category
+ */
+function mapTypeScriptErrorCode(code) {
+    // 6133: variable declared but never used
+    // 6138: variables never used
+    // 7006: parameter never used
+    // 18004: type never used
+    // 2304: name not found
+    // 2307: cannot find module
+    if (code === 6133 || code === 6138)
+        return 'unused-var';
+    if (code === 7006)
+        return 'unused-param';
+    if (code === 18004)
+        return 'unused-export';
+    if (code === 2304 || code === 2307)
+        return 'type-error';
+    return 'type-error';
+}
+/**
+ * Check if TypeScript error can be auto-fixed
+ */
+function isTypeScriptFixable() {
+    // Some TypeScript errors could theoretically be fixed
+    // but we'll be conservative and only mark known fixable ones
+    return false; // Default: not fixable via automation
+}
+/**
+ * Get suggestion for fixing TypeScript error
+ */
+function getTypeScriptSuggestion(code) {
+    const suggestions = {
+        6133: 'Remove the variable or use it in your code',
+        6138: 'Remove unused variables or use them',
+        7006: 'Remove the parameter or use it in the function',
+        18004: 'Remove the type definition or use it',
+        2304: 'Check that this name is defined and imported correctly',
+        2307: 'Verify the module path and that the package is installed',
+    };
+    return suggestions[code] || 'Fix this TypeScript error';
+}
+//# sourceMappingURL=typescriptChecker.js.map

package/dist/src/checkers/typescriptChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescriptChecker.js","sourceRoot":"","sources":["../../../src/checkers/typescriptChecker.ts"],"names":[],"mappings":"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"}

package/dist/src/config/detectors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Project structure detection
+ * Auto-detects project type and configuration
+ */
+import type { ProjectConfig } from '../types.js';
+/**
+ * Detect project configuration and type
+ */
+export declare function detectProjectConfig(projectRoot: string): ProjectConfig;
+/**
+ * Get entry points for a project based on its type
+ */
+export declare function getEntryPoints(config: ProjectConfig): string[];
+/**
+ * Get project source patterns for Knip
+ */
+export declare function getProjectPatterns(config: ProjectConfig): string[];
+/**
+ * Get ignore patterns for Knip
+ */
+export declare function getIgnorePatterns(): string[];
+/**
+ * Get ESLint paths configuration
+ */
+export declare function getESLintPaths(config: ProjectConfig): {
+    include: string[];
+    exclude: string[];
+};
+//# sourceMappingURL=detectors.d.ts.map

package/dist/src/config/detectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.d.ts","sourceRoot":"","sources":["../../../src/config/detectors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA8EtE;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAiC9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAqBlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAY5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAK9F"}

package/dist/src/config/detectors.js

@@ -0,0 +1,159 @@
+/**
+ * Project structure detection
+ * Auto-detects project type and configuration
+ */
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Detect project configuration and type
+ */
+export function detectProjectConfig(projectRoot) {
+    const config = {
+        root: projectRoot,
+        hasPackageJson: false,
+        hasTypeScript: false,
+        type: 'unknown',
+        existingConfigs: {},
+    };
+    // Check for package.json
+    const packageJsonPath = resolve(projectRoot, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        config.hasPackageJson = true;
+        try {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            // Check for React
+            if (packageJson.dependencies?.react || packageJson.devDependencies?.react) {
+                config.type = 'react';
+            }
+            // Check for Node.js frameworks
+            else if (packageJson.dependencies?.express ||
+                packageJson.dependencies?.fastify ||
+                packageJson.dependencies?.['next.js'] ||
+                packageJson.dependencies?.nest ||
+                packageJson.devDependencies?.['@nestjs/core']) {
+                config.type = 'node';
+            }
+            // Default to Node for backend-only projects
+            else if (packageJson.type === 'module' && !packageJson.dependencies?.react) {
+                config.type = 'node';
+            }
+            // Check if it's a monorepo
+            if (packageJson.workspaces) {
+                config.type = 'fullstack';
+            }
+        }
+        catch (_error) {
+            // Ignore parsing errors
+        }
+    }
+    // Check for TypeScript
+    const tsconfigPath = resolve(projectRoot, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        config.hasTypeScript = true;
+        config.tsconfigPath = tsconfigPath;
+    }
+    // Detect existing configs
+    const configFiles = [
+        { key: 'eslint', names: ['.eslintrc.js', '.eslintrc.json', 'eslint.config.js'] },
+        { key: 'prettier', names: ['.prettierrc', '.prettierrc.js', 'prettier.config.js'] },
+        { key: 'knip', names: ['knip.json'] },
+        { key: 'husky', names: ['.husky'] },
+    ];
+    for (const { key, names } of configFiles) {
+        for (const name of names) {
+            const path = resolve(projectRoot, name);
+            if (existsSync(path)) {
+                config.existingConfigs[key] = path;
+                break;
+            }
+        }
+    }
+    // If no type detected, infer from structure
+    if (config.type === 'unknown') {
+        if (hasSrcDirectory(projectRoot)) {
+            config.type = config.hasPackageJson ? 'node' : 'unknown';
+        }
+    }
+    return config;
+}
+/**
+ * Check if project has a src directory
+ */
+function hasSrcDirectory(projectRoot) {
+    return existsSync(resolve(projectRoot, 'src'));
+}
+/**
+ * Get entry points for a project based on its type
+ */
+export function getEntryPoints(config) {
+    const entry = [];
+    const root = config.root;
+    switch (config.type) {
+        case 'react':
+            entry.push('src/main.ts', 'src/main.tsx', 'src/index.ts', 'src/index.tsx');
+            break;
+        case 'node':
+            // Common Node.js entry points
+            entry.push('src/index.ts', 'src/main.ts', 'dist/index.js', 'index.ts', 'api/index.ts');
+            break;
+        case 'fullstack':
+            // Monorepo: pick sensible defaults
+            entry.push('src/main.ts', 'src/index.ts', 'api/index.ts', 'backend/src/index.ts');
+            break;
+        default:
+            // Fallback
+            entry.push('src/index.ts', 'index.ts');
+    }
+    // Filter to entries that exist
+    const existingEntries = entry.filter((e) => existsSync(resolve(root, e)));
+    // If nothing found, add default globs
+    if (existingEntries.length === 0) {
+        existingEntries.push('src/index.ts');
+    }
+    return existingEntries;
+}
+/**
+ * Get project source patterns for Knip
+ */
+export function getProjectPatterns(config) {
+    const patterns = [];
+    switch (config.type) {
+        case 'react':
+            patterns.push('src/**/*.{ts,tsx}');
+            break;
+        case 'node':
+            patterns.push('src/**/*.ts', 'api/**/*.ts', 'lib/**/*.ts');
+            break;
+        case 'fullstack':
+            patterns.push('src/**/*.{ts,tsx}', 'api/**/*.ts', 'backend/**/*.ts');
+            break;
+        default:
+            patterns.push('**/*.ts', '**/*.tsx');
+    }
+    return patterns;
+}
+/**
+ * Get ignore patterns for Knip
+ */
+export function getIgnorePatterns() {
+    return [
+        'dist/**',
+        'build/**',
+        'node_modules/**',
+        '**/*.d.ts',
+        '**/node_modules/**',
+        '.next/**',
+        'out/**',
+        'coverage/**',
+        '.git/**',
+    ];
+}
+/**
+ * Get ESLint paths configuration
+ */
+export function getESLintPaths(config) {
+    const include = getProjectPatterns(config);
+    const exclude = getIgnorePatterns();
+    return { include, exclude };
+}
+//# sourceMappingURL=detectors.js.map

package/dist/src/config/detectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.js","sourceRoot":"","sources":["../../../src/config/detectors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,MAAM,GAAkB;QAC5B,IAAI,EAAE,WAAW;QACjB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;QACpB,IAAI,EAAE,SAAS;QACf,eAAe,EAAE,EAAE;KACpB,CAAC;IAEF,yBAAyB;IACzB,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YAEvE,kBAAkB;YAClB,IAAI,WAAW,CAAC,YAAY,EAAE,KAAK,IAAI,WAAW,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC;gBAC1E,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;YACxB,CAAC;YACD,+BAA+B;iBAC1B,IACH,WAAW,CAAC,YAAY,EAAE,OAAO;gBACjC,WAAW,CAAC,YAAY,EAAE,OAAO;gBACjC,WAAW,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC;gBACrC,WAAW,CAAC,YAAY,EAAE,IAAI;gBAC9B,WAAW,CAAC,eAAe,EAAE,CAAC,cAAc,CAAC,EAC7C,CAAC;gBACD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;YACvB,CAAC;YACD,4CAA4C;iBACvC,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC;gBAC3E,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;YACvB,CAAC;YAED,2BAA2B;YAC3B,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,GAAG,WAAW,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,0BAA0B;IAC1B,MAAM,WAAW,GAAG;QAClB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE;QAChF,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,EAAE;QACnF,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE;QACrC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;KACpC,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACnC,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;YAC3E,MAAM;QAER,KAAK,MAAM;YACT,8BAA8B;YAC9B,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;YACvF,MAAM;QAER,KAAK,WAAW;YACd,mCAAmC;YACnC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,CAAC,CAAC;YAClF,MAAM;QAER;YACE,WAAW;YACX,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,+BAA+B;IAC/B,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1E,sCAAsC;IACtC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACnC,MAAM;QAER,KAAK,MAAM;YACT,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;YAC3D,MAAM;QAER,KAAK,WAAW;YACd,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC;YACrE,MAAM;QAER;YACE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,WAAW;QACX,oBAAoB;QACpB,UAAU;QACV,QAAQ;QACR,aAAa;QACb,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/src/config/templates.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Configuration file templates
+ * Generates default configs for Knip, ESLint, etc.
+ */
+import type { ProjectConfig } from '../types.js';
+/**
+ * Generate knip.json configuration
+ */
+export declare function generateKnipConfig(config: ProjectConfig): Record<string, unknown>;
+/**
+ * Generate knip.json as JSON string
+ */
+export declare function generateKnipConfigJSON(config: ProjectConfig): string;
+/**
+ * Generate ESLint configuration partial (rules to add)
+ */
+export declare function generateESLintRules(): Record<string, unknown>;
+/**
+ * Generate ESLint configuration as JavaScript code
+ */
+export declare function generateESLintConfigCode(): string;
+/**
+ * Generate typecoveragerc.json configuration
+ */
+export declare function generateTypeCoverageConfig(config: ProjectConfig): Record<string, unknown>;
+/**
+ * Generate typecoveragerc.json as JSON string
+ */
+export declare function generateTypeCoverageConfigJSON(config: ProjectConfig): string;
+/**
+ * Generate .lintstagedrc.json configuration
+ */
+export declare function generateLintStagedConfig(): Record<string, unknown>;
+/**
+ * Generate .lintstagedrc.json as JSON string
+ */
+export declare function generateLintStagedConfigJSON(): string;
+/**
+ * Generate pre-commit hook script
+ */
+export declare function generatePreCommitHook(): string;
+/**
+ * Generate package.json scripts to add
+ */
+export declare function generatePackageJsonScripts(): Record<string, string>;
+/**
+ * Configuration templates metadata
+ */
+export declare const CONFIG_TEMPLATES: {
+    readonly knip: {
+        readonly filename: "knip.json";
+        readonly description: "Knip configuration for dead code detection";
+        readonly generator: typeof generateKnipConfigJSON;
+    };
+    readonly eslint: {
+        readonly filename: "eslint.config.js (partial - add to existing config)";
+        readonly description: "ESLint rules for dead code detection";
+        readonly generator: typeof generateESLintConfigCode;
+    };
+    readonly typeCoverage: {
+        readonly filename: "typecoveragerc.json";
+        readonly description: "Type coverage measurement configuration";
+        readonly generator: typeof generateTypeCoverageConfigJSON;
+    };
+    readonly lintStaged: {
+        readonly filename: ".lintstagedrc.json";
+        readonly description: "Lint-staged configuration for staged files";
+        readonly generator: typeof generateLintStagedConfigJSON;
+    };
+    readonly preCommit: {
+        readonly filename: ".husky/pre-commit";
+        readonly description: "Pre-commit hook script";
+        readonly generator: typeof generatePreCommitHook;
+    };
+};
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/config/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/config/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAmBjD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAuC9C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASnE;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnB,CAAC"}

package/dist/src/config/templates.js

@@ -0,0 +1,191 @@
+/**
+ * Configuration file templates
+ * Generates default configs for Knip, ESLint, etc.
+ */
+import { getEntryPoints, getProjectPatterns, getIgnorePatterns } from './detectors.js';
+/**
+ * Generate knip.json configuration
+ */
+export function generateKnipConfig(config) {
+    const entryPoints = getEntryPoints(config);
+    const patterns = getProjectPatterns(config);
+    const ignorePatterns = getIgnorePatterns();
+    return {
+        entry: entryPoints,
+        project: patterns,
+        ignore: ignorePatterns,
+        ignoreDependencies: [
+            '@types/node', // Type definitions are not "used"
+            'typescript', // Compiler is not "used" in code
+        ],
+    };
+}
+/**
+ * Generate knip.json as JSON string
+ */
+export function generateKnipConfigJSON(config) {
+    return JSON.stringify(generateKnipConfig(config), null, 2);
+}
+/**
+ * Generate ESLint configuration partial (rules to add)
+ */
+export function generateESLintRules() {
+    return {
+        '@typescript-eslint/no-redundant-type-constituents': 'warn',
+        '@typescript-eslint/no-unused-vars': [
+            'warn',
+            {
+                argsIgnorePattern: '^_',
+                varsIgnorePattern: '^_',
+                caughtErrorsIgnorePattern: '^_',
+            },
+        ],
+    };
+}
+/**
+ * Generate ESLint configuration as JavaScript code
+ */
+export function generateESLintConfigCode() {
+    return `// Add to eslint.config.js or update your existing config
+export default [
+  // ... existing configs ...
+  {
+    files: ['src/**/*.{ts,tsx}', 'api/**/*.ts'],
+    rules: {
+      '@typescript-eslint/no-redundant-type-constituents': 'warn',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+];`;
+}
+/**
+ * Generate typecoveragerc.json configuration
+ */
+export function generateTypeCoverageConfig(config) {
+    const patterns = getProjectPatterns(config);
+    return {
+        files: patterns,
+        ignore: getIgnorePatterns(),
+        ignoreFiles: ['**/*.d.ts', '**/node_modules/**'],
+        ignoreCatch: true,
+        skipLibCheck: true,
+        checkPropertyAccess: true,
+        strict: true,
+        suppressError: false,
+    };
+}
+/**
+ * Generate typecoveragerc.json as JSON string
+ */
+export function generateTypeCoverageConfigJSON(config) {
+    return JSON.stringify(generateTypeCoverageConfig(config), null, 2);
+}
+/**
+ * Generate .lintstagedrc.json configuration
+ */
+export function generateLintStagedConfig() {
+    return {
+        '*.{ts,tsx}': ['eslint --fix'],
+        '*.{json,md}': ['prettier --write'],
+    };
+}
+/**
+ * Generate .lintstagedrc.json as JSON string
+ */
+export function generateLintStagedConfigJSON() {
+    return JSON.stringify(generateLintStagedConfig(), null, 2);
+}
+/**
+ * Generate pre-commit hook script
+ */
+export function generatePreCommitHook() {
+    return `#!/bin/sh
+# Pre-commit hook for dead code and quality checks
+# Generated by @mathonsunday/dead-code-toolkit
+
+set -e
+
+echo "[Dead Code Toolkit] Running pre-commit checks..."
+
+# Stage 1: lint-staged (on staged files only)
+echo "[Stage 1/4] Running lint-staged (ESLint + Prettier)..."
+npx lint-staged || {
+  echo "❌ Lint-staged failed"
+  exit 1
+}
+
+# Stage 2: Full type check
+echo "[Stage 2/4] Running TypeScript type check..."
+npm run type-check || {
+  echo "❌ Type check failed"
+  exit 1
+}
+
+# Stage 3: Dead code detection (optional - doesn't block on failure)
+echo "[Stage 3/4] Checking for dead code..."
+npm run dead-code || {
+  echo "⚠️  Dead code detected. Consider running: npm run dead-code:fix"
+  # Don't exit - just warn
+}
+
+# Stage 4: Run tests
+echo "[Stage 4/4] Running tests..."
+npm test -- --run || {
+  echo "❌ Tests failed"
+  exit 1
+}
+
+echo "✅ All pre-commit checks passed!"
+exit 0`;
+}
+/**
+ * Generate package.json scripts to add
+ */
+export function generatePackageJsonScripts() {
+    return {
+        'dead-code': 'knip',
+        'dead-code:fix': 'knip --fix',
+        'dead-code:analyze': 'dead-code-toolkit analyze',
+        'type:coverage': 'type-coverage --detail --strict',
+        'type:report': 'typescript-coverage-report',
+        verify: 'npm run type-check && npm run lint && npm run dead-code && npm test',
+    };
+}
+/**
+ * Configuration templates metadata
+ */
+export const CONFIG_TEMPLATES = {
+    knip: {
+        filename: 'knip.json',
+        description: 'Knip configuration for dead code detection',
+        generator: generateKnipConfigJSON,
+    },
+    eslint: {
+        filename: 'eslint.config.js (partial - add to existing config)',
+        description: 'ESLint rules for dead code detection',
+        generator: generateESLintConfigCode,
+    },
+    typeCoverage: {
+        filename: 'typecoveragerc.json',
+        description: 'Type coverage measurement configuration',
+        generator: generateTypeCoverageConfigJSON,
+    },
+    lintStaged: {
+        filename: '.lintstagedrc.json',
+        description: 'Lint-staged configuration for staged files',
+        generator: generateLintStagedConfigJSON,
+    },
+    preCommit: {
+        filename: '.husky/pre-commit',
+        description: 'Pre-commit hook script',
+        generator: generatePreCommitHook,
+    },
+};
+//# sourceMappingURL=templates.js.map

package/dist/src/config/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/config/templates.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Main entry point for dead code toolkit
+ * Exports public API for programmatic usage
+ */
+export { analyzeDeadCode, fixFindings } from './analyzer.js';
+export type { AnalysisOptions, AnalysisResult, AnalysisSummary, CheckResult, CheckType, Finding, FixResult, FixDetail, SetupOptions, SetupResult, ProjectConfig, } from './types.js';
+export { createJSONReport, formatJSONReport, formatJSONReportCompact, createLLMSummary, type JSONReport, type JSONFinding, type LLMSummaryReport, } from './reporters/jsonReporter.js';
+export { runKnipCheck } from './checkers/knipChecker.js';
+export { runTypeScriptCheck } from './checkers/typescriptChecker.js';
+export { setupProject } from './setup/installer.js';
+export { detectProjectConfig, getEntryPoints, getProjectPatterns } from './config/detectors.js';
+export { generateKnipConfig, generateESLintRules, generateTypeCoverageConfig, generateLintStagedConfig, generatePackageJsonScripts, } from './config/templates.js';
+//# sourceMappingURL=index.d.ts.map