tdepend 0.2.0

package/dist/metrics/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeAllMetrics = computeAllMetrics;
+const abstractness_1 = require("./abstractness");
+const distance_1 = require("./distance");
+const instability_1 = require("./instability");
+function computeAllMetrics(graph, modules, cycles) {
+    const moduleMap = new Map(modules.map((m) => [m.filePath, m]));
+    const metrics = [];
+    for (const node of graph.getAllNodes()) {
+        const module = moduleMap.get(node.filePath);
+        const moduleCycles = cycles.filter((cycle) => cycle.includes(node.filePath));
+        const Ca = node.dependents.size;
+        const Ce = node.dependencies.size;
+        const abstractness = module ? (0, abstractness_1.computeAbstractness)(module) : 0;
+        const instability = (0, instability_1.computeInstability)(Ca, Ce);
+        const distance = (0, distance_1.computeDistance)(abstractness, instability);
+        metrics.push({
+            filePath: node.filePath,
+            Ca,
+            Ce,
+            cycles: moduleCycles,
+            abstractness,
+            instability,
+            distance,
+        });
+    }
+    return metrics;
+}
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":";;AAOA,8CA8BC;AAlCD,iDAAqD;AACrD,yCAA6C;AAC7C,+CAAmD;AAEnD,SAAgB,iBAAiB,CAC/B,KAAsB,EACtB,OAAuB,EACvB,MAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE7E,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAClC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,kCAAmB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,IAAA,gCAAkB,EAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAA,0BAAe,EAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAE5D,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,EAAE;YACF,EAAE;YACF,MAAM,EAAE,YAAY;YACpB,YAAY;YACZ,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/metrics/instability.d.ts

@@ -0,0 +1 @@
+export declare function computeInstability(Ca: number, Ce: number): number;

package/dist/metrics/instability.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeInstability = computeInstability;
+function computeInstability(Ca, Ce) {
+    const total = Ca + Ce;
+    return total === 0 ? 0 : Ce / total;
+}
+//# sourceMappingURL=instability.js.map

package/dist/metrics/instability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instability.js","sourceRoot":"","sources":["../../src/metrics/instability.ts"],"names":[],"mappings":";;AAAA,gDAGC;AAHD,SAAgB,kBAAkB,CAAC,EAAU,EAAE,EAAU;IACvD,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;IACtB,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC;AACtC,CAAC"}

package/dist/parser/fileScanner.d.ts

@@ -0,0 +1,8 @@
+import type { TDependConfig } from '../config/schema';
+/**
+ * Scan files based on include/exclude patterns from config
+ *
+ * @param config - TDepend configuration with include/exclude patterns
+ * @returns Array of normalized absolute file paths
+ */
+export declare function scanFiles(config: TDependConfig): Promise<string[]>;

package/dist/parser/fileScanner.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanFiles = scanFiles;
+const glob_1 = require("glob");
+const pathUtils_1 = require("../utils/pathUtils");
+/**
+ * Scan files based on include/exclude patterns from config
+ *
+ * @param config - TDepend configuration with include/exclude patterns
+ * @returns Array of normalized absolute file paths
+ */
+async function scanFiles(config) {
+    const { include, exclude } = config;
+    // Scan files matching include patterns
+    const files = await (0, glob_1.glob)(include, {
+        ignore: exclude,
+        absolute: true,
+        nodir: true,
+    });
+    return files.map((file) => (0, pathUtils_1.normalizePath)(file));
+}
+//# sourceMappingURL=fileScanner.js.map

package/dist/parser/fileScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.js","sourceRoot":"","sources":["../../src/parser/fileScanner.ts"],"names":[],"mappings":";;AAWA,8BAWC;AAtBD,+BAA4B;AAG5B,kDAAmD;AAEnD;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,MAAqB;IACnD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEpC,uCAAuC;IACvC,MAAM,KAAK,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE;QAChC,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,yBAAa,EAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/parser/tsParser.d.ts

@@ -0,0 +1,18 @@
+import { Project } from 'ts-morph';
+import type { ParsedModule } from '../types/parser';
+/**
+ * Parse multiple TypeScript files in a project
+ *
+ * @param filePaths - Array of file paths to parse
+ * @param tsConfigPath - Optional path to tsconfig.json
+ * @returns Array of ParsedModule objects
+ */
+export declare function parseProject(filePaths: string[], tsConfigPath?: string): ParsedModule[];
+/**
+ * Parse a single TypeScript file
+ *
+ * @param filePath - Path to the file to parse
+ * @param project - Optional ts-morph Project instance
+ * @returns ParsedModule with extracted information
+ */
+export declare function parseFile(filePath: string, project?: Project): ParsedModule;

package/dist/parser/tsParser.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseProject = parseProject;
+exports.parseFile = parseFile;
+const node_path_1 = require("node:path");
+const ts_morph_1 = require("ts-morph");
+const pathUtils_1 = require("../utils/pathUtils");
+function extractImports(sourceFile, filePath) {
+    const imports = [];
+    const importDeclarations = sourceFile.getImportDeclarations();
+    for (const importDecl of importDeclarations) {
+        const moduleSpecifier = importDecl.getModuleSpecifierValue();
+        if ((0, pathUtils_1.isRelativeImport)(moduleSpecifier)) {
+            const resolvedPath = resolveImportPath(moduleSpecifier, filePath);
+            if (resolvedPath) {
+                imports.push(resolvedPath);
+            }
+        }
+        else if (!(0, pathUtils_1.isExternalModule)(moduleSpecifier)) {
+            // Handle absolute imports (potential path aliases)
+            // For now, we'll skip these - full path alias resolution needs tsconfig
+            // This will be enhanced if needed
+        }
+    }
+    return imports;
+}
+function extractClasses(sourceFile, filePath) {
+    const classes = [];
+    const exports = [];
+    const classDeclarations = sourceFile.getClasses();
+    for (const classDecl of classDeclarations) {
+        const name = classDecl.getName();
+        if (name) {
+            const isAbstract = classDecl.isAbstract();
+            const isExported = classDecl.isExported();
+            classes.push({
+                name,
+                isAbstract,
+                isExported,
+                filePath,
+            });
+            if (isExported) {
+                exports.push(name);
+            }
+        }
+    }
+    return { classes, exports };
+}
+function extractInterfaces(sourceFile) {
+    const exports = [];
+    let interfaces = 0;
+    const interfaceDeclarations = sourceFile.getInterfaces();
+    for (const interfaceDecl of interfaceDeclarations) {
+        const name = interfaceDecl.getName();
+        if (interfaceDecl.isExported()) {
+            exports.push(name);
+            interfaces++;
+        }
+        else {
+            interfaces++;
+        }
+    }
+    return { interfaces, exports };
+}
+function extractNamespaces(sourceFile, filePath) {
+    const namespaces = [];
+    const exports = [];
+    const namespaceDeclarations = sourceFile.getModules();
+    for (const namespaceDecl of namespaceDeclarations) {
+        const name = namespaceDecl.getName();
+        namespaces.push({
+            name,
+            filePath,
+        });
+        if (namespaceDecl.isExported()) {
+            exports.push(name);
+        }
+    }
+    return { namespaces, exports };
+}
+function extractOtherExports(sourceFile, existingExports) {
+    const otherExports = [];
+    const exportedDeclarations = sourceFile.getExportedDeclarations();
+    for (const [name, declarations] of exportedDeclarations) {
+        if (existingExports.includes(name)) {
+            continue;
+        }
+        if (declarations.length > 0) {
+            otherExports.push(name);
+        }
+    }
+    return otherExports;
+}
+function parseSourceFile(sourceFile) {
+    const filePath = (0, pathUtils_1.normalizePath)(sourceFile.getFilePath());
+    const imports = extractImports(sourceFile, filePath);
+    const { classes, exports: classExports } = extractClasses(sourceFile, filePath);
+    const { interfaces, exports: interfaceExports } = extractInterfaces(sourceFile);
+    const { namespaces, exports: namespaceExports } = extractNamespaces(sourceFile, filePath);
+    const allExports = [...classExports, ...interfaceExports, ...namespaceExports];
+    const otherExports = extractOtherExports(sourceFile, allExports);
+    const exports = [...allExports, ...otherExports];
+    const totalTypes = classes.length + interfaces;
+    return {
+        filePath,
+        imports,
+        exports,
+        classes,
+        namespaces,
+        interfaces,
+        totalTypes,
+    };
+}
+function resolveImportPath(importSpecifier, fromFile) {
+    const dir = (0, node_path_1.dirname)(fromFile);
+    // Resolve relative to the importing file
+    const resolvedPath = (0, node_path_1.resolve)(dir, importSpecifier);
+    // Try .ts as default extension for TypeScript projects
+    const pathWithTs = resolvedPath + '.ts';
+    return (0, pathUtils_1.normalizePath)(pathWithTs);
+}
+/**
+ * Parse multiple TypeScript files in a project
+ *
+ * @param filePaths - Array of file paths to parse
+ * @param tsConfigPath - Optional path to tsconfig.json
+ * @returns Array of ParsedModule objects
+ */
+function parseProject(filePaths, tsConfigPath) {
+    const project = new ts_morph_1.Project({
+        tsConfigFilePath: tsConfigPath,
+        skipAddingFilesFromTsConfig: true,
+    });
+    // Add all files to the project
+    for (const filePath of filePaths) {
+        project.addSourceFileAtPath(filePath);
+    }
+    const modules = [];
+    const sourceFiles = project.getSourceFiles();
+    for (const sourceFile of sourceFiles) {
+        const parsedModule = parseSourceFile(sourceFile);
+        modules.push(parsedModule);
+    }
+    return modules;
+}
+/**
+ * Parse a single TypeScript file
+ *
+ * @param filePath - Path to the file to parse
+ * @param project - Optional ts-morph Project instance
+ * @returns ParsedModule with extracted information
+ */
+function parseFile(filePath, project) {
+    const proj = project || new ts_morph_1.Project();
+    const sourceFile = proj.addSourceFileAtPath(filePath);
+    return parseSourceFile(sourceFile);
+}
+//# sourceMappingURL=tsParser.js.map

package/dist/parser/tsParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsParser.js","sourceRoot":"","sources":["../../src/parser/tsParser.ts"],"names":[],"mappings":";;AAkKA,oCAoBC;AASD,8BAIC;AAnMD,yCAA6C;AAC7C,uCAAoD;AAGpD,kDAAuF;AAEvF,SAAS,cAAc,CAAC,UAAsB,EAAE,QAAgB;IAC9D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,kBAAkB,GAAG,UAAU,CAAC,qBAAqB,EAAE,CAAC;IAE9D,KAAK,MAAM,UAAU,IAAI,kBAAkB,EAAE,CAAC;QAC5C,MAAM,eAAe,GAAG,UAAU,CAAC,uBAAuB,EAAE,CAAC;QAE7D,IAAI,IAAA,4BAAgB,EAAC,eAAe,CAAC,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YAClE,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,IAAA,4BAAgB,EAAC,eAAe,CAAC,EAAE,CAAC;YAC9C,mDAAmD;YACnD,wEAAwE;YACxE,kCAAkC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,UAAsB,EAAE,QAAgB;IAI9D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IAElD,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;YAE1C,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,UAAU;gBACV,UAAU;gBACV,QAAQ;aACT,CAAC,CAAC;YAEH,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAsB;IAI/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,qBAAqB,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC;IAEzD,KAAK,MAAM,aAAa,IAAI,qBAAqB,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,UAAU,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAsB,EAAE,QAAgB;IAIjE,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,qBAAqB,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IAEtD,KAAK,MAAM,aAAa,IAAI,qBAAqB,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;QACrC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI;YACJ,QAAQ;SACT,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAsB,EAAE,eAAyB;IAC5E,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,oBAAoB,GAAG,UAAU,CAAC,uBAAuB,EAAE,CAAC;IAElE,KAAK,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,oBAAoB,EAAE,CAAC;QACxD,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CAAC,UAAsB;IAC7C,MAAM,QAAQ,GAAG,IAAA,yBAAa,EAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE1F,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC;IAE/C,OAAO;QACL,QAAQ;QACR,OAAO;QACP,OAAO;QACP,OAAO;QACP,UAAU;QACV,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,eAAuB,EAAE,QAAgB;IAClE,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,QAAQ,CAAC,CAAC;IAE9B,yCAAyC;IACzC,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEnD,uDAAuD;IACvD,MAAM,UAAU,GAAG,YAAY,GAAG,KAAK,CAAC;IACxC,OAAO,IAAA,yBAAa,EAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,SAAmB,EAAE,YAAqB;IACrE,MAAM,OAAO,GAAG,IAAI,kBAAO,CAAC;QAC1B,gBAAgB,EAAE,YAAY;QAC9B,2BAA2B,EAAE,IAAI;KAClC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAE7C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,QAAgB,EAAE,OAAiB;IAC3D,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,kBAAO,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC"}

package/dist/types/api.d.ts

@@ -0,0 +1,74 @@
+import type { DependencyGraph } from '../graph/dependencyGraph';
+import type { ParsedModule } from './parser';
+import type { ModuleMetrics } from './graph';
+import type { AnalysisReport } from '../analysis/reporter';
+import type { TDependConfig } from '../config/schema';
+/**
+ * Main result returned by the analyze() function.
+ * Contains rich objects (DependencyGraph with Sets) suitable for programmatic use.
+ */
+export interface AnalysisResult {
+    /** Parsed modules with imports, exports, classes, etc. */
+    modules: ParsedModule[];
+    /** Dependency graph with Set-based relationships */
+    graph: DependencyGraph;
+    /** Detected dependency cycles */
+    cycles: string[][];
+    /** Computed metrics for each module */
+    metrics: ModuleMetrics[];
+    /** Generated analysis report with summary and violations */
+    report: AnalysisReport;
+    /** Configuration used for this analysis */
+    config: TDependConfig;
+}
+/**
+ * Serializable version of DependencyNode with Arrays instead of Sets.
+ */
+export interface SerializableDependencyNode {
+    /** File path of this module */
+    filePath: string;
+    /** Modules that this module depends on (outgoing dependencies) */
+    dependencies: string[];
+    /** Modules that depend on this module (incoming dependencies) */
+    dependents: string[];
+}
+/**
+ * Serializable dependency graph with array-based relationships.
+ */
+export interface SerializableDependencyGraph {
+    /** All nodes in the dependency graph */
+    nodes: SerializableDependencyNode[];
+}
+/**
+ * Normalized cycle with stable identification.
+ */
+export interface SerializableCycle {
+    /** Unique identifier (hash of sorted file paths) */
+    id: string;
+    /** File paths forming the cycle (normalized to start with lexicographically smallest) */
+    nodes: string[];
+    /** Number of nodes in the cycle */
+    length: number;
+}
+/**
+ * Complete serializable analysis result suitable for JSON export.
+ * All Sets are converted to Arrays for proper JSON serialization.
+ */
+export interface SerializableAnalysisResult {
+    /** Format version for compatibility checking */
+    version: string;
+    /** ISO 8601 timestamp of when this analysis was generated */
+    timestamp: string;
+    /** Configuration used for this analysis */
+    config: TDependConfig;
+    /** Parsed modules with imports, exports, classes, etc. */
+    modules: ParsedModule[];
+    /** Serializable dependency graph */
+    graph: SerializableDependencyGraph;
+    /** Normalized cycles with unique IDs */
+    cycles: SerializableCycle[];
+    /** Computed metrics for each module */
+    metrics: ModuleMetrics[];
+    /** Generated analysis report with summary and violations */
+    report: AnalysisReport;
+}

package/dist/types/api.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

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

package/dist/types/graph.d.ts

@@ -0,0 +1,14 @@
+export interface DependencyNode {
+    filePath: string;
+    dependencies: Set<string>;
+    dependents: Set<string>;
+}
+export interface ModuleMetrics {
+    filePath: string;
+    Ca: number;
+    Ce: number;
+    cycles: string[][];
+    abstractness: number;
+    instability: number;
+    distance: number;
+}

package/dist/types/graph.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=graph.js.map

package/dist/types/graph.js.map

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

package/dist/types/parser.d.ts

@@ -0,0 +1,26 @@
+export interface ParsedClass {
+    name: string;
+    isAbstract: boolean;
+    isExported: boolean;
+    filePath: string;
+}
+export interface ParsedNamespace {
+    name: string;
+    filePath: string;
+}
+export interface ParsedModule {
+    /** Normalized absolute path to the module file */
+    filePath: string;
+    /** Resolved import paths (normalized file paths) */
+    imports: string[];
+    /** Names of exported symbols */
+    exports: string[];
+    /** Parsed classes in this module */
+    classes: ParsedClass[];
+    /** Parsed namespaces in this module */
+    namespaces: ParsedNamespace[];
+    /** Count of interfaces (for abstractness calculation) */
+    interfaces: number;
+    /** Total count of types (classes + interfaces) */
+    totalTypes: number;
+}

package/dist/types/parser.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parser.js.map

package/dist/types/parser.js.map

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

package/dist/utils/deepMerge.d.ts

@@ -0,0 +1 @@
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;

package/dist/utils/deepMerge.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMerge = deepMerge;
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        const sourceValue = source[key];
+        const targetValue = result[key];
+        if (sourceValue &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            result[key] = deepMerge(targetValue, sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deepMerge.js.map

package/dist/utils/deepMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.js","sourceRoot":"","sources":["../../src/utils/deepMerge.ts"],"names":[],"mappings":";;AAAA,8BAyBC;AAzBD,SAAgB,SAAS,CAAoC,MAAS,EAAE,MAAkB;IACxF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAsC,EACtC,WAAsC,CACR,CAAC;QACnC,CAAC;aAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,WAA0C,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/log.d.ts

@@ -0,0 +1,2 @@
+import { TDependConfig } from "../config/schema";
+export declare function log(config: TDependConfig, message: string): void;

package/dist/utils/log.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+function log(config, message) {
+    if (config.ci.outputFormat !== 'json') {
+        console.log(message);
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":";;AAEA,kBAIC;AAJD,SAAgB,GAAG,CAAC,MAAqB,EAAE,OAAe;IACxD,IAAI,MAAM,CAAC,EAAE,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/utils/pathUtils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalize a file path to an absolute, cross-platform path
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Check if an import specifier is a relative import
+ */
+export declare function isRelativeImport(importSpecifier: string): boolean;
+/**
+ * Check if an import specifier is an external module
+ */
+export declare function isExternalModule(importSpecifier: string): boolean;

package/dist/utils/pathUtils.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePath = normalizePath;
+exports.isRelativeImport = isRelativeImport;
+exports.isExternalModule = isExternalModule;
+const node_path_1 = require("node:path");
+/**
+ * Normalize a file path to an absolute, cross-platform path
+ */
+function normalizePath(filePath) {
+    const absolutePath = (0, node_path_1.isAbsolute)(filePath) ? filePath : (0, node_path_1.resolve)(filePath);
+    return (0, node_path_1.normalize)(absolutePath);
+}
+/**
+ * Check if an import specifier is a relative import
+ */
+function isRelativeImport(importSpecifier) {
+    return importSpecifier.startsWith('./') || importSpecifier.startsWith('../');
+}
+/**
+ * Check if an import specifier is an external module
+ */
+function isExternalModule(importSpecifier) {
+    // External if it doesn't start with . or /
+    return !importSpecifier.startsWith('.') && !importSpecifier.startsWith('/');
+}
+//# sourceMappingURL=pathUtils.js.map

package/dist/utils/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/utils/pathUtils.ts"],"names":[],"mappings":";;AAKA,sCAGC;AAKD,4CAEC;AAKD,4CAGC;AAvBD,yCAA2D;AAE3D;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC5C,MAAM,YAAY,GAAG,IAAA,sBAAU,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,CAAC;IACzE,OAAO,IAAA,qBAAS,EAAC,YAAY,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,eAAuB;IACtD,OAAO,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,eAAuB;IACtD,2CAA2C;IAC3C,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC9E,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "tdepend",
+  "version": "0.2.0",
+  "description": "JDepend-inspired dependency analysis tool for TypeScript",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "tdepend": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js",
+      "require": "./dist/cli/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "dependency",
+    "analysis",
+    "typescript",
+    "cli",
+    "library",
+    "api",
+    "jdepend",
+    "metrics",
+    "architecture",
+    "coupling",
+    "abstractness",
+    "instability",
+    "dependency-analysis",
+    "code-quality"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dvmhmdsd/tdepend.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dvmhmdsd/tdepend/issues"
+  },
+  "homepage": "https://github.com/dvmhmdsd/tdepend#readme",
+  "author": "Mohamed Saad <mohamed.tarif999@gmail.com>",
+  "license": "MIT",
+  "packageManager": "pnpm@8.15.4",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "glob": "^13.0.0",
+    "ts-morph": "^27.0.2",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/glob": "^9.0.0",
+    "@types/node": "^20.11.30",
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "ts-node src/cli/index.ts analyze --help",
+    "cli": "node dist/cli/index.js",
+    "test": "vitest run",
+    "format": "prettier --write ."
+  }
+}