tdepend 0.2.0 → 0.3.1

package/dist/api/analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/api/analyze.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/api/analyze.ts"],"names":[],"mappings":";;AAyBA,0BA8BC;AAvDD,yCAAmD;AAEnD,qDAAkD;AAClD,sCAAwC;AACxC,wDAA0F;AAC1F,8BAA8C;AAC9C,4DAAyD;AACzD,gEAA6D;AAC7D,+DAA4D;AAY5D;;;;GAIG;AACI,KAAK,UAAU,OAAO,CAAC,UAA0B,EAAE;IACxD,MAAM,OAAO,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,uBAAU,EAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAClF,IAAI,CAAC,IAAA,UAAK,EAAC,IAAA,mBAAc,GAAE,EAAE,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,oBAAW,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,iCAAe,EAAC,OAAO,EAAE;QACnC,UAAU,EAAE,IAAA,mCAAoB,EAAC,4BAAa,EAAE,MAAM,CAAC,OAAO,CAAC;QAC/D,gBAAgB,EAAE,IAAA,mCAAoB,EAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;KAC3D,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC,GAAG,EAAE;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,4BAAa;KAC3B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAA,+BAAc,EAAC,GAAG,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAA,+BAAc,EAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE;QACtF,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,GAAG;QACH,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/api/explain.d.ts

@@ -0,0 +1,22 @@
+import type { EdgeKind, LoadReason } from '../parser/types';
+import type { ResolutionClass, Target } from '../resolver/types';
+import { type AnalyzeOptions } from './analyze';
+export interface ExplainRow {
+    specifier: string;
+    line: number;
+    column: number;
+    kind: EdgeKind;
+    loadsTarget: boolean;
+    loadsTargetBy: LoadReason | null;
+    loadReason: string;
+    class: ResolutionClass;
+    target: Target | null;
+}
+/**
+ * Lists every import in one file with its syntactic kind, whether it loads its
+ * target at runtime (and why), and how it resolved. This is the debugging view
+ * for the graph and the runtime-load contract.
+ */
+export declare function explainFile(options: AnalyzeOptions & {
+    file: string;
+}): Promise<ExplainRow[]>;

package/dist/api/explain.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainFile = explainFile;
+const node_path_1 = require("node:path");
+const errors_1 = require("../errors");
+const fs_1 = require("../fs");
+const analyze_1 = require("./analyze");
+/**
+ * Lists every import in one file with its syntactic kind, whether it loads its
+ * target at runtime (and why), and how it resolved. This is the debugging view
+ * for the graph and the runtime-load contract.
+ */
+async function explainFile(options) {
+    const result = await (0, analyze_1.analyze)(options);
+    const file = toRootRelative(result.ctx.rootDir, options.file);
+    if (!result.files.files.includes(file)) {
+        throw new errors_1.ConfigError(`File is not in the analysis set: ${file}`);
+    }
+    return result.sites
+        .filter((record) => record.file === file)
+        .map((record) => ({
+        specifier: record.site.specifier,
+        line: record.site.line,
+        column: record.site.column,
+        kind: record.site.kind,
+        loadsTarget: record.site.loadsTarget === true,
+        loadsTargetBy: record.site.loadsTargetBy ?? null,
+        loadReason: record.site.loadReason ?? '',
+        class: record.resolution.class,
+        target: record.resolution.target,
+    }));
+}
+function toRootRelative(rootDir, file) {
+    if ((0, node_path_1.isAbsolute)(file))
+        return (0, fs_1.toPosix)((0, node_path_1.relative)(rootDir, file));
+    return (0, fs_1.toPosix)(file.replace(/^\.\//, ''));
+}
+//# sourceMappingURL=explain.js.map

package/dist/api/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/api/explain.ts"],"names":[],"mappings":";;AAyBA,kCAsBC;AA/CD,yCAAiD;AAEjD,sCAAwC;AACxC,8BAAgC;AAGhC,uCAAyD;AAczD;;;;GAIG;AACI,KAAK,UAAU,WAAW,CAC/B,OAA0C;IAE1C,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAO,EAAC,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,oBAAW,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC,KAAK;SAChB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;SACxC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;QAC7C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI;QAChD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE;QACxC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;QAC9B,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;KACjC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAAY;IACnD,IAAI,IAAA,sBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,IAAA,YAAO,EAAC,IAAA,oBAAQ,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,OAAO,IAAA,YAAO,EAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/api/export.d.ts

@@ -1,50 +1,7 @@
 import type { AnalysisResult } from '../types/api';
 /**
- * Options for exporting analysis results.
+ * Writes the versioned JSON export of an analysis to a file. The output is
+ * pretty-printed and ends with a newline; two runs on the same inputs write
+ * byte-identical files.
  */
-export interface ExportOptions {
-    /**
-     * Whether to pretty-print the JSON output.
-     * @default true
-     */
-    pretty?: boolean;
-}
-/**
- * Exports analysis results to a JSON file.
- *
- * This function converts the analysis result to a serializable format
- * (fixing Set serialization issues) and writes it to the specified file.
- *
- * @param result - The analysis result to export
- * @param filePath - Path where the JSON file should be written
- * @param options - Export options (pretty-printing, etc.)
- *
- * @example
- * ```typescript
- * import { analyze, exportToFile } from 'tdepend';
- *
- * const result = await analyze({ rootDir: 'src' });
- * await exportToFile(result, 'architecture-snapshot.json');
- * ```
- */
-export declare function exportToFile(result: AnalysisResult, filePath: string, options?: ExportOptions): Promise<void>;
-/**
- * Converts analysis results to a JSON string.
- *
- * This function converts the analysis result to a serializable format
- * and returns it as a JSON string (does not write to file).
- *
- * @param result - The analysis result to export
- * @param options - Export options (pretty-printing, etc.)
- * @returns JSON string representation of the analysis result
- *
- * @example
- * ```typescript
- * import { analyze, exportToJson } from 'tdepend';
- *
- * const result = await analyze({ rootDir: 'src' });
- * const json = exportToJson(result, { pretty: false }); // Compact JSON
- * console.log(json);
- * ```
- */
-export declare function exportToJson(result: AnalysisResult, options?: ExportOptions): string;
+export declare function exportToFile(result: AnalysisResult, path: string): Promise<void>;

package/dist/api/export.js

@@ -1,53 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exportToFile = exportToFile;
-exports.exportToJson = exportToJson;
-const promises_1 = require("fs/promises");
+const promises_1 = require("node:fs/promises");
 const serialization_1 = require("./serialization");
 /**
- * Exports analysis results to a JSON file.
- *
- * This function converts the analysis result to a serializable format
- * (fixing Set serialization issues) and writes it to the specified file.
- *
- * @param result - The analysis result to export
- * @param filePath - Path where the JSON file should be written
- * @param options - Export options (pretty-printing, etc.)
- *
- * @example
- * ```typescript
- * import { analyze, exportToFile } from 'tdepend';
- *
- * const result = await analyze({ rootDir: 'src' });
- * await exportToFile(result, 'architecture-snapshot.json');
- * ```
+ * Writes the versioned JSON export of an analysis to a file. The output is
+ * pretty-printed and ends with a newline; two runs on the same inputs write
+ * byte-identical files.
  */
-async function exportToFile(result, filePath, options = {}) {
-    const json = exportToJson(result, options);
-    await (0, promises_1.writeFile)(filePath, json, 'utf-8');
-}
-/**
- * Converts analysis results to a JSON string.
- *
- * This function converts the analysis result to a serializable format
- * and returns it as a JSON string (does not write to file).
- *
- * @param result - The analysis result to export
- * @param options - Export options (pretty-printing, etc.)
- * @returns JSON string representation of the analysis result
- *
- * @example
- * ```typescript
- * import { analyze, exportToJson } from 'tdepend';
- *
- * const result = await analyze({ rootDir: 'src' });
- * const json = exportToJson(result, { pretty: false }); // Compact JSON
- * console.log(json);
- * ```
- */
-function exportToJson(result, options = {}) {
-    const serialized = (0, serialization_1.toSerializable)(result);
-    const indent = options.pretty !== false ? 2 : 0;
-    return JSON.stringify(serialized, null, indent);
+async function exportToFile(result, path) {
+    await (0, promises_1.writeFile)(path, `${JSON.stringify((0, serialization_1.toSerializable)(result), null, 2)}\n`, 'utf-8');
 }
 //# sourceMappingURL=export.js.map

package/dist/api/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/api/export.ts"],"names":[],"mappings":";;AAiCA,oCAOC;AAqBD,oCAIC;AAjED,0CAAwC;AACxC,mDAAiD;AAcjD;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,QAAgB,EAChB,UAAyB,EAAE;IAE3B,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,MAAsB,EAAE,UAAyB,EAAE;IAC9E,MAAM,UAAU,GAAG,IAAA,8BAAc,EAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/api/export.ts"],"names":[],"mappings":";;AAUA,oCAEC;AAZD,+CAA6C;AAG7C,mDAAiD;AAEjD;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAC,MAAsB,EAAE,IAAY;IACrE,MAAM,IAAA,oBAAS,EAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,8BAAc,EAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzF,CAAC"}

package/dist/api/serialization.d.ts

@@ -1,28 +1,8 @@
-import type { DependencyGraph } from '../graph/dependencyGraph';
-import type { AnalysisResult, SerializableAnalysisResult, SerializableDependencyGraph, SerializableCycle } from '../types/api';
+import type { AnalysisResult, SerializableResult } from '../types/api';
 /**
- * Converts a DependencyGraph with Sets to a serializable format with Arrays.
- * @param graph - The dependency graph to serialize
- * @returns Serializable graph with array-based relationships
+ * Projects an analysis into its versioned, fully sorted export shape. The
+ * parser's `ts.Node` references and the project context are dropped here, so
+ * the result is plain data with no timestamp.
  */
-export declare function serializeGraph(graph: DependencyGraph): SerializableDependencyGraph;
-/**
- * Normalizes a cycle for consistent identification across runs.
- * Creates a unique ID based on the cycle's contents and rotates the cycle
- * to start with the lexicographically smallest file path.
- *
- * @param cycle - Array of file paths forming a cycle
- * @returns Normalized cycle with unique ID
- */
-export declare function normalizeCycle(cycle: string[]): SerializableCycle;
-/**
- * Converts an AnalysisResult with rich objects to a fully serializable format.
- * This includes:
- * - Converting Sets to Arrays in the dependency graph
- * - Normalizing cycles with unique IDs
- * - Adding version and timestamp metadata
- *
- * @param result - The analysis result to serialize
- * @returns Fully serializable result ready for JSON.stringify
- */
-export declare function toSerializable(result: AnalysisResult): SerializableAnalysisResult;
+export declare function toSerializable(result: AnalysisResult): SerializableResult;
+export declare function discoveryWarnings(result: AnalysisResult): string[];

package/dist/api/serialization.js

@@ -1,71 +1,81 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeGraph = serializeGraph;
-exports.normalizeCycle = normalizeCycle;
 exports.toSerializable = toSerializable;
-const crypto_1 = require("crypto");
+exports.discoveryWarnings = discoveryWarnings;
 /**
- * Converts a DependencyGraph with Sets to a serializable format with Arrays.
- * @param graph - The dependency graph to serialize
- * @returns Serializable graph with array-based relationships
+ * Projects an analysis into its versioned, fully sorted export shape. The
+ * parser's `ts.Node` references and the project context are dropped here, so
+ * the result is plain data with no timestamp.
  */
-function serializeGraph(graph) {
-    const nodes = graph.getAllNodes().map((node) => ({
-        filePath: node.filePath,
-        dependencies: Array.from(node.dependencies).sort(),
-        dependents: Array.from(node.dependents).sort(),
-    }));
-    return { nodes };
+function toSerializable(result) {
+    return {
+        version: 1,
+        files: result.graph.files(),
+        edges: result.graph.edges().map(serializeEdge),
+        sites: [...result.sites].sort(compareRecords).map(serializeSite),
+        report: serializeReport(result),
+    };
 }
-/**
- * Normalizes a cycle for consistent identification across runs.
- * Creates a unique ID based on the cycle's contents and rotates the cycle
- * to start with the lexicographically smallest file path.
- *
- * @param cycle - Array of file paths forming a cycle
- * @returns Normalized cycle with unique ID
- */
-function normalizeCycle(cycle) {
-    if (cycle.length === 0) {
-        return {
-            id: '',
-            nodes: [],
-            length: 0,
-        };
-    }
-    // Create stable ID by hashing sorted paths
-    const sorted = [...cycle].sort();
-    const id = (0, crypto_1.createHash)('sha256').update(sorted.join('|')).digest('hex').slice(0, 16);
-    // Rotate cycle to start with lexicographically smallest element
-    const minPath = sorted[0];
-    const minIndex = cycle.indexOf(minPath);
-    const normalized = [...cycle.slice(minIndex), ...cycle.slice(0, minIndex)];
+function serializeSite(record) {
+    const { site, resolution } = record;
     return {
-        id,
-        nodes: normalized,
-        length: cycle.length,
+        file: record.file,
+        specifier: site.specifier,
+        line: site.line,
+        column: site.column,
+        kind: site.kind,
+        form: site.form,
+        deferred: site.deferred === true,
+        unsupported: site.unsupported ?? null,
+        loadsTarget: site.loadsTarget === true,
+        loadsTargetBy: site.loadsTargetBy ?? null,
+        class: resolution.class,
+        reason: resolution.reason ?? null,
+        target: resolution.target,
+        mapped: resolution.mapped?.from ?? null,
+        requested: resolution.requested ?? null,
     };
 }
-/**
- * Converts an AnalysisResult with rich objects to a fully serializable format.
- * This includes:
- * - Converting Sets to Arrays in the dependency graph
- * - Normalizing cycles with unique IDs
- * - Adding version and timestamp metadata
- *
- * @param result - The analysis result to serialize
- * @returns Fully serializable result ready for JSON.stringify
- */
-function toSerializable(result) {
+function serializeEdge(edge) {
     return {
-        version: '1.0.0',
-        timestamp: new Date().toISOString(),
-        config: result.config,
-        modules: result.modules,
-        graph: serializeGraph(result.graph),
-        cycles: result.cycles.map(normalizeCycle),
-        metrics: result.metrics,
-        report: result.report,
+        from: edge.from,
+        to: edge.to,
+        runtime: edge.runtime,
+        mapped: edge.mapped,
+        kinds: [...new Set(edge.sites.map((site) => site.kind))].sort(),
     };
 }
+function serializeReport(result) {
+    return {
+        stats: { ...result.report.stats },
+        unresolved: result.report.unresolved.map(siteLocation),
+        ignoredByDir: { ...result.report.ignoredByDir },
+        unsupported: result.report.unsupported.map(serializeUnsupported),
+        selfImports: [...result.report.selfImports],
+        uncovered: [...result.report.uncovered],
+        skipped: result.report.skipped.map((entry) => ({ file: entry.file, reason: entry.reason })),
+        warnings: discoveryWarnings(result),
+    };
+}
+function discoveryWarnings(result) {
+    return [...result.ctx.warnings, ...result.ctx.unsupported.map((name) => `unsupported: ${name}`)];
+}
+function siteLocation(record) {
+    return {
+        file: record.file,
+        line: record.site.line,
+        column: record.site.column,
+        specifier: record.site.specifier,
+    };
+}
+function serializeUnsupported(record) {
+    return { ...siteLocation(record), reason: record.resolution.reason ?? '' };
+}
+function compareRecords(a, b) {
+    if (a.file !== b.file)
+        return a.file < b.file ? -1 : 1;
+    if (a.site.line !== b.site.line)
+        return a.site.line - b.site.line;
+    return a.site.column - b.site.column;
+}
 //# sourceMappingURL=serialization.js.map

package/dist/api/serialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/api/serialization.ts"],"names":[],"mappings":";;AAeA,wCAQC;AAUD,wCAuBC;AAYD,wCAWC;AA/ED,mCAAoC;AAUpC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAsB;IACnD,MAAM,KAAK,GAAiC,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7E,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;QAClD,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;KAC/C,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,KAAe;IAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,EAAE;YACN,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,EAAE,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpF,gEAAgE;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3E,OAAO;QACL,EAAE;QACF,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAAC,MAAsB;IACnD,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/api/serialization.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -1,134 +1,16 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const loadConfig_1 = require("../config/loadConfig");
-const reporter_1 = require("../analysis/reporter");
-const dependencyGraph_1 = require("../graph/dependencyGraph");
-const cycleDetector_1 = require("../graph/cycleDetector");
-const metrics_1 = require("../metrics");
-const fileScanner_1 = require("../parser/fileScanner");
-const tsParser_1 = require("../parser/tsParser");
-const log_1 = require("../utils/log");
-const export_1 = require("../api/export");
-async function runAnalysis(config) {
-    (0, log_1.log)(config, '✓ Configuration loaded successfully');
-    (0, log_1.log)(config, `  Root directory: ${config.rootDir}`);
-    (0, log_1.log)(config, `  Enabled metrics: ${config.metrics.enabled.join(', ')}`);
-    if (config.analysis.target) {
-        (0, log_1.log)(config, `  Analysis scope: ${config.analysis.target} = ${config.analysis.value}`);
-    }
-    (0, log_1.log)(config, '\n📁 Scanning files...');
-    const files = await (0, fileScanner_1.scanFiles)(config);
-    (0, log_1.log)(config, `✓ Found ${files.length} TypeScript files`);
-    if (files.length === 0) {
-        (0, log_1.log)(config, '\n⚠ No files found matching the configured patterns.');
-        process.exitCode = 0;
-        return null;
-    }
-    (0, log_1.log)(config, '\n📝 Parsing modules...');
-    const modules = (0, tsParser_1.parseProject)(files);
-    (0, log_1.log)(config, `✓ Parsed ${modules.length} modules`);
-    (0, log_1.log)(config, '\n🔗 Building dependency graph...');
-    const graph = new dependencyGraph_1.DependencyGraph(modules);
-    (0, log_1.log)(config, '✓ Dependency graph built');
-    (0, log_1.log)(config, '\n🔄 Detecting cycles...');
-    const cycles = (0, cycleDetector_1.detectCycles)(graph);
-    (0, log_1.log)(config, `✓ Found ${cycles.length} cycle(s)`);
-    if (checkCyclesAndFail(cycles, config.ci.failOnCycle)) {
-        if (config.ci.outputFormat !== 'json') {
-            process.exitCode = 1;
-            return null;
-        }
-    }
-    (0, log_1.log)(config, '\n📐 Computing metrics...');
-    const metrics = (0, metrics_1.computeAllMetrics)(graph, modules, cycles);
-    (0, log_1.log)(config, '✓ Metrics computed');
-    const report = (0, reporter_1.generateReport)(modules, metrics, cycles, config);
-    // Create AnalysisResult for potential export
-    const result = {
-        modules,
-        graph,
-        cycles,
-        metrics,
-        report,
-        config,
-    };
-    if (config.ci.outputFormat === 'json') {
-        console.log((0, reporter_1.formatJsonOutput)(report));
-    }
-    else {
-        (0, reporter_1.formatConsoleOutput)(report, config);
-    }
-    if (!report.success) {
-        if (config.ci.outputFormat !== 'json') {
-            console.error(report.violations.cycles.length > 0 && config.ci.failOnCycle
-                ? '\n❌ Error: Cycles detected in dependency graph'
-                : '\n❌ Error: Modules exceed distance threshold');
-        }
-        process.exitCode = 1;
-    }
-    else {
-        process.exitCode = 0;
-    }
-    return result;
-}
-function checkCyclesAndFail(cycles, failOnCycle) {
-    if (cycles.length > 0 && failOnCycle) {
-        console.error('\n❌ Error: Cycles detected in dependency graph');
-        for (const cycle of cycles) {
-            const fileNames = cycle.map((p) => p.split('/').pop()).join(' → ');
-            console.error(`  - ${fileNames}`);
-        }
-        return true;
-    }
-    return false;
-}
-const program = new commander_1.Command();
-program
-    .name('tdepend')
-    .description('TDepend: TypeScript dependency analysis tool')
-    .version('0.1.0');
-program
-    .command('analyze')
-    .description('Analyze a TypeScript project for dependencies and metrics')
-    .option('-c, --config <path>', 'Path to config file (tdepend.config.json)')
-    .option('--class <name>', 'Analyze a specific class by name')
-    .option('--namespace <name>', 'Analyze a specific namespace by name')
-    .option('--ci', 'Run in CI mode with JSON output and strict exit codes')
-    .option('-e, --export <path>', 'Export full analysis to JSON file')
-    .option('-o, --output <path>', 'Alias for --export')
-    .argument('[target]', 'Optional module/file path to analyze')
-    .action(async (target, options) => {
-    try {
-        const config = (0, loadConfig_1.loadConfig)(options.config);
-        if (options.ci) {
-            config.ci.outputFormat = 'json';
-        }
-        if (target) {
-            config.analysis.target = 'module';
-            config.analysis.value = target;
-        }
-        if (options.class) {
-            config.analysis.target = 'class';
-            config.analysis.value = options.class;
-        }
-        if (options.namespace) {
-            config.analysis.target = 'namespace';
-            config.analysis.value = options.namespace;
-        }
-        const result = await runAnalysis(config);
-        // Handle export if requested
-        if (result && (options.export || options.output)) {
-            const exportPath = options.export || options.output;
-            await (0, export_1.exportToFile)(result, exportPath);
-            (0, log_1.log)(config, `\n✓ Analysis exported to ${exportPath}`);
-        }
-    }
-    catch (error) {
-        console.error('Error:', error instanceof Error ? error.message : String(error));
-        process.exitCode = 1;
-    }
+const run_1 = require("./run");
+void (0, run_1.runCli)(process.argv.slice(2), {
+    cwd: process.cwd(),
+    stdout: (message) => {
+        process.stdout.write(message);
+    },
+    stderr: (message) => {
+        process.stderr.write(message);
+    },
+}).then((code) => {
+    process.exitCode = code;
 });
-program.parse();
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,+BAA+B;AAE/B,KAAK,IAAA,YAAM,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACjC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;CACF,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,12 @@
+export interface CliIo {
+    cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}
+type ExitCode = 0 | 1 | 2;
+/**
+ * Runs the CLI and resolves to its exit code. Only the commands that exist at
+ * this milestone are registered: `analyze` and `explain`.
+ */
+export declare function runCli(argv: string[], io: CliIo): Promise<ExitCode>;
+export {};