@mathonsunday/dead-code-toolkit 0.1.0

package/dist/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/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/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/config/detectors.js.map

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

package/dist/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/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/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/config/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/config/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,cAAc;QACtB,kBAAkB,EAAE;YAClB,aAAa,EAAE,kCAAkC;YACjD,YAAY,EAAE,iCAAiC;SAChD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,mDAAmD,EAAE,MAAM;QAC3D,mCAAmC,EAAE;YACnC,MAAM;YACN;gBACE,iBAAiB,EAAE,IAAI;gBACvB,iBAAiB,EAAE,IAAI;gBACvB,yBAAyB,EAAE,IAAI;aAChC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;GAiBN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAqB;IAC9D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,iBAAiB,EAAE;QAC3B,WAAW,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;QAChD,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;QAClB,mBAAmB,EAAE,IAAI;QACzB,MAAM,EAAE,IAAI;QACZ,aAAa,EAAE,KAAK;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAqB;IAClE,OAAO,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,aAAa,EAAE,CAAC,kBAAkB,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCF,CAAC;AACR,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,WAAW,EAAE,MAAM;QACnB,eAAe,EAAE,YAAY;QAC7B,mBAAmB,EAAE,2BAA2B;QAChD,eAAe,EAAE,iCAAiC;QAClD,aAAa,EAAE,4BAA4B;QAC3C,MAAM,EAAE,qEAAqE;KAC9E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE;QACJ,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE,sBAAsB;KAClC;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,qDAAqD;QAC/D,WAAW,EAAE,sCAAsC;QACnD,SAAS,EAAE,wBAAwB;KACpC;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EAAE,yCAAyC;QACtD,SAAS,EAAE,8BAA8B;KAC1C;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,oBAAoB;QAC9B,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE,4BAA4B;KACxC;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,mBAAmB;QAC7B,WAAW,EAAE,wBAAwB;QACrC,SAAS,EAAE,qBAAqB;KACjC;CACO,CAAC"}

package/dist/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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG7D,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * Main entry point for dead code toolkit
+ * Exports public API for programmatic usage
+ */
+// Core functions
+export { analyzeDeadCode, fixFindings } from './analyzer.js';
+// Reporters
+export { createJSONReport, formatJSONReport, formatJSONReportCompact, createLLMSummary, } from './reporters/jsonReporter.js';
+// Checkers (for advanced usage)
+export { runKnipCheck } from './checkers/knipChecker.js';
+export { runTypeScriptCheck } from './checkers/typescriptChecker.js';
+// Setup functions
+export { setupProject } from './setup/installer.js';
+// Config utilities (for advanced usage)
+export { detectProjectConfig, getEntryPoints, getProjectPatterns } from './config/detectors.js';
+export { generateKnipConfig, generateESLintRules, generateTypeCoverageConfig, generateLintStagedConfig, generatePackageJsonScripts, } from './config/templates.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiB7D,YAAY;AACZ,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,GAIjB,MAAM,6BAA6B,CAAC;AAErC,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,wCAAwC;AACxC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/reporters/jsonReporter.d.ts

@@ -0,0 +1,68 @@
+/**
+ * JSON reporter - formats analysis results as JSON for programmatic consumption
+ * Optimized for LLM interpretation
+ */
+import type { AnalysisResult } from '../types.js';
+export interface JSONReport {
+    version: '1.0';
+    timestamp: string;
+    status: AnalysisResult['status'];
+    summary: {
+        totalIssues: number;
+        fixableIssues: number;
+        byCategory: Record<string, number>;
+        bySeverity: {
+            errors: number;
+            warnings: number;
+            info: number;
+        };
+        executionTimeMs: number;
+    };
+    findings: JSONFinding[];
+    recommendations: string[];
+    checksRun: string[];
+}
+export interface JSONFinding {
+    id: string;
+    category: string;
+    severity: string;
+    file: string;
+    location?: {
+        line?: number;
+        column?: number;
+    };
+    message: string;
+    fixable: boolean;
+    suggestion?: string;
+    source: string;
+    rule?: string;
+}
+/**
+ * Convert analysis result to JSON report
+ */
+export declare function createJSONReport(result: AnalysisResult): JSONReport;
+/**
+ * Format JSON report as indented string for display
+ */
+export declare function formatJSONReport(report: JSONReport): string;
+/**
+ * Format JSON report as compact string for logging
+ */
+export declare function formatJSONReportCompact(report: JSONReport): string;
+/**
+ * Create a summary report for LLM consumption
+ */
+export interface LLMSummaryReport {
+    status: 'success' | 'failure' | 'partial' | 'clean';
+    totalIssues: number;
+    summary: string;
+    topIssues: Array<{
+        count: number;
+        type: string;
+        severity: string;
+        fixable: number;
+    }>;
+    actionItems: string[];
+}
+export declare function createLLMSummary(result: AnalysisResult): LLMSummaryReport;
+//# sourceMappingURL=jsonReporter.d.ts.map

package/dist/reporters/jsonReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/jsonReporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAoBnE;AAoFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA6CzE"}