@m4x_7/type-debt 1.0.4 → 1.0.6

package/dist/constants.d.ts

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

package/{constants.ts → dist/constants.js}

@@ -1,15 +1,11 @@
-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;
-
-
+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,
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IAErB,UAAU,EAAE,EAAE;IAEd,iBAAiB,EAAC;QACd,mBAAmB,EAAE,CAAC;QACtB,mBAAmB,EAAE,CAAC;QACtB,aAAa,EAAE,CAAC;QAChB,kBAAkB,EAAE,CAAC;QACrB,yBAAyB,EAAE,CAAC;KAC/B;CAEK,CAAC"}

package/dist/core/chunkProcessor.d.ts

@@ -0,0 +1,2 @@
+import { FileReport } from "../types.js";
+export declare function processChunk(chunk: string[]): FileReport[];

package/dist/core/chunkProcessor.js

@@ -0,0 +1,20 @@
+import { Project } from "ts-morph";
+import { getTypeDebt } from "./typeDebt.js";
+export function processChunk(chunk) {
+    const project = new Project({ skipAddingFilesFromTsConfig: true });
+    project.addSourceFilesAtPaths(chunk);
+    const chunkResults = [];
+    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;
+}
+//# sourceMappingURL=chunkProcessor.js.map

package/dist/core/chunkProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkProcessor.js","sourceRoot":"","sources":["../../core/chunkProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,UAAU,YAAY,CAAC,KAAe;IAE1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,YAAY,GAAiB,EAAE,CAAC;IAEtC,OAAO,CAAC,yBAAyB,CAAC,GAAG,EAAE;QACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5C,YAAY,CAAC,IAAI,CAAC;gBAChB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE;gBAC5B,eAAe,EAAE,WAAW,CAAC,IAAI,CAAC;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5C,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/core/reporter.d.ts

@@ -0,0 +1,2 @@
+import { FileReport } from "../types.js";
+export declare function generateMarkdownReport(results: FileReport[], targetDir: string, outputPath?: string): Promise<void>;

package/dist/core/reporter.js

@@ -0,0 +1,33 @@
+import { promises as fs } from "fs";
+import path from "path";
+export async function generateMarkdownReport(results, targetDir, 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);
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/core/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../core/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAqB,EAAE,SAAiB,EAAE,UAAU,GAAG,qBAAqB;IACvH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAC,eAAe,CAAC,KAAK,CAClD,CAAC;IAEF,IAAI,EAAE,GAAG,sBAAsB,CAAC;IAChC,EAAE,IAAI,mBAAmB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAExD,EAAE,IAAI,cAAc,CAAC;IACrB,EAAE,IAAI,0BAA0B,UAAU,IAAI,CAAC;IAC/C,EAAE,IAAI,oBAAoB,YAAY,UAAU,CAAC;IAEjD,EAAE,IAAI,+BAA+B,CAAC;IAEtC,EAAE,IAAI,8GAA8G,CAAC;IAErH,EAAE,IAAI,4DAA4D,CAAC;IAEnE,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAElD,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,EAAE,IAAI,KAAK,OAAO,CAAC,KAAK,QAAQ,SAAS,QAAQ,OAAO,CAAC,YAAY,MAAM,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,iBAAiB,MAAM,CAAC;IAClL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,gDAAgD,UAAU,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/core/typeDebt.d.ts

@@ -0,0 +1,5 @@
+import { SourceFile } from "ts-morph";
+import { TypeDebtMetrics } from "../types.js";
+export declare function getTypeDebt(sourceFile: SourceFile): TypeDebtMetrics;
+export declare function calculateScore(metrics: TypeDebtMetrics): number;
+export declare function calculatePenalty(metrics: TypeDebtMetrics): number;

package/dist/core/typeDebt.js

@@ -0,0 +1,93 @@
+import { SyntaxKind } from "ts-morph";
+import { CONSTANTS } from "../constants.js";
+const SUPPRESSION_REGEX = /(?:\/\/|\/\*)\s*@ts-(ignore|expect-error|nocheck)/g;
+export function getTypeDebt(sourceFile) {
+    const metrics = {
+        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) {
+    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) {
+    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) {
+    return (kind === SyntaxKind.TypeReference ||
+        kind === SyntaxKind.StringKeyword ||
+        kind === SyntaxKind.NumberKeyword ||
+        kind === SyntaxKind.BooleanKeyword ||
+        kind === SyntaxKind.InterfaceDeclaration ||
+        kind === SyntaxKind.TypeAliasDeclaration);
+}
+//# sourceMappingURL=typeDebt.js.map

package/dist/core/typeDebt.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -1,27 +1,45 @@
 #!/usr/bin/env node
-var V=Object.defineProperty;var v=Object.getOwnPropertySymbols;var J=Object.prototype.hasOwnProperty,tt=Object.prototype.propertyIsEnumerable;var k=(t,e,s)=>e in t?V(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s,E=(t,e)=>{for(var s in e||(e={}))J.call(e,s)&&k(t,s,e[s]);if(v)for(var s of v(e))tt.call(e,s)&&k(t,s,e[s]);return t};var c=(t,e,s)=>k(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 et}from"module";import{basename as st,dirname as P,normalize as rt,relative as it,resolve as nt,sep as C}from"path";import*as ot from"fs";var te={};var I=et(te.url);function lt(t){let e=rt(t);return e.length>1&&e[e.length-1]===C&&(e=e.substring(0,e.length-1)),e}var ut=/[\\/]/g;function N(t,e){return t.replace(ut,e)}var ct=/^[a-z]:[\\/]$/i;function at(t){return t==="/"||ct.test(t)}function D(t,e){let{resolvePaths:s,normalizePath:r,pathSeparator:i}=e,o=process.platform==="win32"&&t.includes("/")||t.startsWith(".");if(s&&(t=nt(t)),(r||o)&&(t=lt(t)),t===".")return"";let l=t[t.length-1]!==i;return N(l?t+i:t,i)}function M(t,e){return e+t}function ht(t,e){return function(s,r){return r.startsWith(t)?r.slice(t.length)+s:N(it(t,r),e.pathSeparator)+e.pathSeparator+s}}function pt(t){return t}function ft(t,e,s){return e+t+s}function yt(t,e){let{relativePaths:s,includeBasePath:r}=e;return s&&t?ht(t,e):r?M:pt}function mt(t){return function(e,s){s.push(e.substring(t.length)||".")}}function gt(t){return function(e,s,r){let i=e.substring(t.length)||".";r.every(o=>o(i,!0))&&s.push(i)}}var dt=(t,e)=>{e.push(t||".")},St=(t,e,s)=>{let r=t||".";s.every(i=>i(r,!0))&&e.push(r)},wt=()=>{};function Tt(t,e){let{includeDirs:s,filters:r,relativePaths:i}=e;return s?i?r&&r.length?gt(t):mt(t):r&&r.length?St:dt:wt}var Et=(t,e,s,r)=>{r.every(i=>i(t,!1))&&s.files++},bt=(t,e,s,r)=>{r.every(i=>i(t,!1))&&e.push(t)},xt=(t,e,s,r)=>{s.files++},At=(t,e)=>{e.push(t)},Ft=()=>{};function kt(t){let{excludeFiles:e,filters:s,onlyCounts:r}=t;return e?Ft:s&&s.length?r?Et:bt:r?xt:At}var Dt=t=>t,Pt=()=>[""].slice(0,0);function _t(t){return t.group?Pt:Dt}var vt=(t,e,s)=>{t.push({directory:e,files:s,dir:e})},It=()=>{};function Rt(t){return t.group?vt:It}var Ct=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()&&W(t,n,e))return r.dequeue(null,e);s(h,n),r.dequeue(null,e)})})},Nt=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()&&W(t,l,e))return;s(n,l)}catch(l){if(!o)throw l}};function Mt(t,e){return!t.resolveSymlinks||t.excludeSymlinks?null:e?Nt:Ct}function W(t,e,s){if(s.options.useRealPaths)return Wt(e,s);let r=P(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=P(r)}return s.symlinks.set(t,e),i>1}function Wt(t,e){return e.visited.includes(t+e.options.pathSeparator)}var $t=t=>t.counts,Ot=t=>t.groups,qt=t=>t.paths,Kt=t=>t.paths.slice(0,t.options.maxFiles),Gt=(t,e,s)=>(b(e,s,t.counts,t.options.suppressErrors),null),Bt=(t,e,s)=>(b(e,s,t.paths,t.options.suppressErrors),null),Ht=(t,e,s)=>(b(e,s,t.paths.slice(0,t.options.maxFiles),t.options.suppressErrors),null),jt=(t,e,s)=>(b(e,s,t.groups,t.options.suppressErrors),null);function b(t,e,s,r){e(t&&!r?t:null,s)}function Lt(t,e){let{onlyCounts:s,group:r,maxFiles:i}=t;return s?e?$t:Gt:r?e?Ot:jt:i?e?Kt:Ht:e?qt:Bt}var $={withFileTypes:!0},Yt=(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||".",$,(l,n=[])=>{i(n,s,r),t.queue.dequeue(t.options.suppressErrors?null:l,t)})},Ut=(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||".",$)}catch(n){if(!t.options.suppressErrors)throw n}i(l,s,r)};function zt(t){return t?Ut:Yt}var Qt=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))}},Xt=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}},Zt=class{constructor(){c(this,"aborted",!1)}abort(){this.aborted=!0}},O=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:x}=this.state;if(x.aborted||h&&h.aborted||u&&r.length>u)return;let A=this.getArray(this.state.paths);for(let F=0;F<t.length;++F){let g=t[F];if(g.isFile()||g.isSymbolicLink()&&!o&&!l){let y=this.joinPath(g.name,e);this.pushFile(y,A,this.state.counts,i)}else if(g.isDirectory()){let y=ft(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=M(g.name,e);this.resolveSymlink(y,this.state,(Q,m)=>{if(Q.isDirectory()){if(m=D(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 X=st(m),Z=D(P(m),this.state.options);m=this.joinPath(X,Z),this.pushFile(m,A,this.state.counts,i)}})}}this.groupFiles(this.state.groups,e,A)});this.isSynchronous=!s,this.callbackInvoker=Lt(e,this.isSynchronous),this.root=D(t,e),this.state={root:at(this.root)?this.root:this.root.slice(0,-1),paths:[""].slice(0,0),groups:[],counts:new Xt,options:e,queue:new Qt((r,i)=>this.callbackInvoker(i,r,s)),symlinks:new Map,visited:[""].slice(0,0),controller:new Zt,fs:e.fs||ot},this.joinPath=yt(this.root,e),this.pushDirectory=Tt(this.root,e),this.pushFile=kt(e),this.getArray=_t(e),this.groupFiles=Rt(e),this.resolveSymlink=Mt(e,this.isSynchronous),this.walkDirectory=zt(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 Vt(t,e){return new Promise((s,r)=>{q(t,e,(i,o)=>{if(i)return r(i);s(o)})})}function q(t,e,s){new O(t,e,s).start()}function Jt(t,e){return new O(t,e).start()}var R=class{constructor(t,e){this.root=t,this.options=e}withPromise(){return Vt(this.root,this.options)}withCallback(t){q(this.root,this.options,t)}sync(){return Jt(this.root,this.options)}},K=null;try{I.resolve("picomatch"),K=I("picomatch")}catch(t){}var G=class{constructor(t){c(this,"globCache",{});c(this,"options",{maxDepth:1/0,suppressErrors:!0,pathSeparator:C,filters:[]});c(this,"globFunction");this.options=E(E({},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 R(t||".",this.options)}withGlobFunction(t){return this.globFunction=t,this}crawlWithOptions(t,e){return this.options=E(E({},this.options),e),new R(t||".",this.options)}glob(...t){return this.globFunction?this.globWithOptions(t):this.globWithOptions(t,{dot:!0})}globWithOptions(t,...e){let s=this.globFunction||K;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 ee}from"fs/promises";function B(t){return new G().withFullPaths().exclude(s=>s==="node_modules"||s==="dist"||s==="build"||s===".git").filter(s=>s.endsWith(".ts")||s.endsWith(".tsx")).crawl(t).sync()}function H(t,e){let s=[];for(let r=0;r<t.length;r+=e)s.push(t.slice(r,r+e));return s}function j(t){return S(this,null,function*(){let e;try{e=yield ee(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 oe}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 se=/(?:\/\/|\/\*)\s*@ts-(ignore|expect-error|nocheck)/g;function L(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++:ne(o)&&e.validTypes++});let r=t.getFullText().match(se);return e.suppressions=r?r.length:0,e.score=re(e),e}function re(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=ie(t)/s*100;return Math.max(0,Math.round(r-o))}}function ie(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 ne(t){return t===a.TypeReference||t===a.StringKeyword||t===a.NumberKeyword||t===a.BooleanKeyword||t===a.InterfaceDeclaration||t===a.TypeAliasDeclaration}function Y(t){let e=new oe({skipAddingFilesFromTsConfig:!0});e.addSourceFilesAtPaths(t);let s=[];e.forgetNodesCreatedInBlock(()=>{for(let r of e.getSourceFiles())s.push({filePath:r.getFilePath(),typeDebtMetrics:L(r)})});for(let r of e.getSourceFiles())e.removeSourceFile(r);return s}import{promises as le}from"fs";import U from"path";function z(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=U.resolve(e);for(let p of u){let f=p.typeDebtMetrics,x=U.relative(h,p.filePath);n+=`| ${f.score} | \`${x}\` | ${f.suppressions} | ${f.implicitAny} | ${f.explicitAny} | ${f.asAny} | ${f.nonNullAssertions} |
-`}try{yield le.writeFile(s,n,"utf-8"),console.log(`
-Markdown report successfully generated at: ${s}`)}catch(p){console.error(`
-Failed to write Markdown report:`,p)}})}var _=process.argv.slice(2);(_.includes("--help")||_.includes("-h"))&&(ae(),process.exit(0));var ue=_[0]||".";ce(ue).catch(t=>{console.error(`
-\x1B[31m Error: ${t.message}\x1B[0m
-`),process.exit(1)});function ce(t){return S(this,null,function*(){yield j(t),console.log(`
-Scanning directory: ${t}`);let e=B(t);if(e.length===0)throw new Error("No TypeScript files found to process.");let s=H(e,d.CHUNK_SIZE),r=[];for(let[i,o]of s.entries()){let l=Y(o);r=r.concat(l),process.stdout.write(`\rProcessed chunk ${i+1}/${s.length}`)}yield z(r,t)})}function ae(){console.log(`
+import { getTargetFiles } from "./utils.js";
+import { chunkArray, validateDirectory } from "./utils.js";
+import { processChunk } from "./core/chunkProcessor.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) {
+    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 = [];
+    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]
+Usage: npx type-debt [directory]
 
 Examples:
-       npx tsx index.ts .
-       npx tsx index.ts ./src
-  `),process.exit(0)}
+       npx type-debt .
+       npx type-debt ./src
+  `);
+    process.exit(0);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAE9B,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAGH,KAAK,UAAU,MAAM,CAAC,SAAiB;IAErC,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAE9D,IAAI,UAAU,GAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAElD,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACzC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEtD,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;GAQX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+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/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function getTargetFiles(directoryPath: string): string[];
+export declare function chunkArray<T>(array: T[], chunkSize: number): T[][];
+export declare function validateDirectory(path: string): Promise<void>;

package/dist/utils.js

@@ -0,0 +1,33 @@
+import { fdir } from "fdir";
+import { stat } from "fs/promises";
+export function getTargetFiles(directoryPath) {
+    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();
+}
+export function chunkArray(array, chunkSize) {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += chunkSize) {
+        chunks.push(array.slice(i, i + chunkSize));
+    }
+    return chunks;
+}
+export async function validateDirectory(path) {
+    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.`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,MAAM,UAAU,cAAc,CAAC,aAAqB;IAClD,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE;SACvB,aAAa,EAAE;SACf,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,KAAK,cAAc;QAC1B,OAAO,KAAK,MAAM;QAClB,OAAO,KAAK,OAAO;QACnB,OAAO,KAAK,MAAM,CACnB;SACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC/D,KAAK,CAAC,aAAa,CAAC,CAAC;IAExB,OAAO,OAAO,CAAC,IAAI,EAAc,CAAC;AACpC,CAAC;AAGD,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,SAAiB;IACzD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAElD,IAAI,KAAK,CAAC;IAEV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,mBAAmB,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,uBAAuB,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,14 +1,19 @@
 {
   "name": "@m4x_7/type-debt",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "description": "A high-performance TypeScript static analyzer that calculates Type Debt and generates reports.",
-  "main": "dist/index.js",
+  "main": "./dist/index.js",
   "bin": {
-    "type-debt": "dist/index.js"
+    "type-debt": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "build": "tsup index.ts --format esm --minify --shims --clean",
+    "build": "tsc",
     "test": "vitest",
     "dev": "nodemon --ignore temp_repos/ --exec ts-node main.ts"
   },
@@ -37,4 +42,4 @@
     "typescript": "^6.0.2",
     "vitest": "^4.1.9"
   }
-}
+}

package/core/chunkProcessor.ts

@@ -1,27 +0,0 @@
-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

@@ -1,46 +0,0 @@
-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

@@ -1,125 +0,0 @@
-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/index.ts

@@ -1,66 +0,0 @@
-#!/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/tests/typeDebt.test.ts

@@ -1,93 +0,0 @@
-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

@@ -1,46 +0,0 @@
-{
-  // 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

@@ -1,22 +0,0 @@
-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

@@ -1,14 +0,0 @@
-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

@@ -1,43 +0,0 @@
-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.`);
-  }
-}