@m4x_7/type-debt 1.0.0

package/constants.ts

@@ -0,0 +1,15 @@
+export const CONSTANTS = {
+
+    CHUNK_SIZE: 50,
+
+    TYPE_DEBT_METRICS:{
+        EXPLICIT_ANY_WEIGHT: 2,
+        IMPLICIT_ANY_WEIGHT: 3,
+        AS_ANY_WEIGHT: 2,
+        SUPPRESSION_WEIGHT: 4,
+        NON_NULL_ASSERTION_WEIGHT: 1,
+    },
+
+} as const;
+
+

package/core/chunkProcessor.ts

@@ -0,0 +1,27 @@
+import { Project } from "ts-morph";
+import { getTypeDebt } from "./typeDebt";
+import { FileReport } from "../types";
+
+
+export function processChunk(chunk: string[]): FileReport[] {
+  
+  const project = new Project({ skipAddingFilesFromTsConfig: true });
+  project.addSourceFilesAtPaths(chunk);
+
+  const chunkResults: FileReport[] = [];
+
+  project.forgetNodesCreatedInBlock(() => {
+    for (const file of project.getSourceFiles()) {
+      chunkResults.push({
+        filePath: file.getFilePath(),
+        typeDebtMetrics: getTypeDebt(file)
+      });
+    }
+  });
+
+  for (const file of project.getSourceFiles()) {
+    project.removeSourceFile(file);
+  }
+
+  return chunkResults;
+} 

package/core/reporter.ts

@@ -0,0 +1,46 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { FileReport } from "../types"
+
+
+export async function generateMarkdownReport(results: FileReport[], targetDir: string, outputPath = "type-debt-report.md") {
+  if (results.length === 0) return;
+
+  const totalFiles = results.length;
+  const totalScore = results.reduce((acc, curr) => acc + curr.typeDebtMetrics.score, 0);
+  const averageScore = Math.round(totalScore / totalFiles);
+
+  const sortedResults = [...results].sort((a, b) =>
+    a.typeDebtMetrics.score - b.typeDebtMetrics.score
+  );
+
+  let md = `Type Debt Report\n\n`;
+  md += `> Generated on: ${new Date().toUTCString()}\n\n`;
+
+  md += `## Summary\n`;
+  md += `- Total Files Scanned: ${totalFiles}\n`;
+  md += `- Average Score: ${averageScore}/100\n\n`;
+
+  md += `## Top 10 Worst Offenders\n\n`;
+
+  md += `| Score | File Path | Suppressions | Implicit \`any\` | Explicit \`any\` | \`as any\` | Non-Null (\`!\`) |\n`;
+
+  md += `| :---: | :--- | :---: | :---: | :---: | :---: | :---: |\n`;
+
+  const worstOffenders = sortedResults.slice(0, 10);
+
+  const absoluteTargetDir = path.resolve(targetDir);
+
+  for (const result of worstOffenders) {
+    const metrics = result.typeDebtMetrics;
+    const cleanPath = path.relative(absoluteTargetDir, result.filePath);
+    md += `| ${metrics.score} | \`${cleanPath}\` | ${metrics.suppressions} | ${metrics.implicitAny} | ${metrics.explicitAny} | ${metrics.asAny} | ${metrics.nonNullAssertions} |\n`;
+  }
+
+  try {
+    await fs.writeFile(outputPath, md, "utf-8");
+    console.log(`\nMarkdown report successfully generated at: ${outputPath}`);
+  } catch (error) {
+    console.error(`\nFailed to write Markdown report:`, error);
+  }
+}

package/core/typeDebt.ts

@@ -0,0 +1,125 @@
+import { SourceFile, SyntaxKind } from "ts-morph";
+import { TypeDebtMetrics } from "../types";
+import { CONSTANTS } from "../constants";
+
+
+const SUPPRESSION_REGEX = /(?:\/\/|\/\*)\s*@ts-(ignore|expect-error|nocheck)/g;
+
+export function getTypeDebt(sourceFile: SourceFile): TypeDebtMetrics {
+
+  const metrics: TypeDebtMetrics = {
+    explicitAny: 0,
+    implicitAny: 0,
+    asAny: 0,
+    suppressions: 0,
+    nonNullAssertions: 0,
+    validTypes: 0,
+    score: 0
+  }
+
+  sourceFile.forEachDescendant(node => {
+
+    const kind = node.getKind();
+
+    // explicit any
+    if (kind === SyntaxKind.AnyKeyword) {
+      const parent = node.getParent();
+      if (parent?.getKind() !== SyntaxKind.AsExpression) {
+        metrics.explicitAny++;
+      }
+    }
+
+    // as any
+    else if (kind === SyntaxKind.AsExpression) {
+
+      const asExpression = node.asKindOrThrow(SyntaxKind.AsExpression);
+
+      if (asExpression.getTypeNode()?.getKind() === SyntaxKind.AnyKeyword) {
+        metrics.asAny++;
+      }
+
+    }
+
+    // implicit any 
+    if (kind === SyntaxKind.Parameter) {
+      const parameter = node.asKindOrThrow(SyntaxKind.Parameter);
+
+      if (!parameter.getTypeNode() && !parameter.getInitializer()) {
+        const parentFunction = parameter.getParent();
+        const grandParent = parentFunction?.getParent();
+
+        // Ignore parameters in callbacks (e.g., .map(item => ...))
+        const isCallback =
+          (parentFunction?.getKind() === SyntaxKind.ArrowFunction ||
+            parentFunction?.getKind() === SyntaxKind.FunctionExpression) &&
+          grandParent?.getKind() === SyntaxKind.CallExpression;
+
+        if (!isCallback) {
+          metrics.implicitAny++;
+        }
+      }
+    }
+
+    // not null expression
+    if (kind === SyntaxKind.NonNullExpression) {
+      metrics.nonNullAssertions++;
+    }
+
+
+    // valid types
+    else if (isValidType(kind)) {
+      metrics.validTypes++;
+    }
+
+  });
+
+  //suppressions
+  const text = sourceFile.getFullText();
+  const matches = text.match(SUPPRESSION_REGEX);
+  metrics.suppressions = matches ? matches.length : 0;
+
+  metrics.score = calculateScore(metrics);
+
+  return metrics;
+}
+
+export function calculateScore(metrics: TypeDebtMetrics): number {
+
+  const totalDebtInstances =
+    metrics.explicitAny +
+    metrics.implicitAny +
+    metrics.asAny +
+    metrics.suppressions +
+    metrics.nonNullAssertions;
+
+  const totalTypeNodes = metrics.validTypes + totalDebtInstances;
+
+  if (totalTypeNodes == 0) {
+    return 100;
+  }
+
+  else {
+    const baseScore = (metrics.validTypes / totalTypeNodes) * 100;
+    const rawPenalty = calculatePenalty(metrics);
+    const scaledPenalty = (rawPenalty / totalTypeNodes) * 100;
+    return Math.max(0, Math.round(baseScore - scaledPenalty));
+  }
+
+}
+
+export function calculatePenalty(metrics: TypeDebtMetrics): number {
+  return metrics.explicitAny * CONSTANTS.TYPE_DEBT_METRICS.EXPLICIT_ANY_WEIGHT
+    + metrics.implicitAny * CONSTANTS.TYPE_DEBT_METRICS.IMPLICIT_ANY_WEIGHT
+    + metrics.asAny * CONSTANTS.TYPE_DEBT_METRICS.AS_ANY_WEIGHT
+    + metrics.nonNullAssertions * CONSTANTS.TYPE_DEBT_METRICS.NON_NULL_ASSERTION_WEIGHT
+    + metrics.suppressions * CONSTANTS.TYPE_DEBT_METRICS.SUPPRESSION_WEIGHT;
+}
+
+function isValidType(kind: SyntaxKind): boolean {
+  return (kind === SyntaxKind.TypeReference ||
+    kind === SyntaxKind.StringKeyword ||
+    kind === SyntaxKind.NumberKeyword ||
+    kind === SyntaxKind.BooleanKeyword ||
+    kind === SyntaxKind.InterfaceDeclaration ||
+    kind === SyntaxKind.TypeAliasDeclaration);
+}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+var X=Object.defineProperty;var P=Object.getOwnPropertySymbols;var Z=Object.prototype.hasOwnProperty,V=Object.prototype.propertyIsEnumerable;var A=(t,e,s)=>e in t?X(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s,w=(t,e)=>{for(var s in e||(e={}))Z.call(e,s)&&A(t,s,e[s]);if(P)for(var s of P(e))V.call(e,s)&&A(t,s,e[s]);return t};var c=(t,e,s)=>A(t,typeof e!="symbol"?e+"":e,s);var S=(t,e,s)=>new Promise((r,i)=>{var o=u=>{try{n(s.next(u))}catch(h){i(h)}},l=u=>{try{n(s.throw(u))}catch(h){i(h)}},n=u=>u.done?r(u.value):Promise.resolve(u.value).then(o,l);n((s=s.apply(t,e)).next())});import{createRequire as J}from"module";import{basename as tt,dirname as k,normalize as et,relative as st,resolve as rt,sep as I}from"path";import*as it from"fs";var Vt={};var _=J(Vt.url);function nt(t){let e=et(t);return e.length>1&&e[e.length-1]===I&&(e=e.substring(0,e.length-1)),e}var ot=/[\\/]/g;function R(t,e){return t.replace(ot,e)}var lt=/^[a-z]:[\\/]$/i;function ut(t){return t==="/"||lt.test(t)}function F(t,e){let{resolvePaths:s,normalizePath:r,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(s&&(t=rt(t)),(r||o)&&(t=nt(t)),t===".")return"";let l=t[t.length-1]!==i;return R(l?t+i:t,i)}function C(t,e){return e+t}function ct(t,e){return function(s,r){return r.startsWith(t)?r.slice(t.length)+s:R(st(t,r),e.pathSeparator)+e.pathSeparator+s}}function at(t){return t}function ht(t,e,s){return e+t+s}function pt(t,e){let{relativePaths:s,includeBasePath:r}=e;return s&&t?ct(t,e):r?C:at}function ft(t){return function(e,s){s.push(e.substring(t.length)||".")}}function yt(t){return function(e,s,r){let i=e.substring(t.length)||".";r.every(o=>o(i,!0))&&s.push(i)}}var mt=(t,e)=>{e.push(t||".")},gt=(t,e,s)=>{let r=t||".";s.every(i=>i(r,!0))&&e.push(r)},dt=()=>{};function St(t,e){let{includeDirs:s,filters:r,relativePaths:i}=e;return s?i?r&&r.length?yt(t):ft(t):r&&r.length?gt:mt:dt}var wt=(t,e,s,r)=>{r.every(i=>i(t,!1))&&s.files++},Tt=(t,e,s,r)=>{r.every(i=>i(t,!1))&&e.push(t)},Et=(t,e,s,r)=>{s.files++},bt=(t,e)=>{e.push(t)},xt=()=>{};function At(t){let{excludeFiles:e,filters:s,onlyCounts:r}=t;return e?xt:s&&s.length?r?wt:Tt:r?Et:bt}var Ft=t=>t,kt=()=>[""].slice(0,0);function Dt(t){return t.group?kt:Ft}var Pt=(t,e,s)=>{t.push({directory:e,files:s,dir:e})},_t=()=>{};function vt(t){return t.group?Pt:_t}var It=function(t,e,s){let{queue:r,fs:i,options:{suppressErrors:o}}=e;r.enqueue(),i.realpath(t,(l,n)=>{if(l)return r.dequeue(o?null:l,e);i.stat(n,(u,h)=>{if(u)return r.dequeue(o?null:u,e);if(h.isDirectory()&&N(t,n,e))return r.dequeue(null,e);s(h,n),r.dequeue(null,e)})})},Rt=function(t,e,s){let{queue:r,fs:i,options:{suppressErrors:o}}=e;r.enqueue();try{let l=i.realpathSync(t),n=i.statSync(l);if(n.isDirectory()&&N(t,l,e))return;s(n,l)}catch(l){if(!o)throw l}};function Ct(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?Rt:It}function N(t,e,s){if(s.options.useRealPaths)return Nt(e,s);let r=k(t),i=1;for(;r!==s.root&&i<2;){let o=s.symlinks.get(r);!!o&&(o===e||o.startsWith(e)||e.startsWith(o))?i++:r=k(r)}return s.symlinks.set(t,e),i>1}function Nt(t,e){return e.visited.includes(t+e.options.pathSeparator)}var Mt=t=>t.counts,Wt=t=>t.groups,$t=t=>t.paths,Ot=t=>t.paths.slice(0,t.options.maxFiles),qt=(t,e,s)=>(T(e,s,t.counts,t.options.suppressErrors),null),Kt=(t,e,s)=>(T(e,s,t.paths,t.options.suppressErrors),null),Gt=(t,e,s)=>(T(e,s,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),Bt=(t,e,s)=>(T(e,s,t.groups,t.options.suppressErrors),null);function T(t,e,s,r){e(t&&!r?t:null,s)}function Ht(t,e){let{onlyCounts:s,group:r,maxFiles:i}=t;return s?e?Mt:qt:r?e?Wt:Bt:i?e?Ot:Gt:e?$t:Kt}var M={withFileTypes:!0},jt=(t,e,s,r,i)=>{if(t.queue.enqueue(),r<0)return t.queue.dequeue(null,t);let{fs:o}=t;t.visited.push(e),t.counts.directories++,o.readdir(e||".",M,(l,n=[])=>{i(n,s,r),t.queue.dequeue(t.options.suppressErrors?null:l,t)})},Lt=(t,e,s,r,i)=>{let{fs:o}=t;if(r<0)return;t.visited.push(e),t.counts.directories++;let l=[];try{l=o.readdirSync(e||".",M)}catch(n){if(!t.options.suppressErrors)throw n}i(l,s,r)};function Yt(t){return t?Lt:jt}var Ut=class{constructor(t){c(this,"count",0);this.onQueueEmpty=t}enqueue(){return this.count++,this.count}dequeue(t,e){this.onQueueEmpty&&(--this.count<=0||t)&&(this.onQueueEmpty(t,e),t&&(e.controller.abort(),this.onQueueEmpty=void 0))}},zt=class{constructor(){c(this,"_files",0);c(this,"_directories",0)}set files(t){this._files=t}get files(){return this._files}set directories(t){this._directories=t}get directories(){return this._directories}get dirs(){return this._directories}},Qt=class{constructor(){c(this,"aborted",!1)}abort(){this.aborted=!0}},W=class{constructor(t,e,s){c(this,"root");c(this,"isSynchronous");c(this,"state");c(this,"joinPath");c(this,"pushDirectory");c(this,"pushFile");c(this,"getArray");c(this,"groupFiles");c(this,"resolveSymlink");c(this,"walkDirectory");c(this,"callbackInvoker");c(this,"walk",(t,e,s)=>{let{paths:r,options:{filters:i,resolveSymlinks:o,excludeSymlinks:l,exclude:n,maxFiles:u,signal:h,useRealPaths:p,pathSeparator:f},controller:E}=this.state;if(E.aborted||h&&h.aborted||u&&r.length>u)return;let b=this.getArray(this.state.paths);for(let x=0;x<t.length;++x){let g=t[x];if(g.isFile()||g.isSymbolicLink()&&!o&&!l){let y=this.joinPath(g.name,e);this.pushFile(y,b,this.state.counts,i)}else if(g.isDirectory()){let y=ht(g.name,e,this.state.options.pathSeparator);if(n&&n(g.name,y))continue;this.pushDirectory(y,r,i),this.walkDirectory(this.state,y,y,s-1,this.walk)}else if(this.resolveSymlink&&g.isSymbolicLink()){let y=C(g.name,e);this.resolveSymlink(y,this.state,(U,m)=>{if(U.isDirectory()){if(m=F(m,this.state.options),n&&n(g.name,p?m:y+f))return;this.walkDirectory(this.state,m,p?m:y+f,s-1,this.walk)}else{m=p?m:y;let z=tt(m),Q=F(k(m),this.state.options);m=this.joinPath(z,Q),this.pushFile(m,b,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,b)});this.isSynchronous=!s,this.callbackInvoker=Ht(e,this.isSynchronous),this.root=F(t,e),this.state={root:ut(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new zt,options:e,queue:new Ut((r,i)=>this.callbackInvoker(i,r,s)),symlinks:new Map,visited:[""].slice(0,0),controller:new Qt,fs:e.fs||it},this.joinPath=pt(this.root,e),this.pushDirectory=St(this.root,e),this.pushFile=At(e),this.getArray=Dt(e),this.groupFiles=vt(e),this.resolveSymlink=Ct(e,this.isSynchronous),this.walkDirectory=Yt(this.isSynchronous)}start(){return this.pushDirectory(this.root,this.state.paths,this.state.options.filters),this.walkDirectory(this.state,this.root,this.root,this.state.options.maxDepth,this.walk),this.isSynchronous?this.callbackInvoker(this.state,null):null}};function Xt(t,e){return new Promise((s,r)=>{$(t,e,(i,o)=>{if(i)return r(i);s(o)})})}function $(t,e,s){new W(t,e,s).start()}function Zt(t,e){return new W(t,e).start()}var v=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return Xt(this.root,this.options)}withCallback(t){$(this.root,this.options,t)}sync(){return Zt(this.root,this.options)}},O=null;try{_.resolve("picomatch"),O=_("picomatch")}catch(t){}var q=class{constructor(t){c(this,"globCache",{});c(this,"options",{maxDepth:1/0,suppressErrors:!0,pathSeparator:I,filters:[]});c(this,"globFunction");this.options=w(w({},this.options),t),this.globFunction=this.options.globFunction}group(){return this.options.group=!0,this}withPathSeparator(t){return this.options.pathSeparator=t,this}withBasePath(){return this.options.includeBasePath=!0,this}withRelativePaths(){return this.options.relativePaths=!0,this}withDirs(){return this.options.includeDirs=!0,this}withMaxDepth(t){return this.options.maxDepth=t,this}withMaxFiles(t){return this.options.maxFiles=t,this}withFullPaths(){return this.options.resolvePaths=!0,this.options.includeBasePath=!0,this}withErrors(){return this.options.suppressErrors=!1,this}withSymlinks({resolvePaths:t=!0}={}){return this.options.resolveSymlinks=!0,this.options.useRealPaths=t,this.withFullPaths()}withAbortSignal(t){return this.options.signal=t,this}normalize(){return this.options.normalizePath=!0,this}filter(t){return this.options.filters.push(t),this}onlyDirs(){return this.options.excludeFiles=!0,this.options.includeDirs=!0,this}exclude(t){return this.options.exclude=t,this}onlyCounts(){return this.options.onlyCounts=!0,this}crawl(t){return new v(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options=w(w({},this.options),e),new v(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let s=this.globFunction||O;if(!s)throw new Error("Please specify a glob function to use glob matching.");var r=this.globCache[t.join("\0")];return r||(r=s(t,...e),this.globCache[t.join("\0")]=r),this.options.filters.push(i=>r(i)),this}};import{stat as Jt}from"fs/promises";function K(t){return new q().withFullPaths().exclude(s=>s==="node_modules"||s==="dist"||s==="build"||s===".git").filter(s=>s.endsWith(".ts")||s.endsWith(".tsx")).crawl(t).sync()}function G(t,e){let s=[];for(let r=0;r<t.length;r+=e)s.push(t.slice(r,r+e));return s}function B(t){return S(this,null,function*(){let e;try{e=yield Jt(t)}catch(s){throw new Error(`Directory "${t}" does not exist.`)}if(!e.isDirectory())throw new Error(`"${t}" is not a directory.`)})}import{Project as ie}from"ts-morph";import{SyntaxKind as a}from"ts-morph";var d={CHUNK_SIZE:50,TYPE_DEBT_METRICS:{EXPLICIT_ANY_WEIGHT:2,IMPLICIT_ANY_WEIGHT:3,AS_ANY_WEIGHT:2,SUPPRESSION_WEIGHT:4,NON_NULL_ASSERTION_WEIGHT:1}};var te=/(?:\/\/|\/\*)\s*@ts-(ignore|expect-error|nocheck)/g;function H(t){let e={explicitAny:0,implicitAny:0,asAny:0,suppressions:0,nonNullAssertions:0,validTypes:0,score:0};t.forEachDescendant(i=>{var l;let o=i.getKind();if(o===a.AnyKeyword){let n=i.getParent();(n==null?void 0:n.getKind())!==a.AsExpression&&e.explicitAny++}else o===a.AsExpression&&((l=i.asKindOrThrow(a.AsExpression).getTypeNode())==null?void 0:l.getKind())===a.AnyKeyword&&e.asAny++;if(o===a.Parameter){let n=i.asKindOrThrow(a.Parameter);if(!n.getTypeNode()&&!n.getInitializer()){let u=n.getParent(),h=u==null?void 0:u.getParent();((u==null?void 0:u.getKind())===a.ArrowFunction||(u==null?void 0:u.getKind())===a.FunctionExpression)&&(h==null?void 0:h.getKind())===a.CallExpression||e.implicitAny++}}o===a.NonNullExpression?e.nonNullAssertions++:re(o)&&e.validTypes++});let r=t.getFullText().match(te);return e.suppressions=r?r.length:0,e.score=ee(e),e}function ee(t){let e=t.explicitAny+t.implicitAny+t.asAny+t.suppressions+t.nonNullAssertions,s=t.validTypes+e;if(s==0)return 100;{let r=t.validTypes/s*100,o=se(t)/s*100;return Math.max(0,Math.round(r-o))}}function se(t){return t.explicitAny*d.TYPE_DEBT_METRICS.EXPLICIT_ANY_WEIGHT+t.implicitAny*d.TYPE_DEBT_METRICS.IMPLICIT_ANY_WEIGHT+t.asAny*d.TYPE_DEBT_METRICS.AS_ANY_WEIGHT+t.nonNullAssertions*d.TYPE_DEBT_METRICS.NON_NULL_ASSERTION_WEIGHT+t.suppressions*d.TYPE_DEBT_METRICS.SUPPRESSION_WEIGHT}function re(t){return t===a.TypeReference||t===a.StringKeyword||t===a.NumberKeyword||t===a.BooleanKeyword||t===a.InterfaceDeclaration||t===a.TypeAliasDeclaration}function j(t){let e=new ie({skipAddingFilesFromTsConfig:!0});e.addSourceFilesAtPaths(t);let s=[];e.forgetNodesCreatedInBlock(()=>{for(let r of e.getSourceFiles())s.push({filePath:r.getFilePath(),typeDebtMetrics:H(r)})});for(let r of e.getSourceFiles())e.removeSourceFile(r);return s}import{promises as ne}from"fs";import L from"path";function Y(t,e,s="type-debt-report.md"){return S(this,null,function*(){if(t.length===0)return;let r=t.length,i=t.reduce((p,f)=>p+f.typeDebtMetrics.score,0),o=Math.round(i/r),l=[...t].sort((p,f)=>p.typeDebtMetrics.score-f.typeDebtMetrics.score),n=`Type Debt Report
+
+`;n+=`> Generated on: ${new Date().toUTCString()}
+
+`,n+=`## Summary
+`,n+=`- Total Files Scanned: ${r}
+`,n+=`- Average Score: ${o}/100
+
+`,n+=`## Top 10 Worst Offenders
+
+`,n+="| Score | File Path | Suppressions | Implicit `any` | Explicit `any` | `as any` | Non-Null (`!`) |\n",n+=`| :---: | :--- | :---: | :---: | :---: | :---: | :---: |
+`;let u=l.slice(0,10),h=L.resolve(e);for(let p of u){let f=p.typeDebtMetrics,E=L.relative(h,p.filePath);n+=`| ${f.score} | \`${E}\` | ${f.suppressions} | ${f.implicitAny} | ${f.explicitAny} | ${f.asAny} | ${f.nonNullAssertions} |
+`}try{yield ne.writeFile(s,n,"utf-8"),console.log(`
+Markdown report successfully generated at: ${s}`)}catch(p){console.error(`
+Failed to write Markdown report:`,p)}})}var D=process.argv.slice(2);(D.includes("--help")||D.includes("-h"))&&(ue(),process.exit(0));var oe=D[0]||".";le(oe).catch(t=>{console.error(`
+\x1B[31m Error: ${t.message}\x1B[0m
+`),process.exit(1)});function le(t){return S(this,null,function*(){yield B(t),console.log(`
+Scanning directory: ${t}`);let e=K(t);if(e.length===0)throw new Error("No TypeScript files found to process.");let s=G(e,d.CHUNK_SIZE),r=[];for(let[i,o]of s.entries()){let l=j(o);r=r.concat(l),process.stdout.write(`\rProcessed chunk ${i+1}/${s.length}`)}yield Y(r,t)})}function ue(){console.log(`
+Type Debt Analyzer
+
+Usage: npx tsx index.ts [directory]
+
+Examples:
+       npx tsx index.ts .
+       npx tsx index.ts ./src
+  `),process.exit(0)}

package/index.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { getTargetFiles } from "./utils.js";
+import { chunkArray, validateDirectory } from "./utils.js";
+import { processChunk } from "./core/chunkProcessor.js";
+import { FileReport } from "./types.js";
+import { CONSTANTS } from "./constants.js";
+import { generateMarkdownReport } from "./core/reporter.js";
+
+
+
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  printHelp();
+  process.exit(0);
+}
+
+const target = args[0] || ".";
+
+runCLI(target).catch((err) => {
+  console.error(`\n\x1b[31m Error: ${err.message}\x1b[0m\n`);
+  process.exit(1);
+});
+
+
+async function runCLI(targetDir: string) {
+
+  await validateDirectory(targetDir);
+
+  console.log(`\nScanning directory: ${targetDir}`);
+  const allFiles = getTargetFiles(targetDir);
+
+  if (allFiles.length === 0) {
+    throw new Error(`No TypeScript files found to process.`);
+  }
+
+  const fileChunks = chunkArray(allFiles, CONSTANTS.CHUNK_SIZE);
+
+  let allResults: FileReport[] = [];
+
+  for (const [index, chunk] of fileChunks.entries()) {
+
+    const chunkResults = processChunk(chunk);
+    allResults = allResults.concat(chunkResults);
+    process.stdout.write(`\rProcessed chunk ${index + 1}/${fileChunks.length}`);
+  }
+
+  await generateMarkdownReport(allResults, targetDir);
+
+}
+
+function printHelp() {
+  console.log(`
+Type Debt Analyzer
+
+Usage: npx tsx index.ts [directory]
+
+Examples:
+       npx tsx index.ts .
+       npx tsx index.ts ./src
+  `);
+  process.exit(0);
+}
+
+

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@m4x_7/type-debt",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A high-performance TypeScript static analyzer that calculates Type Debt and generates reports.",
+  "main": "./dist/index.js",
+  "bin": {
+    "type-debt": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup index.ts --format esm --minify --clean",
+    "test": "vitest",
+    "dev": "nodemon --ignore temp_repos/ --exec ts-node main.ts"
+  },
+  "keywords": [
+    "typescript",
+    "analyzer",
+    "type-debt",
+    "cli"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "jscpd": "^4.0.8",
+    "simple-git": "^3.35.2",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.5.2",
+    "nodemon": "^3.1.14",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.9"
+  }
+}

package/tests/typeDebt.test.ts

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { Project } from "ts-morph";
+import { calculatePenalty, calculateScore, getTypeDebt } from "../core/typeDebt";
+import { TypeDebtMetrics } from "../types";
+
+describe("Type Debt Analysis", () => {
+  it("should correctly identify all forms of type debt", () => {
+
+    const project = new Project({ useInMemoryFileSystem: true });
+
+    const sourceCode = `
+
+      interface ValidUser { id: number; }
+
+      // @ts-ignore
+      const id: any = 123;
+      
+      const user = fetchUser() as any;
+      
+      function process(payload) {
+        console.log(payload!.data);
+      }
+    `;
+
+    const sourceFile = project.createSourceFile("test.ts", sourceCode);
+
+    const metrics = getTypeDebt(sourceFile);
+
+    expect(metrics.explicitAny).toBe(1);
+    expect(metrics.asAny).toBe(1);
+    expect(metrics.suppressions).toBe(1);
+    expect(metrics.implicitAny).toBe(1);
+    expect(metrics.nonNullAssertions).toBe(1);
+    expect(metrics.validTypes).toBeGreaterThan(0);
+
+  });
+
+  it("should correctly calculate penalty", () => {
+
+    const metrics: TypeDebtMetrics = {
+      explicitAny: 2,
+      implicitAny: 3,
+      asAny: 2,
+      suppressions: 1,
+      nonNullAssertions: 1,
+      validTypes: 40,
+      score: 0
+    }
+
+    const penalty = calculatePenalty(metrics);
+    expect(penalty).toBe(22);
+
+  });
+
+
+
+  it("should correctly calculate score for ordinary data", () => {
+
+    let metrics: TypeDebtMetrics = {
+      explicitAny: 2,
+      implicitAny: 3,
+      asAny: 2,
+      suppressions: 1,
+      nonNullAssertions: 1,
+      validTypes: 40,
+      score: 0
+    }
+
+    metrics.score = calculateScore(metrics);
+    expect(metrics.score).toBe(37);
+
+  });
+
+    it("should correctly calculate score when no type nodes were found in the file", () => {
+
+    let metrics: TypeDebtMetrics = {
+      explicitAny: 0,
+      implicitAny: 0,
+      asAny: 0,
+      suppressions: 0,
+      nonNullAssertions: 0,
+      validTypes: 0,
+      score: 0
+    }
+
+    metrics.score = calculateScore(metrics);
+    expect(metrics.score).toBe(100);
+
+  });
+
+
+})
+

package/tsconfig.json

@@ -0,0 +1,46 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    // "rootDir": "./src",
+    // "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "CommonJS",
+    "esModuleInterop": true,
+    "target": "es2016",
+    "types": [],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": false,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  }
+}

package/type-debt-report.md

@@ -0,0 +1,22 @@
+Type Debt Report
+
+> Generated on: Mon, 29 Jun 2026 14:06:35 GMT
+
+## Summary
+- Total Files Scanned: 709
+- Average Score: 73/100
+
+## Top 10 Worst Offenders
+
+| Score | File Path | Suppressions | Implicit `any` | Explicit `any` | `as any` | Non-Null (`!`) |
+| :---: | :--- | :---: | :---: | :---: | :---: | :---: |
+| 0 | `compiler/visitorPublic.ts` | 0 | 810 | 1 | 0 | 4 |
+| 0 | `harness/harnessGlobals.ts` | 0 | 3 | 1 | 0 | 0 |
+| 0 | `lib/es2017.intl.d.ts` | 0 | 0 | 11 | 0 | 0 |
+| 0 | `server/moduleSpecifierCache.ts` | 0 | 22 | 0 | 0 | 0 |
+| 0 | `services/codefixes/addEmptyExportDeclaration.ts` | 0 | 1 | 0 | 0 | 0 |
+| 0 | `services/codefixes/addMissingDeclareProperty.ts` | 0 | 2 | 0 | 0 | 0 |
+| 0 | `services/codefixes/addMissingInvocationForDecorator.ts` | 0 | 2 | 0 | 0 | 1 |
+| 0 | `services/codefixes/addMissingResolutionModeImportAttribute.ts` | 0 | 2 | 0 | 0 | 1 |
+| 0 | `services/codefixes/disableJsDiagnostics.ts` | 3 | 2 | 0 | 0 | 0 |
+| 0 | `services/codefixes/fixAddMissingNewOperator.ts` | 0 | 2 | 0 | 0 | 0 |

package/types.ts

@@ -0,0 +1,14 @@
+export interface FileReport {
+  filePath: string;
+  typeDebtMetrics: TypeDebtMetrics;
+}
+
+export interface TypeDebtMetrics {
+  explicitAny: number;
+  implicitAny: number;
+  asAny: number;
+  suppressions: number;
+  nonNullAssertions: number;
+  validTypes: number;
+  score: number;
+}

package/utils.ts

@@ -0,0 +1,43 @@
+import { fdir } from "fdir";
+import { stat } from "fs/promises";
+
+
+export function getTargetFiles(directoryPath: string): string[] {
+  const crawler = new fdir()
+    .withFullPaths()
+    .exclude((dirName) =>
+      dirName === "node_modules" ||
+      dirName === "dist" ||
+      dirName === "build" ||
+      dirName === ".git"
+    )
+    .filter((path) => path.endsWith(".ts") || path.endsWith(".tsx"))
+    .crawl(directoryPath);
+
+  return crawler.sync() as string[];
+}
+
+
+export function chunkArray<T>(array: T[], chunkSize: number): T[][] {
+  const chunks: T[][] = [];
+  for (let i = 0; i < array.length; i += chunkSize) {
+    chunks.push(array.slice(i, i + chunkSize));
+  }
+  return chunks;
+}
+
+
+export async function validateDirectory(path: string) {
+
+  let stats;
+
+  try {
+    stats = await stat(path);
+  } catch {
+    throw new Error(`Directory "${path}" does not exist.`);
+  }
+
+  if (!stats.isDirectory()) {
+    throw new Error(`"${path}" is not a directory.`);
+  }
+}