1#!/usr/bin/env python3
2"""
3TypeScript Project Diagnostic Script
4Analyzes TypeScript projects for configuration, performance, and common issues.
5"""
6 
7import subprocess
8import sys
9import os
10import json
11from pathlib import Path
12 
13def run_cmd(cmd: str) -> str:
14    """Run shell command and return output."""
15    try:
16        result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
17        return result.stdout + result.stderr
18    except Exception as e:
19        return str(e)
20 
21def check_versions():
22    """Check TypeScript and Node versions."""
23    print("\n📦 Versions:")
24    print("-" * 40)
25    
26    ts_version = run_cmd("npx tsc --version 2>/dev/null").strip()
27    node_version = run_cmd("node -v 2>/dev/null").strip()
28    
29    print(f"  TypeScript: {ts_version or 'Not found'}")
30    print(f"  Node.js: {node_version or 'Not found'}")
31 
32def check_tsconfig():
33    """Analyze tsconfig.json settings."""
34    print("\n⚙️ TSConfig Analysis:")
35    print("-" * 40)
36    
37    tsconfig_path = Path("tsconfig.json")
38    if not tsconfig_path.exists():
39        print("⚠️ tsconfig.json not found")
40        return
41    
42    try:
43        with open(tsconfig_path) as f:
44            config = json.load(f)
45        
46        compiler_opts = config.get("compilerOptions", {})
47        
48        # Check strict mode
49        if compiler_opts.get("strict"):
50            print("✅ Strict mode enabled")
51        else:
52            print("⚠️ Strict mode NOT enabled")
53        
54        # Check important flags
55        flags = {
56            "noUncheckedIndexedAccess": "Unchecked index access protection",
57            "noImplicitOverride": "Implicit override protection",
58            "skipLibCheck": "Skip lib check (performance)",
59            "incremental": "Incremental compilation"
60        }
61        
62        for flag, desc in flags.items():
63            status = "✅" if compiler_opts.get(flag) else "⚪"
64            print(f"  {status} {desc}: {compiler_opts.get(flag, 'not set')}")
65        
66        # Check module settings
67        print(f"\n  Module: {compiler_opts.get('module', 'not set')}")
68        print(f"  Module Resolution: {compiler_opts.get('moduleResolution', 'not set')}")
69        print(f"  Target: {compiler_opts.get('target', 'not set')}")
70        
71    except json.JSONDecodeError:
72        print("❌ Invalid JSON in tsconfig.json")
73 
74def check_tooling():
75    """Detect TypeScript tooling ecosystem."""
76    print("\n🛠️ Tooling Detection:")
77    print("-" * 40)
78    
79    pkg_path = Path("package.json")
80    if not pkg_path.exists():
81        print("⚠️ package.json not found")
82        return
83    
84    try:
85        with open(pkg_path) as f:
86            pkg = json.load(f)
87        
88        all_deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
89        
90        tools = {
91            "biome": "Biome (linter/formatter)",
92            "eslint": "ESLint",
93            "prettier": "Prettier",
94            "vitest": "Vitest (testing)",
95            "jest": "Jest (testing)",
96            "turborepo": "Turborepo (monorepo)",
97            "turbo": "Turbo (monorepo)",
98            "nx": "Nx (monorepo)",
99            "lerna": "Lerna (monorepo)"
100        }
101        
102        for tool, desc in tools.items():
103            for dep in all_deps:
104                if tool in dep.lower():
105                    print(f"  ✅ {desc}")
106                    break
107                    
108    except json.JSONDecodeError:
109        print("❌ Invalid JSON in package.json")
110 
111def check_monorepo():
112    """Check for monorepo configuration."""
113    print("\n📦 Monorepo Check:")
114    print("-" * 40)
115    
116    indicators = [
117        ("pnpm-workspace.yaml", "PNPM Workspace"),
118        ("lerna.json", "Lerna"),
119        ("nx.json", "Nx"),
120        ("turbo.json", "Turborepo")
121    ]
122    
123    found = False
124    for file, name in indicators:
125        if Path(file).exists():
126            print(f"  ✅ {name} detected")
127            found = True
128    
129    if not found:
130        print("  ⚪ No monorepo configuration detected")
131 
132def check_type_errors():
133    """Run quick type check."""
134    print("\n🔍 Type Check:")
135    print("-" * 40)
136    
137    result = run_cmd("npx tsc --noEmit 2>&1 | head -20")
138    if "error TS" in result:
139        errors = result.count("error TS")
140        print(f"  ❌ {errors}+ type errors found")
141        print(result[:500])
142    else:
143        print("  ✅ No type errors")
144 
145def check_any_usage():
146    """Check for any type usage."""
147    print("\n⚠️ 'any' Type Usage:")
148    print("-" * 40)
149    
150    result = run_cmd("grep -r ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | wc -l")
151    count = result.strip()
152    if count and count != "0":
153        print(f"  ⚠️ Found {count} occurrences of ': any'")
154        sample = run_cmd("grep -rn ': any' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | head -5")
155        if sample:
156            print(sample)
157    else:
158        print("  ✅ No explicit 'any' types found")
159 
160def check_type_assertions():
161    """Check for type assertions."""
162    print("\n⚠️ Type Assertions (as):")
163    print("-" * 40)
164    
165    result = run_cmd("grep -r ' as ' --include='*.ts' --include='*.tsx' src/ 2>/dev/null | grep -v 'import' | wc -l")
166    count = result.strip()
167    if count and count != "0":
168        print(f"  ⚠️ Found {count} type assertions")
169    else:
170        print("  ✅ No type assertions found")
171 
172def check_performance():
173    """Check type checking performance."""
174    print("\n⏱️ Type Check Performance:")
175    print("-" * 40)
176    
177    result = run_cmd("npx tsc --extendedDiagnostics --noEmit 2>&1 | grep -E 'Check time|Files:|Lines:|Nodes:'")
178    if result.strip():
179        for line in result.strip().split('\n'):
180            print(f"  {line}")
181    else:
182        print("  ⚠️ Could not measure performance")
183 
184def main():
185    print("=" * 50)
186    print("🔍 TypeScript Project Diagnostic Report")
187    print("=" * 50)
188    
189    check_versions()
190    check_tsconfig()
191    check_tooling()
192    check_monorepo()
193    check_any_usage()
194    check_type_assertions()
195    check_type_errors()
196    check_performance()
197    
198    print("\n" + "=" * 50)
199    print("✅ Diagnostic Complete")
200    print("=" * 50)
201 
202if __name__ == "__main__":
203    main()
204